| | | | |
| Offset 3250, 15 lines modified | Offset 3250, 15 lines modified |
| 3250 | certificate·once·it·is·issued.·Some·plugins,·like·the·built\-in·Apache·and·Nginx | 3250 | certificate·once·it·is·issued.·Some·plugins,·like·the·built\-in·Apache·and·Nginx |
| 3251 | plugins,·implement·both·interfaces·and·perform·both·tasks.·Others,·like·the | 3251 | plugins,·implement·both·interfaces·and·perform·both·tasks.·Others,·like·the |
| 3252 | built\-in·Standalone·authenticator,·implement·just·one·interface. | 3252 | built\-in·Standalone·authenticator,·implement·just·one·interface. |
| 3253 | .SS·Authenticators | 3253 | .SS·Authenticators |
| 3254 | .sp | 3254 | .sp |
| 3255 | Authenticators·are·plugins·that·prove·control·of·a·domain·name·by·solving·a | 3255 | Authenticators·are·plugins·that·prove·control·of·a·domain·name·by·solving·a |
| 3256 | challenge·provided·by·the·ACME·server.·ACME·currently·defines·several·types·of | 3256 | challenge·provided·by·the·ACME·server.·ACME·currently·defines·several·types·of |
| 3257 | challenges:·HTTP,·TLS\-ALPN,·and·DNS,·represented·by·classes·in·\fI\%acme.challenges\fP\&. | 3257 | challenges:·HTTP,·TLS\-ALPN,·and·DNS,·represented·by·classes·in·\fBacme.challenges\fP\&. |
| 3258 | An·authenticator·plugin·should·implement·support·for·at·least·one·challenge·type. | 3258 | An·authenticator·plugin·should·implement·support·for·at·least·one·challenge·type. |
| 3259 | .sp | 3259 | .sp |
| 3260 | An·Authenticator·indicates·which·challenges·it·supports·by·implementing | 3260 | An·Authenticator·indicates·which·challenges·it·supports·by·implementing |
| 3261 | \fBget_chall_pref(domain)\fP·to·return·a·sorted·list·of·challenge·types·in | 3261 | \fBget_chall_pref(domain)\fP·to·return·a·sorted·list·of·challenge·types·in |
| 3262 | preference·order. | 3262 | preference·order. |
| 3263 | .sp | 3263 | .sp |
| 3264 | An·Authenticator·must·also·implement·\fBperform(achalls)\fP,·which·\(dqperforms\(dq·a·list | 3264 | An·Authenticator·must·also·implement·\fBperform(achalls)\fP,·which·\(dqperforms\(dq·a·list |
| Offset 3795, 15 lines modified | Offset 3795, 15 lines modified |
| 3795 | Then·the·rest·of·certbot·code·relies·on·this·module·to·be·platform·agnostic. | 3795 | Then·the·rest·of·certbot·code·relies·on·this·module·to·be·platform·agnostic. |
| 3796 | .SS·Submodules | 3796 | .SS·Submodules |
| 3797 | .SS·certbot.compat.filesystem·module | 3797 | .SS·certbot.compat.filesystem·module |
| 3798 | .sp | 3798 | .sp |
| 3799 | Compat·module·to·handle·files·security·on·Windows·and·Linux | 3799 | Compat·module·to·handle·files·security·on·Windows·and·Linux |
| 3800 | .INDENT·0.0 | 3800 | .INDENT·0.0 |
| 3801 | .TP | 3801 | .TP |
| 3802 | .B·certbot.compat.filesystem.chmod(file_path:·\fI\%str\fP,·mode:·\fI\%int\fP)·->·\fI\%None\fP | 3802 | .B·certbot.compat.filesystem.chmod(file_path:·str,·mode:·int)·->·None |
| 3803 | Apply·a·POSIX·mode·on·given·file_path: | 3803 | Apply·a·POSIX·mode·on·given·file_path: |
| 3804 | .INDENT·7.0 | 3804 | .INDENT·7.0 |
| 3805 | .INDENT·3.5 | 3805 | .INDENT·3.5 |
| 3806 | .INDENT·0.0 | 3806 | .INDENT·0.0 |
| 3807 | .IP·\(bu·2 | 3807 | .IP·\(bu·2 |
| 3808 | for·Linux,·the·POSIX·mode·will·be·directly·applied·using·chmod, | 3808 | for·Linux,·the·POSIX·mode·will·be·directly·applied·using·chmod, |
| 3809 | .IP·\(bu·2 | 3809 | .IP·\(bu·2 |
| Offset 3817, 431 lines modified | Offset 3817, 431 lines modified |
| 3817 | is·explained·at·\fI\%https://github.com/certbot/certbot/issues/6356\fP·and·is·implemented·by·the | 3817 | is·explained·at·\fI\%https://github.com/certbot/certbot/issues/6356\fP·and·is·implemented·by·the |
| 3818 | method·\fB_generate_windows_flags()\fP\&. | 3818 | method·\fB_generate_windows_flags()\fP\&. |
| 3819 | .INDENT·7.0 | 3819 | .INDENT·7.0 |
| 3820 | .TP | 3820 | .TP |
| 3821 | .B·Parameters | 3821 | .B·Parameters |
| 3822 | .INDENT·7.0 | 3822 | .INDENT·7.0 |
| 3823 | .IP·\(bu·2 | 3823 | .IP·\(bu·2 |
| 3824 | \fBfile_path\fP·(\fI\%str\fP)·\-\-·Path·of·the·file | 3824 | \fBfile_path\fP·(\fIstr\fP)·\-\-·Path·of·the·file |
| 3825 | .IP·\(bu·2 | 3825 | .IP·\(bu·2 |
| 3826 | \fBmode\fP·(\fI\%int\fP)·\-\-·POSIX·mode·to·apply | 3826 | \fBmode\fP·(\fIint\fP)·\-\-·POSIX·mode·to·apply |
| 3827 | .UNINDENT | 3827 | .UNINDENT |
| 3828 | .UNINDENT | 3828 | .UNINDENT |
| 3829 | .UNINDENT | 3829 | .UNINDENT |
| 3830 | .INDENT·0.0 | 3830 | .INDENT·0.0 |
| 3831 | .TP | 3831 | .TP |
| 3832 | .B·certbot.compat.filesystem.umask(mask:·\fI\%int\fP)·->·\fI\%int\fP | 3832 | .B·certbot.compat.filesystem.umask(mask:·int)·->·int |
| 3833 | Set·the·current·numeric·umask·and·return·the·previous·umask.·On·Linux,·the·built\-in·umask | 3833 | Set·the·current·numeric·umask·and·return·the·previous·umask.·On·Linux,·the·built\-in·umask |
| 3834 | method·is·used.·On·Windows,·our·Certbot\-side·implementation·is·used. | 3834 | method·is·used.·On·Windows,·our·Certbot\-side·implementation·is·used. |
| 3835 | .INDENT·7.0 | 3835 | .INDENT·7.0 |
| 3836 | .TP | 3836 | .TP |
| 3837 | .B·Parameters | 3837 | .B·Parameters |
| 3838 | \fBmask\fP·(\fI\%int\fP)·\-\-·The·user·file\-creation·mode·mask·to·apply. | 3838 | \fBmask\fP·(\fIint\fP)·\-\-·The·user·file\-creation·mode·mask·to·apply. |
| 3839 | .TP | 3839 | .TP |
| 3840 | .B·Return·type | 3840 | .B·Return·type |
| 3841 | \fI\%int\fP | 3841 | int |
| 3842 | .TP | 3842 | .TP |
| 3843 | .B·Returns | 3843 | .B·Returns |
| 3844 | The·previous·umask·value. | 3844 | The·previous·umask·value. |
| 3845 | .UNINDENT | 3845 | .UNINDENT |
| 3846 | .UNINDENT | 3846 | .UNINDENT |
| 3847 | .INDENT·0.0 | 3847 | .INDENT·0.0 |
| 3848 | .TP | 3848 | .TP |
| 3849 | .B·certbot.compat.filesystem.temp_umask(mask:·\fI\%int\fP)·->·\fI\%Generator\fP[\fI\%None\fP,·\fI\%None\fP,·\fI\%None\fP] | 3849 | .B·certbot.compat.filesystem.temp_umask(mask:·int)·->·Generator[None,·None,·None] |
| 3850 | Apply·a·umask·temporarily,·meant·to·be·used·in·a·\fBwith\fP·block.·Uses·the·Certbot | 3850 | Apply·a·umask·temporarily,·meant·to·be·used·in·a·\fBwith\fP·block.·Uses·the·Certbot |
| 3851 | implementation·of·umask. | 3851 | implementation·of·umask. |
| 3852 | .INDENT·7.0 | 3852 | .INDENT·7.0 |
| 3853 | .TP | 3853 | .TP |
| 3854 | .B·Parameters | 3854 | .B·Parameters |
| 3855 | \fBmask\fP·(\fI\%int\fP)·\-\-·The·user·file\-creation·mode·mask·to·apply·temporarily | 3855 | \fBmask\fP·(\fIint\fP)·\-\-·The·user·file\-creation·mode·mask·to·apply·temporarily |
| 3856 | .UNINDENT | 3856 | .UNINDENT |
| 3857 | .UNINDENT | 3857 | .UNINDENT |
| 3858 | .INDENT·0.0 | 3858 | .INDENT·0.0 |
| 3859 | .TP | 3859 | .TP |
| 3860 | .B·certbot.compat.filesystem.copy_ownership_and_apply_mode(src:·\fI\%str\fP,·dst:·\fI\%str\fP,·mode:·\fI\%int\fP,·copy_user:·\fI\%bool\fP,·copy_group:·\fI\%bool\fP)·->·\fI\%None\fP | 3860 | .B·certbot.compat.filesystem.copy_ownership_and_apply_mode(src:·str,·dst:·str,·mode:·int,·copy_user:·bool,·copy_group:·bool)·->·None |
| 3861 | Copy·ownership·(user·and·optionally·group·on·Linux)·from·the·source·to·the | 3861 | Copy·ownership·(user·and·optionally·group·on·Linux)·from·the·source·to·the |
| 3862 | destination,·then·apply·given·mode·in·compatible·way·for·Linux·and·Windows. | 3862 | destination,·then·apply·given·mode·in·compatible·way·for·Linux·and·Windows. |
| 3863 | This·replaces·the·os.chown·command. | 3863 | This·replaces·the·os.chown·command. |
| 3864 | .INDENT·7.0 | 3864 | .INDENT·7.0 |
| 3865 | .TP | 3865 | .TP |
| 3866 | .B·Parameters | 3866 | .B·Parameters |
| 3867 | .INDENT·7.0 | 3867 | .INDENT·7.0 |
| 3868 | .IP·\(bu·2 | 3868 | .IP·\(bu·2 |
| 3869 | \fBsrc\fP·(\fI\%str\fP)·\-\-·Path·of·the·source·file | 3869 | \fBsrc\fP·(\fIstr\fP)·\-\-·Path·of·the·source·file |
| 3870 | .IP·\(bu·2 | 3870 | .IP·\(bu·2 |
| 3871 | \fBdst\fP·(\fI\%str\fP)·\-\-·Path·of·the·destination·file | 3871 | \fBdst\fP·(\fIstr\fP)·\-\-·Path·of·the·destination·file |
| 3872 | .IP·\(bu·2 | 3872 | .IP·\(bu·2 |
| 3873 | \fBmode\fP·(\fI\%int\fP)·\-\-·Permission·mode·to·apply·on·the·destination·file | 3873 | \fBmode\fP·(\fIint\fP)·\-\-·Permission·mode·to·apply·on·the·destination·file |
| 3874 | .IP·\(bu·2 | 3874 | .IP·\(bu·2 |
| 3875 | \fBcopy_user\fP·(\fI\%bool\fP)·\-\-·Copy·user·if·\fI\%True\fP | 3875 | \fBcopy_user\fP·(\fIbool\fP)·\-\-·Copy·user·if·\fBTrue\fP |
| 3876 | .IP·\(bu·2 | 3876 | .IP·\(bu·2 |
| 3877 | \fBcopy_group\fP·(\fI\%bool\fP)·\-\-·Copy·group·if·\fI\%True\fP·on·Linux·(has·no·effect·on·Windows) | 3877 | \fBcopy_group\fP·(\fIbool\fP)·\-\-·Copy·group·if·\fBTrue\fP·on·Linux·(has·no·effect·on·Windows) |
| 3878 | .UNINDENT | 3878 | .UNINDENT |
| 3879 | .UNINDENT | 3879 | .UNINDENT |
| 3880 | .UNINDENT | 3880 | .UNINDENT |
| 3881 | .INDENT·0.0 | 3881 | .INDENT·0.0 |
| 3882 | .TP | 3882 | .TP |
| 3883 | .B·certbot.compat.filesystem.copy_ownership_and_mode(src:·\fI\%str\fP,·dst:·\fI\%str\fP,·copy_user:·\fI\%bool\fP·=·True,·copy_group:·\fI\%bool\fP·=·True)·->·\fI\%None\fP | 3883 | .B·certbot.compat.filesystem.copy_ownership_and_mode(src:·str,·dst:·str,·copy_user:·bool·=·True,·copy_group:·bool·=·True)·->·None |
| 3884 | Copy·ownership·(user·and·optionally·group·on·Linux)·and·mode/DACL | 3884 | Copy·ownership·(user·and·optionally·group·on·Linux)·and·mode/DACL |
| 3885 | from·the·source·to·the·destination. | 3885 | from·the·source·to·the·destination. |
| 3886 | .INDENT·7.0 | 3886 | .INDENT·7.0 |
| 3887 | .TP | 3887 | .TP |
| 3888 | .B·Parameters | 3888 | .B·Parameters |
| 3889 | .INDENT·7.0 | 3889 | .INDENT·7.0 |
| 3890 | .IP·\(bu·2 | 3890 | .IP·\(bu·2 |
| 3891 | \fBsrc\fP·(\fI\%str\fP)·\-\-·Path·of·the·source·file | 3891 | \fBsrc\fP·(\fIstr\fP)·\-\-·Path·of·the·source·file |
| 3892 | .IP·\(bu·2 | 3892 | .IP·\(bu·2 |
| 3893 | \fBdst\fP·(\fI\%str\fP)·\-\-·Path·of·the·destination·file | 3893 | \fBdst\fP·(\fIstr\fP)·\-\-·Path·of·the·destination·file |
| 3894 | .IP·\(bu·2 | 3894 | .IP·\(bu·2 |
| 3895 | \fBcopy_user\fP·(\fI\%bool\fP)·\-\-·Copy·user·if·\fI\%True\fP | 3895 | \fBcopy_user\fP·(\fIbool\fP)·\-\-·Copy·user·if·\fBTrue\fP |
| 3896 | .IP·\(bu·2 | 3896 | .IP·\(bu·2 |
| 3897 | \fBcopy_group\fP·(\fI\%bool\fP)·\-\-·Copy·group·if·\fI\%True\fP·on·Linux·(has·no·effect·on·Windows) | 3897 | \fBcopy_group\fP·(\fIbool\fP)·\-\-·Copy·group·if·\fBTrue\fP·on·Linux·(has·no·effect·on·Windows) |
| 3898 | .UNINDENT | 3898 | .UNINDENT |
| 3899 | .UNINDENT | 3899 | .UNINDENT |
| 3900 | .UNINDENT | 3900 | .UNINDENT |
| 3901 | .INDENT·0.0 | 3901 | .INDENT·0.0 |
| 3902 | .TP | 3902 | .TP |
| 3903 | .B·certbot.compat.filesystem.check_mode(file_path:·\fI\%str\fP,·mode:·\fI\%int\fP)·->·\fI\%bool\fP | 3903 | .B·certbot.compat.filesystem.check_mode(file_path:·str,·mode:·int)·->·bool |
| 3904 | Check·if·the·given·mode·matches·the·permissions·of·the·given·file. | 3904 | Check·if·the·given·mode·matches·the·permissions·of·the·given·file. |
| 3905 | On·Linux,·will·make·a·direct·comparison,·on·Windows,·mode·will·be·compared·against | 3905 | On·Linux,·will·make·a·direct·comparison,·on·Windows,·mode·will·be·compared·against |
| 3906 | the·security·model. | 3906 | the·security·model. |
| 3907 | .INDENT·7.0 | 3907 | .INDENT·7.0 |
| 3908 | .TP | 3908 | .TP |
| 3909 | .B·Parameters | 3909 | .B·Parameters |
| 3910 | .INDENT·7.0 | 3910 | .INDENT·7.0 |
| 3911 | .IP·\(bu·2 | 3911 | .IP·\(bu·2 |
|
Max diff block lines reached; 153149/159312 bytes (96.13%) of diff not shown.
|