1
0
mirror of git://git.sv.gnu.org/coreutils.git synced 2026-07-26 02:30:35 +02:00

doc: clarify SMACK related --help and documentation

* src/ls.c: Remove all mention of SELinux since ls
should treat all security context labels equally.
* doc/coreutils.texi (ls invocation): Likewise.
(id invocation): Clarify that -Z outputs the context
inherited by the process, rather than one specific to a user.
Note for SMACK this can be set instead by the SMACK64EXEC label,
in the unusual case where this is set on the id executable.
* src/id.c (usage): Likewise.
* src/mkdir.c (usage): Clarify that -Z is specific to SELinux,
while --context=CTX is also supported for SMACK.
* src/mkfifo.c (usage): Likewise.
* src/mknod.c (usage): Likewise.
This commit is contained in:
Chengwei Yang
2014-01-17 15:46:43 +00:00
committed by Pádraig Brady
parent 7fa1641db0
commit 6fab28dce4
6 changed files with 22 additions and 17 deletions
+6 -4
View File
@@ -7268,7 +7268,7 @@ space, there is no alternate access method. When it is a printing
character, then there is such a method.
GNU @command{ls} uses a @samp{.} character to indicate a file
with an SELinux security context, but no other alternate access method.
with a security context, but no other alternate access method.
A file with any other combination of alternate access methods
is marked with a @samp{+} character.
@@ -8466,7 +8466,8 @@ to the system default type for destination files, similarly to the
@command{restorecon} command.
The long form of this option with a specific context specified,
will set the context for newly created files only.
With a specified context, if SELinux is disabled, a warning is issued.
With a specified context, if both SELinux and SMACK are disabled, a warning is
issued.
@end macro
@optContext
This option is mutually exclusive with the @option{--preserve=context}
@@ -14563,8 +14564,9 @@ Print only the user ID.
@opindex --context
@cindex SELinux
@cindex security context
Print only the security context of the current user.
If SELinux is disabled then print a warning and
Print only the security context of the process, which is generally
the user's security context inherited from the parent process.
If neither SELinux or SMACK is enabled then print a warning and
set the exit status to 1.
@item -z
+1 -1
View File
@@ -89,7 +89,7 @@ or (when USER omitted) for the current user.\n\
stdout);
fputs (_("\
-a ignore, for compatibility with other versions\n\
-Z, --context print only the security context of the current user\n\
-Z, --context print only the security context of the process\n\
-g, --group print only the effective group ID\n\
-G, --groups print all group IDs\n\
-n, --name print a name instead of a number, for -ugG\n\
+9 -9
View File
@@ -186,7 +186,7 @@ verify (sizeof filetype_letter - 1 == arg_directory + 1);
enum acl_type
{
ACL_T_NONE,
ACL_T_SELINUX_ONLY,
ACL_T_LSM_CONTEXT_ONLY,
ACL_T_YES
};
@@ -206,7 +206,7 @@ struct fileinfo
zero. */
mode_t linkmode;
/* SELinux security context. */
/* security context. */
security_context_t scontext;
bool stat_ok;
@@ -216,7 +216,7 @@ struct fileinfo
bool linkok;
/* For long listings, true if the file has an access control list,
or an SELinux security context. */
or a security context. */
enum acl_type acl_type;
/* For color listings, true if a regular file has capability info. */
@@ -2804,8 +2804,8 @@ errno_unsupported (int err)
}
/* Cache *getfilecon failure, when it's trivial to do so.
Like getfilecon/lgetfilecon, but when F's st_dev says it's on a known-
SELinux-challenged file system, fail with ENOTSUP immediately. */
Like getfilecon/lgetfilecon, but when F's st_dev says it's doesn't
support getting the security context, fail with ENOTSUP immediately. */
static int
getfilecon_cache (char const *file, struct fileinfo *f, bool deref)
{
@@ -3052,7 +3052,7 @@ gobble_file (char const *name, enum filetype type, ino_t inode,
f->acl_type = (!have_scontext && !have_acl
? ACL_T_NONE
: (have_scontext && !have_acl
? ACL_T_SELINUX_ONLY
? ACL_T_LSM_CONTEXT_ONLY
: ACL_T_YES));
any_has_acl |= f->acl_type != ACL_T_NONE;
@@ -3799,7 +3799,7 @@ print_long_format (const struct fileinfo *f)
struct tm *when_local;
/* Compute the mode string, except remove the trailing space if no
file in this directory has an ACL or SELinux security context. */
file in this directory has an ACL or security context. */
if (f->stat_ok)
filemodestring (&f->stat, modebuf);
else
@@ -3810,7 +3810,7 @@ print_long_format (const struct fileinfo *f)
}
if (! any_has_acl)
modebuf[10] = '\0';
else if (f->acl_type == ACL_T_SELINUX_ONLY)
else if (f->acl_type == ACL_T_LSM_CONTEXT_ONLY)
modebuf[10] = '.';
else if (f->acl_type == ACL_T_YES)
modebuf[10] = '+';
@@ -4886,7 +4886,7 @@ Sort entries alphabetically if none of -cftuvSUX nor --sort is specified.\n\
-w, --width=COLS assume screen width instead of current value\n\
-x list entries by lines instead of by columns\n\
-X sort alphabetically by entry extension\n\
-Z, --context print any SELinux security context of each file\n\
-Z, --context print any security context of each file\n\
-1 list one file per line\n\
"), stdout);
fputs (HELP_OPTION_DESCRIPTION, stdout);
+2 -1
View File
@@ -67,7 +67,8 @@ Create the DIRECTORY(ies), if they do not already exist.\n\
-p, --parents no error if existing, make parent directories as needed\n\
-v, --verbose print a message for each created directory\n\
-Z, --context[=CTX] set the SELinux security context of each created\n\
directory to default type or to CTX if specified\n\
directory to default type or set the SELinux or\n\
SMACK security context to CTX if specified\n\
"), stdout);
fputs (HELP_OPTION_DESCRIPTION, stdout);
fputs (VERSION_OPTION_DESCRIPTION, stdout);
+2 -1
View File
@@ -62,7 +62,8 @@ Create named pipes (FIFOs) with the given NAMEs.\n\
"), stdout);
fputs (_("\
-Z, --context[=CTX] set the SELinux security context of each NAME to\n\
default type, or CTX if specified\n\
default type, or set the SELinux or SMACK\n\
security context to CTX if specified\n\
"), stdout);
fputs (HELP_OPTION_DESCRIPTION, stdout);
fputs (VERSION_OPTION_DESCRIPTION, stdout);
+2 -1
View File
@@ -64,7 +64,8 @@ Create the special file NAME of the given TYPE.\n\
"), stdout);
fputs (_("\
-Z, --context[=CTX] set the SELinux security context of NAME to\n\
default type, or to CTX if specified\n\
default type, or set the SELinux or SMACK\n\
security context to CTX if specified\n\
"), stdout);
fputs (HELP_OPTION_DESCRIPTION, stdout);
fputs (VERSION_OPTION_DESCRIPTION, stdout);