man/openrc-run.8: more updates and clarifications for checkpath

X-Gentoo-Bug: 500606
X-Gentoo-Bug-URL: https://bugs.gentoo.org/show_bug.cgi?id=500606
This commit is contained in:
William Hubbs 2014-07-13 11:15:26 -05:00
parent d59737afb1
commit 40141244e3

View File

@ -322,30 +322,35 @@ Mark the service as inactive.
.Op Fl p , -pipe .Op Fl p , -pipe
.Op Fl m , -mode Ar mode .Op Fl m , -mode Ar mode
.Op Fl o , -owner Ar owner .Op Fl o , -owner Ar owner
.Op Fl W , -writable
.Op Fl q , -quiet .Op Fl q , -quiet
.Ar path ... .Ar path ...
.Xc .Xc
Checks to see if the path exists, is of the right type, owned by the right If -d, -f or -p is specified, checkpath checks to see if the path
people and has the correct access modes. If not, then it corrects the path. exists, is the right type and has the correct owner and access modes. If
any of these tests fail, the path is created and set up as specified. If
more than one of -d, -f or -p are specified, the last one will be used.
Type. The argument to -m is a three or four digit octal number. If this option
File, directory and pipe types are supported, if type is not provided then is not provided, the value defaults to 0644 for files and 0775 for
directory is used directories.
Mode. The argument to -o is a representation of the user and/or group which
Mode should be provided as a three (644) or four digit string (0644). If mode should own the path. The user and group can be represented numerically
is argument is not provided then default value is used: 0644 - for files, and or with names, and are separated by a colon.
0775 for directories.
Truncate variant of options create empty directory or file, or clears contents The truncate options (-D and -F) cause the directory or file to be
if it exists. cleared of all contents.
Quiet argument suppress normal output, repeat quiet argument to suppress errors. If -W is specified, checkpath checks to see if the first path given on
.It Ic checkpath the command line is writable. This is different from how the test
.Op Fl W , -writable command in the shell works, because it also checks to make sure the file
.Ar path system is not read only.
.Xc
checks to see if the path is writable. Also, the -d, -f or -p options should not be specified along with this option.
The -q option suppresses all informational output. If it is specified
twice, all error messages are suppressed as well.
.It Ic yesno Ar value .It Ic yesno Ar value
If If
.Ar value .Ar value