Skip to content

Commit bc88e5c

Browse files
committed
Deprecate chroot support
1 parent fdafc2c commit bc88e5c

File tree

11 files changed

+242
-198
lines changed

11 files changed

+242
-198
lines changed

docs/sudo.man.in

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -712,6 +712,9 @@ before running the
712712
\fIcommand\fR.
713713
The security policy may return an error if the user does not have
714714
permission to specify the root directory.
715+
.sp
716+
This option is deprecated and will be removed in a future version of
717+
\fBsudo\fR.
715718
.if \n(SL \{\
716719
.TP 8n
717720
\fB\-r\fR \fIrole\fR, \fB\--role\fR=\fIrole\fR

docs/sudo.mdoc.in

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -667,6 +667,9 @@ before running the
667667
.Ar command .
668668
The security policy may return an error if the user does not have
669669
permission to specify the root directory.
670+
.Pp
671+
This option is deprecated and will be removed in a future version of
672+
.Nm .
670673
.if \n(SL \{\
671674
.It Fl r Ar role , Fl -role Ns = Ns Ar role
672675
Run the

docs/sudoers.man.in

Lines changed: 11 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@
2626
.nr BA @BAMAN@
2727
.nr LC @LCMAN@
2828
.nr PS @PSMAN@
29-
.TH "SUDOERS" "@mansectform@" "February 22, 2025" "Sudo @PACKAGE_VERSION@" "File Formats Manual"
29+
.TH "SUDOERS" "@mansectform@" "June 7, 2025" "Sudo @PACKAGE_VERSION@" "File Formats Manual"
3030
.nh
3131
.if n .ad l
3232
.SH "NAME"
@@ -1868,6 +1868,10 @@ user's home directory.
18681868
.PP
18691869
This setting is only supported by version 1.9.3 or higher.
18701870
.SS "Chroot_Spec"
1871+
Support for setting the root directory is deprecated and will be removed
1872+
in a future version of
1873+
\fBsudo\fR.
1874+
.PP
18711875
The root directory that the command will be run in can be specified
18721876
using the
18731877
\fRCHROOT\fR
@@ -5647,6 +5651,10 @@ that includes a
56475651
\fIChroot_Spec\fR.
56485652
.sp
56495653
This setting is only supported by version 1.9.3 or higher.
5654+
.sp
5655+
Support for setting the root directory is deprecated and will be removed
5656+
in a future version of
5657+
\fBsudo\fR.
56505658
.TP 14n
56515659
runcwd
56525660
If set,
@@ -6967,12 +6975,7 @@ facility in all cases and for commands to be run with
69676975
the target user's home directory as the working directory.
69686976
We don't want to subject the full time staff to the
69696977
\fBsudo\fR
6970-
lecture and we want to allow them to run commands in a
6971-
chroot(2)
6972-
\(lqsandbox\(rq
6973-
via the
6974-
\fB\-R\fR
6975-
option.
6978+
lecture.
69766979
User
69776980
\fBmillert\fR
69786981
need not provide a password and we don't want to reset the
@@ -7003,7 +7006,7 @@ privileges.
70037006
# Override built-in defaults
70047007
Defaults syslog=auth,runcwd=~
70057008
Defaults>root !set_logname
7006-
Defaults:FULLTIMERS !lecture,runchroot=*
7009+
Defaults:FULLTIMERS !lecture
70077010
Defaults:millert !authenticate
70087011
Defaults@SERVERS log_year, logfile=@log_dir@/sudo.log
70097012
Defaults!PAGERS noexec

docs/sudoers.mdoc.in

Lines changed: 11 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -25,7 +25,7 @@
2525
.nr BA @BAMAN@
2626
.nr LC @LCMAN@
2727
.nr PS @PSMAN@
28-
.Dd February 22, 2025
28+
.Dd June 7, 2025
2929
.Dt SUDOERS @mansectform@
3030
.Os Sudo @PACKAGE_VERSION@
3131
.Sh NAME
@@ -1772,6 +1772,10 @@ user's home directory.
17721772
.Pp
17731773
This setting is only supported by version 1.9.3 or higher.
17741774
.Ss Chroot_Spec
1775+
Support for setting the root directory is deprecated and will be removed
1776+
in a future version of
1777+
.Nm sudo .
1778+
.Pp
17751779
The root directory that the command will be run in can be specified
17761780
using the
17771781
.Dv CHROOT
@@ -5281,6 +5285,10 @@ that includes a
52815285
.Em Chroot_Spec .
52825286
.Pp
52835287
This setting is only supported by version 1.9.3 or higher.
5288+
.Pp
5289+
Support for setting the root directory is deprecated and will be removed
5290+
in a future version of
5291+
.Nm sudo .
52845292
.It runcwd
52855293
If set,
52865294
.Nm sudo
@@ -6462,12 +6470,7 @@ facility in all cases and for commands to be run with
64626470
the target user's home directory as the working directory.
64636471
We don't want to subject the full time staff to the
64646472
.Nm sudo
6465-
lecture and we want to allow them to run commands in a
6466-
.Xr chroot 2
6467-
.Dq sandbox
6468-
via the
6469-
.Fl R
6470-
option.
6473+
lecture.
64716474
User
64726475
.Sy millert
64736476
need not provide a password and we don't want to reset the
@@ -6497,7 +6500,7 @@ privileges.
64976500
# Override built-in defaults
64986501
Defaults syslog=auth,runcwd=~
64996502
Defaults>root !set_logname
6500-
Defaults:FULLTIMERS !lecture,runchroot=*
6503+
Defaults:FULLTIMERS !lecture
65016504
Defaults:millert !authenticate
65026505
Defaults@SERVERS log_year, logfile=@log_dir@/sudo.log
65036506
Defaults!PAGERS noexec

0 commit comments

Comments
 (0)