From 2d961637e0e206ca3afae36a68996750fcabfa67 Mon Sep 17 00:00:00 2001 From: Ian Jackson Date: Fri, 29 Nov 2013 18:28:57 +0000 Subject: [PATCH] really: Document -R option in the manpage. Closes:#693354. --- cprogs/really.8 | 19 +++++++++++++++---- debian/changelog | 1 + 2 files changed, 16 insertions(+), 4 deletions(-) diff --git a/cprogs/really.8 b/cprogs/really.8 index 45bca20..fb21f05 100644 --- a/cprogs/really.8 +++ b/cprogs/really.8 @@ -8,11 +8,11 @@ really \- gain privilege or run commands a different user .SH DESCRIPTION .B really checks whether the caller is allowed, and if it is it changes its uids -and gids according to the command line options and executes the -specified command. +and gids (and perhaps root directory) according to the command line +options and executes the specified command. .PP If no options are specified, the uid will be set to 0 and the gids -will be left unchanged. +and root directory will be left unchanged. .PP If no command is specified, .B really @@ -68,6 +68,17 @@ relative position of .B -z in the argument list is not relevant. .TP +\fB-R\fR \fIroot-dir\fR | \fB--chroot\fR \fIroot-dir\fR +The program will have its root directory set to +.IR root-dir . + +.BR "Do not use this option unless you know what you are doing" : +Unlike chroot(8), the current working directory will remain unchanged. +This means that if the current directory isn't underneath the +specified new root, the program will still be able to access files +outside the new root by using relative pathnames. If this isn't +what you want, please use the chroot utility instead. +.TP .B \-\- Indicates the end of the options. The next argument (if present) will be interpreted as the command name, even if it starts with a hyphen. @@ -126,7 +137,7 @@ This version of .B really was written by Ian Jackson . .PP -It and this manpage are Copyright (C) 1992-5,2003 Ian Jackson +It and this manpage are Copyright (C) 1992-5,2004,2013 Ian Jackson . .PP .B really diff --git a/debian/changelog b/debian/changelog index 62433bf..a17ffd0 100644 --- a/debian/changelog +++ b/debian/changelog @@ -1,6 +1,7 @@ chiark-utils (4.2.1~~iwj4) unstable; urgency=low * really: Add "danger!" warning to usage message description of -R. + * really: Document -R option in the manpage. Closes:#693354. -- -- 2.30.2