diff options
author | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-19 16:58:41 +0000 |
---|---|---|
committer | Daniel Baumann <daniel.baumann@progress-linux.org> | 2024-04-19 16:58:41 +0000 |
commit | e1908ae95dd4c9d19ee4dfabfc8bf8a7f85943fe (patch) | |
tree | f5cc731bedcac0fb7fe14d952e4581e749f8bb87 /man | |
parent | Initial commit. (diff) | |
download | coreutils-e1908ae95dd4c9d19ee4dfabfc8bf8a7f85943fe.tar.xz coreutils-e1908ae95dd4c9d19ee4dfabfc8bf8a7f85943fe.zip |
Adding upstream version 9.4.upstream/9.4upstream
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'man')
-rw-r--r-- | man/arch.1 | 36 | ||||
-rw-r--r-- | man/arch.x | 6 | ||||
-rw-r--r-- | man/b2sum.1 | 84 | ||||
-rw-r--r-- | man/b2sum.x | 6 | ||||
-rw-r--r-- | man/base32.1 | 55 | ||||
-rw-r--r-- | man/base32.x | 6 | ||||
-rw-r--r-- | man/base64.1 | 55 | ||||
-rw-r--r-- | man/base64.x | 6 | ||||
-rw-r--r-- | man/basename.1 | 64 | ||||
-rw-r--r-- | man/basename.x | 6 | ||||
-rw-r--r-- | man/basenc.1 | 106 | ||||
-rw-r--r-- | man/basenc.x | 38 | ||||
-rw-r--r-- | man/cat.1 | 75 | ||||
-rw-r--r-- | man/cat.x | 6 | ||||
-rw-r--r-- | man/chcon.1 | 92 | ||||
-rw-r--r-- | man/chcon.x | 4 | ||||
-rw-r--r-- | man/chgrp.1 | 93 | ||||
-rw-r--r-- | man/chgrp.x | 6 | ||||
-rw-r--r-- | man/chmod.1 | 174 | ||||
-rw-r--r-- | man/chmod.x | 118 | ||||
-rw-r--r-- | man/chown.1 | 125 | ||||
-rw-r--r-- | man/chown.x | 30 | ||||
-rw-r--r-- | man/chroot.1 | 63 | ||||
-rw-r--r-- | man/chroot.x | 6 | ||||
-rw-r--r-- | man/cksum.1 | 120 | ||||
-rw-r--r-- | man/cksum.x | 4 | ||||
-rw-r--r-- | man/comm.1 | 76 | ||||
-rw-r--r-- | man/comm.x | 6 | ||||
-rw-r--r-- | man/coreutils.1 | 35 | ||||
-rw-r--r-- | man/coreutils.x | 4 | ||||
-rw-r--r-- | man/cp.1 | 197 | ||||
-rw-r--r-- | man/cp.x | 6 | ||||
-rw-r--r-- | man/csplit.1 | 77 | ||||
-rw-r--r-- | man/csplit.x | 4 | ||||
-rw-r--r-- | man/cut.1 | 85 | ||||
-rw-r--r-- | man/cut.x | 4 | ||||
-rw-r--r-- | man/date.1 | 269 | ||||
-rw-r--r-- | man/date.x | 13 | ||||
-rw-r--r-- | man/dd.1 | 176 | ||||
-rw-r--r-- | man/dd.x | 4 | ||||
-rw-r--r-- | man/df.1 | 120 | ||||
-rw-r--r-- | man/df.x | 29 | ||||
-rw-r--r-- | man/dir.1 | 265 | ||||
-rw-r--r-- | man/dir.x | 4 | ||||
-rw-r--r-- | man/dircolors.1 | 50 | ||||
-rw-r--r-- | man/dircolors.x | 4 | ||||
-rw-r--r-- | man/dirname.1 | 50 | ||||
-rw-r--r-- | man/dirname.x | 6 | ||||
-rw-r--r-- | man/du.1 | 163 | ||||
-rw-r--r-- | man/du.x | 28 | ||||
-rwxr-xr-x | man/dummy-man | 73 | ||||
-rw-r--r-- | man/echo.1 | 93 | ||||
-rw-r--r-- | man/echo.x | 6 | ||||
-rw-r--r-- | man/env.1 | 142 | ||||
-rw-r--r-- | man/env.x | 67 | ||||
-rw-r--r-- | man/expand.1 | 54 | ||||
-rw-r--r-- | man/expand.x | 6 | ||||
-rw-r--r-- | man/expr.1 | 107 | ||||
-rw-r--r-- | man/expr.x | 4 | ||||
-rw-r--r-- | man/factor.1 | 37 | ||||
-rw-r--r-- | man/factor.x | 4 | ||||
-rw-r--r-- | man/false.1 | 40 | ||||
-rw-r--r-- | man/false.x | 4 | ||||
-rw-r--r-- | man/fmt.1 | 60 | ||||
-rw-r--r-- | man/fmt.x | 4 | ||||
-rw-r--r-- | man/fold.1 | 49 | ||||
-rw-r--r-- | man/fold.x | 6 | ||||
-rw-r--r-- | man/groups.1 | 37 | ||||
-rw-r--r-- | man/groups.x | 6 | ||||
-rw-r--r-- | man/head.1 | 65 | ||||
-rw-r--r-- | man/head.x | 6 | ||||
-rwxr-xr-x | man/help2man | 802 | ||||
-rw-r--r-- | man/hostid.1 | 36 | ||||
-rw-r--r-- | man/hostid.x | 6 | ||||
-rw-r--r-- | man/hostname.1 | 36 | ||||
-rw-r--r-- | man/hostname.x | 4 | ||||
-rw-r--r-- | man/id.1 | 62 | ||||
-rw-r--r-- | man/id.x | 4 | ||||
-rw-r--r-- | man/install.1 | 138 | ||||
-rw-r--r-- | man/install.x | 6 | ||||
-rw-r--r-- | man/join.1 | 97 | ||||
-rw-r--r-- | man/join.x | 6 | ||||
-rw-r--r-- | man/kill.1 | 62 | ||||
-rw-r--r-- | man/kill.x | 6 | ||||
-rw-r--r-- | man/link.1 | 39 | ||||
-rw-r--r-- | man/link.x | 6 | ||||
-rw-r--r-- | man/ln.1 | 119 | ||||
-rw-r--r-- | man/ln.x | 6 | ||||
-rw-r--r-- | man/local.mk | 211 | ||||
-rw-r--r-- | man/logname.1 | 36 | ||||
-rw-r--r-- | man/logname.x | 6 | ||||
-rw-r--r-- | man/ls.1 | 268 | ||||
-rw-r--r-- | man/ls.x | 6 | ||||
-rw-r--r-- | man/md5sum.1 | 83 | ||||
-rw-r--r-- | man/md5sum.x | 11 | ||||
-rw-r--r-- | man/mkdir.1 | 56 | ||||
-rw-r--r-- | man/mkdir.x | 6 | ||||
-rw-r--r-- | man/mkfifo.1 | 48 | ||||
-rw-r--r-- | man/mkfifo.x | 6 | ||||
-rw-r--r-- | man/mknod.1 | 66 | ||||
-rw-r--r-- | man/mknod.x | 6 | ||||
-rw-r--r-- | man/mktemp.1 | 64 | ||||
-rw-r--r-- | man/mktemp.x | 6 | ||||
-rw-r--r-- | man/mv.1 | 118 | ||||
-rw-r--r-- | man/mv.x | 6 | ||||
-rw-r--r-- | man/nice.1 | 60 | ||||
-rw-r--r-- | man/nice.x | 6 | ||||
-rw-r--r-- | man/nl.1 | 103 | ||||
-rw-r--r-- | man/nl.x | 4 | ||||
-rw-r--r-- | man/nohup.1 | 59 | ||||
-rw-r--r-- | man/nohup.x | 4 | ||||
-rw-r--r-- | man/nproc.1 | 40 | ||||
-rw-r--r-- | man/nproc.x | 4 | ||||
-rw-r--r-- | man/numfmt.1 | 185 | ||||
-rw-r--r-- | man/numfmt.x | 4 | ||||
-rw-r--r-- | man/od.1 | 169 | ||||
-rw-r--r-- | man/od.x | 11 | ||||
-rw-r--r-- | man/paste.1 | 47 | ||||
-rw-r--r-- | man/paste.x | 4 | ||||
-rw-r--r-- | man/pathchk.1 | 42 | ||||
-rw-r--r-- | man/pathchk.x | 4 | ||||
-rw-r--r-- | man/pinky.1 | 62 | ||||
-rw-r--r-- | man/pinky.x | 4 | ||||
-rw-r--r-- | man/pr.1 | 132 | ||||
-rw-r--r-- | man/pr.x | 4 | ||||
-rw-r--r-- | man/printenv.1 | 41 | ||||
-rw-r--r-- | man/printenv.x | 4 | ||||
-rw-r--r-- | man/printf.1 | 104 | ||||
-rw-r--r-- | man/printf.x | 6 | ||||
-rw-r--r-- | man/ptx.1 | 91 | ||||
-rw-r--r-- | man/ptx.x | 4 | ||||
-rw-r--r-- | man/pwd.1 | 48 | ||||
-rw-r--r-- | man/pwd.x | 6 | ||||
-rw-r--r-- | man/readlink.1 | 67 | ||||
-rw-r--r-- | man/readlink.x | 8 | ||||
-rw-r--r-- | man/realpath.1 | 64 | ||||
-rw-r--r-- | man/realpath.x | 6 | ||||
-rw-r--r-- | man/rm.1 | 108 | ||||
-rw-r--r-- | man/rm.x | 31 | ||||
-rw-r--r-- | man/rmdir.1 | 46 | ||||
-rw-r--r-- | man/rmdir.x | 6 | ||||
-rw-r--r-- | man/runcon.1 | 80 | ||||
-rw-r--r-- | man/runcon.x | 14 | ||||
-rw-r--r-- | man/seq.1 | 62 | ||||
-rw-r--r-- | man/seq.x | 4 | ||||
-rw-r--r-- | man/sha1sum.1 | 83 | ||||
-rw-r--r-- | man/sha1sum.x | 11 | ||||
-rw-r--r-- | man/sha224sum.1 | 78 | ||||
-rw-r--r-- | man/sha224sum.x | 6 | ||||
-rw-r--r-- | man/sha256sum.1 | 78 | ||||
-rw-r--r-- | man/sha256sum.x | 6 | ||||
-rw-r--r-- | man/sha384sum.1 | 78 | ||||
-rw-r--r-- | man/sha384sum.x | 6 | ||||
-rw-r--r-- | man/sha512sum.1 | 78 | ||||
-rw-r--r-- | man/sha512sum.x | 6 | ||||
-rw-r--r-- | man/shred.1 | 81 | ||||
-rw-r--r-- | man/shred.x | 4 | ||||
-rw-r--r-- | man/shuf.1 | 64 | ||||
-rw-r--r-- | man/shuf.x | 4 | ||||
-rw-r--r-- | man/sleep.1 | 42 | ||||
-rw-r--r-- | man/sleep.x | 6 | ||||
-rw-r--r-- | man/sort.1 | 158 | ||||
-rw-r--r-- | man/sort.x | 6 | ||||
-rw-r--r-- | man/split.1 | 108 | ||||
-rw-r--r-- | man/split.x | 4 | ||||
-rw-r--r-- | man/stat.1 | 223 | ||||
-rw-r--r-- | man/stat.x | 6 | ||||
-rw-r--r-- | man/stdbuf.1 | 81 | ||||
-rw-r--r-- | man/stdbuf.x | 17 | ||||
-rw-r--r-- | man/stty.1 | 413 | ||||
-rw-r--r-- | man/stty.x | 4 | ||||
-rw-r--r-- | man/sum.1 | 41 | ||||
-rw-r--r-- | man/sum.x | 4 | ||||
-rw-r--r-- | man/sync.1 | 48 | ||||
-rw-r--r-- | man/sync.x | 9 | ||||
-rw-r--r-- | man/tac.1 | 49 | ||||
-rw-r--r-- | man/tac.x | 6 | ||||
-rw-r--r-- | man/tail.1 | 99 | ||||
-rw-r--r-- | man/tail.x | 6 | ||||
-rw-r--r-- | man/tee.1 | 64 | ||||
-rw-r--r-- | man/tee.x | 4 | ||||
-rw-r--r-- | man/test.1 | 179 | ||||
-rw-r--r-- | man/test.x | 26 | ||||
-rw-r--r-- | man/timeout.1 | 99 | ||||
-rw-r--r-- | man/timeout.x | 8 | ||||
-rw-r--r-- | man/touch.1 | 84 | ||||
-rw-r--r-- | man/touch.x | 13 | ||||
-rw-r--r-- | man/tr.1 | 143 | ||||
-rw-r--r-- | man/tr.x | 13 | ||||
-rw-r--r-- | man/true.1 | 40 | ||||
-rw-r--r-- | man/true.x | 4 | ||||
-rw-r--r-- | man/truncate.1 | 64 | ||||
-rw-r--r-- | man/truncate.x | 6 | ||||
-rw-r--r-- | man/tsort.1 | 35 | ||||
-rw-r--r-- | man/tsort.x | 4 | ||||
-rw-r--r-- | man/tty.1 | 36 | ||||
-rw-r--r-- | man/tty.x | 4 | ||||
-rw-r--r-- | man/uname.1 | 64 | ||||
-rw-r--r-- | man/uname.x | 6 | ||||
-rw-r--r-- | man/unexpand.1 | 57 | ||||
-rw-r--r-- | man/unexpand.x | 6 | ||||
-rw-r--r-- | man/uniq.1 | 83 | ||||
-rw-r--r-- | man/uniq.x | 6 | ||||
-rw-r--r-- | man/unlink.1 | 39 | ||||
-rw-r--r-- | man/unlink.x | 6 | ||||
-rw-r--r-- | man/uptime.1 | 37 | ||||
-rw-r--r-- | man/uptime.x | 4 | ||||
-rw-r--r-- | man/users.1 | 37 | ||||
-rw-r--r-- | man/users.x | 6 | ||||
-rw-r--r-- | man/vdir.1 | 265 | ||||
-rw-r--r-- | man/vdir.x | 4 | ||||
-rw-r--r-- | man/wc.1 | 67 | ||||
-rw-r--r-- | man/wc.x | 4 | ||||
-rw-r--r-- | man/who.1 | 84 | ||||
-rw-r--r-- | man/who.x | 4 | ||||
-rw-r--r-- | man/whoami.1 | 34 | ||||
-rw-r--r-- | man/whoami.x | 4 | ||||
-rw-r--r-- | man/yes.1 | 36 | ||||
-rw-r--r-- | man/yes.x | 4 |
219 files changed, 11711 insertions, 0 deletions
diff --git a/man/arch.1 b/man/arch.1 new file mode 100644 index 0000000..1fa34ce --- /dev/null +++ b/man/arch.1 @@ -0,0 +1,36 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH ARCH "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +arch \- print machine hardware name (same as uname -m) +.SH SYNOPSIS +.B arch +[\fI\,OPTION\/\fR]... +.SH DESCRIPTION +.\" Add any additional description here +.PP +Print machine architecture. +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.SH AUTHOR +Written by David MacKenzie and Karel Zak. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +\fBuname\fP(1), \fBuname\fP(2) +.PP +.br +Full documentation <https://www.gnu.org/software/coreutils/arch> +.br +or available locally via: info \(aq(coreutils) arch invocation\(aq diff --git a/man/arch.x b/man/arch.x new file mode 100644 index 0000000..0a310b4 --- /dev/null +++ b/man/arch.x @@ -0,0 +1,6 @@ +[NAME] +arch \- print machine hardware name (same as uname -m) +[DESCRIPTION] +.\" Add any additional description here +[SEE ALSO] +uname(1), uname(2) diff --git a/man/b2sum.1 b/man/b2sum.1 new file mode 100644 index 0000000..413d3b5 --- /dev/null +++ b/man/b2sum.1 @@ -0,0 +1,84 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH B2SUM "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +b2sum \- compute and check BLAKE2 message digest +.SH SYNOPSIS +.B b2sum +[\fI\,OPTION\/\fR]... [\fI\,FILE\/\fR]... +.SH DESCRIPTION +.\" Add any additional description here +.PP +Print or check BLAKE2b (512\-bit) checksums. +.PP +With no FILE, or when FILE is \-, read standard input. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\fB\-b\fR, \fB\-\-binary\fR +read in binary mode +.TP +\fB\-c\fR, \fB\-\-check\fR +read checksums from the FILEs and check them +.TP +\fB\-l\fR, \fB\-\-length\fR=\fI\,BITS\/\fR +digest length in bits; must not exceed the max for +the blake2 algorithm and must be a multiple of 8 +.TP +\fB\-\-tag\fR +create a BSD\-style checksum +.TP +\fB\-t\fR, \fB\-\-text\fR +read in text mode (default) +.TP +\fB\-z\fR, \fB\-\-zero\fR +end each output line with NUL, not newline, +and disable file name escaping +.SS "The following five options are useful only when verifying checksums:" +.TP +\fB\-\-ignore\-missing\fR +don't fail or report status for missing files +.TP +\fB\-\-quiet\fR +don't print OK for each successfully verified file +.TP +\fB\-\-status\fR +don't output anything, status code shows success +.TP +\fB\-\-strict\fR +exit non\-zero for improperly formatted checksum lines +.TP +\fB\-w\fR, \fB\-\-warn\fR +warn about improperly formatted checksum lines +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.PP +The sums are computed as described in RFC 7693. +When checking, the input should be a former output of this program. +The default mode is to print a line with: checksum, a space, +a character indicating input mode ('*' for binary, ' ' for text +or where binary is insignificant), and name for each FILE. +.PP +Note: There is no difference between binary mode and text mode on GNU systems. +.SH AUTHOR +Written by Padraig Brady and Samuel Neves. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +\fBcksum\fP(1) +.PP +.br +Full documentation <https://www.gnu.org/software/coreutils/b2sum> +.br +or available locally via: info \(aq(coreutils) b2sum invocation\(aq diff --git a/man/b2sum.x b/man/b2sum.x new file mode 100644 index 0000000..5a857ca --- /dev/null +++ b/man/b2sum.x @@ -0,0 +1,6 @@ +[NAME] +b2sum \- compute and check BLAKE2 message digest +[DESCRIPTION] +.\" Add any additional description here +[SEE ALSO] +cksum(1) diff --git a/man/base32.1 b/man/base32.1 new file mode 100644 index 0000000..abb9984 --- /dev/null +++ b/man/base32.1 @@ -0,0 +1,55 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH BASE32 "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +base32 \- base32 encode/decode data and print to standard output +.SH SYNOPSIS +.B base32 +[\fI\,OPTION\/\fR]... [\fI\,FILE\/\fR] +.SH DESCRIPTION +.\" Add any additional description here +.PP +Base32 encode or decode FILE, or standard input, to standard output. +.PP +With no FILE, or when FILE is \-, read standard input. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\fB\-d\fR, \fB\-\-decode\fR +decode data +.TP +\fB\-i\fR, \fB\-\-ignore\-garbage\fR +when decoding, ignore non\-alphabet characters +.TP +\fB\-w\fR, \fB\-\-wrap\fR=\fI\,COLS\/\fR +wrap encoded lines after COLS character (default 76). +Use 0 to disable line wrapping +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.PP +The data are encoded as described for the base32 alphabet in RFC 4648. +When decoding, the input may contain newlines in addition to the bytes of +the formal base32 alphabet. Use \fB\-\-ignore\-garbage\fR to attempt to recover +from any other non\-alphabet bytes in the encoded stream. +.SH AUTHOR +Written by Simon Josefsson. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +\fBbasenc\fP(1) +.PP +.br +Full documentation <https://www.gnu.org/software/coreutils/base32> +.br +or available locally via: info \(aq(coreutils) base32 invocation\(aq diff --git a/man/base32.x b/man/base32.x new file mode 100644 index 0000000..b2d506e --- /dev/null +++ b/man/base32.x @@ -0,0 +1,6 @@ +[NAME] +base32 \- base32 encode/decode data and print to standard output +[DESCRIPTION] +.\" Add any additional description here +[SEE ALSO] +basenc(1) diff --git a/man/base64.1 b/man/base64.1 new file mode 100644 index 0000000..a7b3587 --- /dev/null +++ b/man/base64.1 @@ -0,0 +1,55 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH BASE64 "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +base64 \- base64 encode/decode data and print to standard output +.SH SYNOPSIS +.B base64 +[\fI\,OPTION\/\fR]... [\fI\,FILE\/\fR] +.SH DESCRIPTION +.\" Add any additional description here +.PP +Base64 encode or decode FILE, or standard input, to standard output. +.PP +With no FILE, or when FILE is \-, read standard input. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\fB\-d\fR, \fB\-\-decode\fR +decode data +.TP +\fB\-i\fR, \fB\-\-ignore\-garbage\fR +when decoding, ignore non\-alphabet characters +.TP +\fB\-w\fR, \fB\-\-wrap\fR=\fI\,COLS\/\fR +wrap encoded lines after COLS character (default 76). +Use 0 to disable line wrapping +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.PP +The data are encoded as described for the base64 alphabet in RFC 4648. +When decoding, the input may contain newlines in addition to the bytes of +the formal base64 alphabet. Use \fB\-\-ignore\-garbage\fR to attempt to recover +from any other non\-alphabet bytes in the encoded stream. +.SH AUTHOR +Written by Simon Josefsson. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +\fBbasenc\fP(1) +.PP +.br +Full documentation <https://www.gnu.org/software/coreutils/base64> +.br +or available locally via: info \(aq(coreutils) base64 invocation\(aq diff --git a/man/base64.x b/man/base64.x new file mode 100644 index 0000000..cce39d6 --- /dev/null +++ b/man/base64.x @@ -0,0 +1,6 @@ +[NAME] +base64 \- base64 encode/decode data and print to standard output +[DESCRIPTION] +.\" Add any additional description here +[SEE ALSO] +basenc(1) diff --git a/man/basename.1 b/man/basename.1 new file mode 100644 index 0000000..590328b --- /dev/null +++ b/man/basename.1 @@ -0,0 +1,64 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH BASENAME "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +basename \- strip directory and suffix from filenames +.SH SYNOPSIS +.B basename +\fI\,NAME \/\fR[\fI\,SUFFIX\/\fR] +.br +.B basename +\fI\,OPTION\/\fR... \fI\,NAME\/\fR... +.SH DESCRIPTION +.\" Add any additional description here +.PP +Print NAME with any leading directory components removed. +If specified, also remove a trailing SUFFIX. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\fB\-a\fR, \fB\-\-multiple\fR +support multiple arguments and treat each as a NAME +.TP +\fB\-s\fR, \fB\-\-suffix\fR=\fI\,SUFFIX\/\fR +remove a trailing SUFFIX; implies \fB\-a\fR +.TP +\fB\-z\fR, \fB\-\-zero\fR +end each output line with NUL, not newline +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.SH EXAMPLES +.TP +basename /usr/bin/sort +\-> "sort" +.TP +basename include/stdio.h .h +\-> "stdio" +.TP +basename \-s .h include/stdio.h +\-> "stdio" +.TP +basename \-a any/str1 any/str2 +\-> "str1" followed by "str2" +.SH AUTHOR +Written by David MacKenzie. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +\fBdirname\fP(1), \fBreadlink\fP(1) +.PP +.br +Full documentation <https://www.gnu.org/software/coreutils/basename> +.br +or available locally via: info \(aq(coreutils) basename invocation\(aq diff --git a/man/basename.x b/man/basename.x new file mode 100644 index 0000000..e91ee57 --- /dev/null +++ b/man/basename.x @@ -0,0 +1,6 @@ +[NAME] +basename \- strip directory and suffix from filenames +[DESCRIPTION] +.\" Add any additional description here +[SEE ALSO] +dirname(1), readlink(1) diff --git a/man/basenc.1 b/man/basenc.1 new file mode 100644 index 0000000..5c216f1 --- /dev/null +++ b/man/basenc.1 @@ -0,0 +1,106 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH BASENC "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +basenc \- Encode/decode data and print to standard output +.SH SYNOPSIS +.B basenc +[\fI\,OPTION\/\fR]... [\fI\,FILE\/\fR] +.SH DESCRIPTION +.\" Add any additional description here +.PP +basenc encode or decode FILE, or standard input, to standard output. +.PP +With no FILE, or when FILE is \-, read standard input. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\fB\-\-base64\fR +same as 'base64' program (RFC4648 section 4) +.TP +\fB\-\-base64url\fR +file\- and url\-safe base64 (RFC4648 section 5) +.TP +\fB\-\-base32\fR +same as 'base32' program (RFC4648 section 6) +.TP +\fB\-\-base32hex\fR +extended hex alphabet base32 (RFC4648 section 7) +.TP +\fB\-\-base16\fR +hex encoding (RFC4648 section 8) +.TP +\fB\-\-base2msbf\fR +bit string with most significant bit (msb) first +.TP +\fB\-\-base2lsbf\fR +bit string with least significant bit (lsb) first +.TP +\fB\-d\fR, \fB\-\-decode\fR +decode data +.TP +\fB\-i\fR, \fB\-\-ignore\-garbage\fR +when decoding, ignore non\-alphabet characters +.TP +\fB\-w\fR, \fB\-\-wrap\fR=\fI\,COLS\/\fR +wrap encoded lines after COLS character (default 76). +Use 0 to disable line wrapping +.TP +\fB\-\-z85\fR +ascii85\-like encoding (ZeroMQ spec:32/Z85); +when encoding, input length must be a multiple of 4; +when decoding, input length must be a multiple of 5 +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.PP +When decoding, the input may contain newlines in addition to the bytes of +the formal alphabet. Use \fB\-\-ignore\-garbage\fR to attempt to recover +from any other non\-alphabet bytes in the encoded stream. +.SH "ENCODING EXAMPLES" +.PP +.nf +.RS +$ printf '\\376\\117\\202' | basenc \-\-base64 +/k+C + +$ printf '\\376\\117\\202' | basenc \-\-base64url +_k-C + +$ printf '\\376\\117\\202' | basenc \-\-base32 +7ZHYE=== + +$ printf '\\376\\117\\202' | basenc \-\-base32hex +VP7O4=== + +$ printf '\\376\\117\\202' | basenc \-\-base16 +FE4F82 + +$ printf '\\376\\117\\202' | basenc \-\-base2lsbf +011111111111001001000001 + +$ printf '\\376\\117\\202' | basenc \-\-base2msbf +111111100100111110000010 + +$ printf '\\376\\117\\202\\000' | basenc \-\-z85 +@.FaC +.RE +.fi +.SH AUTHOR +Written by Simon Josefsson and Assaf Gordon. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +Full documentation <https://www.gnu.org/software/coreutils/basenc> +.br +or available locally via: info \(aq(coreutils) basenc invocation\(aq diff --git a/man/basenc.x b/man/basenc.x new file mode 100644 index 0000000..051c915 --- /dev/null +++ b/man/basenc.x @@ -0,0 +1,38 @@ +'\" Copyright (C) 2018-2023 Free Software Foundation, Inc. +'\" +'\" This is free software. You may redistribute copies of it under the terms +'\" of the GNU General Public License <https://www.gnu.org/licenses/gpl.html>. +'\" There is NO WARRANTY, to the extent permitted by law. +[NAME] +basenc \- Encode/decode data and print to standard output +[DESCRIPTION] +.\" Add any additional description here +[ENCODING EXAMPLES] +.PP +.nf +.RS +$ printf '\\376\\117\\202' | basenc \-\-base64 +/k+C + +$ printf '\\376\\117\\202' | basenc \-\-base64url +_k-C + +$ printf '\\376\\117\\202' | basenc \-\-base32 +7ZHYE=== + +$ printf '\\376\\117\\202' | basenc \-\-base32hex +VP7O4=== + +$ printf '\\376\\117\\202' | basenc \-\-base16 +FE4F82 + +$ printf '\\376\\117\\202' | basenc \-\-base2lsbf +011111111111001001000001 + +$ printf '\\376\\117\\202' | basenc \-\-base2msbf +111111100100111110000010 + +$ printf '\\376\\117\\202\\000' | basenc \-\-z85 +@.FaC +.RE +.fi diff --git a/man/cat.1 b/man/cat.1 new file mode 100644 index 0000000..b5a7b43 --- /dev/null +++ b/man/cat.1 @@ -0,0 +1,75 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH CAT "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +cat \- concatenate files and print on the standard output +.SH SYNOPSIS +.B cat +[\fI\,OPTION\/\fR]... [\fI\,FILE\/\fR]... +.SH DESCRIPTION +.\" Add any additional description here +.PP +Concatenate FILE(s) to standard output. +.PP +With no FILE, or when FILE is \-, read standard input. +.TP +\fB\-A\fR, \fB\-\-show\-all\fR +equivalent to \fB\-vET\fR +.TP +\fB\-b\fR, \fB\-\-number\-nonblank\fR +number nonempty output lines, overrides \fB\-n\fR +.TP +\fB\-e\fR +equivalent to \fB\-vE\fR +.TP +\fB\-E\fR, \fB\-\-show\-ends\fR +display $ at end of each line +.TP +\fB\-n\fR, \fB\-\-number\fR +number all output lines +.TP +\fB\-s\fR, \fB\-\-squeeze\-blank\fR +suppress repeated empty output lines +.TP +\fB\-t\fR +equivalent to \fB\-vT\fR +.TP +\fB\-T\fR, \fB\-\-show\-tabs\fR +display TAB characters as ^I +.TP +\fB\-u\fR +(ignored) +.TP +\fB\-v\fR, \fB\-\-show\-nonprinting\fR +use ^ and M\- notation, except for LFD and TAB +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.SH EXAMPLES +.TP +cat f \- g +Output f's contents, then standard input, then g's contents. +.TP +cat +Copy standard input to standard output. +.SH AUTHOR +Written by Torbjorn Granlund and Richard M. Stallman. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +\fBtac\fP(1) +.PP +.br +Full documentation <https://www.gnu.org/software/coreutils/cat> +.br +or available locally via: info \(aq(coreutils) cat invocation\(aq diff --git a/man/cat.x b/man/cat.x new file mode 100644 index 0000000..9eb38cf --- /dev/null +++ b/man/cat.x @@ -0,0 +1,6 @@ +[NAME] +cat \- concatenate files and print on the standard output +[DESCRIPTION] +.\" Add any additional description here +[SEE ALSO] +tac(1) diff --git a/man/chcon.1 b/man/chcon.1 new file mode 100644 index 0000000..bb5c4f8 --- /dev/null +++ b/man/chcon.1 @@ -0,0 +1,92 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH CHCON "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +chcon \- change file security context +.SH SYNOPSIS +.B chcon +[\fI\,OPTION\/\fR]... \fI\,CONTEXT FILE\/\fR... +.br +.B chcon +[\fI\,OPTION\/\fR]... [\fI\,-u USER\/\fR] [\fI\,-r ROLE\/\fR] [\fI\,-l RANGE\/\fR] [\fI\,-t TYPE\/\fR] \fI\,FILE\/\fR... +.br +.B chcon +[\fI\,OPTION\/\fR]... \fI\,--reference=RFILE FILE\/\fR... +.SH DESCRIPTION +.\" Add any additional description here +.PP +Change the SELinux security context of each FILE to CONTEXT. +With \fB\-\-reference\fR, change the security context of each FILE to that of RFILE. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\fB\-\-dereference\fR +affect the referent of each symbolic link (this is +the default), rather than the symbolic link itself +.TP +\fB\-h\fR, \fB\-\-no\-dereference\fR +affect symbolic links instead of any referenced file +.TP +\fB\-u\fR, \fB\-\-user\fR=\fI\,USER\/\fR +set user USER in the target security context +.TP +\fB\-r\fR, \fB\-\-role\fR=\fI\,ROLE\/\fR +set role ROLE in the target security context +.TP +\fB\-t\fR, \fB\-\-type\fR=\fI\,TYPE\/\fR +set type TYPE in the target security context +.TP +\fB\-l\fR, \fB\-\-range\fR=\fI\,RANGE\/\fR +set range RANGE in the target security context +.TP +\fB\-\-no\-preserve\-root\fR +do not treat '/' specially (the default) +.TP +\fB\-\-preserve\-root\fR +fail to operate recursively on '/' +.TP +\fB\-\-reference\fR=\fI\,RFILE\/\fR +use RFILE's security context rather than specifying +a CONTEXT value +.TP +\fB\-R\fR, \fB\-\-recursive\fR +operate on files and directories recursively +.TP +\fB\-v\fR, \fB\-\-verbose\fR +output a diagnostic for every file processed +.PP +The following options modify how a hierarchy is traversed when the \fB\-R\fR +option is also specified. If more than one is specified, only the final +one takes effect. +.TP +\fB\-H\fR +if a command line argument is a symbolic link +to a directory, traverse it +.TP +\fB\-L\fR +traverse every symbolic link to a directory +encountered +.TP +\fB\-P\fR +do not traverse any symbolic links (default) +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.SH AUTHOR +Written by Russell Coker and Jim Meyering. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +Full documentation <https://www.gnu.org/software/coreutils/chcon> +.br +or available locally via: info \(aq(coreutils) chcon invocation\(aq diff --git a/man/chcon.x b/man/chcon.x new file mode 100644 index 0000000..8c1ff6f --- /dev/null +++ b/man/chcon.x @@ -0,0 +1,4 @@ +[NAME] +chcon \- change file security context +[DESCRIPTION] +.\" Add any additional description here diff --git a/man/chgrp.1 b/man/chgrp.1 new file mode 100644 index 0000000..3a415c9 --- /dev/null +++ b/man/chgrp.1 @@ -0,0 +1,93 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH CHGRP "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +chgrp \- change group ownership +.SH SYNOPSIS +.B chgrp +[\fI\,OPTION\/\fR]... \fI\,GROUP FILE\/\fR... +.br +.B chgrp +[\fI\,OPTION\/\fR]... \fI\,--reference=RFILE FILE\/\fR... +.SH DESCRIPTION +.\" Add any additional description here +.PP +Change the group of each FILE to GROUP. +With \fB\-\-reference\fR, change the group of each FILE to that of RFILE. +.TP +\fB\-c\fR, \fB\-\-changes\fR +like verbose but report only when a change is made +.TP +\fB\-f\fR, \fB\-\-silent\fR, \fB\-\-quiet\fR +suppress most error messages +.TP +\fB\-v\fR, \fB\-\-verbose\fR +output a diagnostic for every file processed +.TP +\fB\-\-dereference\fR +affect the referent of each symbolic link (this is +the default), rather than the symbolic link itself +.TP +\fB\-h\fR, \fB\-\-no\-dereference\fR +affect symbolic links instead of any referenced file +(useful only on systems that can change the +ownership of a symlink) +.TP +\fB\-\-no\-preserve\-root\fR +do not treat '/' specially (the default) +.TP +\fB\-\-preserve\-root\fR +fail to operate recursively on '/' +.TP +\fB\-\-reference\fR=\fI\,RFILE\/\fR +use RFILE's group rather than specifying a GROUP. +RFILE is always dereferenced if a symbolic link. +.TP +\fB\-R\fR, \fB\-\-recursive\fR +operate on files and directories recursively +.PP +The following options modify how a hierarchy is traversed when the \fB\-R\fR +option is also specified. If more than one is specified, only the final +one takes effect. +.TP +\fB\-H\fR +if a command line argument is a symbolic link +to a directory, traverse it +.TP +\fB\-L\fR +traverse every symbolic link to a directory +encountered +.TP +\fB\-P\fR +do not traverse any symbolic links (default) +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.SH EXAMPLES +.TP +chgrp staff /u +Change the group of /u to "staff". +.TP +chgrp \-hR staff /u +Change the group of /u and subfiles to "staff". +.SH AUTHOR +Written by David MacKenzie and Jim Meyering. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +\fBchown\fP(1), \fBchown\fP(2) +.PP +.br +Full documentation <https://www.gnu.org/software/coreutils/chgrp> +.br +or available locally via: info \(aq(coreutils) chgrp invocation\(aq diff --git a/man/chgrp.x b/man/chgrp.x new file mode 100644 index 0000000..a61f308 --- /dev/null +++ b/man/chgrp.x @@ -0,0 +1,6 @@ +[NAME] +chgrp \- change group ownership +[DESCRIPTION] +.\" Add any additional description here +[SEE ALSO] +chown(1), chown(2) diff --git a/man/chmod.1 b/man/chmod.1 new file mode 100644 index 0000000..b6ed051 --- /dev/null +++ b/man/chmod.1 @@ -0,0 +1,174 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH CHMOD "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +chmod \- change file mode bits +.SH SYNOPSIS +.B chmod +[\fI\,OPTION\/\fR]... \fI\,MODE\/\fR[\fI\,,MODE\/\fR]... \fI\,FILE\/\fR... +.br +.B chmod +[\fI\,OPTION\/\fR]... \fI\,OCTAL-MODE FILE\/\fR... +.br +.B chmod +[\fI\,OPTION\/\fR]... \fI\,--reference=RFILE FILE\/\fR... +.SH DESCRIPTION +This manual page +documents the GNU version of +.BR chmod . +.B chmod +changes the file mode bits of each given file according to +.IR mode , +which can be either a symbolic representation of changes to make, or +an octal number representing the bit pattern for the new mode bits. +.PP +The format of a symbolic mode is [\c +\fBugoa\fP.\|.\|.][[\fB-+=\fP][\fIperms\fP.\|.\|.].\|.\|.], +where +.I "perms" +is either zero or more letters from the set +\fBrwxXst\fP, or a single letter from the set \fBugo\fP. +Multiple symbolic +modes can be given, separated by commas. +.PP +A combination of the letters \fBugoa\fP controls which users' access +to the file will be changed: the user who owns it (\fBu\fP), other +users in the file's group (\fBg\fP), other users not in the file's +group (\fBo\fP), or all users (\fBa\fP). If none of these are given, +the effect is as if (\fBa\fP) were +given, but bits that are set in the umask are not affected. +.PP +The operator \fB+\fP causes the selected file mode bits to be added to +the existing file mode bits of each file; \fB-\fP causes them to be +removed; and \fB=\fP causes them to be added and causes unmentioned +bits to be removed except that a directory's unmentioned set user and +group ID bits are not affected. +.PP +The letters \fBrwxXst\fP select file mode bits for the affected users: +read (\fBr\fP), write (\fBw\fP), execute (or search for directories) +(\fBx\fP), execute/search only if the file is a directory or already +has execute permission for some user (\fBX\fP), set user or group ID +on execution (\fBs\fP), restricted deletion flag or sticky bit +(\fBt\fP). Instead of one or more of these letters, you can specify +exactly one of the letters \fBugo\fP: the permissions granted to the +user who owns the file (\fBu\fP), the permissions granted to other +users who are members of the file's group (\fBg\fP), +and the permissions granted to users that are in neither of the two preceding +categories (\fBo\fP). +.PP +A numeric mode is from one to four octal digits (0\-7), derived by +adding up the bits with values 4, 2, and 1. Omitted digits are +assumed to be leading zeros. +The first digit selects the set user ID (4) and set group ID (2) and +restricted deletion or sticky (1) attributes. The second digit +selects permissions for the user who owns the file: read (4), write (2), +and execute (1); the third selects permissions for other users in the +file's group, with the same values; and the fourth for other users not +in the file's group, with the same values. +.PP +.B chmod +never changes the permissions of symbolic links; the +.B chmod +system call cannot change their permissions. This is not a problem +since the permissions of symbolic links are never used. +However, for each symbolic link listed on the command line, +.B chmod +changes the permissions of the pointed-to file. +In contrast, +.B chmod +ignores symbolic links encountered during recursive directory +traversals. +.SH "SETUID AND SETGID BITS" +.B chmod +clears the set-group-ID bit of a +regular file if the file's group ID does not match the user's +effective group ID or one of the user's supplementary group IDs, +unless the user has appropriate privileges. Additional restrictions +may cause the set-user-ID and set-group-ID bits of +.I MODE +or +.I RFILE +to be ignored. This behavior depends on the policy and +functionality of the underlying +.B chmod +system call. When in +doubt, check the underlying system behavior. +.PP +For directories +.B chmod +preserves set-user-ID and set-group-ID bits unless you +explicitly specify otherwise. You can set or clear the bits with +symbolic modes like +.B u+s +and +.BR g\-s . +To clear these bits for directories with a numeric mode requires +an additional leading zero like +.BR 00755 , +leading minus like +.BR \-6000 , +or leading equals like +.BR =755 . +.SH "RESTRICTED DELETION FLAG OR STICKY BIT" +The restricted deletion flag or sticky bit is a single bit, whose +interpretation depends on the file type. For directories, it prevents +unprivileged users from removing or renaming a file in the directory +unless they own the file or the directory; this is called the +.I "restricted deletion flag" +for the directory, and is commonly found on world-writable directories +like \fB/tmp\fP. For regular files on some older systems, the bit +saves the program's text image on the swap device so it will load more +quickly when run; this is called the +.IR "sticky bit" . +.SH OPTIONS +.PP +Change the mode of each FILE to MODE. +With \fB\-\-reference\fR, change the mode of each FILE to that of RFILE. +.TP +\fB\-c\fR, \fB\-\-changes\fR +like verbose but report only when a change is made +.TP +\fB\-f\fR, \fB\-\-silent\fR, \fB\-\-quiet\fR +suppress most error messages +.TP +\fB\-v\fR, \fB\-\-verbose\fR +output a diagnostic for every file processed +.TP +\fB\-\-no\-preserve\-root\fR +do not treat '/' specially (the default) +.TP +\fB\-\-preserve\-root\fR +fail to operate recursively on '/' +.TP +\fB\-\-reference\fR=\fI\,RFILE\/\fR +use RFILE's mode instead of specifying MODE values. +RFILE is always dereferenced if a symbolic link. +.TP +\fB\-R\fR, \fB\-\-recursive\fR +change files and directories recursively +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.PP +Each MODE is of the form '[ugoa]*([\-+=]([rwxXst]*|[ugo]))+|[\-+=][0\-7]+'. +.SH AUTHOR +Written by David MacKenzie and Jim Meyering. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +\fBchmod\fP(2) +.PP +.br +Full documentation <https://www.gnu.org/software/coreutils/chmod> +.br +or available locally via: info \(aq(coreutils) chmod invocation\(aq diff --git a/man/chmod.x b/man/chmod.x new file mode 100644 index 0000000..b2a82d6 --- /dev/null +++ b/man/chmod.x @@ -0,0 +1,118 @@ +'\" Copyright (C) 1998-2023 Free Software Foundation, Inc. +'\" +'\" This is free software. You may redistribute copies of it under the terms +'\" of the GNU General Public License <https://www.gnu.org/licenses/gpl.html>. +'\" There is NO WARRANTY, to the extent permitted by law. +[NAME] +chmod \- change file mode bits +[DESCRIPTION] +This manual page +documents the GNU version of +.BR chmod . +.B chmod +changes the file mode bits of each given file according to +.IR mode , +which can be either a symbolic representation of changes to make, or +an octal number representing the bit pattern for the new mode bits. +.PP +The format of a symbolic mode is [\c +\fBugoa\fP.\|.\|.][[\fB-+=\fP][\fIperms\fP.\|.\|.].\|.\|.], +where +.I "perms" +is either zero or more letters from the set +\fBrwxXst\fP, or a single letter from the set \fBugo\fP. +Multiple symbolic +modes can be given, separated by commas. +.PP +A combination of the letters \fBugoa\fP controls which users' access +to the file will be changed: the user who owns it (\fBu\fP), other +users in the file's group (\fBg\fP), other users not in the file's +group (\fBo\fP), or all users (\fBa\fP). If none of these are given, +the effect is as if (\fBa\fP) were +given, but bits that are set in the umask are not affected. +.PP +The operator \fB+\fP causes the selected file mode bits to be added to +the existing file mode bits of each file; \fB-\fP causes them to be +removed; and \fB=\fP causes them to be added and causes unmentioned +bits to be removed except that a directory's unmentioned set user and +group ID bits are not affected. +.PP +The letters \fBrwxXst\fP select file mode bits for the affected users: +read (\fBr\fP), write (\fBw\fP), execute (or search for directories) +(\fBx\fP), execute/search only if the file is a directory or already +has execute permission for some user (\fBX\fP), set user or group ID +on execution (\fBs\fP), restricted deletion flag or sticky bit +(\fBt\fP). Instead of one or more of these letters, you can specify +exactly one of the letters \fBugo\fP: the permissions granted to the +user who owns the file (\fBu\fP), the permissions granted to other +users who are members of the file's group (\fBg\fP), +and the permissions granted to users that are in neither of the two preceding +categories (\fBo\fP). +.PP +A numeric mode is from one to four octal digits (0\-7), derived by +adding up the bits with values 4, 2, and 1. Omitted digits are +assumed to be leading zeros. +The first digit selects the set user ID (4) and set group ID (2) and +restricted deletion or sticky (1) attributes. The second digit +selects permissions for the user who owns the file: read (4), write (2), +and execute (1); the third selects permissions for other users in the +file's group, with the same values; and the fourth for other users not +in the file's group, with the same values. +.PP +.B chmod +never changes the permissions of symbolic links; the +.B chmod +system call cannot change their permissions. This is not a problem +since the permissions of symbolic links are never used. +However, for each symbolic link listed on the command line, +.B chmod +changes the permissions of the pointed-to file. +In contrast, +.B chmod +ignores symbolic links encountered during recursive directory +traversals. +.SH "SETUID AND SETGID BITS" +.B chmod +clears the set-group-ID bit of a +regular file if the file's group ID does not match the user's +effective group ID or one of the user's supplementary group IDs, +unless the user has appropriate privileges. Additional restrictions +may cause the set-user-ID and set-group-ID bits of +.I MODE +or +.I RFILE +to be ignored. This behavior depends on the policy and +functionality of the underlying +.B chmod +system call. When in +doubt, check the underlying system behavior. +.PP +For directories +.B chmod +preserves set-user-ID and set-group-ID bits unless you +explicitly specify otherwise. You can set or clear the bits with +symbolic modes like +.B u+s +and +.BR g\-s . +To clear these bits for directories with a numeric mode requires +an additional leading zero like +.BR 00755 , +leading minus like +.BR \-6000 , +or leading equals like +.BR =755 . +.SH "RESTRICTED DELETION FLAG OR STICKY BIT" +The restricted deletion flag or sticky bit is a single bit, whose +interpretation depends on the file type. For directories, it prevents +unprivileged users from removing or renaming a file in the directory +unless they own the file or the directory; this is called the +.I "restricted deletion flag" +for the directory, and is commonly found on world-writable directories +like \fB/tmp\fP. For regular files on some older systems, the bit +saves the program's text image on the swap device so it will load more +quickly when run; this is called the +.IR "sticky bit" . +.SH OPTIONS +[SEE ALSO] +chmod(2) diff --git a/man/chown.1 b/man/chown.1 new file mode 100644 index 0000000..47deaec --- /dev/null +++ b/man/chown.1 @@ -0,0 +1,125 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH CHOWN "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +chown \- change file owner and group +.SH SYNOPSIS +.B chown +[\fI\,OPTION\/\fR]... [\fI\,OWNER\/\fR][\fI\,:\/\fR[\fI\,GROUP\/\fR]] \fI\,FILE\/\fR... +.br +.B chown +[\fI\,OPTION\/\fR]... \fI\,--reference=RFILE FILE\/\fR... +.SH DESCRIPTION +This manual page +documents the GNU version of +.BR chown . +.B chown +changes the user and/or group ownership of each given file. If +only an owner (a user name or numeric user ID) is given, that user is made the +owner of each given file, and the files' group is not changed. If the +owner is followed by a colon and a group name (or numeric group ID), +with no spaces between them, the group ownership of the files is +changed as well. If a colon but no group name follows the user name, +that user is made the owner of the files and the group of the files is +changed to that user's login group. If the colon and group are given, +but the owner is omitted, only the group of the files is changed; +in this case, +.B chown +performs the same function as +.BR chgrp . +If only a colon is given, or if the entire operand is empty, neither the +owner nor the group is changed. +.SH OPTIONS +.PP +Change the owner and/or group of each FILE to OWNER and/or GROUP. +With \fB\-\-reference\fR, change the owner and group of each FILE to those of RFILE. +.TP +\fB\-c\fR, \fB\-\-changes\fR +like verbose but report only when a change is made +.TP +\fB\-f\fR, \fB\-\-silent\fR, \fB\-\-quiet\fR +suppress most error messages +.TP +\fB\-v\fR, \fB\-\-verbose\fR +output a diagnostic for every file processed +.TP +\fB\-\-dereference\fR +affect the referent of each symbolic link (this is +the default), rather than the symbolic link itself +.TP +\fB\-h\fR, \fB\-\-no\-dereference\fR +affect symbolic links instead of any referenced file +(useful only on systems that can change the +ownership of a symlink) +.TP +\fB\-\-from\fR=\fI\,CURRENT_OWNER\/\fR:CURRENT_GROUP +change the owner and/or group of each file only if +its current owner and/or group match those specified +here. Either may be omitted, in which case a match +is not required for the omitted attribute +.TP +\fB\-\-no\-preserve\-root\fR +do not treat '/' specially (the default) +.TP +\fB\-\-preserve\-root\fR +fail to operate recursively on '/' +.TP +\fB\-\-reference\fR=\fI\,RFILE\/\fR +use RFILE's owner and group rather than specifying +OWNER:GROUP values. RFILE is always dereferenced. +.TP +\fB\-R\fR, \fB\-\-recursive\fR +operate on files and directories recursively +.PP +The following options modify how a hierarchy is traversed when the \fB\-R\fR +option is also specified. If more than one is specified, only the final +one takes effect. +.TP +\fB\-H\fR +if a command line argument is a symbolic link +to a directory, traverse it +.TP +\fB\-L\fR +traverse every symbolic link to a directory +encountered +.TP +\fB\-P\fR +do not traverse any symbolic links (default) +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.PP +Owner is unchanged if missing. Group is unchanged if missing, but changed +to login group if implied by a ':' following a symbolic OWNER. +OWNER and GROUP may be numeric as well as symbolic. +.SH EXAMPLES +.TP +chown root /u +Change the owner of /u to "root". +.TP +chown root:staff /u +Likewise, but also change its group to "staff". +.TP +chown \-hR root /u +Change the owner of /u and subfiles to "root". +.SH AUTHOR +Written by David MacKenzie and Jim Meyering. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +\fBchown\fP(2) +.PP +.br +Full documentation <https://www.gnu.org/software/coreutils/chown> +.br +or available locally via: info \(aq(coreutils) chown invocation\(aq diff --git a/man/chown.x b/man/chown.x new file mode 100644 index 0000000..bf8d256 --- /dev/null +++ b/man/chown.x @@ -0,0 +1,30 @@ +'\" Copyright (C) 1998-2023 Free Software Foundation, Inc. +'\" +'\" This is free software. You may redistribute copies of it under the terms +'\" of the GNU General Public License <https://www.gnu.org/licenses/gpl.html>. +'\" There is NO WARRANTY, to the extent permitted by law. +[NAME] +chown \- change file owner and group +[DESCRIPTION] +This manual page +documents the GNU version of +.BR chown . +.B chown +changes the user and/or group ownership of each given file. If +only an owner (a user name or numeric user ID) is given, that user is made the +owner of each given file, and the files' group is not changed. If the +owner is followed by a colon and a group name (or numeric group ID), +with no spaces between them, the group ownership of the files is +changed as well. If a colon but no group name follows the user name, +that user is made the owner of the files and the group of the files is +changed to that user's login group. If the colon and group are given, +but the owner is omitted, only the group of the files is changed; +in this case, +.B chown +performs the same function as +.BR chgrp . +If only a colon is given, or if the entire operand is empty, neither the +owner nor the group is changed. +.SH OPTIONS +[SEE ALSO] +chown(2) diff --git a/man/chroot.1 b/man/chroot.1 new file mode 100644 index 0000000..d8ab9b0 --- /dev/null +++ b/man/chroot.1 @@ -0,0 +1,63 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH CHROOT "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +chroot \- run command or interactive shell with special root directory +.SH SYNOPSIS +.B chroot +[\fI\,OPTION\/\fR] \fI\,NEWROOT \/\fR[\fI\,COMMAND \/\fR[\fI\,ARG\/\fR]...] +.br +.B chroot +\fI\,OPTION\/\fR +.SH DESCRIPTION +.\" Add any additional description here +.PP +Run COMMAND with root directory set to NEWROOT. +.TP +\fB\-\-groups\fR=\fI\,G_LIST\/\fR +specify supplementary groups as g1,g2,..,gN +.TP +\fB\-\-userspec\fR=\fI\,USER\/\fR:GROUP +specify user and group (ID or name) to use +.TP +\fB\-\-skip\-chdir\fR +do not change working directory to '/' +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.PP +If no command is given, run '"$SHELL" \fB\-i\fR' (default: '/bin/sh \fB\-i\fR'). +.SS "Exit status:" +.TP +125 +if the chroot command itself fails +.TP +126 +if COMMAND is found but cannot be invoked +.TP +127 +if COMMAND cannot be found +.TP +\- +the exit status of COMMAND otherwise +.SH AUTHOR +Written by Roland McGrath. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +\fBchroot\fP(2) +.PP +.br +Full documentation <https://www.gnu.org/software/coreutils/chroot> +.br +or available locally via: info \(aq(coreutils) chroot invocation\(aq diff --git a/man/chroot.x b/man/chroot.x new file mode 100644 index 0000000..fc1be52 --- /dev/null +++ b/man/chroot.x @@ -0,0 +1,6 @@ +[NAME] +chroot \- run command or interactive shell with special root directory +[DESCRIPTION] +.\" Add any additional description here +[SEE ALSO] +chroot(2) diff --git a/man/cksum.1 b/man/cksum.1 new file mode 100644 index 0000000..85f1bd7 --- /dev/null +++ b/man/cksum.1 @@ -0,0 +1,120 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH CKSUM "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +cksum \- compute and verify file checksums +.SH SYNOPSIS +.B cksum +[\fI\,OPTION\/\fR]... [\fI\,FILE\/\fR]... +.SH DESCRIPTION +.\" Add any additional description here +.PP +Print or verify checksums. +By default use the 32 bit CRC algorithm. +.PP +With no FILE, or when FILE is \-, read standard input. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\fB\-a\fR, \fB\-\-algorithm\fR=\fI\,TYPE\/\fR +select the digest type to use. See DIGEST below. +.TP +\fB\-\-base64\fR +emit base64\-encoded digests, not hexadecimal +.TP +\fB\-c\fR, \fB\-\-check\fR +read checksums from the FILEs and check them +.TP +\fB\-l\fR, \fB\-\-length\fR=\fI\,BITS\/\fR +digest length in bits; must not exceed the max for +the blake2 algorithm and must be a multiple of 8 +.TP +\fB\-\-raw\fR +emit a raw binary digest, not hexadecimal +.TP +\fB\-\-tag\fR +create a BSD\-style checksum (the default) +.TP +\fB\-\-untagged\fR +create a reversed style checksum, without digest type +.TP +\fB\-z\fR, \fB\-\-zero\fR +end each output line with NUL, not newline, +and disable file name escaping +.SS "The following five options are useful only when verifying checksums:" +.TP +\fB\-\-ignore\-missing\fR +don't fail or report status for missing files +.TP +\fB\-\-quiet\fR +don't print OK for each successfully verified file +.TP +\fB\-\-status\fR +don't output anything, status code shows success +.TP +\fB\-\-strict\fR +exit non\-zero for improperly formatted checksum lines +.TP +\fB\-w\fR, \fB\-\-warn\fR +warn about improperly formatted checksum lines +.TP +\fB\-\-debug\fR +indicate which implementation used +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.SS "DIGEST determines the digest algorithm and default output format:" +.TP +sysv +(equivalent to sum \fB\-s\fR) +.TP +bsd +(equivalent to sum \fB\-r\fR) +.TP +crc +(equivalent to cksum) +.TP +md5 +(equivalent to md5sum) +.TP +sha1 +(equivalent to sha1sum) +.TP +sha224 +(equivalent to sha224sum) +.TP +sha256 +(equivalent to sha256sum) +.TP +sha384 +(equivalent to sha384sum) +.TP +sha512 +(equivalent to sha512sum) +.TP +blake2b +(equivalent to b2sum) +.TP +sm3 +(only available through cksum) +.PP +When checking, the input should be a former output of this program, +or equivalent standalone program. +.SH AUTHOR +Written by Padraig Brady and Q. Frank Xia. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +Full documentation <https://www.gnu.org/software/coreutils/cksum> +.br +or available locally via: info \(aq(coreutils) cksum invocation\(aq diff --git a/man/cksum.x b/man/cksum.x new file mode 100644 index 0000000..28f954c --- /dev/null +++ b/man/cksum.x @@ -0,0 +1,4 @@ +[NAME] +cksum \- compute and verify file checksums +[DESCRIPTION] +.\" Add any additional description here diff --git a/man/comm.1 b/man/comm.1 new file mode 100644 index 0000000..5e7e6fa --- /dev/null +++ b/man/comm.1 @@ -0,0 +1,76 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH COMM "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +comm \- compare two sorted files line by line +.SH SYNOPSIS +.B comm +[\fI\,OPTION\/\fR]... \fI\,FILE1 FILE2\/\fR +.SH DESCRIPTION +.\" Add any additional description here +.PP +Compare sorted files FILE1 and FILE2 line by line. +.PP +When FILE1 or FILE2 (not both) is \-, read standard input. +.PP +With no options, produce three\-column output. Column one contains +lines unique to FILE1, column two contains lines unique to FILE2, +and column three contains lines common to both files. +.TP +\fB\-1\fR +suppress column 1 (lines unique to FILE1) +.TP +\fB\-2\fR +suppress column 2 (lines unique to FILE2) +.TP +\fB\-3\fR +suppress column 3 (lines that appear in both files) +.TP +\fB\-\-check\-order\fR +check that the input is correctly sorted, even +if all input lines are pairable +.TP +\fB\-\-nocheck\-order\fR +do not check that the input is correctly sorted +.TP +\fB\-\-output\-delimiter\fR=\fI\,STR\/\fR +separate columns with STR +.TP +\fB\-\-total\fR +output a summary +.TP +\fB\-z\fR, \fB\-\-zero\-terminated\fR +line delimiter is NUL, not newline +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.PP +Note, comparisons honor the rules specified by 'LC_COLLATE'. +.SH EXAMPLES +.TP +comm \-12 file1 file2 +Print only lines present in both file1 and file2. +.TP +comm \-3 file1 file2 +Print lines in file1 not in file2, and vice versa. +.SH AUTHOR +Written by Richard M. Stallman and David MacKenzie. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +\fBjoin\fP(1), \fBuniq\fP(1) +.PP +.br +Full documentation <https://www.gnu.org/software/coreutils/comm> +.br +or available locally via: info \(aq(coreutils) comm invocation\(aq diff --git a/man/comm.x b/man/comm.x new file mode 100644 index 0000000..d4d8e00 --- /dev/null +++ b/man/comm.x @@ -0,0 +1,6 @@ +[NAME] +comm \- compare two sorted files line by line +[DESCRIPTION] +.\" Add any additional description here +[SEE ALSO] +join(1), uniq(1) diff --git a/man/coreutils.1 b/man/coreutils.1 new file mode 100644 index 0000000..cff53bc --- /dev/null +++ b/man/coreutils.1 @@ -0,0 +1,35 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH COREUTILS "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +coreutils \- single binary for coreutils programs +.SH SYNOPSIS +.B coreutils +\fI\,--coreutils-prog=PROGRAM_NAME \/\fR[\fI\,PARAMETERS\/\fR]... +.SH DESCRIPTION +.\" Add any additional description here +.PP +Execute the PROGRAM_NAME built\-in program with the given PARAMETERS. +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.PP +Use: 'coreutils \fB\-\-coreutils\-prog\fR=\fI\,PROGRAM_NAME\/\fR \fB\-\-help\fR' for individual program help. +.SH AUTHOR +Written by Alex Deymo. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +Full documentation <https://www.gnu.org/software/coreutils/coreutils> +.br +or available locally via: info \(aq(coreutils) Multi\-call invocation\(aq diff --git a/man/coreutils.x b/man/coreutils.x new file mode 100644 index 0000000..a7a4879 --- /dev/null +++ b/man/coreutils.x @@ -0,0 +1,4 @@ +[NAME] +coreutils \- single binary for coreutils programs +[DESCRIPTION] +.\" Add any additional description here diff --git a/man/cp.1 b/man/cp.1 new file mode 100644 index 0000000..fb0e6e7 --- /dev/null +++ b/man/cp.1 @@ -0,0 +1,197 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH CP "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +cp \- copy files and directories +.SH SYNOPSIS +.B cp +[\fI\,OPTION\/\fR]... [\fI\,-T\/\fR] \fI\,SOURCE DEST\/\fR +.br +.B cp +[\fI\,OPTION\/\fR]... \fI\,SOURCE\/\fR... \fI\,DIRECTORY\/\fR +.br +.B cp +[\fI\,OPTION\/\fR]... \fI\,-t DIRECTORY SOURCE\/\fR... +.SH DESCRIPTION +.\" Add any additional description here +.PP +Copy SOURCE to DEST, or multiple SOURCE(s) to DIRECTORY. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\fB\-a\fR, \fB\-\-archive\fR +same as \fB\-dR\fR \fB\-\-preserve\fR=\fI\,all\/\fR +.TP +\fB\-\-attributes\-only\fR +don't copy the file data, just the attributes +.TP +\fB\-\-backup\fR[=\fI\,CONTROL\/\fR] +make a backup of each existing destination file +.TP +\fB\-b\fR +like \fB\-\-backup\fR but does not accept an argument +.TP +\fB\-\-copy\-contents\fR +copy contents of special files when recursive +.TP +\fB\-d\fR +same as \fB\-\-no\-dereference\fR \fB\-\-preserve\fR=\fI\,links\/\fR +.TP +\fB\-\-debug\fR +explain how a file is copied. Implies \fB\-v\fR +.TP +\fB\-f\fR, \fB\-\-force\fR +if an existing destination file cannot be +opened, remove it and try again (this option +is ignored when the \fB\-n\fR option is also used) +.TP +\fB\-i\fR, \fB\-\-interactive\fR +prompt before overwrite (overrides a previous \fB\-n\fR +option) +.TP +\fB\-H\fR +follow command\-line symbolic links in SOURCE +.TP +\fB\-l\fR, \fB\-\-link\fR +hard link files instead of copying +.TP +\fB\-L\fR, \fB\-\-dereference\fR +always follow symbolic links in SOURCE +.TP +\fB\-n\fR, \fB\-\-no\-clobber\fR +do not overwrite an existing file (overrides a +\fB\-u\fR or previous \fB\-i\fR option). See also \fB\-\-update\fR +.TP +\fB\-P\fR, \fB\-\-no\-dereference\fR +never follow symbolic links in SOURCE +.TP +\fB\-p\fR +same as \fB\-\-preserve\fR=\fI\,mode\/\fR,ownership,timestamps +.TP +\fB\-\-preserve\fR[=\fI\,ATTR_LIST\/\fR] +preserve the specified attributes +.TP +\fB\-\-no\-preserve\fR=\fI\,ATTR_LIST\/\fR +don't preserve the specified attributes +.TP +\fB\-\-parents\fR +use full source file name under DIRECTORY +.TP +\fB\-R\fR, \fB\-r\fR, \fB\-\-recursive\fR +copy directories recursively +.TP +\fB\-\-reflink\fR[=\fI\,WHEN\/\fR] +control clone/CoW copies. See below +.TP +\fB\-\-remove\-destination\fR +remove each existing destination file before +attempting to open it (contrast with \fB\-\-force\fR) +.TP +\fB\-\-sparse\fR=\fI\,WHEN\/\fR +control creation of sparse files. See below +.TP +\fB\-\-strip\-trailing\-slashes\fR +remove any trailing slashes from each SOURCE +argument +.TP +\fB\-s\fR, \fB\-\-symbolic\-link\fR +make symbolic links instead of copying +.TP +\fB\-S\fR, \fB\-\-suffix\fR=\fI\,SUFFIX\/\fR +override the usual backup suffix +.TP +\fB\-t\fR, \fB\-\-target\-directory\fR=\fI\,DIRECTORY\/\fR +copy all SOURCE arguments into DIRECTORY +.TP +\fB\-T\fR, \fB\-\-no\-target\-directory\fR +treat DEST as a normal file +.TP +\fB\-\-update\fR[=\fI\,UPDATE\/\fR] +control which existing files are updated; +UPDATE={all,none,older(default)}. See below +.TP +\fB\-u\fR +equivalent to \fB\-\-update\fR[=\fI\,older\/\fR] +.TP +\fB\-v\fR, \fB\-\-verbose\fR +explain what is being done +.TP +\fB\-x\fR, \fB\-\-one\-file\-system\fR +stay on this file system +.TP +\fB\-Z\fR +set SELinux security context of destination +file to default type +.TP +\fB\-\-context\fR[=\fI\,CTX\/\fR] +like \fB\-Z\fR, or if CTX is specified then set the +SELinux or SMACK security context to CTX +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.PP +ATTR_LIST is a comma\-separated list of attributes. Attributes are 'mode' for +permissions (including any ACL and xattr permissions), 'ownership' for user +and group, 'timestamps' for file timestamps, 'links' for hard links, 'context' +for security context, 'xattr' for extended attributes, and 'all' for all +attributes. +.PP +By default, sparse SOURCE files are detected by a crude heuristic and the +corresponding DEST file is made sparse as well. That is the behavior +selected by \fB\-\-sparse\fR=\fI\,auto\/\fR. Specify \fB\-\-sparse\fR=\fI\,always\/\fR to create a sparse DEST +file whenever the SOURCE file contains a long enough sequence of zero bytes. +Use \fB\-\-sparse\fR=\fI\,never\/\fR to inhibit creation of sparse files. +.PP +UPDATE controls which existing files in the destination are replaced. +\&'all' is the default operation when an \fB\-\-update\fR option is not specified, +and results in all existing files in the destination being replaced. +\&'none' is similar to the \fB\-\-no\-clobber\fR option, in that no files in the +destination are replaced, but also skipped files do not induce a failure. +\&'older' is the default operation when \fB\-\-update\fR is specified, and results +in files being replaced if they're older than the corresponding source file. +.PP +When \fB\-\-reflink\fR[=\fI\,always\/\fR] is specified, perform a lightweight copy, where the +data blocks are copied only when modified. If this is not possible the copy +fails, or if \fB\-\-reflink\fR=\fI\,auto\/\fR is specified, fall back to a standard copy. +Use \fB\-\-reflink\fR=\fI\,never\/\fR to ensure a standard copy is performed. +.PP +The backup suffix is '~', unless set with \fB\-\-suffix\fR or SIMPLE_BACKUP_SUFFIX. +The version control method may be selected via the \fB\-\-backup\fR option or through +the VERSION_CONTROL environment variable. Here are the values: +.TP +none, off +never make backups (even if \fB\-\-backup\fR is given) +.TP +numbered, t +make numbered backups +.TP +existing, nil +numbered if numbered backups exist, simple otherwise +.TP +simple, never +always make simple backups +.PP +As a special case, cp makes a backup of SOURCE when the force and backup +options are given and SOURCE and DEST are the same name for an existing, +regular file. +.SH AUTHOR +Written by Torbjorn Granlund, David MacKenzie, and Jim Meyering. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +\fBinstall\fP(1) +.PP +.br +Full documentation <https://www.gnu.org/software/coreutils/cp> +.br +or available locally via: info \(aq(coreutils) cp invocation\(aq diff --git a/man/cp.x b/man/cp.x new file mode 100644 index 0000000..d75bfb2 --- /dev/null +++ b/man/cp.x @@ -0,0 +1,6 @@ +[NAME] +cp \- copy files and directories +[DESCRIPTION] +.\" Add any additional description here +[SEE ALSO] +install(1) diff --git a/man/csplit.1 b/man/csplit.1 new file mode 100644 index 0000000..35948d7 --- /dev/null +++ b/man/csplit.1 @@ -0,0 +1,77 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH CSPLIT "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +csplit \- split a file into sections determined by context lines +.SH SYNOPSIS +.B csplit +[\fI\,OPTION\/\fR]... \fI\,FILE PATTERN\/\fR... +.SH DESCRIPTION +.\" Add any additional description here +.PP +Output pieces of FILE separated by PATTERN(s) to files 'xx00', 'xx01', ..., +and output byte counts of each piece to standard output. +.PP +Read standard input if FILE is \- +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\fB\-b\fR, \fB\-\-suffix\-format\fR=\fI\,FORMAT\/\fR +use sprintf FORMAT instead of %02d +.TP +\fB\-f\fR, \fB\-\-prefix\fR=\fI\,PREFIX\/\fR +use PREFIX instead of 'xx' +.TP +\fB\-k\fR, \fB\-\-keep\-files\fR +do not remove output files on errors +.TP +\fB\-\-suppress\-matched\fR +suppress the lines matching PATTERN +.TP +\fB\-n\fR, \fB\-\-digits\fR=\fI\,DIGITS\/\fR +use specified number of digits instead of 2 +.TP +\fB\-s\fR, \fB\-\-quiet\fR, \fB\-\-silent\fR +do not print counts of output file sizes +.TP +\fB\-z\fR, \fB\-\-elide\-empty\-files\fR +suppress empty output files +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.SS "Each PATTERN may be:" +.TP +INTEGER +copy up to but not including specified line number +.TP +/REGEXP/[OFFSET] +copy up to but not including a matching line +.TP +%REGEXP%[OFFSET] +skip to, but not including a matching line +.TP +{INTEGER} +repeat the previous pattern specified number of times +.TP +{*} +repeat the previous pattern as many times as possible +.PP +A line OFFSET is an integer optionally preceded by '+' or '\-' +.SH AUTHOR +Written by Stuart Kemp and David MacKenzie. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +Full documentation <https://www.gnu.org/software/coreutils/csplit> +.br +or available locally via: info \(aq(coreutils) csplit invocation\(aq diff --git a/man/csplit.x b/man/csplit.x new file mode 100644 index 0000000..dc19d89 --- /dev/null +++ b/man/csplit.x @@ -0,0 +1,4 @@ +[NAME] +csplit \- split a file into sections determined by context lines +[DESCRIPTION] +.\" Add any additional description here diff --git a/man/cut.1 b/man/cut.1 new file mode 100644 index 0000000..442dc8b --- /dev/null +++ b/man/cut.1 @@ -0,0 +1,85 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH CUT "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +cut \- remove sections from each line of files +.SH SYNOPSIS +.B cut +\fI\,OPTION\/\fR... [\fI\,FILE\/\fR]... +.SH DESCRIPTION +.\" Add any additional description here +.PP +Print selected parts of lines from each FILE to standard output. +.PP +With no FILE, or when FILE is \-, read standard input. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\fB\-b\fR, \fB\-\-bytes\fR=\fI\,LIST\/\fR +select only these bytes +.TP +\fB\-c\fR, \fB\-\-characters\fR=\fI\,LIST\/\fR +select only these characters +.TP +\fB\-d\fR, \fB\-\-delimiter\fR=\fI\,DELIM\/\fR +use DELIM instead of TAB for field delimiter +.TP +\fB\-f\fR, \fB\-\-fields\fR=\fI\,LIST\/\fR +select only these fields; also print any line +that contains no delimiter character, unless +the \fB\-s\fR option is specified +.TP +\fB\-n\fR +(ignored) +.TP +\fB\-\-complement\fR +complement the set of selected bytes, characters +or fields +.TP +\fB\-s\fR, \fB\-\-only\-delimited\fR +do not print lines not containing delimiters +.TP +\fB\-\-output\-delimiter\fR=\fI\,STRING\/\fR +use STRING as the output delimiter +the default is to use the input delimiter +.TP +\fB\-z\fR, \fB\-\-zero\-terminated\fR +line delimiter is NUL, not newline +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.PP +Use one, and only one of \fB\-b\fR, \fB\-c\fR or \fB\-f\fR. Each LIST is made up of one +range, or many ranges separated by commas. Selected input is written +in the same order that it is read, and is written exactly once. +Each range is one of: +.TP +N +N'th byte, character or field, counted from 1 +.TP +N\- +from N'th byte, character or field, to end of line +.TP +N\-M +from N'th to M'th (included) byte, character or field +.TP +\fB\-M\fR +from first to M'th (included) byte, character or field +.SH AUTHOR +Written by David M. Ihnat, David MacKenzie, and Jim Meyering. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +Full documentation <https://www.gnu.org/software/coreutils/cut> +.br +or available locally via: info \(aq(coreutils) cut invocation\(aq diff --git a/man/cut.x b/man/cut.x new file mode 100644 index 0000000..fd09338 --- /dev/null +++ b/man/cut.x @@ -0,0 +1,4 @@ +[NAME] +cut \- remove sections from each line of files +[DESCRIPTION] +.\" Add any additional description here diff --git a/man/date.1 b/man/date.1 new file mode 100644 index 0000000..94c8471 --- /dev/null +++ b/man/date.1 @@ -0,0 +1,269 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH DATE "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +date \- print or set the system date and time +.SH SYNOPSIS +.B date +[\fI\,OPTION\/\fR]... [\fI\,+FORMAT\/\fR] +.br +.B date +[\fI\,-u|--utc|--universal\/\fR] [\fI\,MMDDhhmm\/\fR[[\fI\,CC\/\fR]\fI\,YY\/\fR][\fI\,.ss\/\fR]] +.SH DESCRIPTION +.\" Add any additional description here +.PP +Display date and time in the given FORMAT. +With \fB\-s\fR, or with [MMDDhhmm[[CC]YY][.ss]], set the date and time. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\fB\-d\fR, \fB\-\-date\fR=\fI\,STRING\/\fR +display time described by STRING, not 'now' +.TP +\fB\-\-debug\fR +annotate the parsed date, +and warn about questionable usage to stderr +.TP +\fB\-f\fR, \fB\-\-file\fR=\fI\,DATEFILE\/\fR +like \fB\-\-date\fR; once for each line of DATEFILE +.TP +\fB\-I[FMT]\fR, \fB\-\-iso\-8601\fR[=\fI\,FMT\/\fR] +output date/time in ISO 8601 format. +FMT='date' for date only (the default), +\&'hours', 'minutes', 'seconds', or 'ns' +for date and time to the indicated precision. +Example: 2006\-08\-14T02:34:56\-06:00 +.TP +\fB\-\-resolution\fR +output the available resolution of timestamps +Example: 0.000000001 +.TP +\fB\-R\fR, \fB\-\-rfc\-email\fR +output date and time in RFC 5322 format. +Example: Mon, 14 Aug 2006 02:34:56 \fB\-0600\fR +.TP +\fB\-\-rfc\-3339\fR=\fI\,FMT\/\fR +output date/time in RFC 3339 format. +FMT='date', 'seconds', or 'ns' +for date and time to the indicated precision. +Example: 2006\-08\-14 02:34:56\-06:00 +.TP +\fB\-r\fR, \fB\-\-reference\fR=\fI\,FILE\/\fR +display the last modification time of FILE +.TP +\fB\-s\fR, \fB\-\-set\fR=\fI\,STRING\/\fR +set time described by STRING +.TP +\fB\-u\fR, \fB\-\-utc\fR, \fB\-\-universal\fR +print or set Coordinated Universal Time (UTC) +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.PP +All options that specify the date to display are mutually exclusive. +I.e.: \fB\-\-date\fR, \fB\-\-file\fR, \fB\-\-reference\fR, \fB\-\-resolution\fR. +.PP +FORMAT controls the output. Interpreted sequences are: +.TP +%% +a literal % +.TP +%a +locale's abbreviated weekday name (e.g., Sun) +.TP +%A +locale's full weekday name (e.g., Sunday) +.TP +%b +locale's abbreviated month name (e.g., Jan) +.TP +%B +locale's full month name (e.g., January) +.TP +%c +locale's date and time (e.g., Thu Mar 3 23:05:25 2005) +.TP +%C +century; like %Y, except omit last two digits (e.g., 20) +.TP +%d +day of month (e.g., 01) +.TP +%D +date; same as %m/%d/%y +.TP +%e +day of month, space padded; same as %_d +.TP +%F +full date; like %+4Y\-%m\-%d +.TP +%g +last two digits of year of ISO week number (see %G) +.TP +%G +year of ISO week number (see %V); normally useful only with %V +.TP +%h +same as %b +.TP +%H +hour (00..23) +.TP +%I +hour (01..12) +.TP +%j +day of year (001..366) +.TP +%k +hour, space padded ( 0..23); same as %_H +.TP +%l +hour, space padded ( 1..12); same as %_I +.TP +%m +month (01..12) +.TP +%M +minute (00..59) +.TP +%n +a newline +.TP +%N +nanoseconds (000000000..999999999) +.TP +%p +locale's equivalent of either AM or PM; blank if not known +.TP +%P +like %p, but lower case +.TP +%q +quarter of year (1..4) +.TP +%r +locale's 12\-hour clock time (e.g., 11:11:04 PM) +.TP +%R +24\-hour hour and minute; same as %H:%M +.TP +%s +seconds since the Epoch (1970\-01\-01 00:00 UTC) +.TP +%S +second (00..60) +.TP +%t +a tab +.TP +%T +time; same as %H:%M:%S +.TP +%u +day of week (1..7); 1 is Monday +.TP +%U +week number of year, with Sunday as first day of week (00..53) +.TP +%V +ISO week number, with Monday as first day of week (01..53) +.TP +%w +day of week (0..6); 0 is Sunday +.TP +%W +week number of year, with Monday as first day of week (00..53) +.TP +%x +locale's date representation (e.g., 12/31/99) +.TP +%X +locale's time representation (e.g., 23:13:48) +.TP +%y +last two digits of year (00..99) +.TP +%Y +year +.TP +%z ++hhmm numeric time zone (e.g., \fB\-0400\fR) +.TP +%:z ++hh:mm numeric time zone (e.g., \fB\-04\fR:00) +.TP +%::z ++hh:mm:ss numeric time zone (e.g., \fB\-04\fR:00:00) +.TP +%:::z +numeric time zone with : to necessary precision (e.g., \fB\-04\fR, +05:30) +.TP +%Z +alphabetic time zone abbreviation (e.g., EDT) +.PP +By default, date pads numeric fields with zeroes. +The following optional flags may follow '%': +.TP +\- +(hyphen) do not pad the field +.TP +_ +(underscore) pad with spaces +.TP +0 +(zero) pad with zeros +.TP ++ +pad with zeros, and put '+' before future years with >4 digits +.TP +^ +use upper case if possible +.TP +# +use opposite case if possible +.PP +After any flags comes an optional field width, as a decimal number; +then an optional modifier, which is either +E to use the locale's alternate representations if available, or +O to use the locale's alternate numeric symbols if available. +.SH EXAMPLES +Convert seconds since the Epoch (1970\-01\-01 UTC) to a date +.IP +\f(CW$ date --date='@2147483647'\fR +.PP +Show the time on the west coast of the US (use \fBtzselect\fP(1) to find TZ) +.IP +\f(CW$ TZ='America/Los_Angeles' date\fR +.PP +Show the local time for 9AM next Friday on the west coast of the US +.IP +\f(CW$ date --date='TZ="America/Los_Angeles" 09:00 next Fri'\fR +.SH "DATE STRING" +.\" NOTE: keep this paragraph in sync with the one in touch.x +The --date=STRING is a mostly free format human readable date string +such as "Sun, 29 Feb 2004 16:21:42 -0800" or "2004-02-29 16:21:42" or +even "next Thursday". A date string may contain items indicating +calendar date, time of day, time zone, day of week, relative time, +relative date, and numbers. An empty string indicates the beginning +of the day. The date string format is more complex than is easily +documented here but is fully described in the info documentation. +.SH AUTHOR +Written by David MacKenzie. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +Full documentation <https://www.gnu.org/software/coreutils/date> +.br +or available locally via: info \(aq(coreutils) date invocation\(aq diff --git a/man/date.x b/man/date.x new file mode 100644 index 0000000..bbcbafc --- /dev/null +++ b/man/date.x @@ -0,0 +1,13 @@ +[NAME] +date \- print or set the system date and time +[DESCRIPTION] +.\" Add any additional description here +[DATE STRING] +.\" NOTE: keep this paragraph in sync with the one in touch.x +The --date=STRING is a mostly free format human readable date string +such as "Sun, 29 Feb 2004 16:21:42 -0800" or "2004-02-29 16:21:42" or +even "next Thursday". A date string may contain items indicating +calendar date, time of day, time zone, day of week, relative time, +relative date, and numbers. An empty string indicates the beginning +of the day. The date string format is more complex than is easily +documented here but is fully described in the info documentation. diff --git a/man/dd.1 b/man/dd.1 new file mode 100644 index 0000000..50a9bc5 --- /dev/null +++ b/man/dd.1 @@ -0,0 +1,176 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH DD "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +dd \- convert and copy a file +.SH SYNOPSIS +.B dd +[\fI\,OPERAND\/\fR]... +.br +.B dd +\fI\,OPTION\/\fR +.SH DESCRIPTION +.\" Add any additional description here +.PP +Copy a file, converting and formatting according to the operands. +.TP +bs=BYTES +read and write up to BYTES bytes at a time (default: 512); +overrides ibs and obs +.TP +cbs=BYTES +convert BYTES bytes at a time +.TP +conv=CONVS +convert the file as per the comma separated symbol list +.TP +count=N +copy only N input blocks +.TP +ibs=BYTES +read up to BYTES bytes at a time (default: 512) +.TP +if=FILE +read from FILE instead of stdin +.TP +iflag=FLAGS +read as per the comma separated symbol list +.TP +obs=BYTES +write BYTES bytes at a time (default: 512) +.TP +of=FILE +write to FILE instead of stdout +.TP +oflag=FLAGS +write as per the comma separated symbol list +.TP +seek=N +(or oseek=N) skip N obs\-sized output blocks +.TP +skip=N +(or iseek=N) skip N ibs\-sized input blocks +.TP +status=LEVEL +The LEVEL of information to print to stderr; +\&'none' suppresses everything but error messages, +\&'noxfer' suppresses the final transfer statistics, +\&'progress' shows periodic transfer statistics +.PP +N and BYTES may be followed by the following multiplicative suffixes: +c=1, w=2, b=512, kB=1000, K=1024, MB=1000*1000, M=1024*1024, xM=M, +GB=1000*1000*1000, G=1024*1024*1024, and so on for T, P, E, Z, Y, R, Q. +Binary prefixes can be used, too: KiB=K, MiB=M, and so on. +If N ends in 'B', it counts bytes not blocks. +.PP +Each CONV symbol may be: +.TP +ascii +from EBCDIC to ASCII +.TP +ebcdic +from ASCII to EBCDIC +.TP +ibm +from ASCII to alternate EBCDIC +.TP +block +pad newline\-terminated records with spaces to cbs\-size +.TP +unblock +replace trailing spaces in cbs\-size records with newline +.TP +lcase +change upper case to lower case +.TP +ucase +change lower case to upper case +.TP +sparse +try to seek rather than write all\-NUL output blocks +.TP +swab +swap every pair of input bytes +.TP +sync +pad every input block with NULs to ibs\-size; when used +with block or unblock, pad with spaces rather than NULs +.TP +excl +fail if the output file already exists +.TP +nocreat +do not create the output file +.TP +notrunc +do not truncate the output file +.TP +noerror +continue after read errors +.TP +fdatasync +physically write output file data before finishing +.TP +fsync +likewise, but also write metadata +.PP +Each FLAG symbol may be: +.TP +append +append mode (makes sense only for output; conv=notrunc suggested) +.TP +direct +use direct I/O for data +.TP +directory +fail unless a directory +.TP +dsync +use synchronized I/O for data +.TP +sync +likewise, but also for metadata +.TP +fullblock +accumulate full blocks of input (iflag only) +.TP +nonblock +use non\-blocking I/O +.TP +noatime +do not update access time +.TP +nocache +Request to drop cache. See also oflag=sync +.TP +noctty +do not assign controlling terminal from file +.TP +nofollow +do not follow symlinks +.PP +Sending a USR1 signal to a running 'dd' process makes it +print I/O statistics to standard error and then resume copying. +.PP +Options are: +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.SH AUTHOR +Written by Paul Rubin, David MacKenzie, and Stuart Kemp. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +Full documentation <https://www.gnu.org/software/coreutils/dd> +.br +or available locally via: info \(aq(coreutils) dd invocation\(aq diff --git a/man/dd.x b/man/dd.x new file mode 100644 index 0000000..bc92af5 --- /dev/null +++ b/man/dd.x @@ -0,0 +1,4 @@ +[NAME] +dd \- convert and copy a file +[DESCRIPTION] +.\" Add any additional description here diff --git a/man/df.1 b/man/df.1 new file mode 100644 index 0000000..6782a52 --- /dev/null +++ b/man/df.1 @@ -0,0 +1,120 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH DF "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +df \- report file system space usage +.SH SYNOPSIS +.B df +[\fI\,OPTION\/\fR]... [\fI\,FILE\/\fR]... +.SH DESCRIPTION +This manual page +documents the GNU version of +.BR df . +.B df +displays the amount of space available on the file system +containing each file name argument. If no file name is given, the +space available on all currently mounted file systems is shown. +Space is shown in 1K blocks by default, unless the environment +variable POSIXLY_CORRECT is set, in which case 512-byte blocks are +used. +.PP +If an argument is the absolute file name of a device node containing a +mounted file system, +.B df +shows the space available on that file system rather than on the +file system containing the device node. This version of +.B df +cannot show the space available on unmounted file systems, because on +most kinds of systems doing so requires non-portable intimate +knowledge of file system structures. +.SH OPTIONS +.PP +Show information about the file system on which each FILE resides, +or all file systems by default. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\fB\-a\fR, \fB\-\-all\fR +include pseudo, duplicate, inaccessible file systems +.TP +\fB\-B\fR, \fB\-\-block\-size\fR=\fI\,SIZE\/\fR +scale sizes by SIZE before printing them; e.g., +\&'\-BM' prints sizes in units of 1,048,576 bytes; +see SIZE format below +.TP +\fB\-h\fR, \fB\-\-human\-readable\fR +print sizes in powers of 1024 (e.g., 1023M) +.TP +\fB\-H\fR, \fB\-\-si\fR +print sizes in powers of 1000 (e.g., 1.1G) +.TP +\fB\-i\fR, \fB\-\-inodes\fR +list inode information instead of block usage +.TP +\fB\-k\fR +like \fB\-\-block\-size\fR=\fI\,1K\/\fR +.TP +\fB\-l\fR, \fB\-\-local\fR +limit listing to local file systems +.TP +\fB\-\-no\-sync\fR +do not invoke sync before getting usage info (default) +.TP +\fB\-\-output\fR[=\fI\,FIELD_LIST\/\fR] +use the output format defined by FIELD_LIST, +or print all fields if FIELD_LIST is omitted. +.TP +\fB\-P\fR, \fB\-\-portability\fR +use the POSIX output format +.TP +\fB\-\-sync\fR +invoke sync before getting usage info +.TP +\fB\-\-total\fR +elide all entries insignificant to available space, +and produce a grand total +.TP +\fB\-t\fR, \fB\-\-type\fR=\fI\,TYPE\/\fR +limit listing to file systems of type TYPE +.TP +\fB\-T\fR, \fB\-\-print\-type\fR +print file system type +.TP +\fB\-x\fR, \fB\-\-exclude\-type\fR=\fI\,TYPE\/\fR +limit listing to file systems not of type TYPE +.TP +\fB\-v\fR +(ignored) +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.PP +Display values are in units of the first available SIZE from \fB\-\-block\-size\fR, +and the DF_BLOCK_SIZE, BLOCK_SIZE and BLOCKSIZE environment variables. +Otherwise, units default to 1024 bytes (or 512 if POSIXLY_CORRECT is set). +.PP +The SIZE argument is an integer and optional unit (example: 10K is 10*1024). +Units are K,M,G,T,P,E,Z,Y,R,Q (powers of 1024) or KB,MB,... (powers of 1000). +Binary prefixes can be used, too: KiB=K, MiB=M, and so on. +.PP +FIELD_LIST is a comma\-separated list of columns to be included. Valid +field names are: 'source', 'fstype', 'itotal', 'iused', 'iavail', 'ipcent', +\&'size', 'used', 'avail', 'pcent', 'file' and 'target' (see info page). +.SH AUTHOR +Written by Torbjorn Granlund, David MacKenzie, and Paul Eggert. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +Full documentation <https://www.gnu.org/software/coreutils/df> +.br +or available locally via: info \(aq(coreutils) df invocation\(aq diff --git a/man/df.x b/man/df.x new file mode 100644 index 0000000..92940aa --- /dev/null +++ b/man/df.x @@ -0,0 +1,29 @@ +'\" Copyright (C) 1998-2023 Free Software Foundation, Inc. +'\" +'\" This is free software. You may redistribute copies of it under the terms +'\" of the GNU General Public License <https://www.gnu.org/licenses/gpl.html>. +'\" There is NO WARRANTY, to the extent permitted by law. +[NAME] +df \- report file system space usage +[DESCRIPTION] +This manual page +documents the GNU version of +.BR df . +.B df +displays the amount of space available on the file system +containing each file name argument. If no file name is given, the +space available on all currently mounted file systems is shown. +Space is shown in 1K blocks by default, unless the environment +variable POSIXLY_CORRECT is set, in which case 512-byte blocks are +used. +.PP +If an argument is the absolute file name of a device node containing a +mounted file system, +.B df +shows the space available on that file system rather than on the +file system containing the device node. This version of +.B df +cannot show the space available on unmounted file systems, because on +most kinds of systems doing so requires non-portable intimate +knowledge of file system structures. +.SH OPTIONS diff --git a/man/dir.1 b/man/dir.1 new file mode 100644 index 0000000..4e7ad2f --- /dev/null +++ b/man/dir.1 @@ -0,0 +1,265 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH DIR "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +dir \- list directory contents +.SH SYNOPSIS +.B dir +[\fI\,OPTION\/\fR]... [\fI\,FILE\/\fR]... +.SH DESCRIPTION +.\" Add any additional description here +.PP +List information about the FILEs (the current directory by default). +Sort entries alphabetically if none of \fB\-cftuvSUX\fR nor \fB\-\-sort\fR is specified. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\fB\-a\fR, \fB\-\-all\fR +do not ignore entries starting with . +.TP +\fB\-A\fR, \fB\-\-almost\-all\fR +do not list implied . and .. +.TP +\fB\-\-author\fR +with \fB\-l\fR, print the author of each file +.TP +\fB\-b\fR, \fB\-\-escape\fR +print C\-style escapes for nongraphic characters +.TP +\fB\-\-block\-size\fR=\fI\,SIZE\/\fR +with \fB\-l\fR, scale sizes by SIZE when printing them; +e.g., '\-\-block\-size=M'; see SIZE format below +.TP +\fB\-B\fR, \fB\-\-ignore\-backups\fR +do not list implied entries ending with ~ +.TP +\fB\-c\fR +with \fB\-lt\fR: sort by, and show, ctime (time of last +change of file status information); +with \fB\-l\fR: show ctime and sort by name; +otherwise: sort by ctime, newest first +.TP +\fB\-C\fR +list entries by columns +.TP +\fB\-\-color\fR[=\fI\,WHEN\/\fR] +color the output WHEN; more info below +.TP +\fB\-d\fR, \fB\-\-directory\fR +list directories themselves, not their contents +.TP +\fB\-D\fR, \fB\-\-dired\fR +generate output designed for Emacs' dired mode +.TP +\fB\-f\fR +list all entries in directory order +.TP +\fB\-F\fR, \fB\-\-classify\fR[=\fI\,WHEN\/\fR] +append indicator (one of */=>@|) to entries WHEN +.TP +\fB\-\-file\-type\fR +likewise, except do not append '*' +.TP +\fB\-\-format\fR=\fI\,WORD\/\fR +across \fB\-x\fR, commas \fB\-m\fR, horizontal \fB\-x\fR, long \fB\-l\fR, +single\-column \fB\-1\fR, verbose \fB\-l\fR, vertical \fB\-C\fR +.TP +\fB\-\-full\-time\fR +like \fB\-l\fR \fB\-\-time\-style\fR=\fI\,full\-iso\/\fR +.TP +\fB\-g\fR +like \fB\-l\fR, but do not list owner +.TP +\fB\-\-group\-directories\-first\fR +group directories before files; +can be augmented with a \fB\-\-sort\fR option, but any +use of \fB\-\-sort\fR=\fI\,none\/\fR (\fB\-U\fR) disables grouping +.TP +\fB\-G\fR, \fB\-\-no\-group\fR +in a long listing, don't print group names +.TP +\fB\-h\fR, \fB\-\-human\-readable\fR +with \fB\-l\fR and \fB\-s\fR, print sizes like 1K 234M 2G etc. +.TP +\fB\-\-si\fR +likewise, but use powers of 1000 not 1024 +.TP +\fB\-H\fR, \fB\-\-dereference\-command\-line\fR +follow symbolic links listed on the command line +.TP +\fB\-\-dereference\-command\-line\-symlink\-to\-dir\fR +follow each command line symbolic link +that points to a directory +.TP +\fB\-\-hide\fR=\fI\,PATTERN\/\fR +do not list implied entries matching shell PATTERN +(overridden by \fB\-a\fR or \fB\-A\fR) +.TP +\fB\-\-hyperlink\fR[=\fI\,WHEN\/\fR] +hyperlink file names WHEN +.TP +\fB\-\-indicator\-style\fR=\fI\,WORD\/\fR +append indicator with style WORD to entry names: +none (default), slash (\fB\-p\fR), +file\-type (\fB\-\-file\-type\fR), classify (\fB\-F\fR) +.TP +\fB\-i\fR, \fB\-\-inode\fR +print the index number of each file +.TP +\fB\-I\fR, \fB\-\-ignore\fR=\fI\,PATTERN\/\fR +do not list implied entries matching shell PATTERN +.TP +\fB\-k\fR, \fB\-\-kibibytes\fR +default to 1024\-byte blocks for file system usage; +used only with \fB\-s\fR and per directory totals +.TP +\fB\-l\fR +use a long listing format +.TP +\fB\-L\fR, \fB\-\-dereference\fR +when showing file information for a symbolic +link, show information for the file the link +references rather than for the link itself +.TP +\fB\-m\fR +fill width with a comma separated list of entries +.TP +\fB\-n\fR, \fB\-\-numeric\-uid\-gid\fR +like \fB\-l\fR, but list numeric user and group IDs +.TP +\fB\-N\fR, \fB\-\-literal\fR +print entry names without quoting +.TP +\fB\-o\fR +like \fB\-l\fR, but do not list group information +.TP +\fB\-p\fR, \fB\-\-indicator\-style\fR=\fI\,slash\/\fR +append / indicator to directories +.TP +\fB\-q\fR, \fB\-\-hide\-control\-chars\fR +print ? instead of nongraphic characters +.TP +\fB\-\-show\-control\-chars\fR +show nongraphic characters as\-is (the default, +unless program is 'ls' and output is a terminal) +.TP +\fB\-Q\fR, \fB\-\-quote\-name\fR +enclose entry names in double quotes +.TP +\fB\-\-quoting\-style\fR=\fI\,WORD\/\fR +use quoting style WORD for entry names: +literal, locale, shell, shell\-always, +shell\-escape, shell\-escape\-always, c, escape +(overrides QUOTING_STYLE environment variable) +.TP +\fB\-r\fR, \fB\-\-reverse\fR +reverse order while sorting +.TP +\fB\-R\fR, \fB\-\-recursive\fR +list subdirectories recursively +.TP +\fB\-s\fR, \fB\-\-size\fR +print the allocated size of each file, in blocks +.TP +\fB\-S\fR +sort by file size, largest first +.TP +\fB\-\-sort\fR=\fI\,WORD\/\fR +sort by WORD instead of name: none (\fB\-U\fR), size (\fB\-S\fR), +time (\fB\-t\fR), version (\fB\-v\fR), extension (\fB\-X\fR), width +.TP +\fB\-\-time\fR=\fI\,WORD\/\fR +select which timestamp used to display or sort; +access time (\fB\-u\fR): atime, access, use; +metadata change time (\fB\-c\fR): ctime, status; +modified time (default): mtime, modification; +birth time: birth, creation; +.IP +with \fB\-l\fR, WORD determines which time to show; +with \fB\-\-sort\fR=\fI\,time\/\fR, sort by WORD (newest first) +.TP +\fB\-\-time\-style\fR=\fI\,TIME_STYLE\/\fR +time/date format with \fB\-l\fR; see TIME_STYLE below +.TP +\fB\-t\fR +sort by time, newest first; see \fB\-\-time\fR +.TP +\fB\-T\fR, \fB\-\-tabsize\fR=\fI\,COLS\/\fR +assume tab stops at each COLS instead of 8 +.TP +\fB\-u\fR +with \fB\-lt\fR: sort by, and show, access time; +with \fB\-l\fR: show access time and sort by name; +otherwise: sort by access time, newest first +.TP +\fB\-U\fR +do not sort; list entries in directory order +.TP +\fB\-v\fR +natural sort of (version) numbers within text +.TP +\fB\-w\fR, \fB\-\-width\fR=\fI\,COLS\/\fR +set output width to COLS. 0 means no limit +.TP +\fB\-x\fR +list entries by lines instead of by columns +.TP +\fB\-X\fR +sort alphabetically by entry extension +.TP +\fB\-Z\fR, \fB\-\-context\fR +print any security context of each file +.TP +\fB\-\-zero\fR +end each output line with NUL, not newline +.TP +\fB\-1\fR +list one file per line +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.PP +The SIZE argument is an integer and optional unit (example: 10K is 10*1024). +Units are K,M,G,T,P,E,Z,Y,R,Q (powers of 1024) or KB,MB,... (powers of 1000). +Binary prefixes can be used, too: KiB=K, MiB=M, and so on. +.PP +The TIME_STYLE argument can be full\-iso, long\-iso, iso, locale, or +FORMAT. +FORMAT is interpreted like in \fBdate\fP(1). If FORMAT is FORMAT1<newline>FORMAT2, +then FORMAT1 applies to non\-recent files and FORMAT2 to recent files. +TIME_STYLE prefixed with 'posix\-' takes effect only outside the POSIX locale. +Also the TIME_STYLE environment variable sets the default style to use. +.PP +The WHEN argument defaults to 'always' and can also be 'auto' or 'never'. +.PP +Using color to distinguish file types is disabled both by default and +with \fB\-\-color\fR=\fI\,never\/\fR. With \fB\-\-color\fR=\fI\,auto\/\fR, ls emits color codes only when +standard output is connected to a terminal. The LS_COLORS environment +variable can change the settings. Use the \fBdircolors\fP(1) command to set it. +.SS "Exit status:" +.TP +0 +if OK, +.TP +1 +if minor problems (e.g., cannot access subdirectory), +.TP +2 +if serious trouble (e.g., cannot access command\-line argument). +.SH AUTHOR +Written by Richard M. Stallman and David MacKenzie. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +Full documentation <https://www.gnu.org/software/coreutils/dir> +.br +or available locally via: info \(aq(coreutils) dir invocation\(aq diff --git a/man/dir.x b/man/dir.x new file mode 100644 index 0000000..9ba5e59 --- /dev/null +++ b/man/dir.x @@ -0,0 +1,4 @@ +[NAME] +dir \- list directory contents +[DESCRIPTION] +.\" Add any additional description here diff --git a/man/dircolors.1 b/man/dircolors.1 new file mode 100644 index 0000000..544b30b --- /dev/null +++ b/man/dircolors.1 @@ -0,0 +1,50 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH DIRCOLORS "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +dircolors \- color setup for ls +.SH SYNOPSIS +.B dircolors +[\fI\,OPTION\/\fR]... [\fI\,FILE\/\fR] +.SH DESCRIPTION +.\" Add any additional description here +.PP +Output commands to set the LS_COLORS environment variable. +.SS "Determine format of output:" +.TP +\fB\-b\fR, \fB\-\-sh\fR, \fB\-\-bourne\-shell\fR +output Bourne shell code to set LS_COLORS +.TP +\fB\-c\fR, \fB\-\-csh\fR, \fB\-\-c\-shell\fR +output C shell code to set LS_COLORS +.TP +\fB\-p\fR, \fB\-\-print\-database\fR +output defaults +.TP +\fB\-\-print\-ls\-colors\fR +output fully escaped colors for display +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.PP +If FILE is specified, read it to determine which colors to use for which +file types and extensions. Otherwise, a precompiled database is used. +For details on the format of these files, run 'dircolors \fB\-\-print\-database\fR'. +.SH AUTHOR +Written by H. Peter Anvin. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +Full documentation <https://www.gnu.org/software/coreutils/dircolors> +.br +or available locally via: info \(aq(coreutils) dircolors invocation\(aq diff --git a/man/dircolors.x b/man/dircolors.x new file mode 100644 index 0000000..fa13247 --- /dev/null +++ b/man/dircolors.x @@ -0,0 +1,4 @@ +[NAME] +dircolors \- color setup for ls +[DESCRIPTION] +.\" Add any additional description here diff --git a/man/dirname.1 b/man/dirname.1 new file mode 100644 index 0000000..786c479 --- /dev/null +++ b/man/dirname.1 @@ -0,0 +1,50 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH DIRNAME "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +dirname \- strip last component from file name +.SH SYNOPSIS +.B dirname +[\fI\,OPTION\/\fR] \fI\,NAME\/\fR... +.SH DESCRIPTION +.\" Add any additional description here +.PP +Output each NAME with its last non\-slash component and trailing slashes +removed; if NAME contains no /'s, output '.' (meaning the current directory). +.TP +\fB\-z\fR, \fB\-\-zero\fR +end each output line with NUL, not newline +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.SH EXAMPLES +.TP +dirname /usr/bin/ +\-> "/usr" +.TP +dirname dir1/str dir2/str +\-> "dir1" followed by "dir2" +.TP +dirname stdio.h +\-> "." +.SH AUTHOR +Written by David MacKenzie and Jim Meyering. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +\fBbasename\fP(1), \fBreadlink\fP(1) +.PP +.br +Full documentation <https://www.gnu.org/software/coreutils/dirname> +.br +or available locally via: info \(aq(coreutils) dirname invocation\(aq diff --git a/man/dirname.x b/man/dirname.x new file mode 100644 index 0000000..09c46e4 --- /dev/null +++ b/man/dirname.x @@ -0,0 +1,6 @@ +[NAME] +dirname \- strip last component from file name +[DESCRIPTION] +.\" Add any additional description here +[SEE ALSO] +basename(1), readlink(1) diff --git a/man/du.1 b/man/du.1 new file mode 100644 index 0000000..e40abeb --- /dev/null +++ b/man/du.1 @@ -0,0 +1,163 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH DU "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +du \- estimate file space usage +.SH SYNOPSIS +.B du +[\fI\,OPTION\/\fR]... [\fI\,FILE\/\fR]... +.br +.B du +[\fI\,OPTION\/\fR]... \fI\,--files0-from=F\/\fR +.SH DESCRIPTION +.\" Add any additional description here +.PP +Summarize device usage of the set of FILEs, recursively for directories. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\fB\-0\fR, \fB\-\-null\fR +end each output line with NUL, not newline +.TP +\fB\-a\fR, \fB\-\-all\fR +write counts for all files, not just directories +.TP +\fB\-\-apparent\-size\fR +print apparent sizes rather than device usage; although +the apparent size is usually smaller, it may be +larger due to holes in ('sparse') files, internal +fragmentation, indirect blocks, and the like +.TP +\fB\-B\fR, \fB\-\-block\-size\fR=\fI\,SIZE\/\fR +scale sizes by SIZE before printing them; e.g., +\&'\-BM' prints sizes in units of 1,048,576 bytes; +see SIZE format below +.TP +\fB\-b\fR, \fB\-\-bytes\fR +equivalent to '\-\-apparent\-size \fB\-\-block\-size\fR=\fI\,1\/\fR' +.TP +\fB\-c\fR, \fB\-\-total\fR +produce a grand total +.TP +\fB\-D\fR, \fB\-\-dereference\-args\fR +dereference only symlinks that are listed on the +command line +.TP +\fB\-d\fR, \fB\-\-max\-depth\fR=\fI\,N\/\fR +print the total for a directory (or file, with \fB\-\-all\fR) +only if it is N or fewer levels below the command +line argument; \fB\-\-max\-depth\fR=\fI\,0\/\fR is the same as +\fB\-\-summarize\fR +.TP +\fB\-\-files0\-from\fR=\fI\,F\/\fR +summarize device usage of the +NUL\-terminated file names specified in file F; +if F is \-, then read names from standard input +.TP +\fB\-H\fR +equivalent to \fB\-\-dereference\-args\fR (\fB\-D\fR) +.TP +\fB\-h\fR, \fB\-\-human\-readable\fR +print sizes in human readable format (e.g., 1K 234M 2G) +.TP +\fB\-\-inodes\fR +list inode usage information instead of block usage +.TP +\fB\-k\fR +like \fB\-\-block\-size\fR=\fI\,1K\/\fR +.TP +\fB\-L\fR, \fB\-\-dereference\fR +dereference all symbolic links +.TP +\fB\-l\fR, \fB\-\-count\-links\fR +count sizes many times if hard linked +.TP +\fB\-m\fR +like \fB\-\-block\-size\fR=\fI\,1M\/\fR +.TP +\fB\-P\fR, \fB\-\-no\-dereference\fR +don't follow any symbolic links (this is the default) +.TP +\fB\-S\fR, \fB\-\-separate\-dirs\fR +for directories do not include size of subdirectories +.TP +\fB\-\-si\fR +like \fB\-h\fR, but use powers of 1000 not 1024 +.TP +\fB\-s\fR, \fB\-\-summarize\fR +display only a total for each argument +.TP +\fB\-t\fR, \fB\-\-threshold\fR=\fI\,SIZE\/\fR +exclude entries smaller than SIZE if positive, +or entries greater than SIZE if negative +.TP +\fB\-\-time\fR +show time of the last modification of any file in the +directory, or any of its subdirectories +.TP +\fB\-\-time\fR=\fI\,WORD\/\fR +show time as WORD instead of modification time: +atime, access, use, ctime or status +.TP +\fB\-\-time\-style\fR=\fI\,STYLE\/\fR +show times using STYLE, which can be: +full\-iso, long\-iso, iso, or +FORMAT; +FORMAT is interpreted like in 'date' +.TP +\fB\-X\fR, \fB\-\-exclude\-from\fR=\fI\,FILE\/\fR +exclude files that match any pattern in FILE +.TP +\fB\-\-exclude\fR=\fI\,PATTERN\/\fR +exclude files that match PATTERN +.TP +\fB\-x\fR, \fB\-\-one\-file\-system\fR +skip directories on different file systems +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.PP +Display values are in units of the first available SIZE from \fB\-\-block\-size\fR, +and the DU_BLOCK_SIZE, BLOCK_SIZE and BLOCKSIZE environment variables. +Otherwise, units default to 1024 bytes (or 512 if POSIXLY_CORRECT is set). +.PP +The SIZE argument is an integer and optional unit (example: 10K is 10*1024). +Units are K,M,G,T,P,E,Z,Y,R,Q (powers of 1024) or KB,MB,... (powers of 1000). +Binary prefixes can be used, too: KiB=K, MiB=M, and so on. +.SH PATTERNS +PATTERN is a shell pattern (not a regular expression). The pattern +.B ?\& +matches any one character, whereas +.B * +matches any string (composed of zero, one or multiple characters). For +example, +.B *.o +will match any files whose names end in +.BR .o . +Therefore, the command +.IP +.B du \-\-exclude=\(aq*.o\(aq +.PP +will skip all files and subdirectories ending in +.B .o +(including the file +.B .o +itself). +.SH AUTHOR +Written by Torbjorn Granlund, David MacKenzie, Paul Eggert, +and Jim Meyering. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +Full documentation <https://www.gnu.org/software/coreutils/du> +.br +or available locally via: info \(aq(coreutils) du invocation\(aq diff --git a/man/du.x b/man/du.x new file mode 100644 index 0000000..bc920ea --- /dev/null +++ b/man/du.x @@ -0,0 +1,28 @@ +'\" Copyright (C) 1998-2023 Free Software Foundation, Inc. +'\" +'\" This is free software. You may redistribute copies of it under the terms +'\" of the GNU General Public License <https://www.gnu.org/licenses/gpl.html>. +'\" There is NO WARRANTY, to the extent permitted by law. +[NAME] +du \- estimate file space usage +[DESCRIPTION] +.\" Add any additional description here +[PATTERNS] +PATTERN is a shell pattern (not a regular expression). The pattern +.B ?\& +matches any one character, whereas +.B * +matches any string (composed of zero, one or multiple characters). For +example, +.B *.o +will match any files whose names end in +.BR .o . +Therefore, the command +.IP +.B du \-\-exclude=\(aq*.o\(aq +.PP +will skip all files and subdirectories ending in +.B .o +(including the file +.B .o +itself). diff --git a/man/dummy-man b/man/dummy-man new file mode 100755 index 0000000..e298295 --- /dev/null +++ b/man/dummy-man @@ -0,0 +1,73 @@ +#!/bin/sh +# Poor man's placeholder for help2man invocation on systems lacking perl, +# or when cross compiling. +# It just copies the distributed man pages. + +set -e; set -u + +fatal_ () +{ + printf '%s: %s\n' "$0" "$*" >&2 + exit 1 +} + +basename_ () +{ + printf '%s\n' "$1" | sed 's,.*/,,' +} + +output= +source="GNU coreutils" +while test $# -gt 0; do + case $1 in + # Help2man options we recognize and handle. + --output=*) output=`expr x"$1" : x'--output=\(.*\)'`;; + --output) shift; output=$1;; + --include=*) include=`expr x"$1" : x'--include=\(.*\)'`;; + --include) shift; include=$1;; + --source=*) source=`expr x"$1" : x'--source=\(.*\)'`;; + --source) shift; source=$1;; + # Recognize (as no-op) other help2man options that might be used + # in the makefile. + --info-page=*);; + -*) fatal_ "invalid or unrecognized help2man option '$1'";; + --) shift; break;; + *) break;; + esac + shift +done + +test $# -gt 0 || fatal_ "missing argument" +test $# -le 1 || fatal_ "too many non-option arguments" + +dist_man=$(printf '%s\n' "$include" | sed 's/\.x$/.1/') +test -f "$dist_man" && cp "$dist_man" "$output" && exit || : + +baseout=`basename_ "$output"` +sed 's/^/WARNING: /' >&2 <<END +Did not generate or find default '$baseout' man page. +Creating a stub man page instead. +END + +progname=`basename_ "$1"` +bs='\' + +cat >"$output" <<END +.TH "$progname" 1 "$source" "User Commands" +.SH NAME +$progname $bs- a $source program +.SH DESCRIPTION +.B OOPS! +We were unable to create a proper manual page for +.B $progname. +For concise option descriptions, run +.IP +.B env $progname --help +.PP +The full documentation for +.B $progname +is maintained as a Texinfo manual, which should be accessible +on your system via the command +.IP +.B info $bs(aq(coreutils) $progname invocation$bs(aq +END diff --git a/man/echo.1 b/man/echo.1 new file mode 100644 index 0000000..fe2dc60 --- /dev/null +++ b/man/echo.1 @@ -0,0 +1,93 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH ECHO "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +echo \- display a line of text +.SH SYNOPSIS +.B echo +[\fI\,SHORT-OPTION\/\fR]... [\fI\,STRING\/\fR]... +.br +.B echo +\fI\,LONG-OPTION\/\fR +.SH DESCRIPTION +.\" Add any additional description here +.PP +Echo the STRING(s) to standard output. +.TP +\fB\-n\fR +do not output the trailing newline +.TP +\fB\-e\fR +enable interpretation of backslash escapes +.TP +\fB\-E\fR +disable interpretation of backslash escapes (default) +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.PP +If \fB\-e\fR is in effect, the following sequences are recognized: +.TP +\e\e +backslash +.TP +\ea +alert (BEL) +.TP +\eb +backspace +.TP +\ec +produce no further output +.TP +\ee +escape +.TP +\ef +form feed +.TP +\en +new line +.TP +\er +carriage return +.TP +\et +horizontal tab +.TP +\ev +vertical tab +.TP +\e0NNN +byte with octal value NNN (1 to 3 digits) +.TP +\exHH +byte with hexadecimal value HH (1 to 2 digits) +.PP +NOTE: your shell may have its own version of echo, which usually supersedes +the version described here. Please refer to your shell's documentation +for details about the options it supports. +.PP +NOTE: \fBprintf\fP(1) is a preferred alternative, +which does not have issues outputting option\-like strings. +.SH AUTHOR +Written by Brian Fox and Chet Ramey. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +\fBprintf\fP(1) +.PP +.br +Full documentation <https://www.gnu.org/software/coreutils/echo> +.br +or available locally via: info \(aq(coreutils) echo invocation\(aq diff --git a/man/echo.x b/man/echo.x new file mode 100644 index 0000000..61a3670 --- /dev/null +++ b/man/echo.x @@ -0,0 +1,6 @@ +[NAME] +echo \- display a line of text +[DESCRIPTION] +.\" Add any additional description here +[SEE ALSO] +printf(1) diff --git a/man/env.1 b/man/env.1 new file mode 100644 index 0000000..f96a26f --- /dev/null +++ b/man/env.1 @@ -0,0 +1,142 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH ENV "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +env \- run a program in a modified environment +.SH SYNOPSIS +.B env +[\fI\,OPTION\/\fR]... [\fI\,-\/\fR] [\fI\,NAME=VALUE\/\fR]... [\fI\,COMMAND \/\fR[\fI\,ARG\/\fR]...] +.SH DESCRIPTION +.\" Add any additional description here +.PP +Set each NAME to VALUE in the environment and run COMMAND. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\fB\-i\fR, \fB\-\-ignore\-environment\fR +start with an empty environment +.TP +\fB\-0\fR, \fB\-\-null\fR +end each output line with NUL, not newline +.TP +\fB\-u\fR, \fB\-\-unset\fR=\fI\,NAME\/\fR +remove variable from the environment +.TP +\fB\-C\fR, \fB\-\-chdir\fR=\fI\,DIR\/\fR +change working directory to DIR +.TP +\fB\-S\fR, \fB\-\-split\-string\fR=\fI\,S\/\fR +process and split S into separate arguments; +used to pass multiple arguments on shebang lines +.TP +\fB\-\-block\-signal\fR[=\fI\,SIG\/\fR] +block delivery of SIG signal(s) to COMMAND +.TP +\fB\-\-default\-signal\fR[=\fI\,SIG\/\fR] +reset handling of SIG signal(s) to the default +.TP +\fB\-\-ignore\-signal\fR[=\fI\,SIG\/\fR] +set handling of SIG signal(s) to do nothing +.TP +\fB\-\-list\-signal\-handling\fR +list non default signal handling to stderr +.TP +\fB\-v\fR, \fB\-\-debug\fR +print verbose information for each processing step +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.PP +A mere \- implies \fB\-i\fR. If no COMMAND, print the resulting environment. +.PP +SIG may be a signal name like 'PIPE', or a signal number like '13'. +Without SIG, all known signals are included. Multiple signals can be +comma\-separated. An empty SIG argument is a no\-op. +.SS "Exit status:" +.TP +125 +if the env command itself fails +.TP +126 +if COMMAND is found but cannot be invoked +.TP +127 +if COMMAND cannot be found +.TP +\- +the exit status of COMMAND otherwise +.SH OPTIONS +.SS "\-S/\-\-split\-string usage in scripts" +The +.B \-S +option allows specifying multiple parameters in a script. +Running a script named +.B 1.pl +containing the following first line: +.PP +.RS +.nf +#!/usr/bin/env \-S perl \-w \-T +\&... +.fi +.RE +.PP +Will execute +.B "perl \-w \-T 1.pl". +.PP +Without the +.B '\-S' +parameter the script will likely fail with: +.PP +.RS +.nf +/usr/bin/env: 'perl \-w \-T': No such file or directory +.fi +.RE +.PP +See the full documentation for more details. +.PP +.SS "\-\-default-signal[=SIG]" usage +This option allows setting a signal handler to its default +action, which is not possible using the traditional shell +trap command. The following example ensures that seq +will be terminated by SIGPIPE no matter how this signal +is being handled in the process invoking the command. + +.PP +.RS +.nf +sh \-c 'env \-\-default-signal=PIPE seq inf | head \-n1' +.fi +.RE +.PP +.SH NOTES +POSIX's \fBexec\fP(3p) pages says: +.RS +"many existing applications wrongly assume that they start with certain +signals set to the default action and/or unblocked.... Therefore, it is best +not to block or ignore signals across execs without explicit reason to do so, +and especially not to block signals across execs of arbitrary (not closely +cooperating) programs." +.RE +.SH AUTHOR +Written by Richard Mlynarik, David MacKenzie, and Assaf Gordon. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +\fBsigaction\fP(2), \fBsigprocmask\fP(2), \fBsignal\fP(7) +.PP +.br +Full documentation <https://www.gnu.org/software/coreutils/env> +.br +or available locally via: info \(aq(coreutils) env invocation\(aq diff --git a/man/env.x b/man/env.x new file mode 100644 index 0000000..3775eff --- /dev/null +++ b/man/env.x @@ -0,0 +1,67 @@ +'\" Copyright (C) 1998-2023 Free Software Foundation, Inc. +'\" +'\" This is free software. You may redistribute copies of it under the terms +'\" of the GNU General Public License <https://www.gnu.org/licenses/gpl.html>. +'\" There is NO WARRANTY, to the extent permitted by law. +[NAME] +env \- run a program in a modified environment +[DESCRIPTION] +.\" Add any additional description here +[OPTIONS] +.SS "\-S/\-\-split\-string usage in scripts" +The +.B \-S +option allows specifying multiple parameters in a script. +Running a script named +.B 1.pl +containing the following first line: +.PP +.RS +.nf +#!/usr/bin/env \-S perl \-w \-T +\&... +.fi +.RE +.PP +Will execute +.B "perl \-w \-T 1.pl". +.PP +Without the +.B '\-S' +parameter the script will likely fail with: +.PP +.RS +.nf +/usr/bin/env: 'perl \-w \-T': No such file or directory +.fi +.RE +.PP +See the full documentation for more details. +.PP +.SS "\-\-default-signal[=SIG]" usage +This option allows setting a signal handler to its default +action, which is not possible using the traditional shell +trap command. The following example ensures that seq +will be terminated by SIGPIPE no matter how this signal +is being handled in the process invoking the command. + +.PP +.RS +.nf +sh \-c 'env \-\-default-signal=PIPE seq inf | head \-n1' +.fi +.RE +.PP + +[NOTES] +POSIX's exec(3p) pages says: +.RS +"many existing applications wrongly assume that they start with certain +signals set to the default action and/or unblocked.... Therefore, it is best +not to block or ignore signals across execs without explicit reason to do so, +and especially not to block signals across execs of arbitrary (not closely +cooperating) programs." +.RE + +[SEE ALSO] +sigaction(2), sigprocmask(2), signal(7) diff --git a/man/expand.1 b/man/expand.1 new file mode 100644 index 0000000..cc43434 --- /dev/null +++ b/man/expand.1 @@ -0,0 +1,54 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH EXPAND "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +expand \- convert tabs to spaces +.SH SYNOPSIS +.B expand +[\fI\,OPTION\/\fR]... [\fI\,FILE\/\fR]... +.SH DESCRIPTION +.\" Add any additional description here +.PP +Convert tabs in each FILE to spaces, writing to standard output. +.PP +With no FILE, or when FILE is \-, read standard input. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\fB\-i\fR, \fB\-\-initial\fR +do not convert tabs after non blanks +.TP +\fB\-t\fR, \fB\-\-tabs\fR=\fI\,N\/\fR +have tabs N characters apart, not 8 +.TP +\fB\-t\fR, \fB\-\-tabs\fR=\fI\,LIST\/\fR +use comma separated list of tab positions. +The last specified position can be prefixed with '/' +to specify a tab size to use after the last +explicitly specified tab stop. Also a prefix of '+' +can be used to align remaining tab stops relative to +the last specified tab stop instead of the first column +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.SH AUTHOR +Written by David MacKenzie. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +\fBunexpand\fP(1) +.PP +.br +Full documentation <https://www.gnu.org/software/coreutils/expand> +.br +or available locally via: info \(aq(coreutils) expand invocation\(aq diff --git a/man/expand.x b/man/expand.x new file mode 100644 index 0000000..06c5388 --- /dev/null +++ b/man/expand.x @@ -0,0 +1,6 @@ +[NAME] +expand \- convert tabs to spaces +[DESCRIPTION] +.\" Add any additional description here +[SEE ALSO] +unexpand(1) diff --git a/man/expr.1 b/man/expr.1 new file mode 100644 index 0000000..abba135 --- /dev/null +++ b/man/expr.1 @@ -0,0 +1,107 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH EXPR "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +expr \- evaluate expressions +.SH SYNOPSIS +.B expr +\fI\,EXPRESSION\/\fR +.br +.B expr +\fI\,OPTION\/\fR +.SH DESCRIPTION +.\" Add any additional description here +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.PP +Print the value of EXPRESSION to standard output. A blank line below +separates increasing precedence groups. EXPRESSION may be: +.TP +ARG1 | ARG2 +ARG1 if it is neither null nor 0, otherwise ARG2 +.TP +ARG1 & ARG2 +ARG1 if neither argument is null or 0, otherwise 0 +.TP +ARG1 < ARG2 +ARG1 is less than ARG2 +.TP +ARG1 <= ARG2 +ARG1 is less than or equal to ARG2 +.TP +ARG1 = ARG2 +ARG1 is equal to ARG2 +.TP +ARG1 != ARG2 +ARG1 is unequal to ARG2 +.TP +ARG1 >= ARG2 +ARG1 is greater than or equal to ARG2 +.TP +ARG1 > ARG2 +ARG1 is greater than ARG2 +.TP +ARG1 + ARG2 +arithmetic sum of ARG1 and ARG2 +.TP +ARG1 \- ARG2 +arithmetic difference of ARG1 and ARG2 +.TP +ARG1 * ARG2 +arithmetic product of ARG1 and ARG2 +.TP +ARG1 / ARG2 +arithmetic quotient of ARG1 divided by ARG2 +.TP +ARG1 % ARG2 +arithmetic remainder of ARG1 divided by ARG2 +.TP +STRING : REGEXP +anchored pattern match of REGEXP in STRING +.TP +match STRING REGEXP +same as STRING : REGEXP +.TP +substr STRING POS LENGTH +substring of STRING, POS counted from 1 +.TP +index STRING CHARS +index in STRING where any CHARS is found, or 0 +.TP +length STRING +length of STRING +.TP ++ TOKEN +interpret TOKEN as a string, even if it is a +.IP +keyword like 'match' or an operator like '/' +.TP +( EXPRESSION ) +value of EXPRESSION +.PP +Beware that many operators need to be escaped or quoted for shells. +Comparisons are arithmetic if both ARGs are numbers, else lexicographical. +Pattern matches return the string matched between \e( and \e) or null; if +\e( and \e) are not used, they return the number of characters matched or 0. +.PP +Exit status is 0 if EXPRESSION is neither null nor 0, 1 if EXPRESSION is null +or 0, 2 if EXPRESSION is syntactically invalid, and 3 if an error occurred. +.SH AUTHOR +Written by Mike Parker, James Youngman, and Paul Eggert. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +Full documentation <https://www.gnu.org/software/coreutils/expr> +.br +or available locally via: info \(aq(coreutils) expr invocation\(aq diff --git a/man/expr.x b/man/expr.x new file mode 100644 index 0000000..5700077 --- /dev/null +++ b/man/expr.x @@ -0,0 +1,4 @@ +[NAME] +expr \- evaluate expressions +[DESCRIPTION] +.\" Add any additional description here diff --git a/man/factor.1 b/man/factor.1 new file mode 100644 index 0000000..65e2d81 --- /dev/null +++ b/man/factor.1 @@ -0,0 +1,37 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH FACTOR "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +factor \- factor numbers +.SH SYNOPSIS +.B factor +[\fI\,OPTION\/\fR] [\fI\,NUMBER\/\fR]... +.SH DESCRIPTION +.\" Add any additional description here +.PP +Print the prime factors of each specified integer NUMBER. If none +are specified on the command line, read them from standard input. +.TP +\fB\-h\fR, \fB\-\-exponents\fR +print repeated factors in form p^e unless e is 1 +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.SH AUTHOR +Written by Paul Rubin, Torbjorn Granlund, and Niels Moller. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +Full documentation <https://www.gnu.org/software/coreutils/factor> +.br +or available locally via: info \(aq(coreutils) factor invocation\(aq diff --git a/man/factor.x b/man/factor.x new file mode 100644 index 0000000..5d6b636 --- /dev/null +++ b/man/factor.x @@ -0,0 +1,4 @@ +[NAME] +factor \- factor numbers +[DESCRIPTION] +.\" Add any additional description here diff --git a/man/false.1 b/man/false.1 new file mode 100644 index 0000000..411919f --- /dev/null +++ b/man/false.1 @@ -0,0 +1,40 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH FALSE "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +false \- do nothing, unsuccessfully +.SH SYNOPSIS +.B false +[\fI\,ignored command line arguments\/\fR] +.br +.B false +\fI\,OPTION\/\fR +.SH DESCRIPTION +.\" Add any additional description here +.PP +Exit with a status code indicating failure. +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.PP +NOTE: your shell may have its own version of false, which usually supersedes +the version described here. Please refer to your shell's documentation +for details about the options it supports. +.SH AUTHOR +Written by Jim Meyering. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +Full documentation <https://www.gnu.org/software/coreutils/false> +.br +or available locally via: info \(aq(coreutils) false invocation\(aq diff --git a/man/false.x b/man/false.x new file mode 100644 index 0000000..3b3b359 --- /dev/null +++ b/man/false.x @@ -0,0 +1,4 @@ +[NAME] +false \- do nothing, unsuccessfully +[DESCRIPTION] +.\" Add any additional description here diff --git a/man/fmt.1 b/man/fmt.1 new file mode 100644 index 0000000..01b5c2a --- /dev/null +++ b/man/fmt.1 @@ -0,0 +1,60 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH FMT "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +fmt \- simple optimal text formatter +.SH SYNOPSIS +.B fmt +[\fI\,-WIDTH\/\fR] [\fI\,OPTION\/\fR]... [\fI\,FILE\/\fR]... +.SH DESCRIPTION +.\" Add any additional description here +.PP +Reformat each paragraph in the FILE(s), writing to standard output. +The option \fB\-WIDTH\fR is an abbreviated form of \fB\-\-width\fR=\fI\,DIGITS\/\fR. +.PP +With no FILE, or when FILE is \-, read standard input. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\fB\-c\fR, \fB\-\-crown\-margin\fR +preserve indentation of first two lines +.TP +\fB\-p\fR, \fB\-\-prefix\fR=\fI\,STRING\/\fR +reformat only lines beginning with STRING, +reattaching the prefix to reformatted lines +.TP +\fB\-s\fR, \fB\-\-split\-only\fR +split long lines, but do not refill +.TP +\fB\-t\fR, \fB\-\-tagged\-paragraph\fR +indentation of first line different from second +.TP +\fB\-u\fR, \fB\-\-uniform\-spacing\fR +one space between words, two after sentences +.TP +\fB\-w\fR, \fB\-\-width\fR=\fI\,WIDTH\/\fR +maximum line width (default of 75 columns) +.TP +\fB\-g\fR, \fB\-\-goal\fR=\fI\,WIDTH\/\fR +goal width (default of 93% of width) +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.SH AUTHOR +Written by Ross Paterson. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +Full documentation <https://www.gnu.org/software/coreutils/fmt> +.br +or available locally via: info \(aq(coreutils) fmt invocation\(aq diff --git a/man/fmt.x b/man/fmt.x new file mode 100644 index 0000000..c4abfeb --- /dev/null +++ b/man/fmt.x @@ -0,0 +1,4 @@ +[NAME] +fmt \- simple optimal text formatter +[DESCRIPTION] +.\" Add any additional description here diff --git a/man/fold.1 b/man/fold.1 new file mode 100644 index 0000000..7e08d25 --- /dev/null +++ b/man/fold.1 @@ -0,0 +1,49 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH FOLD "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +fold \- wrap each input line to fit in specified width +.SH SYNOPSIS +.B fold +[\fI\,OPTION\/\fR]... [\fI\,FILE\/\fR]... +.SH DESCRIPTION +.\" Add any additional description here +.PP +Wrap input lines in each FILE, writing to standard output. +.PP +With no FILE, or when FILE is \-, read standard input. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\fB\-b\fR, \fB\-\-bytes\fR +count bytes rather than columns +.TP +\fB\-s\fR, \fB\-\-spaces\fR +break at spaces +.TP +\fB\-w\fR, \fB\-\-width\fR=\fI\,WIDTH\/\fR +use WIDTH columns instead of 80 +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.SH AUTHOR +Written by David MacKenzie. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +\fBfmt\fP(1) +.PP +.br +Full documentation <https://www.gnu.org/software/coreutils/fold> +.br +or available locally via: info \(aq(coreutils) fold invocation\(aq diff --git a/man/fold.x b/man/fold.x new file mode 100644 index 0000000..c1c8e50 --- /dev/null +++ b/man/fold.x @@ -0,0 +1,6 @@ +[NAME] +fold \- wrap each input line to fit in specified width +[DESCRIPTION] +.\" Add any additional description here +[SEE ALSO] +fmt(1) diff --git a/man/groups.1 b/man/groups.1 new file mode 100644 index 0000000..e75825f --- /dev/null +++ b/man/groups.1 @@ -0,0 +1,37 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH GROUPS "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +groups \- print the groups a user is in +.SH SYNOPSIS +.B groups +[\fI\,OPTION\/\fR]... [\fI\,USERNAME\/\fR]... +.SH DESCRIPTION +.\" Add any additional description here +.PP +Print group memberships for each USERNAME or, if no USERNAME is specified, for +the current process (which may differ if the groups database has changed). +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.SH AUTHOR +Written by David MacKenzie and James Youngman. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +\fBgetent\fP(1) +.PP +.br +Full documentation <https://www.gnu.org/software/coreutils/groups> +.br +or available locally via: info \(aq(coreutils) groups invocation\(aq diff --git a/man/groups.x b/man/groups.x new file mode 100644 index 0000000..fad6845 --- /dev/null +++ b/man/groups.x @@ -0,0 +1,6 @@ +[NAME] +groups \- print the groups a user is in +[DESCRIPTION] +.\" Add any additional description here +[SEE ALSO] +getent(1) diff --git a/man/head.1 b/man/head.1 new file mode 100644 index 0000000..8deadff --- /dev/null +++ b/man/head.1 @@ -0,0 +1,65 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH HEAD "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +head \- output the first part of files +.SH SYNOPSIS +.B head +[\fI\,OPTION\/\fR]... [\fI\,FILE\/\fR]... +.SH DESCRIPTION +.\" Add any additional description here +.PP +Print the first 10 lines of each FILE to standard output. +With more than one FILE, precede each with a header giving the file name. +.PP +With no FILE, or when FILE is \-, read standard input. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\fB\-c\fR, \fB\-\-bytes\fR=\fI\,[\-]NUM\/\fR +print the first NUM bytes of each file; +with the leading '\-', print all but the last +NUM bytes of each file +.TP +\fB\-n\fR, \fB\-\-lines\fR=\fI\,[\-]NUM\/\fR +print the first NUM lines instead of the first 10; +with the leading '\-', print all but the last +NUM lines of each file +.TP +\fB\-q\fR, \fB\-\-quiet\fR, \fB\-\-silent\fR +never print headers giving file names +.TP +\fB\-v\fR, \fB\-\-verbose\fR +always print headers giving file names +.TP +\fB\-z\fR, \fB\-\-zero\-terminated\fR +line delimiter is NUL, not newline +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.PP +NUM may have a multiplier suffix: +b 512, kB 1000, K 1024, MB 1000*1000, M 1024*1024, +GB 1000*1000*1000, G 1024*1024*1024, and so on for T, P, E, Z, Y, R, Q. +Binary prefixes can be used, too: KiB=K, MiB=M, and so on. +.SH AUTHOR +Written by David MacKenzie and Jim Meyering. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +\fBtail\fP(1) +.PP +.br +Full documentation <https://www.gnu.org/software/coreutils/head> +.br +or available locally via: info \(aq(coreutils) head invocation\(aq diff --git a/man/head.x b/man/head.x new file mode 100644 index 0000000..53d2662 --- /dev/null +++ b/man/head.x @@ -0,0 +1,6 @@ +[NAME] +head \- output the first part of files +[DESCRIPTION] +.\" Add any additional description here +[SEE ALSO] +tail(1) diff --git a/man/help2man b/man/help2man new file mode 100755 index 0000000..581f69d --- /dev/null +++ b/man/help2man @@ -0,0 +1,802 @@ +#!/usr/bin/perl -w + +# Generate a short man page from --help and --version output. +# Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2009, +# 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2020, 2021 Free Software +# Foundation, Inc. + +# This program is free software; you can redistribute it and/or modify +# it under the terms of the GNU General Public License as published by +# the Free Software Foundation; either version 3, or (at your option) +# any later version. + +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU General Public License for more details. + +# You should have received a copy of the GNU General Public License +# along with this program; if not, see <https://www.gnu.org/licenses/>. + +# Written by Brendan O'Dea <bod@debian.org> +# Available from https://ftp.gnu.org/gnu/help2man/ + +use 5.008; +use strict; +use Getopt::Long; +use Text::ParseWords qw(shellwords); +use Text::Tabs qw(expand); +use POSIX qw(strftime setlocale LC_ALL); + +my $this_program = 'help2man'; +my $this_version = '1.48.5'; + +sub _ { $_[0] } +sub configure_locale +{ + my $locale = shift; + die "$this_program: no locale support (Locale::gettext required)\n" + unless $locale eq 'C'; +} + +sub dec { $_[0] } +sub enc { $_[0] } +sub enc_user { $_[0] } +sub kark { die +(sprintf shift, @_), "\n" } +sub N_ { $_[0] } + +sub program_basename; +sub get_option_value; +sub convert_option; +sub fix_italic_spacing; + +my $version_info = enc_user sprintf _(<<'EOT'), $this_program, $this_version; +GNU %s %s + +Copyright (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2009, +2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2020, 2021 Free Software +Foundation, Inc. +This is free software; see the source for copying conditions. There is NO +warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. + +Written by Brendan O'Dea <bod@debian.org> +EOT + +my $help_info = enc_user sprintf _(<<'EOT'), $this_program, $this_program; +`%s' generates a man page out of `--help' and `--version' output. + +Usage: %s [OPTION]... EXECUTABLE + + -n, --name=STRING description for the NAME paragraph + -s, --section=SECTION section number for manual page (1, 6, 8) + -m, --manual=TEXT name of manual (User Commands, ...) + -S, --source=TEXT source of program (FSF, Debian, ...) + -L, --locale=STRING select locale (default "C") + -i, --include=FILE include material from `FILE' + -I, --opt-include=FILE include material from `FILE' if it exists + -o, --output=FILE send output to `FILE' + -p, --info-page=TEXT name of Texinfo manual + -N, --no-info suppress pointer to Texinfo manual + -l, --libtool exclude the `lt-' from the program name + -b, --bold-refs apply bold style to references + --help print this help, then exit + --version print version number, then exit + +EXECUTABLE should accept `--help' and `--version' options and produce output on +stdout although alternatives may be specified using: + + -h, --help-option=STRING help option string + -v, --version-option=STRING version option string + --version-string=STRING version string + --no-discard-stderr include stderr when parsing option output + +Report bugs to <bug-help2man@gnu.org>. +EOT + +my $section = 1; +my $manual = ''; +my $source = ''; +my $help_option = '--help'; +my $version_option = '--version'; +my $discard_stderr = 1; +my ($opt_name, @opt_include, $opt_output, $opt_info, $opt_no_info, $opt_libtool, + $opt_bold_refs, $version_text); + +my %opt_def = ( + 'n|name=s' => \$opt_name, + 's|section=s' => \$section, + 'm|manual=s' => \$manual, + 'S|source=s' => \$source, + 'L|locale=s' => sub { configure_locale pop }, + 'i|include=s' => sub { push @opt_include, [ pop, 1 ] }, + 'I|opt-include=s' => sub { push @opt_include, [ pop, 0 ] }, + 'o|output=s' => \$opt_output, + 'p|info-page=s' => \$opt_info, + 'N|no-info' => \$opt_no_info, + 'l|libtool' => \$opt_libtool, + 'b|bold-refs' => \$opt_bold_refs, + 'help' => sub { print $help_info; exit }, + 'version' => sub { print $version_info; exit }, + 'h|help-option=s' => \$help_option, + 'v|version-option=s' => \$version_option, + 'version-string=s' => \$version_text, + 'discard-stderr!' => \$discard_stderr, +); + +# Parse options. +Getopt::Long::config('bundling'); +die $help_info unless GetOptions %opt_def and @ARGV == 1; + +my %include = (); +my %replace = (); +my %append = (); +my %append_match = (); +my @sections = (); # retain order of include file or in-line *section*s + +# Process include file (if given). Format is: +# +# Optional initial text, ignored. May include lines starting with `-' +# which are processed as options. +# +# [section] +# Verbatim text to be included in the named section. By default at +# the start, but in the case of `name' and `synopsis' the content +# will replace the autogenerated contents. +# +# [<section] +# Verbatim text to be inserted at the start of the named section. +# +# [=section] +# Verbatim text to replace the named section. +# +# [>section] +# Verbatim text to be appended to the end of the named section. +# +# /pattern/ +# Verbatim text for inclusion below a paragraph matching `pattern'. +# + +while (@opt_include) +{ + my ($inc, $required) = @{shift @opt_include}; + + next unless -f $inc or $required; + kark N_("%s: can't open `%s' (%s)"), $this_program, $inc, $! + unless open INC, $inc; + + my $key; + my $hash; + + while (<INC>) + { + # Convert input to internal Perl format, so that multibyte + # sequences are treated as single characters. + $_ = dec $_; + + # [section] + if (/^\[([^]]+)\]\s*$/) + { + $key = uc $1; + $key =~ s/^\s+//; + $key =~ s/\s+$//; + $hash = \%include; + # Handle explicit [<section], [=section] and [>section] + if ($key =~ s/^([<>=])\s*//) + { + if ($1 eq '>') { $hash = \%append; } + elsif ($1 eq '=') { $hash = \%replace; } + } + # NAME/SYNOPSIS replace by default + elsif ($key eq _('NAME') or $key eq _('SYNOPSIS')) + { + $hash = \%replace; + } + else + { + $hash = \%include; + } + + push @sections, $key; + next; + } + + # /pattern/ + if (m!^/(.*)/([ims]*)\s*$!) + { + my $pat = $2 ? "(?$2)$1" : $1; + + # Check pattern. + eval { $key = qr($pat) }; + if ($@) + { + $@ =~ s/ at .*? line \d.*//; + die "$inc:$.:$@"; + } + + $hash = \%append_match; + next; + } + + # Check for options before the first section--anything else is + # silently ignored, allowing the first for comments and + # revision info. + unless ($key) + { + # handle options + if (/^-/) + { + local @ARGV = shellwords $_; + GetOptions %opt_def; + } + + next; + } + + $hash->{$key} .= $_; + } + + close INC; + + kark N_("%s: no valid information found in `%s'"), $this_program, $inc + unless $key; +} + +# Compress trailing blank lines. +for my $hash (\(%include, %replace, %append, %append_match)) +{ + for (keys %$hash) { $hash->{$_} =~ s/\n+$/\n/ } +} + +# Grab help and version info from executable. +my $help_text = get_option_value $ARGV[0], $help_option; +$version_text ||= get_option_value $ARGV[0], $version_option; + +# By default the generated manual pages will include the current date. This may +# however be overridden by setting the environment variable $SOURCE_DATE_EPOCH +# to an integer value of the seconds since the UNIX epoch. This is primarily +# intended to support reproducible builds (wiki.debian.org/ReproducibleBuilds) +# and will additionally ensure that the output date string is UTC. +my $epoch_secs = time; +if (exists $ENV{SOURCE_DATE_EPOCH} and $ENV{SOURCE_DATE_EPOCH} =~ /^(\d+)$/) +{ + $epoch_secs = $1; + $ENV{TZ} = 'UTC0'; +} + +# Translators: the following message is a strftime(3) format string, which in +# the English version expands to the month as a word and the full year. It +# is used on the footer of the generated manual pages. If in doubt, you may +# just use %x as the value (which should be the full locale-specific date). +my $date = enc strftime _("%B %Y"), localtime $epoch_secs; +my $program = program_basename $ARGV[0]; +my $package = $program; +my $version; + +if ($opt_output) +{ + unlink $opt_output or kark N_("%s: can't unlink %s (%s)"), + $this_program, $opt_output, $! if -e $opt_output; + + open STDOUT, ">$opt_output" + or kark N_("%s: can't create %s (%s)"), $this_program, $opt_output, $!; +} + +# The first line of the --version information is assumed to be in one +# of the following formats: +# +# <version> +# <program> <version> +# {GNU,Free} <program> <version> +# <program> ({GNU,Free,} <package>) <version> +# <program> - {GNU,Free,} <package> <version> +# <program> - {GNU,Free,} <package> - <version> +# +# and separated from any copyright/author details by a blank line. + +($_, $version_text) = ((split /\n+/, $version_text, 2), ''); + +if (/^(\S+) +\(((?:(?:GNU|Free) +)?[^)]+)\) +(\S.*)$/ or + /^(\S+) +- +((?:(?:GNU|Free) +)?\S.*) +- +(\S.*)$/ or + /^(\S+) +- +((?:(?:GNU|Free) +)?\S+) +(\S.*)$/) +{ + $program = program_basename $1; + $package = $2; + $version = $3; +} +elsif (/^((?:GNU|Free) +)?(\S+) +(\S.*)$/) +{ + $program = program_basename $2; + $package = $1 ? "$1$program" : $program; + $version = $3; +} +else +{ + $version = $_; +} + +# No info for `info' itself. +$opt_no_info = 1 if $program eq 'info'; + +if ($opt_name) +{ + # --name overrides --include contents. + $replace{_('NAME')} = "$program \\- $opt_name\n"; +} + +# Translators: "NAME", "SYNOPSIS" and other one or two word strings in all +# upper case are manual page section headings. The man(1) manual page in your +# language, if available should provide the conventional translations. +for ($replace{_('NAME')} || ($include{_('NAME')} ||= '')) +{ + if ($_) # Use first name given as $program + { + $program = $1 if /^([^\s,]+)(?:,?\s*[^\s,\\-]+)*\s+\\?-/; + } + else # Set a default (useless) NAME paragraph. + { + $_ = sprintf _("%s \\- manual page for %s %s") . "\n", $program, + $program, $version; + } +} + +# Man pages traditionally have the page title in caps. +my $PROGRAM = uc $program; + +# Set default page head/footers +$source ||= "$package $version"; +unless ($manual) +{ + for ($section) + { + if (/^(1[Mm]|8)/) { $manual = enc _('System Administration Utilities') } + elsif (/^6/) { $manual = enc _('Games') } + else { $manual = enc _('User Commands') } + } +} + +# Extract usage clause(s) [if any] for SYNOPSIS. +# Translators: "Usage" and "or" here are patterns (regular expressions) which +# are used to match the usage synopsis in program output. An example from cp +# (GNU coreutils) which contains both strings: +# Usage: cp [OPTION]... [-T] SOURCE DEST +# or: cp [OPTION]... SOURCE... DIRECTORY +# or: cp [OPTION]... -t DIRECTORY SOURCE... +my $PAT_USAGE = _('Usage'); +my $PAT_USAGE_CONT = _('or'); +if ($help_text =~ s/^($PAT_USAGE):( +(\S+))(.*)((?:\n(?: {6}\1| *($PAT_USAGE_CONT): +\S).*)*)//om) +{ + my @syn = $3 . $4; + + if ($_ = $5) + { + s/^\n//; + for (split /\n/) { s/^ *(($PAT_USAGE_CONT): +)?//o; push @syn, $_ } + } + + my $synopsis = ''; + for (@syn) + { + $synopsis .= ".br\n" if $synopsis; + s!^\S*/!!; + s/^lt-// if $opt_libtool; + s/^(\S+) *//; + $synopsis .= ".B $1\n"; + s/\s+$//; + s/(([][]|\.\.+)+)/\\fR$1\\fI/g; + s/^/\\fI/ unless s/^\\fR//; + $_ .= '\fR'; + s/(\\fI)( *)/$2$1/g; + s/\\fI\\fR//g; + s/^\\fR//; + s/\\fI$//; + s/^\./\\&./; + + $_ = fix_italic_spacing $_; + $synopsis .= "$_\n"; + } + + $include{_('SYNOPSIS')} .= $synopsis; +} + +# Process text, initial section is DESCRIPTION. +my $sect = _('DESCRIPTION'); +$_ = "$help_text\n\n$version_text"; + +# Normalise paragraph breaks. +s/^\n+//; +s/\n*$/\n/; +s/\n\n+/\n\n/g; + +# Join hyphenated lines. +s/([A-Za-z])-\n *([A-Za-z])/$1$2/g; + +# Temporarily exchange leading dots, apostrophes and backslashes for +# tokens. +s/^\./\x80/mg; +s/^'/\x81/mg; +s/\\/\x82/g; + +# Translators: patterns are used to match common program output. In the source +# these strings are all of the form of "my $PAT_something = _('...');" and are +# regular expressions. If there is more than one commonly used string, you +# may separate alternatives with "|". Spaces in these expressions are written +# as " +" to indicate that more than one space may be matched. The string +# "(?:[\\w-]+ +)?" in the bug reporting pattern is used to indicate an +# optional word, so that either "Report bugs" or "Report _program_ bugs" will +# be matched. +my $PAT_BUGS = _('Report +(?:[\w-]+ +)?bugs|' . + 'Email +bug +reports +to|' . + '.* +online +help:'); +my $PAT_AUTHOR = _('Written +by'); +my $PAT_OPTIONS = _('Options'); +my $PAT_ENVIRONMENT = _('Environment'); +my $PAT_FILES = _('Files'); +my $PAT_EXAMPLES = _('Examples'); +my $PAT_FREE_SOFTWARE = _('This +is +free +software'); +my $PAT_SEE_ALSO = _('Full +documentation'); + +# Start a new paragraph (if required) for these. +s/([^\n])\n($PAT_BUGS|$PAT_AUTHOR|$PAT_SEE_ALSO) /$1\n\n$2 /og; + +# Convert iso-8859-1 copyright symbol or (c) to nroff +# character. +s/^Copyright +(?:\xa9|\([Cc]\))/Copyright \\(co/mg; + +while (length) +{ + # Convert some standard paragraph names. + if (s/^($PAT_OPTIONS): *\n+//o) + { + $sect = _('OPTIONS'); + next; + } + if (s/^($PAT_ENVIRONMENT): *\n+//o) + { + $sect = _('ENVIRONMENT'); + next; + } + if (s/^($PAT_FILES): *\n+//o) + { + $sect = _('FILES'); + next; + } + elsif (s/^($PAT_EXAMPLES): *\n+//o) + { + $sect = _('EXAMPLES'); + next; + } + + # Custom section indicated by a line containing "*Section Name*". + if (s/^\*(\w(.*\w)?)\* *\n+//) + { + $sect = uc $1; + $sect =~ tr/*/ /; # also accept *Section*Name* + push @sections, $sect; + next; + } + + # Copyright section. + if (/^Copyright /) + { + $sect = _('COPYRIGHT'); + } + + # Bug reporting section. + elsif (/^($PAT_BUGS) /o) + { + $sect = _('REPORTING BUGS'); + } + + # Author section. + elsif (/^($PAT_AUTHOR)/o) + { + $sect = _('AUTHOR'); + } + + elsif (/^($PAT_SEE_ALSO)/o) + { + $sect = _('SEE ALSO'); + $opt_no_info = 1; + } + + # Examples, indicated by an indented leading $, % or > are + # rendered in a constant width font. + if (/^( +)([\$\%>] )\S/) + { + my $indent = $1; + my $prefix = $2; + my $break = '.IP'; + while (s/^$indent\Q$prefix\E(\S.*)\n*//) + { + $include{$sect} .= "$break\n\\f(CW$prefix$1\\fR\n"; + $break = '.br'; + } + + next; + } + + my $matched = ''; + + # Sub-sections have a trailing colon and the second line indented. + if (s/^(\S.*:) *\n / /) + { + $matched .= $& if %append_match; + $include{$sect} .= qq(.SS "$1"\n); + } + + my $indent = 0; + my $content = ''; + + # Option with description. + if (s/^( {1,10}([+-]\S.*?))(?:( +(?!-))|\n( {20,}))(\S.*)\n//) + { + $matched .= $& if %append_match; + $indent = length ($4 || "$1$3"); + $content = ".TP\n\x84$2\n\x84$5\n"; + unless ($4) + { + # Indent may be different on second line. + $indent = length $& if /^ {20,}/; + } + } + + # Option without description. + elsif (s/^ {1,10}([+-]\S.*)\n//) + { + $matched .= $& if %append_match; + $content = ".HP\n\x84$1\n"; + $indent = 80; # not continued + } + + # Indented paragraph with tag. + elsif (s/^( +(\S.*?) +)(\S.*)\n//) + { + $matched .= $& if %append_match; + $indent = length $1; + $content = ".TP\n\x84$2\n\x84$3\n"; + } + + # Indented paragraph. + elsif (s/^( +)(\S.*)\n//) + { + $matched .= $& if %append_match; + $indent = length $1; + $content = ".IP\n\x84$2\n"; + } + + # Left justified paragraph. + else + { + s/(.*)\n//; + $matched .= $& if %append_match; + $content = ".PP\n" if $include{$sect}; + $content .= "$1\n"; + } + + # Append continuations. + while ($indent ? s/^ {$indent}(\S.*)\n// : s/^(\S.*)\n//) + { + $matched .= $& if %append_match; + $content .= "\x84$1\n"; + } + + # Move to next paragraph. + s/^\n+//; + + for ($content) + { + # Leading dot and apostrophe protection. + s/\x84\./\x80/g; + s/\x84'/\x81/g; + s/\x84//g; + + # Examples should be verbatim. + unless ($sect eq _('EXAMPLES')) + { + # Convert options. + s/(^|[ (])(-[][\w=-]+)/$1 . convert_option $2/mge; + + # Italicise filenames: /a/b, $VAR/c/d, ~/e/f + s! + (^|[ (]) # space/punctuation before + ( + (?:\$\w+|~)? # leading variable, or tilde + (?:/\w(?:[\w.-]*\w)?)+ # path components + ) + ($|[ ,;.)]) # space/punctuation after + !$1\\fI$2\\fP$3!xmg; + + $_ = fix_italic_spacing $_; + } + + # Escape remaining hyphens. + s/-/\x83/g; + + if ($sect eq _('COPYRIGHT')) + { + # Insert line breaks before additional copyright messages + # and the disclaimer. + s/\n(Copyright |$PAT_FREE_SOFTWARE)/\n.br\n$1/og; + } + elsif ($sect eq _('REPORTING BUGS')) + { + # Handle multi-line bug reporting sections of the form: + # + # Report <program> bugs to <addr> + # GNU <package> home page: <url> + # ... + s/\n([[:upper:]])/\n.br\n$1/g; + } + elsif ($sect eq _('SEE ALSO')) + { + # Handle external references of the form: + # + # GNU <package> online resources: <addr> + # Full documentation at: <addr> + # or available locally via: info ... + # + s/\'/\\(aq/g; # shell quotes for info command + s/\n(.)/\n.br\n$1/g; # separate lines for each item + } + } + + # Check if matched paragraph contains /pat/. + if (%append_match) + { + for my $pat (keys %append_match) + { + if ($matched =~ $pat) + { + $content .= ".PP\n" unless $append_match{$pat} =~ /^\./; + $content .= $append_match{$pat}; + } + } + } + + $include{$sect} .= $content; +} + +# Refer to the real documentation. +unless ($opt_no_info) +{ + my $info_page = $opt_info || $program; + + $sect = _('SEE ALSO'); + $include{$sect} .= ".PP\n" if $include{$sect}; + $include{$sect} .= sprintf _(<<'EOT'), $program, $program, $info_page; +The full documentation for +.B %s +is maintained as a Texinfo manual. If the +.B info +and +.B %s +programs are properly installed at your site, the command +.IP +.B info %s +.PP +should give you access to the complete manual. +EOT +} + +# Append additional text. +while (my ($sect, $text) = each %append) +{ + $include{$sect} .= $append{$sect}; +} + +# Replace sections. +while (my ($sect, $text) = each %replace) +{ + $include{$sect} = $replace{$sect}; +} + +# Output header. +print <<EOT; +.\\" DO NOT MODIFY THIS FILE! It was generated by $this_program $this_version. +.TH $PROGRAM "$section" "$date" "$source" "$manual" +EOT + +# Section ordering. +my @pre = (_('NAME'), _('SYNOPSIS'), _('DESCRIPTION'), _('OPTIONS'), + _('EXAMPLES')); +my @post = (_('ENVIRONMENT'), _('FILES'), _('AUTHOR'), + _('REPORTING BUGS'), _('COPYRIGHT'), _('SEE ALSO')); +my %filter = map { $_ => 1 } @pre, @post; + +# Output content. +my %done; +for my $sect (@pre, (grep !$filter{$_}, @sections), @post) +{ + next if $done{$sect}++; # ignore duplicates + next unless $include{$sect}; + if ($include{$sect}) + { + my $quote = $sect =~ /\W/ ? '"' : ''; + print enc ".SH $quote$sect$quote\n"; + + for ($include{$sect}) + { + # Add bold style around referenced pages. + if ($opt_bold_refs) + { + # This will ignore entries already marked up (with \) + s/(^|\s|,)([\[\w\x83]+)\(([1-9][[:lower:]]?)\)/$1\\fB$2\\fP($3)/g; + } + + # Replace leading dot, apostrophe, backslash and hyphen + # tokens. + s/\x80/\\&./g; + s/\x81/\\&'/g; + s/\x82/\\e/g; + s/\x83/\\-/g; + + # Convert some latin1 chars to troff equivalents + s/\xa0/\\ /g; # non-breaking space + + print enc $_; + } + } +} + +close STDOUT or kark N_("%s: error writing to %s (%s)"), $this_program, + $opt_output || 'stdout', $!; + +exit; + +# Get program basename, and strip libtool "lt-" prefix if required. +sub program_basename +{ + local $_ = shift; + s!.*/!!; + s/^lt-// if $opt_libtool; + $_; +} + +# Call program with given option and return results. +sub get_option_value +{ + my ($prog, $opt) = @_; + my $stderr = $discard_stderr ? '/dev/null' : '&1'; + my $value = join '', + map { s/ +$//; expand $_ } + map { dec $_ } + `$prog $opt 2>$stderr`; + + unless ($value) + { + my $err = N_("%s: can't get `%s' info from %s%s"); + my $extra = $discard_stderr + ? "\n" . N_("Try `--no-discard-stderr' if option outputs to stderr") + : ''; + + kark $err, $this_program, $opt, $prog, $extra; + } + + $value; +} + +# Convert option dashes to \- to stop nroff from hyphenating 'em, and +# embolden. Option arguments get italicised. +sub convert_option +{ + local $_ = '\fB' . shift; + + s/-/\x83/g; + unless (s/\[=(.*)\]$/\\fR[=\\fI$1\\fR]/) + { + s/=(.)/\\fR=\\fI$1/; + s/ (.)/ \\fI$1/; + $_ .= '\fR'; + } + + $_; +} + +# Insert spacing escape characters \, and \/ before and after italic text. See +# https://www.gnu.org/software/groff/manual/html_node/Ligatures-and-Kerning.html +sub fix_italic_spacing +{ + local $_ = shift; + s!\\fI(.*?)\\f([BRP])!\\fI\\,$1\\/\\f$2!g; + return $_; +} diff --git a/man/hostid.1 b/man/hostid.1 new file mode 100644 index 0000000..6c512c7 --- /dev/null +++ b/man/hostid.1 @@ -0,0 +1,36 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH HOSTID "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +hostid \- print the numeric identifier for the current host +.SH SYNOPSIS +.B hostid +[\fI\,OPTION\/\fR] +.SH DESCRIPTION +.\" Add any additional description here +.PP +Print the numeric identifier (in hexadecimal) for the current host. +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.SH AUTHOR +Written by Jim Meyering. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +\fBgethostid\fP(3) +.PP +.br +Full documentation <https://www.gnu.org/software/coreutils/hostid> +.br +or available locally via: info \(aq(coreutils) hostid invocation\(aq diff --git a/man/hostid.x b/man/hostid.x new file mode 100644 index 0000000..767a3e2 --- /dev/null +++ b/man/hostid.x @@ -0,0 +1,6 @@ +[NAME] +hostid \- print the numeric identifier for the current host +[DESCRIPTION] +.\" Add any additional description here +[SEE ALSO] +gethostid(3) diff --git a/man/hostname.1 b/man/hostname.1 new file mode 100644 index 0000000..9930446 --- /dev/null +++ b/man/hostname.1 @@ -0,0 +1,36 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH HOSTNAME "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +hostname \- set or print the name of the current host system +.SH SYNOPSIS +.B hostname +[\fI\,NAME\/\fR] +.br +.B hostname +\fI\,OPTION\/\fR +.SH DESCRIPTION +.\" Add any additional description here +.PP +Print or set the hostname of the current system. +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.SH AUTHOR +Written by Jim Meyering. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +Full documentation <https://www.gnu.org/software/coreutils/hostname> +.br +or available locally via: info \(aq(coreutils) hostname invocation\(aq diff --git a/man/hostname.x b/man/hostname.x new file mode 100644 index 0000000..4b4489c --- /dev/null +++ b/man/hostname.x @@ -0,0 +1,4 @@ +[NAME] +hostname \- set or print the name of the current host system +[DESCRIPTION] +.\" Add any additional description here diff --git a/man/id.1 b/man/id.1 new file mode 100644 index 0000000..d8eda12 --- /dev/null +++ b/man/id.1 @@ -0,0 +1,62 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH ID "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +id \- print real and effective user and group IDs +.SH SYNOPSIS +.B id +[\fI\,OPTION\/\fR]... [\fI\,USER\/\fR]... +.SH DESCRIPTION +.\" Add any additional description here +.PP +Print user and group information for each specified USER, +or (when USER omitted) for the current process. +.TP +\fB\-a\fR +ignore, for compatibility with other versions +.TP +\fB\-Z\fR, \fB\-\-context\fR +print only the security context of the process +.TP +\fB\-g\fR, \fB\-\-group\fR +print only the effective group ID +.TP +\fB\-G\fR, \fB\-\-groups\fR +print all group IDs +.TP +\fB\-n\fR, \fB\-\-name\fR +print a name instead of a number, for \fB\-ugG\fR +.TP +\fB\-r\fR, \fB\-\-real\fR +print the real ID instead of the effective ID, with \fB\-ugG\fR +.TP +\fB\-u\fR, \fB\-\-user\fR +print only the effective user ID +.TP +\fB\-z\fR, \fB\-\-zero\fR +delimit entries with NUL characters, not whitespace; +.IP +not permitted in default format +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.PP +Without any OPTION, print some useful set of identified information. +.SH AUTHOR +Written by Arnold Robbins and David MacKenzie. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +Full documentation <https://www.gnu.org/software/coreutils/id> +.br +or available locally via: info \(aq(coreutils) id invocation\(aq diff --git a/man/id.x b/man/id.x new file mode 100644 index 0000000..d55b326 --- /dev/null +++ b/man/id.x @@ -0,0 +1,4 @@ +[NAME] +id \- print real and effective user and group IDs +[DESCRIPTION] +.\" Add any additional description here diff --git a/man/install.1 b/man/install.1 new file mode 100644 index 0000000..9db67b0 --- /dev/null +++ b/man/install.1 @@ -0,0 +1,138 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH INSTALL "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +install \- copy files and set attributes +.SH SYNOPSIS +.B install +[\fI\,OPTION\/\fR]... [\fI\,-T\/\fR] \fI\,SOURCE DEST\/\fR +.br +.B install +[\fI\,OPTION\/\fR]... \fI\,SOURCE\/\fR... \fI\,DIRECTORY\/\fR +.br +.B install +[\fI\,OPTION\/\fR]... \fI\,-t DIRECTORY SOURCE\/\fR... +.br +.B install +[\fI\,OPTION\/\fR]... \fI\,-d DIRECTORY\/\fR... +.SH DESCRIPTION +.\" Add any additional description here +.PP +This install program copies files (often just compiled) into destination +locations you choose. If you want to download and install a ready\-to\-use +package on a GNU/Linux system, you should instead be using a package manager +like \fByum\fP(1) or \fBapt\-get\fP(1). +.PP +In the first three forms, copy SOURCE to DEST or multiple SOURCE(s) to +the existing DIRECTORY, while setting permission modes and owner/group. +In the 4th form, create all components of the given DIRECTORY(ies). +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\fB\-\-backup\fR[=\fI\,CONTROL\/\fR] +make a backup of each existing destination file +.TP +\fB\-b\fR +like \fB\-\-backup\fR but does not accept an argument +.TP +\fB\-c\fR +(ignored) +.TP +\fB\-C\fR, \fB\-\-compare\fR +compare content of source and destination files, and +if no change to content, ownership, and permissions, +do not modify the destination at all +.TP +\fB\-d\fR, \fB\-\-directory\fR +treat all arguments as directory names; create all +components of the specified directories +.TP +\fB\-D\fR +create all leading components of DEST except the last, +or all components of \fB\-\-target\-directory\fR, +then copy SOURCE to DEST +.TP +\fB\-\-debug\fR +explain how a file is copied. Implies \fB\-v\fR +.TP +\fB\-g\fR, \fB\-\-group\fR=\fI\,GROUP\/\fR +set group ownership, instead of process' current group +.TP +\fB\-m\fR, \fB\-\-mode\fR=\fI\,MODE\/\fR +set permission mode (as in chmod), instead of rwxr\-xr\-x +.TP +\fB\-o\fR, \fB\-\-owner\fR=\fI\,OWNER\/\fR +set ownership (super\-user only) +.TP +\fB\-p\fR, \fB\-\-preserve\-timestamps\fR +apply access/modification times of SOURCE files +to corresponding destination files +.TP +\fB\-s\fR, \fB\-\-strip\fR +strip symbol tables +.TP +\fB\-\-strip\-program\fR=\fI\,PROGRAM\/\fR +program used to strip binaries +.TP +\fB\-S\fR, \fB\-\-suffix\fR=\fI\,SUFFIX\/\fR +override the usual backup suffix +.TP +\fB\-t\fR, \fB\-\-target\-directory\fR=\fI\,DIRECTORY\/\fR +copy all SOURCE arguments into DIRECTORY +.TP +\fB\-T\fR, \fB\-\-no\-target\-directory\fR +treat DEST as a normal file +.TP +\fB\-v\fR, \fB\-\-verbose\fR +print the name of each created file or directory +.TP +\fB\-\-preserve\-context\fR +preserve SELinux security context +.TP +\fB\-Z\fR +set SELinux security context of destination +file and each created directory to default type +.TP +\fB\-\-context\fR[=\fI\,CTX\/\fR] +like \fB\-Z\fR, or if CTX is specified then set the +SELinux or SMACK security context to CTX +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.PP +The backup suffix is '~', unless set with \fB\-\-suffix\fR or SIMPLE_BACKUP_SUFFIX. +The version control method may be selected via the \fB\-\-backup\fR option or through +the VERSION_CONTROL environment variable. Here are the values: +.TP +none, off +never make backups (even if \fB\-\-backup\fR is given) +.TP +numbered, t +make numbered backups +.TP +existing, nil +numbered if numbered backups exist, simple otherwise +.TP +simple, never +always make simple backups +.SH AUTHOR +Written by David MacKenzie. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +\fBcp\fP(1) +.PP +.br +Full documentation <https://www.gnu.org/software/coreutils/install> +.br +or available locally via: info \(aq(coreutils) install invocation\(aq diff --git a/man/install.x b/man/install.x new file mode 100644 index 0000000..a813e2a --- /dev/null +++ b/man/install.x @@ -0,0 +1,6 @@ +[NAME] +install \- copy files and set attributes +[DESCRIPTION] +.\" Add any additional description here +[SEE ALSO] +cp(1) diff --git a/man/join.1 b/man/join.1 new file mode 100644 index 0000000..b3a8fa4 --- /dev/null +++ b/man/join.1 @@ -0,0 +1,97 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH JOIN "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +join \- join lines of two files on a common field +.SH SYNOPSIS +.B join +[\fI\,OPTION\/\fR]... \fI\,FILE1 FILE2\/\fR +.SH DESCRIPTION +.\" Add any additional description here +.PP +For each pair of input lines with identical join fields, write a line to +standard output. The default join field is the first, delimited by blanks. +.PP +When FILE1 or FILE2 (not both) is \-, read standard input. +.TP +\fB\-a\fR FILENUM +also print unpairable lines from file FILENUM, where +FILENUM is 1 or 2, corresponding to FILE1 or FILE2 +.TP +\fB\-e\fR STRING +replace missing (empty) input fields with STRING; +I.e., missing fields specified with '\-12jo' options +.TP +\fB\-i\fR, \fB\-\-ignore\-case\fR +ignore differences in case when comparing fields +.TP +\fB\-j\fR FIELD +equivalent to '\-1 FIELD \fB\-2\fR FIELD' +.TP +\fB\-o\fR FORMAT +obey FORMAT while constructing output line +.TP +\fB\-t\fR CHAR +use CHAR as input and output field separator +.TP +\fB\-v\fR FILENUM +like \fB\-a\fR FILENUM, but suppress joined output lines +.TP +\fB\-1\fR FIELD +join on this FIELD of file 1 +.TP +\fB\-2\fR FIELD +join on this FIELD of file 2 +.TP +\fB\-\-check\-order\fR +check that the input is correctly sorted, even +if all input lines are pairable +.TP +\fB\-\-nocheck\-order\fR +do not check that the input is correctly sorted +.TP +\fB\-\-header\fR +treat the first line in each file as field headers, +print them without trying to pair them +.TP +\fB\-z\fR, \fB\-\-zero\-terminated\fR +line delimiter is NUL, not newline +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.PP +Unless \fB\-t\fR CHAR is given, leading blanks separate fields and are ignored, +else fields are separated by CHAR. Any FIELD is a field number counted +from 1. FORMAT is one or more comma or blank separated specifications, +each being 'FILENUM.FIELD' or '0'. Default FORMAT outputs the join field, +the remaining fields from FILE1, the remaining fields from FILE2, all +separated by CHAR. If FORMAT is the keyword 'auto', then the first +line of each file determines the number of fields output for each line. +.PP +Important: FILE1 and FILE2 must be sorted on the join fields. +E.g., use "sort \fB\-k\fR 1b,1" if 'join' has no options, +or use "join \fB\-t\fR ''" if 'sort' has no options. +Note, comparisons honor the rules specified by 'LC_COLLATE'. +If the input is not sorted and some lines cannot be joined, a +warning message will be given. +.SH AUTHOR +Written by Mike Haertel. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +\fBcomm\fP(1), \fBuniq\fP(1) +.PP +.br +Full documentation <https://www.gnu.org/software/coreutils/join> +.br +or available locally via: info \(aq(coreutils) join invocation\(aq diff --git a/man/join.x b/man/join.x new file mode 100644 index 0000000..f83e8ce --- /dev/null +++ b/man/join.x @@ -0,0 +1,6 @@ +[NAME] +join \- join lines of two files on a common field +[DESCRIPTION] +.\" Add any additional description here +[SEE ALSO] +comm(1), uniq(1) diff --git a/man/kill.1 b/man/kill.1 new file mode 100644 index 0000000..6e86ebb --- /dev/null +++ b/man/kill.1 @@ -0,0 +1,62 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH KILL "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +kill \- send signals to processes, or list signals +.SH SYNOPSIS +.B kill +[\fI\,-s SIGNAL | -SIGNAL\/\fR] \fI\,PID\/\fR... +.br +.B kill +\fI\,-l \/\fR[\fI\,SIGNAL\/\fR]... +.br +.B kill +\fI\,-t \/\fR[\fI\,SIGNAL\/\fR]... +.SH DESCRIPTION +.\" Add any additional description here +.PP +Send signals to processes, or list signals. +.PP +Mandatory arguments to long options are mandatory for short options too. +.HP +\fB\-s\fR, \fB\-\-signal\fR=\fI\,SIGNAL\/\fR, \fB\-SIGNAL\fR +.IP +specify the name or number of the signal to be sent +.TP +\fB\-l\fR, \fB\-\-list\fR +list signal names, or convert signal names to/from numbers +.TP +\fB\-t\fR, \fB\-\-table\fR +print a table of signal information +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.PP +SIGNAL may be a signal name like 'HUP', or a signal number like '1', +or the exit status of a process terminated by a signal. +PID is an integer; if negative it identifies a process group. +.PP +NOTE: your shell may have its own version of kill, which usually supersedes +the version described here. Please refer to your shell's documentation +for details about the options it supports. +.SH AUTHOR +Written by Paul Eggert. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +\fBkill\fP(2) +.PP +.br +Full documentation <https://www.gnu.org/software/coreutils/kill> +.br +or available locally via: info \(aq(coreutils) kill invocation\(aq diff --git a/man/kill.x b/man/kill.x new file mode 100644 index 0000000..920c59f --- /dev/null +++ b/man/kill.x @@ -0,0 +1,6 @@ +[NAME] +kill \- send signals to processes, or list signals +[DESCRIPTION] +.\" Add any additional description here +[SEE ALSO] +kill(2) diff --git a/man/link.1 b/man/link.1 new file mode 100644 index 0000000..06c6083 --- /dev/null +++ b/man/link.1 @@ -0,0 +1,39 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH LINK "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +link \- call the link function to create a link to a file +.SH SYNOPSIS +.B link +\fI\,FILE1 FILE2\/\fR +.br +.B link +\fI\,OPTION\/\fR +.SH DESCRIPTION +.\" Add any additional description here +.PP +Call the link function to create a link named FILE2 to an existing FILE1. +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.SH AUTHOR +Written by Michael Stone. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +\fBlink\fP(2) +.PP +.br +Full documentation <https://www.gnu.org/software/coreutils/link> +.br +or available locally via: info \(aq(coreutils) link invocation\(aq diff --git a/man/link.x b/man/link.x new file mode 100644 index 0000000..2ae12bc --- /dev/null +++ b/man/link.x @@ -0,0 +1,6 @@ +[NAME] +link \- call the link function to create a link to a file +[DESCRIPTION] +.\" Add any additional description here +[SEE ALSO] +link(2) diff --git a/man/ln.1 b/man/ln.1 new file mode 100644 index 0000000..b9a574e --- /dev/null +++ b/man/ln.1 @@ -0,0 +1,119 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH LN "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +ln \- make links between files +.SH SYNOPSIS +.B ln +[\fI\,OPTION\/\fR]... [\fI\,-T\/\fR] \fI\,TARGET LINK_NAME\/\fR +.br +.B ln +[\fI\,OPTION\/\fR]... \fI\,TARGET\/\fR +.br +.B ln +[\fI\,OPTION\/\fR]... \fI\,TARGET\/\fR... \fI\,DIRECTORY\/\fR +.br +.B ln +[\fI\,OPTION\/\fR]... \fI\,-t DIRECTORY TARGET\/\fR... +.SH DESCRIPTION +.\" Add any additional description here +.PP +In the 1st form, create a link to TARGET with the name LINK_NAME. +In the 2nd form, create a link to TARGET in the current directory. +In the 3rd and 4th forms, create links to each TARGET in DIRECTORY. +Create hard links by default, symbolic links with \fB\-\-symbolic\fR. +By default, each destination (name of new link) should not already exist. +When creating hard links, each TARGET must exist. Symbolic links +can hold arbitrary text; if later resolved, a relative link is +interpreted in relation to its parent directory. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\fB\-\-backup\fR[=\fI\,CONTROL\/\fR] +make a backup of each existing destination file +.TP +\fB\-b\fR +like \fB\-\-backup\fR but does not accept an argument +.TP +\fB\-d\fR, \fB\-F\fR, \fB\-\-directory\fR +allow the superuser to attempt to hard link +directories (note: will probably fail due to +system restrictions, even for the superuser) +.TP +\fB\-f\fR, \fB\-\-force\fR +remove existing destination files +.TP +\fB\-i\fR, \fB\-\-interactive\fR +prompt whether to remove destinations +.TP +\fB\-L\fR, \fB\-\-logical\fR +dereference TARGETs that are symbolic links +.TP +\fB\-n\fR, \fB\-\-no\-dereference\fR +treat LINK_NAME as a normal file if +it is a symbolic link to a directory +.TP +\fB\-P\fR, \fB\-\-physical\fR +make hard links directly to symbolic links +.TP +\fB\-r\fR, \fB\-\-relative\fR +with \fB\-s\fR, create links relative to link location +.TP +\fB\-s\fR, \fB\-\-symbolic\fR +make symbolic links instead of hard links +.TP +\fB\-S\fR, \fB\-\-suffix\fR=\fI\,SUFFIX\/\fR +override the usual backup suffix +.TP +\fB\-t\fR, \fB\-\-target\-directory\fR=\fI\,DIRECTORY\/\fR +specify the DIRECTORY in which to create +the links +.TP +\fB\-T\fR, \fB\-\-no\-target\-directory\fR +treat LINK_NAME as a normal file always +.TP +\fB\-v\fR, \fB\-\-verbose\fR +print name of each linked file +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.PP +The backup suffix is '~', unless set with \fB\-\-suffix\fR or SIMPLE_BACKUP_SUFFIX. +The version control method may be selected via the \fB\-\-backup\fR option or through +the VERSION_CONTROL environment variable. Here are the values: +.TP +none, off +never make backups (even if \fB\-\-backup\fR is given) +.TP +numbered, t +make numbered backups +.TP +existing, nil +numbered if numbered backups exist, simple otherwise +.TP +simple, never +always make simple backups +.PP +Using \fB\-s\fR ignores \fB\-L\fR and \fB\-P\fR. Otherwise, the last option specified controls +behavior when a TARGET is a symbolic link, defaulting to \fB\-P\fR. +.SH AUTHOR +Written by Mike Parker and David MacKenzie. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +\fBlink\fP(2), \fBsymlink\fP(2) +.PP +.br +Full documentation <https://www.gnu.org/software/coreutils/ln> +.br +or available locally via: info \(aq(coreutils) ln invocation\(aq diff --git a/man/ln.x b/man/ln.x new file mode 100644 index 0000000..daba9bf --- /dev/null +++ b/man/ln.x @@ -0,0 +1,6 @@ +[NAME] +ln \- make links between files +[DESCRIPTION] +.\" Add any additional description here +[SEE ALSO] +link(2), symlink(2) diff --git a/man/local.mk b/man/local.mk new file mode 100644 index 0000000..5bdca26 --- /dev/null +++ b/man/local.mk @@ -0,0 +1,211 @@ +# Make coreutils man pages. -*-Makefile-*- +# This is included by the top-level Makefile.am. + +# Copyright (C) 2002-2023 Free Software Foundation, Inc. + +# This program is free software: you can redistribute it and/or modify +# it under the terms of the GNU General Public License as published by +# the Free Software Foundation, either version 3 of the License, or +# (at your option) any later version. + +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY; without even the implied warranty of +# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +# GNU General Public License for more details. + +# You should have received a copy of the GNU General Public License +# along with this program. If not, see <https://www.gnu.org/licenses/>. + +EXTRA_DIST += man/help2man man/dummy-man + +## Use the distributed man pages if cross compiling or lack perl +if CROSS_COMPILING +run_help2man = $(SHELL) $(srcdir)/man/dummy-man +else +## Graceful degradation for systems lacking perl. +if HAVE_PERL +if BOLD_MAN_REFS +help2man_OPTS=--bold-refs +endif +run_help2man = $(PERL) -- $(srcdir)/man/help2man $(help2man_OPTS) +else +run_help2man = $(SHELL) $(srcdir)/man/dummy-man +endif +endif + +man1_MANS = @man1_MANS@ +EXTRA_DIST += $(man1_MANS) $(man1_MANS:.1=.x) + +EXTRA_MANS = @EXTRA_MANS@ +EXTRA_DIST += $(EXTRA_MANS) $(EXTRA_MANS:.1=.x) + +ALL_MANS = $(man1_MANS) $(EXTRA_MANS) + +MAINTAINERCLEANFILES += $(ALL_MANS) + +# This is a kludge to remove generated 'man/*.1' from a non-srcdir build. +# Without this, "make distcheck" might fail. +distclean-local: + test x$(srcdir) = x$(builddir) || rm -f $(ALL_MANS) + +# Dependencies common to all man pages. Updated below. +mandeps = + +# Depend on this to get version number changes. +mandeps += .version + +# This is required so that changes to e.g., emit_bug_reporting_address +# provoke regeneration of all the manpages. +mandeps += $(top_srcdir)/src/system.h + +$(ALL_MANS): $(mandeps) + +if SINGLE_BINARY +mandeps += src/coreutils$(EXEEXT) +else +# Most prog.1 man pages depend on src/prog. List the exceptions: +man/install.1: src/ginstall$(EXEEXT) +man/test.1: src/[$(EXEEXT) + +man/arch.1: src/arch$(EXEEXT) +man/b2sum.1: src/b2sum$(EXEEXT) +man/base32.1: src/base32$(EXEEXT) +man/base64.1: src/base64$(EXEEXT) +man/basename.1: src/basename$(EXEEXT) +man/basenc.1: src/basenc$(EXEEXT) +man/cat.1: src/cat$(EXEEXT) +man/chcon.1: src/chcon$(EXEEXT) +man/chgrp.1: src/chgrp$(EXEEXT) +man/chmod.1: src/chmod$(EXEEXT) +man/chown.1: src/chown$(EXEEXT) +man/chroot.1: src/chroot$(EXEEXT) +man/cksum.1: src/cksum$(EXEEXT) +man/comm.1: src/comm$(EXEEXT) +man/coreutils.1: src/coreutils$(EXEEXT) +man/cp.1: src/cp$(EXEEXT) +man/csplit.1: src/csplit$(EXEEXT) +man/cut.1: src/cut$(EXEEXT) +man/date.1: src/date$(EXEEXT) +man/dd.1: src/dd$(EXEEXT) +man/df.1: src/df$(EXEEXT) +man/dir.1: src/dir$(EXEEXT) +man/dircolors.1: src/dircolors$(EXEEXT) +man/dirname.1: src/dirname$(EXEEXT) +man/du.1: src/du$(EXEEXT) +man/echo.1: src/echo$(EXEEXT) +man/env.1: src/env$(EXEEXT) +man/expand.1: src/expand$(EXEEXT) +man/expr.1: src/expr$(EXEEXT) +man/factor.1: src/factor$(EXEEXT) +man/false.1: src/false$(EXEEXT) +man/fmt.1: src/fmt$(EXEEXT) +man/fold.1: src/fold$(EXEEXT) +man/groups.1: src/groups$(EXEEXT) +man/head.1: src/head$(EXEEXT) +man/hostid.1: src/hostid$(EXEEXT) +man/hostname.1: src/hostname$(EXEEXT) +man/id.1: src/id$(EXEEXT) +man/join.1: src/join$(EXEEXT) +man/kill.1: src/kill$(EXEEXT) +man/link.1: src/link$(EXEEXT) +man/ln.1: src/ln$(EXEEXT) +man/logname.1: src/logname$(EXEEXT) +man/ls.1: src/ls$(EXEEXT) +man/md5sum.1: src/md5sum$(EXEEXT) +man/mkdir.1: src/mkdir$(EXEEXT) +man/mkfifo.1: src/mkfifo$(EXEEXT) +man/mknod.1: src/mknod$(EXEEXT) +man/mktemp.1: src/mktemp$(EXEEXT) +man/mv.1: src/mv$(EXEEXT) +man/nice.1: src/nice$(EXEEXT) +man/nl.1: src/nl$(EXEEXT) +man/nohup.1: src/nohup$(EXEEXT) +man/nproc.1: src/nproc$(EXEEXT) +man/numfmt.1: src/numfmt$(EXEEXT) +man/od.1: src/od$(EXEEXT) +man/paste.1: src/paste$(EXEEXT) +man/pathchk.1: src/pathchk$(EXEEXT) +man/pinky.1: src/pinky$(EXEEXT) +man/pr.1: src/pr$(EXEEXT) +man/printenv.1: src/printenv$(EXEEXT) +man/printf.1: src/printf$(EXEEXT) +man/ptx.1: src/ptx$(EXEEXT) +man/pwd.1: src/pwd$(EXEEXT) +man/readlink.1: src/readlink$(EXEEXT) +man/realpath.1: src/realpath$(EXEEXT) +man/rm.1: src/rm$(EXEEXT) +man/rmdir.1: src/rmdir$(EXEEXT) +man/runcon.1: src/runcon$(EXEEXT) +man/seq.1: src/seq$(EXEEXT) +man/sha1sum.1: src/sha1sum$(EXEEXT) +man/sha224sum.1: src/sha224sum$(EXEEXT) +man/sha256sum.1: src/sha256sum$(EXEEXT) +man/sha384sum.1: src/sha384sum$(EXEEXT) +man/sha512sum.1: src/sha512sum$(EXEEXT) +man/shred.1: src/shred$(EXEEXT) +man/shuf.1: src/shuf$(EXEEXT) +man/sleep.1: src/sleep$(EXEEXT) +man/sort.1: src/sort$(EXEEXT) +man/split.1: src/split$(EXEEXT) +man/stat.1: src/stat$(EXEEXT) +man/stdbuf.1: src/stdbuf$(EXEEXT) +man/stty.1: src/stty$(EXEEXT) +man/sum.1: src/sum$(EXEEXT) +man/sync.1: src/sync$(EXEEXT) +man/tac.1: src/tac$(EXEEXT) +man/tail.1: src/tail$(EXEEXT) +man/tee.1: src/tee$(EXEEXT) +man/timeout.1: src/timeout$(EXEEXT) +man/touch.1: src/touch$(EXEEXT) +man/tr.1: src/tr$(EXEEXT) +man/true.1: src/true$(EXEEXT) +man/truncate.1: src/truncate$(EXEEXT) +man/tsort.1: src/tsort$(EXEEXT) +man/tty.1: src/tty$(EXEEXT) +man/uname.1: src/uname$(EXEEXT) +man/unexpand.1: src/unexpand$(EXEEXT) +man/uniq.1: src/uniq$(EXEEXT) +man/unlink.1: src/unlink$(EXEEXT) +man/uptime.1: src/uptime$(EXEEXT) +man/users.1: src/users$(EXEEXT) +man/vdir.1: src/vdir$(EXEEXT) +man/wc.1: src/wc$(EXEEXT) +man/who.1: src/who$(EXEEXT) +man/whoami.1: src/whoami$(EXEEXT) +man/yes.1: src/yes$(EXEEXT) +endif + +.x.1: + $(AM_V_GEN)name=`echo $@ | sed 's|.*/||; s|\.1$$||'` || exit 1; \ +## Ensure that help2man runs the 'src/ginstall' binary as 'install' when +## creating 'install.1'. Similarly, ensure that it uses the 'src/[' binary +## to create 'test.1'. + case $$name in \ + install) prog='ginstall'; argv=$$name;; \ + test) prog='['; argv='[';; \ + *) prog=$$name; argv=$$prog;; \ + esac; \ +## Note the use of $$t/$*, rather than just '$*' as in other packages. +## That is necessary to avoid failures for programs that are also shell +## built-in functions like echo, false, printf, pwd. + rm -f $@-t \ + && t=$*.td \ + && rm -rf $$t \ + && $(MKDIR_P) $$t \ + && (cd $$t && $(LN_S) '$(abs_top_builddir)/src/'$$prog$(EXEEXT) \ + $$argv$(EXEEXT)) \ + && : $${SOURCE_DATE_EPOCH=`cat $(srcdir)/.timestamp 2>/dev/null || :`} \ + && : $${TZ=UTC0} && export TZ \ + && export SOURCE_DATE_EPOCH && $(run_help2man) \ + --source='$(PACKAGE_STRING)' \ + --include=$(srcdir)/man/$$name.x \ + --output=$$t/$$name.1 \ + --info-page='\(aq(coreutils) '$$name' invocation\(aq' \ + $$t/$$argv$(EXEEXT) \ + && sed \ + -e 's|$*\.td/||g' \ + -e '/For complete documentation/d' \ + $$t/$$name.1 > $@-t \ + && rm -rf $$t \ + && chmod a-w $@-t \ + && rm -f $@ && mv $@-t $@ diff --git a/man/logname.1 b/man/logname.1 new file mode 100644 index 0000000..e32d429 --- /dev/null +++ b/man/logname.1 @@ -0,0 +1,36 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH LOGNAME "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +logname \- print user\'s login name +.SH SYNOPSIS +.B logname +[\fI\,OPTION\/\fR] +.SH DESCRIPTION +.\" Add any additional description here +.PP +Print the user's login name. +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.SH AUTHOR +Written by FIXME: unknown. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +\fBgetlogin\fP(3) +.PP +.br +Full documentation <https://www.gnu.org/software/coreutils/logname> +.br +or available locally via: info \(aq(coreutils) logname invocation\(aq diff --git a/man/logname.x b/man/logname.x new file mode 100644 index 0000000..83dbc06 --- /dev/null +++ b/man/logname.x @@ -0,0 +1,6 @@ +[NAME] +logname \- print user\'s login name +[DESCRIPTION] +.\" Add any additional description here +[SEE ALSO] +getlogin(3) diff --git a/man/ls.1 b/man/ls.1 new file mode 100644 index 0000000..7d67613 --- /dev/null +++ b/man/ls.1 @@ -0,0 +1,268 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH LS "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +ls \- list directory contents +.SH SYNOPSIS +.B ls +[\fI\,OPTION\/\fR]... [\fI\,FILE\/\fR]... +.SH DESCRIPTION +.\" Add any additional description here +.PP +List information about the FILEs (the current directory by default). +Sort entries alphabetically if none of \fB\-cftuvSUX\fR nor \fB\-\-sort\fR is specified. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\fB\-a\fR, \fB\-\-all\fR +do not ignore entries starting with . +.TP +\fB\-A\fR, \fB\-\-almost\-all\fR +do not list implied . and .. +.TP +\fB\-\-author\fR +with \fB\-l\fR, print the author of each file +.TP +\fB\-b\fR, \fB\-\-escape\fR +print C\-style escapes for nongraphic characters +.TP +\fB\-\-block\-size\fR=\fI\,SIZE\/\fR +with \fB\-l\fR, scale sizes by SIZE when printing them; +e.g., '\-\-block\-size=M'; see SIZE format below +.TP +\fB\-B\fR, \fB\-\-ignore\-backups\fR +do not list implied entries ending with ~ +.TP +\fB\-c\fR +with \fB\-lt\fR: sort by, and show, ctime (time of last +change of file status information); +with \fB\-l\fR: show ctime and sort by name; +otherwise: sort by ctime, newest first +.TP +\fB\-C\fR +list entries by columns +.TP +\fB\-\-color\fR[=\fI\,WHEN\/\fR] +color the output WHEN; more info below +.TP +\fB\-d\fR, \fB\-\-directory\fR +list directories themselves, not their contents +.TP +\fB\-D\fR, \fB\-\-dired\fR +generate output designed for Emacs' dired mode +.TP +\fB\-f\fR +list all entries in directory order +.TP +\fB\-F\fR, \fB\-\-classify\fR[=\fI\,WHEN\/\fR] +append indicator (one of */=>@|) to entries WHEN +.TP +\fB\-\-file\-type\fR +likewise, except do not append '*' +.TP +\fB\-\-format\fR=\fI\,WORD\/\fR +across \fB\-x\fR, commas \fB\-m\fR, horizontal \fB\-x\fR, long \fB\-l\fR, +single\-column \fB\-1\fR, verbose \fB\-l\fR, vertical \fB\-C\fR +.TP +\fB\-\-full\-time\fR +like \fB\-l\fR \fB\-\-time\-style\fR=\fI\,full\-iso\/\fR +.TP +\fB\-g\fR +like \fB\-l\fR, but do not list owner +.TP +\fB\-\-group\-directories\-first\fR +group directories before files; +can be augmented with a \fB\-\-sort\fR option, but any +use of \fB\-\-sort\fR=\fI\,none\/\fR (\fB\-U\fR) disables grouping +.TP +\fB\-G\fR, \fB\-\-no\-group\fR +in a long listing, don't print group names +.TP +\fB\-h\fR, \fB\-\-human\-readable\fR +with \fB\-l\fR and \fB\-s\fR, print sizes like 1K 234M 2G etc. +.TP +\fB\-\-si\fR +likewise, but use powers of 1000 not 1024 +.TP +\fB\-H\fR, \fB\-\-dereference\-command\-line\fR +follow symbolic links listed on the command line +.TP +\fB\-\-dereference\-command\-line\-symlink\-to\-dir\fR +follow each command line symbolic link +that points to a directory +.TP +\fB\-\-hide\fR=\fI\,PATTERN\/\fR +do not list implied entries matching shell PATTERN +(overridden by \fB\-a\fR or \fB\-A\fR) +.TP +\fB\-\-hyperlink\fR[=\fI\,WHEN\/\fR] +hyperlink file names WHEN +.TP +\fB\-\-indicator\-style\fR=\fI\,WORD\/\fR +append indicator with style WORD to entry names: +none (default), slash (\fB\-p\fR), +file\-type (\fB\-\-file\-type\fR), classify (\fB\-F\fR) +.TP +\fB\-i\fR, \fB\-\-inode\fR +print the index number of each file +.TP +\fB\-I\fR, \fB\-\-ignore\fR=\fI\,PATTERN\/\fR +do not list implied entries matching shell PATTERN +.TP +\fB\-k\fR, \fB\-\-kibibytes\fR +default to 1024\-byte blocks for file system usage; +used only with \fB\-s\fR and per directory totals +.TP +\fB\-l\fR +use a long listing format +.TP +\fB\-L\fR, \fB\-\-dereference\fR +when showing file information for a symbolic +link, show information for the file the link +references rather than for the link itself +.TP +\fB\-m\fR +fill width with a comma separated list of entries +.TP +\fB\-n\fR, \fB\-\-numeric\-uid\-gid\fR +like \fB\-l\fR, but list numeric user and group IDs +.TP +\fB\-N\fR, \fB\-\-literal\fR +print entry names without quoting +.TP +\fB\-o\fR +like \fB\-l\fR, but do not list group information +.TP +\fB\-p\fR, \fB\-\-indicator\-style\fR=\fI\,slash\/\fR +append / indicator to directories +.TP +\fB\-q\fR, \fB\-\-hide\-control\-chars\fR +print ? instead of nongraphic characters +.TP +\fB\-\-show\-control\-chars\fR +show nongraphic characters as\-is (the default, +unless program is 'ls' and output is a terminal) +.TP +\fB\-Q\fR, \fB\-\-quote\-name\fR +enclose entry names in double quotes +.TP +\fB\-\-quoting\-style\fR=\fI\,WORD\/\fR +use quoting style WORD for entry names: +literal, locale, shell, shell\-always, +shell\-escape, shell\-escape\-always, c, escape +(overrides QUOTING_STYLE environment variable) +.TP +\fB\-r\fR, \fB\-\-reverse\fR +reverse order while sorting +.TP +\fB\-R\fR, \fB\-\-recursive\fR +list subdirectories recursively +.TP +\fB\-s\fR, \fB\-\-size\fR +print the allocated size of each file, in blocks +.TP +\fB\-S\fR +sort by file size, largest first +.TP +\fB\-\-sort\fR=\fI\,WORD\/\fR +sort by WORD instead of name: none (\fB\-U\fR), size (\fB\-S\fR), +time (\fB\-t\fR), version (\fB\-v\fR), extension (\fB\-X\fR), width +.TP +\fB\-\-time\fR=\fI\,WORD\/\fR +select which timestamp used to display or sort; +access time (\fB\-u\fR): atime, access, use; +metadata change time (\fB\-c\fR): ctime, status; +modified time (default): mtime, modification; +birth time: birth, creation; +.IP +with \fB\-l\fR, WORD determines which time to show; +with \fB\-\-sort\fR=\fI\,time\/\fR, sort by WORD (newest first) +.TP +\fB\-\-time\-style\fR=\fI\,TIME_STYLE\/\fR +time/date format with \fB\-l\fR; see TIME_STYLE below +.TP +\fB\-t\fR +sort by time, newest first; see \fB\-\-time\fR +.TP +\fB\-T\fR, \fB\-\-tabsize\fR=\fI\,COLS\/\fR +assume tab stops at each COLS instead of 8 +.TP +\fB\-u\fR +with \fB\-lt\fR: sort by, and show, access time; +with \fB\-l\fR: show access time and sort by name; +otherwise: sort by access time, newest first +.TP +\fB\-U\fR +do not sort; list entries in directory order +.TP +\fB\-v\fR +natural sort of (version) numbers within text +.TP +\fB\-w\fR, \fB\-\-width\fR=\fI\,COLS\/\fR +set output width to COLS. 0 means no limit +.TP +\fB\-x\fR +list entries by lines instead of by columns +.TP +\fB\-X\fR +sort alphabetically by entry extension +.TP +\fB\-Z\fR, \fB\-\-context\fR +print any security context of each file +.TP +\fB\-\-zero\fR +end each output line with NUL, not newline +.TP +\fB\-1\fR +list one file per line +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.PP +The SIZE argument is an integer and optional unit (example: 10K is 10*1024). +Units are K,M,G,T,P,E,Z,Y,R,Q (powers of 1024) or KB,MB,... (powers of 1000). +Binary prefixes can be used, too: KiB=K, MiB=M, and so on. +.PP +The TIME_STYLE argument can be full\-iso, long\-iso, iso, locale, or +FORMAT. +FORMAT is interpreted like in \fBdate\fP(1). If FORMAT is FORMAT1<newline>FORMAT2, +then FORMAT1 applies to non\-recent files and FORMAT2 to recent files. +TIME_STYLE prefixed with 'posix\-' takes effect only outside the POSIX locale. +Also the TIME_STYLE environment variable sets the default style to use. +.PP +The WHEN argument defaults to 'always' and can also be 'auto' or 'never'. +.PP +Using color to distinguish file types is disabled both by default and +with \fB\-\-color\fR=\fI\,never\/\fR. With \fB\-\-color\fR=\fI\,auto\/\fR, ls emits color codes only when +standard output is connected to a terminal. The LS_COLORS environment +variable can change the settings. Use the \fBdircolors\fP(1) command to set it. +.SS "Exit status:" +.TP +0 +if OK, +.TP +1 +if minor problems (e.g., cannot access subdirectory), +.TP +2 +if serious trouble (e.g., cannot access command\-line argument). +.SH AUTHOR +Written by Richard M. Stallman and David MacKenzie. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +\fBdircolors\fP(1) +.PP +.br +Full documentation <https://www.gnu.org/software/coreutils/ls> +.br +or available locally via: info \(aq(coreutils) ls invocation\(aq diff --git a/man/ls.x b/man/ls.x new file mode 100644 index 0000000..83dd496 --- /dev/null +++ b/man/ls.x @@ -0,0 +1,6 @@ +[NAME] +ls \- list directory contents +[DESCRIPTION] +.\" Add any additional description here +[SEE ALSO] +dircolors(1) diff --git a/man/md5sum.1 b/man/md5sum.1 new file mode 100644 index 0000000..57a23e2 --- /dev/null +++ b/man/md5sum.1 @@ -0,0 +1,83 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH MD5SUM "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +md5sum \- compute and check MD5 message digest +.SH SYNOPSIS +.B md5sum +[\fI\,OPTION\/\fR]... [\fI\,FILE\/\fR]... +.SH DESCRIPTION +.\" Add any additional description here +.PP +Print or check MD5 (128\-bit) checksums. +.PP +With no FILE, or when FILE is \-, read standard input. +.TP +\fB\-b\fR, \fB\-\-binary\fR +read in binary mode +.TP +\fB\-c\fR, \fB\-\-check\fR +read checksums from the FILEs and check them +.TP +\fB\-\-tag\fR +create a BSD\-style checksum +.TP +\fB\-t\fR, \fB\-\-text\fR +read in text mode (default) +.TP +\fB\-z\fR, \fB\-\-zero\fR +end each output line with NUL, not newline, +and disable file name escaping +.SS "The following five options are useful only when verifying checksums:" +.TP +\fB\-\-ignore\-missing\fR +don't fail or report status for missing files +.TP +\fB\-\-quiet\fR +don't print OK for each successfully verified file +.TP +\fB\-\-status\fR +don't output anything, status code shows success +.TP +\fB\-\-strict\fR +exit non\-zero for improperly formatted checksum lines +.TP +\fB\-w\fR, \fB\-\-warn\fR +warn about improperly formatted checksum lines +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.PP +The sums are computed as described in RFC 1321. +When checking, the input should be a former output of this program. +The default mode is to print a line with: checksum, a space, +a character indicating input mode ('*' for binary, ' ' for text +or where binary is insignificant), and name for each FILE. +.PP +Note: There is no difference between binary mode and text mode on GNU systems. +.SH BUGS +Do not use the MD5 algorithm for security related purposes. +Instead, use an SHA\-2 algorithm, implemented in the programs +\fBsha224sum\fP(1), \fBsha256sum\fP(1), \fBsha384sum\fP(1), \fBsha512sum\fP(1), +or the BLAKE2 algorithm, implemented in \fBb2sum\fP(1) +.SH AUTHOR +Written by Ulrich Drepper, Scott Miller, and David Madore. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +\fBcksum\fP(1) +.PP +.br +Full documentation <https://www.gnu.org/software/coreutils/md5sum> +.br +or available locally via: info \(aq(coreutils) md5sum invocation\(aq diff --git a/man/md5sum.x b/man/md5sum.x new file mode 100644 index 0000000..3f4cc64 --- /dev/null +++ b/man/md5sum.x @@ -0,0 +1,11 @@ +[NAME] +md5sum \- compute and check MD5 message digest +[DESCRIPTION] +.\" Add any additional description here +[BUGS] +Do not use the MD5 algorithm for security related purposes. +Instead, use an SHA\-2 algorithm, implemented in the programs +sha224sum(1), sha256sum(1), sha384sum(1), sha512sum(1), +or the BLAKE2 algorithm, implemented in b2sum(1) +[SEE ALSO] +cksum(1) diff --git a/man/mkdir.1 b/man/mkdir.1 new file mode 100644 index 0000000..9c1d199 --- /dev/null +++ b/man/mkdir.1 @@ -0,0 +1,56 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH MKDIR "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +mkdir \- make directories +.SH SYNOPSIS +.B mkdir +[\fI\,OPTION\/\fR]... \fI\,DIRECTORY\/\fR... +.SH DESCRIPTION +.\" Add any additional description here +.PP +Create the DIRECTORY(ies), if they do not already exist. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\fB\-m\fR, \fB\-\-mode\fR=\fI\,MODE\/\fR +set file mode (as in chmod), not a=rwx \- umask +.TP +\fB\-p\fR, \fB\-\-parents\fR +no error if existing, make parent directories as needed, +with their file modes unaffected by any \fB\-m\fR option. +.TP +\fB\-v\fR, \fB\-\-verbose\fR +print a message for each created directory +.TP +\fB\-Z\fR +set SELinux security context of each created directory +to the default type +.TP +\fB\-\-context\fR[=\fI\,CTX\/\fR] +like \fB\-Z\fR, or if CTX is specified then set the SELinux +or SMACK security context to CTX +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.SH AUTHOR +Written by David MacKenzie. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +\fBmkdir\fP(2) +.PP +.br +Full documentation <https://www.gnu.org/software/coreutils/mkdir> +.br +or available locally via: info \(aq(coreutils) mkdir invocation\(aq diff --git a/man/mkdir.x b/man/mkdir.x new file mode 100644 index 0000000..4b35013 --- /dev/null +++ b/man/mkdir.x @@ -0,0 +1,6 @@ +[NAME] +mkdir \- make directories +[DESCRIPTION] +.\" Add any additional description here +[SEE ALSO] +mkdir(2) diff --git a/man/mkfifo.1 b/man/mkfifo.1 new file mode 100644 index 0000000..30f5372 --- /dev/null +++ b/man/mkfifo.1 @@ -0,0 +1,48 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH MKFIFO "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +mkfifo \- make FIFOs (named pipes) +.SH SYNOPSIS +.B mkfifo +[\fI\,OPTION\/\fR]... \fI\,NAME\/\fR... +.SH DESCRIPTION +.\" Add any additional description here +.PP +Create named pipes (FIFOs) with the given NAMEs. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\fB\-m\fR, \fB\-\-mode\fR=\fI\,MODE\/\fR +set file permission bits to MODE, not a=rw \- umask +.TP +\fB\-Z\fR +set the SELinux security context to default type +.TP +\fB\-\-context\fR[=\fI\,CTX\/\fR] +like \fB\-Z\fR, or if CTX is specified then set the SELinux +or SMACK security context to CTX +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.SH AUTHOR +Written by David MacKenzie. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +\fBmkfifo\fP(3) +.PP +.br +Full documentation <https://www.gnu.org/software/coreutils/mkfifo> +.br +or available locally via: info \(aq(coreutils) mkfifo invocation\(aq diff --git a/man/mkfifo.x b/man/mkfifo.x new file mode 100644 index 0000000..7d06348 --- /dev/null +++ b/man/mkfifo.x @@ -0,0 +1,6 @@ +[NAME] +mkfifo \- make FIFOs (named pipes) +[DESCRIPTION] +.\" Add any additional description here +[SEE ALSO] +mkfifo(3) diff --git a/man/mknod.1 b/man/mknod.1 new file mode 100644 index 0000000..172842d --- /dev/null +++ b/man/mknod.1 @@ -0,0 +1,66 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH MKNOD "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +mknod \- make block or character special files +.SH SYNOPSIS +.B mknod +[\fI\,OPTION\/\fR]... \fI\,NAME TYPE \/\fR[\fI\,MAJOR MINOR\/\fR] +.SH DESCRIPTION +.\" Add any additional description here +.PP +Create the special file NAME of the given TYPE. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\fB\-m\fR, \fB\-\-mode\fR=\fI\,MODE\/\fR +set file permission bits to MODE, not a=rw \- umask +.TP +\fB\-Z\fR +set the SELinux security context to default type +.TP +\fB\-\-context\fR[=\fI\,CTX\/\fR] +like \fB\-Z\fR, or if CTX is specified then set the SELinux +or SMACK security context to CTX +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.PP +Both MAJOR and MINOR must be specified when TYPE is b, c, or u, and they +must be omitted when TYPE is p. If MAJOR or MINOR begins with 0x or 0X, +it is interpreted as hexadecimal; otherwise, if it begins with 0, as octal; +otherwise, as decimal. TYPE may be: +.TP +b +create a block (buffered) special file +.TP +c, u +create a character (unbuffered) special file +.TP +p +create a FIFO +.PP +NOTE: your shell may have its own version of mknod, which usually supersedes +the version described here. Please refer to your shell's documentation +for details about the options it supports. +.SH AUTHOR +Written by David MacKenzie. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +\fBmknod\fP(2) +.PP +.br +Full documentation <https://www.gnu.org/software/coreutils/mknod> +.br +or available locally via: info \(aq(coreutils) mknod invocation\(aq diff --git a/man/mknod.x b/man/mknod.x new file mode 100644 index 0000000..aaa3a9a --- /dev/null +++ b/man/mknod.x @@ -0,0 +1,6 @@ +[NAME] +mknod \- make block or character special files +[DESCRIPTION] +.\" Add any additional description here +[SEE ALSO] +mknod(2) diff --git a/man/mktemp.1 b/man/mktemp.1 new file mode 100644 index 0000000..eca42ac --- /dev/null +++ b/man/mktemp.1 @@ -0,0 +1,64 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH MKTEMP "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +mktemp \- create a temporary file or directory +.SH SYNOPSIS +.B mktemp +[\fI\,OPTION\/\fR]... [\fI\,TEMPLATE\/\fR] +.SH DESCRIPTION +.\" Add any additional description here +.PP +Create a temporary file or directory, safely, and print its name. +TEMPLATE must contain at least 3 consecutive 'X's in last component. +If TEMPLATE is not specified, use tmp.XXXXXXXXXX, and \fB\-\-tmpdir\fR is implied. +Files are created u+rw, and directories u+rwx, minus umask restrictions. +.TP +\fB\-d\fR, \fB\-\-directory\fR +create a directory, not a file +.TP +\fB\-u\fR, \fB\-\-dry\-run\fR +do not create anything; merely print a name (unsafe) +.TP +\fB\-q\fR, \fB\-\-quiet\fR +suppress diagnostics about file/dir\-creation failure +.TP +\fB\-\-suffix\fR=\fI\,SUFF\/\fR +append SUFF to TEMPLATE; SUFF must not contain a slash. +This option is implied if TEMPLATE does not end in X +.TP +\fB\-p\fR DIR, \fB\-\-tmpdir\fR[=\fI\,DIR\/\fR] +interpret TEMPLATE relative to DIR; if DIR is not +specified, use $TMPDIR if set, else \fI\,/tmp\/\fP. With +this option, TEMPLATE must not be an absolute name; +unlike with \fB\-t\fR, TEMPLATE may contain slashes, but +mktemp creates only the final component +.TP +\fB\-t\fR +interpret TEMPLATE as a single file name component, +relative to a directory: $TMPDIR, if set; else the +directory specified via \fB\-p\fR; else \fI\,/tmp\/\fP [deprecated] +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.SH AUTHOR +Written by Jim Meyering and Eric Blake. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +\fBmkstemp\fP(3), \fBmkdtemp\fP(3), \fBmktemp\fP(3) +.PP +.br +Full documentation <https://www.gnu.org/software/coreutils/mktemp> +.br +or available locally via: info \(aq(coreutils) mktemp invocation\(aq diff --git a/man/mktemp.x b/man/mktemp.x new file mode 100644 index 0000000..393ca74 --- /dev/null +++ b/man/mktemp.x @@ -0,0 +1,6 @@ +[NAME] +mktemp \- create a temporary file or directory +[DESCRIPTION] +.\" Add any additional description here +[SEE ALSO] +mkstemp(3), mkdtemp(3), mktemp(3) diff --git a/man/mv.1 b/man/mv.1 new file mode 100644 index 0000000..21d2e4c --- /dev/null +++ b/man/mv.1 @@ -0,0 +1,118 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH MV "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +mv \- move (rename) files +.SH SYNOPSIS +.B mv +[\fI\,OPTION\/\fR]... [\fI\,-T\/\fR] \fI\,SOURCE DEST\/\fR +.br +.B mv +[\fI\,OPTION\/\fR]... \fI\,SOURCE\/\fR... \fI\,DIRECTORY\/\fR +.br +.B mv +[\fI\,OPTION\/\fR]... \fI\,-t DIRECTORY SOURCE\/\fR... +.SH DESCRIPTION +.\" Add any additional description here +.PP +Rename SOURCE to DEST, or move SOURCE(s) to DIRECTORY. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\fB\-\-backup\fR[=\fI\,CONTROL\/\fR] +make a backup of each existing destination file +.TP +\fB\-b\fR +like \fB\-\-backup\fR but does not accept an argument +.TP +\fB\-\-debug\fR +explain how a file is copied. Implies \fB\-v\fR +.TP +\fB\-f\fR, \fB\-\-force\fR +do not prompt before overwriting +.TP +\fB\-i\fR, \fB\-\-interactive\fR +prompt before overwrite +.TP +\fB\-n\fR, \fB\-\-no\-clobber\fR +do not overwrite an existing file +.PP +If you specify more than one of \fB\-i\fR, \fB\-f\fR, \fB\-n\fR, only the final one takes effect. +.TP +\fB\-\-no\-copy\fR +do not copy if renaming fails +.TP +\fB\-\-strip\-trailing\-slashes\fR +remove any trailing slashes from each SOURCE +argument +.TP +\fB\-S\fR, \fB\-\-suffix\fR=\fI\,SUFFIX\/\fR +override the usual backup suffix +.TP +\fB\-t\fR, \fB\-\-target\-directory\fR=\fI\,DIRECTORY\/\fR +move all SOURCE arguments into DIRECTORY +.TP +\fB\-T\fR, \fB\-\-no\-target\-directory\fR +treat DEST as a normal file +.TP +\fB\-\-update\fR[=\fI\,UPDATE\/\fR] +control which existing files are updated; +UPDATE={all,none,older(default)}. See below +.TP +\fB\-u\fR +equivalent to \fB\-\-update\fR[=\fI\,older\/\fR] +.TP +\fB\-v\fR, \fB\-\-verbose\fR +explain what is being done +.TP +\fB\-Z\fR, \fB\-\-context\fR +set SELinux security context of destination +file to default type +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.PP +UPDATE controls which existing files in the destination are replaced. +\&'all' is the default operation when an \fB\-\-update\fR option is not specified, +and results in all existing files in the destination being replaced. +\&'none' is similar to the \fB\-\-no\-clobber\fR option, in that no files in the +destination are replaced, but also skipped files do not induce a failure. +\&'older' is the default operation when \fB\-\-update\fR is specified, and results +in files being replaced if they're older than the corresponding source file. +.PP +The backup suffix is '~', unless set with \fB\-\-suffix\fR or SIMPLE_BACKUP_SUFFIX. +The version control method may be selected via the \fB\-\-backup\fR option or through +the VERSION_CONTROL environment variable. Here are the values: +.TP +none, off +never make backups (even if \fB\-\-backup\fR is given) +.TP +numbered, t +make numbered backups +.TP +existing, nil +numbered if numbered backups exist, simple otherwise +.TP +simple, never +always make simple backups +.SH AUTHOR +Written by Mike Parker, David MacKenzie, and Jim Meyering. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +\fBrename\fP(2) +.PP +.br +Full documentation <https://www.gnu.org/software/coreutils/mv> +.br +or available locally via: info \(aq(coreutils) mv invocation\(aq diff --git a/man/mv.x b/man/mv.x new file mode 100644 index 0000000..6e32d5d --- /dev/null +++ b/man/mv.x @@ -0,0 +1,6 @@ +[NAME] +mv \- move (rename) files +[DESCRIPTION] +.\" Add any additional description here +[SEE ALSO] +rename(2) diff --git a/man/nice.1 b/man/nice.1 new file mode 100644 index 0000000..2aa8a46 --- /dev/null +++ b/man/nice.1 @@ -0,0 +1,60 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH NICE "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +nice \- run a program with modified scheduling priority +.SH SYNOPSIS +.B nice +[\fI\,OPTION\/\fR] [\fI\,COMMAND \/\fR[\fI\,ARG\/\fR]...] +.SH DESCRIPTION +.\" Add any additional description here +.PP +Run COMMAND with an adjusted niceness, which affects process scheduling. +With no COMMAND, print the current niceness. Niceness values range from +\fB\-20\fR (most favorable to the process) to 19 (least favorable to the process). +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\fB\-n\fR, \fB\-\-adjustment\fR=\fI\,N\/\fR +add integer N to the niceness (default 10) +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.PP +NOTE: your shell may have its own version of nice, which usually supersedes +the version described here. Please refer to your shell's documentation +for details about the options it supports. +.SS "Exit status:" +.TP +125 +if the nice command itself fails +.TP +126 +if COMMAND is found but cannot be invoked +.TP +127 +if COMMAND cannot be found +.TP +\- +the exit status of COMMAND otherwise +.SH AUTHOR +Written by David MacKenzie. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +\fBnice\fP(2), \fBrenice\fP(1) +.PP +.br +Full documentation <https://www.gnu.org/software/coreutils/nice> +.br +or available locally via: info \(aq(coreutils) nice invocation\(aq diff --git a/man/nice.x b/man/nice.x new file mode 100644 index 0000000..952cb10 --- /dev/null +++ b/man/nice.x @@ -0,0 +1,6 @@ +[NAME] +nice \- run a program with modified scheduling priority +[DESCRIPTION] +.\" Add any additional description here +[SEE ALSO] +nice(2), renice(1) diff --git a/man/nl.1 b/man/nl.1 new file mode 100644 index 0000000..9da16e8 --- /dev/null +++ b/man/nl.1 @@ -0,0 +1,103 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH NL "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +nl \- number lines of files +.SH SYNOPSIS +.B nl +[\fI\,OPTION\/\fR]... [\fI\,FILE\/\fR]... +.SH DESCRIPTION +.\" Add any additional description here +.PP +Write each FILE to standard output, with line numbers added. +.PP +With no FILE, or when FILE is \-, read standard input. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\fB\-b\fR, \fB\-\-body\-numbering\fR=\fI\,STYLE\/\fR +use STYLE for numbering body lines +.TP +\fB\-d\fR, \fB\-\-section\-delimiter\fR=\fI\,CC\/\fR +use CC for logical page delimiters +.TP +\fB\-f\fR, \fB\-\-footer\-numbering\fR=\fI\,STYLE\/\fR +use STYLE for numbering footer lines +.TP +\fB\-h\fR, \fB\-\-header\-numbering\fR=\fI\,STYLE\/\fR +use STYLE for numbering header lines +.TP +\fB\-i\fR, \fB\-\-line\-increment\fR=\fI\,NUMBER\/\fR +line number increment at each line +.TP +\fB\-l\fR, \fB\-\-join\-blank\-lines\fR=\fI\,NUMBER\/\fR +group of NUMBER empty lines counted as one +.TP +\fB\-n\fR, \fB\-\-number\-format\fR=\fI\,FORMAT\/\fR +insert line numbers according to FORMAT +.TP +\fB\-p\fR, \fB\-\-no\-renumber\fR +do not reset line numbers for each section +.TP +\fB\-s\fR, \fB\-\-number\-separator\fR=\fI\,STRING\/\fR +add STRING after (possible) line number +.TP +\fB\-v\fR, \fB\-\-starting\-line\-number\fR=\fI\,NUMBER\/\fR +first line number for each section +.TP +\fB\-w\fR, \fB\-\-number\-width\fR=\fI\,NUMBER\/\fR +use NUMBER columns for line numbers +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.PP +Default options are: \fB\-bt\fR \fB\-d\fR'\e:' \fB\-fn\fR \fB\-hn\fR \fB\-i1\fR \fB\-l1\fR \fB\-n\fR'rn' \fB\-s\fR<TAB> \fB\-v1\fR \fB\-w6\fR +.PP +CC are two delimiter characters used to construct logical page delimiters; +a missing second character implies ':'. As a GNU extension one can specify +more than two characters, and also specifying the empty string (\fB\-d\fR '') +disables section matching. +.PP +STYLE is one of: +.TP +a +number all lines +.TP +t +number only nonempty lines +.TP +n +number no lines +.TP +pBRE +number only lines that contain a match for the basic regular +expression, BRE +.PP +FORMAT is one of: +.TP +ln +left justified, no leading zeros +.TP +rn +right justified, no leading zeros +.TP +rz +right justified, leading zeros +.SH AUTHOR +Written by Scott Bartram and David MacKenzie. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +Full documentation <https://www.gnu.org/software/coreutils/nl> +.br +or available locally via: info \(aq(coreutils) nl invocation\(aq diff --git a/man/nl.x b/man/nl.x new file mode 100644 index 0000000..cf9b648 --- /dev/null +++ b/man/nl.x @@ -0,0 +1,4 @@ +[NAME] +nl \- number lines of files +[DESCRIPTION] +.\" Add any additional description here diff --git a/man/nohup.1 b/man/nohup.1 new file mode 100644 index 0000000..6979264 --- /dev/null +++ b/man/nohup.1 @@ -0,0 +1,59 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH NOHUP "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +nohup \- run a command immune to hangups, with output to a non-tty +.SH SYNOPSIS +.B nohup +\fI\,COMMAND \/\fR[\fI\,ARG\/\fR]... +.br +.B nohup +\fI\,OPTION\/\fR +.SH DESCRIPTION +.\" Add any additional description here +.PP +Run COMMAND, ignoring hangup signals. +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.PP +If standard input is a terminal, redirect it from an unreadable file. +If standard output is a terminal, append output to 'nohup.out' if possible, +\&'$HOME/nohup.out' otherwise. +If standard error is a terminal, redirect it to standard output. +To save output to FILE, use 'nohup COMMAND > FILE'. +.PP +NOTE: your shell may have its own version of nohup, which usually supersedes +the version described here. Please refer to your shell's documentation +for details about the options it supports. +.SS "Exit status:" +.TP +125 +if the nohup command itself fails +.TP +126 +if COMMAND is found but cannot be invoked +.TP +127 +if COMMAND cannot be found +.TP +\- +the exit status of COMMAND otherwise +.SH AUTHOR +Written by Jim Meyering. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +Full documentation <https://www.gnu.org/software/coreutils/nohup> +.br +or available locally via: info \(aq(coreutils) nohup invocation\(aq diff --git a/man/nohup.x b/man/nohup.x new file mode 100644 index 0000000..dbb8fb8 --- /dev/null +++ b/man/nohup.x @@ -0,0 +1,4 @@ +[NAME] +nohup \- run a command immune to hangups, with output to a non-tty +[DESCRIPTION] +.\" Add any additional description here diff --git a/man/nproc.1 b/man/nproc.1 new file mode 100644 index 0000000..9194505 --- /dev/null +++ b/man/nproc.1 @@ -0,0 +1,40 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH NPROC "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +nproc \- print the number of processing units available +.SH SYNOPSIS +.B nproc +[\fI\,OPTION\/\fR]... +.SH DESCRIPTION +.\" Add any additional description here +.PP +Print the number of processing units available to the current process, +which may be less than the number of online processors +.TP +\fB\-\-all\fR +print the number of installed processors +.TP +\fB\-\-ignore\fR=\fI\,N\/\fR +if possible, exclude N processing units +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.SH AUTHOR +Written by Giuseppe Scrivano. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +Full documentation <https://www.gnu.org/software/coreutils/nproc> +.br +or available locally via: info \(aq(coreutils) nproc invocation\(aq diff --git a/man/nproc.x b/man/nproc.x new file mode 100644 index 0000000..870d6bd --- /dev/null +++ b/man/nproc.x @@ -0,0 +1,4 @@ +[NAME] +nproc \- print the number of processing units available +[DESCRIPTION] +.\" Add any additional description here diff --git a/man/numfmt.1 b/man/numfmt.1 new file mode 100644 index 0000000..785dcff --- /dev/null +++ b/man/numfmt.1 @@ -0,0 +1,185 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH NUMFMT "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +numfmt \- Convert numbers from/to human-readable strings +.SH SYNOPSIS +.B numfmt +[\fI\,OPTION\/\fR]... [\fI\,NUMBER\/\fR]... +.SH DESCRIPTION +.\" Add any additional description here +.PP +Reformat NUMBER(s), or the numbers from standard input if none are specified. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\fB\-\-debug\fR +print warnings about invalid input +.TP +\fB\-d\fR, \fB\-\-delimiter\fR=\fI\,X\/\fR +use X instead of whitespace for field delimiter +.TP +\fB\-\-field\fR=\fI\,FIELDS\/\fR +replace the numbers in these input fields (default=1); +see FIELDS below +.TP +\fB\-\-format\fR=\fI\,FORMAT\/\fR +use printf style floating\-point FORMAT; +see FORMAT below for details +.TP +\fB\-\-from\fR=\fI\,UNIT\/\fR +auto\-scale input numbers to UNITs; default is 'none'; +see UNIT below +.TP +\fB\-\-from\-unit\fR=\fI\,N\/\fR +specify the input unit size (instead of the default 1) +.TP +\fB\-\-grouping\fR +use locale\-defined grouping of digits, e.g. 1,000,000 +(which means it has no effect in the C/POSIX locale) +.TP +\fB\-\-header\fR[=\fI\,N\/\fR] +print (without converting) the first N header lines; +N defaults to 1 if not specified +.TP +\fB\-\-invalid\fR=\fI\,MODE\/\fR +failure mode for invalid numbers: MODE can be: +abort (default), fail, warn, ignore +.TP +\fB\-\-padding\fR=\fI\,N\/\fR +pad the output to N characters; positive N will +right\-align; negative N will left\-align; +padding is ignored if the output is wider than N; +the default is to automatically pad if a whitespace +is found +.TP +\fB\-\-round\fR=\fI\,METHOD\/\fR +use METHOD for rounding when scaling; METHOD can be: +up, down, from\-zero (default), towards\-zero, nearest +.TP +\fB\-\-suffix\fR=\fI\,SUFFIX\/\fR +add SUFFIX to output numbers, and accept optional +SUFFIX in input numbers +.TP +\fB\-\-to\fR=\fI\,UNIT\/\fR +auto\-scale output numbers to UNITs; see UNIT below +.TP +\fB\-\-to\-unit\fR=\fI\,N\/\fR +the output unit size (instead of the default 1) +.TP +\fB\-z\fR, \fB\-\-zero\-terminated\fR +line delimiter is NUL, not newline +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.SS "UNIT options:" +.TP +none +no auto\-scaling is done; suffixes will trigger an error +.TP +auto +accept optional single/two letter suffix: +.IP +1K = 1000, +1Ki = 1024, +1M = 1000000, +1Mi = 1048576, +.TP +si +accept optional single letter suffix: +.IP +1K = 1000, +1M = 1000000, +\&... +.TP +iec +accept optional single letter suffix: +.IP +1K = 1024, +1M = 1048576, +\&... +.TP +iec\-i +accept optional two\-letter suffix: +.IP +1Ki = 1024, +1Mi = 1048576, +\&... +.SS "FIELDS supports \fBcut\fP(1) style field ranges:" +.TP +N +N'th field, counted from 1 +.TP +N\- +from N'th field, to end of line +.TP +N\-M +from N'th to M'th field (inclusive) +.TP +\fB\-M\fR +from first to M'th field (inclusive) +.TP +\- +all fields +.PP +Multiple fields/ranges can be separated with commas +.PP +FORMAT must be suitable for printing one floating\-point argument '%f'. +Optional quote (%'f) will enable \fB\-\-grouping\fR (if supported by current locale). +Optional width value (%10f) will pad output. Optional zero (%010f) width +will zero pad the number. Optional negative values (%\-10f) will left align. +Optional precision (%.1f) will override the input determined precision. +.PP +Exit status is 0 if all input numbers were successfully converted. +By default, numfmt will stop at the first conversion error with exit status 2. +With \fB\-\-invalid=\fR'fail' a warning is printed for each conversion error +and the exit status is 2. With \fB\-\-invalid=\fR'warn' each conversion error is +diagnosed, but the exit status is 0. With \fB\-\-invalid=\fR'ignore' conversion +errors are not diagnosed and the exit status is 0. +.SH EXAMPLES +.IP +\f(CW$ numfmt --to=si 1000\fR +.IP +\-> "1.0K" +.IP +\f(CW$ numfmt --to=iec 2048\fR +.IP +\-> "2.0K" +.IP +\f(CW$ numfmt --to=iec-i 4096\fR +.IP +\-> "4.0Ki" +.IP +\f(CW$ echo 1K | numfmt --from=si\fR +.IP +\-> "1000" +.IP +\f(CW$ echo 1K | numfmt --from=iec\fR +.IP +\-> "1024" +.IP +\f(CW$ df -B1 | numfmt --header --field 2-4 --to=si\fR +.br +\f(CW$ ls -l | numfmt --header --field 5 --to=iec\fR +.br +\f(CW$ ls -lh | numfmt --header --field 5 --from=iec --padding=10\fR +.br +\f(CW$ ls -lh | numfmt --header --field 5 --from=iec --format %10f\fR +.SH AUTHOR +Written by Assaf Gordon. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +Full documentation <https://www.gnu.org/software/coreutils/numfmt> +.br +or available locally via: info \(aq(coreutils) numfmt invocation\(aq diff --git a/man/numfmt.x b/man/numfmt.x new file mode 100644 index 0000000..6deaff1 --- /dev/null +++ b/man/numfmt.x @@ -0,0 +1,4 @@ +[NAME] +numfmt \- Convert numbers from/to human-readable strings +[DESCRIPTION] +.\" Add any additional description here diff --git a/man/od.1 b/man/od.1 new file mode 100644 index 0000000..3497120 --- /dev/null +++ b/man/od.1 @@ -0,0 +1,169 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH OD "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +od \- dump files in octal and other formats +.SH SYNOPSIS +.B od +[\fI\,OPTION\/\fR]... [\fI\,FILE\/\fR]... +.br +.B od +[\fI\,-abcdfilosx\/\fR]... [\fI\,FILE\/\fR] [[\fI\,+\/\fR]\fI\,OFFSET\/\fR[\fI\,.\/\fR][\fI\,b\/\fR]] +.br +.B od +\fI\,--traditional \/\fR[\fI\,OPTION\/\fR]... [\fI\,FILE\/\fR] [[\fI\,+\/\fR]\fI\,OFFSET\/\fR[\fI\,.\/\fR][\fI\,b\/\fR] [\fI\,+\/\fR][\fI\,LABEL\/\fR][\fI\,.\/\fR][\fI\,b\/\fR]] +.SH DESCRIPTION +.\" Add any additional description here +.PP +Write an unambiguous representation, octal bytes by default, +of FILE to standard output. With more than one FILE argument, +concatenate them in the listed order to form the input. +.PP +With no FILE, or when FILE is \-, read standard input. +.PP +If first and second call formats both apply, the second format is assumed +if the last operand begins with + or (if there are 2 operands) a digit. +An OFFSET operand means \fB\-j\fR OFFSET. LABEL is the pseudo\-address +at first byte printed, incremented when dump is progressing. +For OFFSET and LABEL, a 0x or 0X prefix indicates hexadecimal; +suffixes may be . for octal and b for multiply by 512. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\fB\-A\fR, \fB\-\-address\-radix\fR=\fI\,RADIX\/\fR +output format for file offsets; RADIX is one +of [doxn], for Decimal, Octal, Hex or None +.TP +\fB\-\-endian=\fR{big|little} +swap input bytes according the specified order +.TP +\fB\-j\fR, \fB\-\-skip\-bytes\fR=\fI\,BYTES\/\fR +skip BYTES input bytes first +.TP +\fB\-N\fR, \fB\-\-read\-bytes\fR=\fI\,BYTES\/\fR +limit dump to BYTES input bytes +.TP +\fB\-S\fR BYTES, \fB\-\-strings\fR[=\fI\,BYTES\/\fR] +show only NUL terminated strings +of at least BYTES (3) printable characters +.TP +\fB\-t\fR, \fB\-\-format\fR=\fI\,TYPE\/\fR +select output format or formats +.TP +\fB\-v\fR, \fB\-\-output\-duplicates\fR +do not use * to mark line suppression +.TP +\fB\-w[BYTES]\fR, \fB\-\-width\fR[=\fI\,BYTES\/\fR] +output BYTES bytes per output line; +32 is implied when BYTES is not specified +.TP +\fB\-\-traditional\fR +accept arguments in third form above +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.SS "Traditional format specifications may be intermixed; they accumulate:" +.TP +\fB\-a\fR +same as \fB\-t\fR a, select named characters, ignoring high\-order bit +.TP +\fB\-b\fR +same as \fB\-t\fR o1, select octal bytes +.TP +\fB\-c\fR +same as \fB\-t\fR c, select printable characters or backslash escapes +.TP +\fB\-d\fR +same as \fB\-t\fR u2, select unsigned decimal 2\-byte units +.TP +\fB\-f\fR +same as \fB\-t\fR fF, select floats +.TP +\fB\-i\fR +same as \fB\-t\fR dI, select decimal ints +.TP +\fB\-l\fR +same as \fB\-t\fR dL, select decimal longs +.TP +\fB\-o\fR +same as \fB\-t\fR o2, select octal 2\-byte units +.TP +\fB\-s\fR +same as \fB\-t\fR d2, select decimal 2\-byte units +.TP +\fB\-x\fR +same as \fB\-t\fR x2, select hexadecimal 2\-byte units +.SS "TYPE is made up of one or more of these specifications:" +.TP +a +named character, ignoring high\-order bit +.TP +c +printable character or backslash escape +.TP +d[SIZE] +signed decimal, SIZE bytes per integer +.TP +f[SIZE] +floating point, SIZE bytes per float +.TP +o[SIZE] +octal, SIZE bytes per integer +.TP +u[SIZE] +unsigned decimal, SIZE bytes per integer +.TP +x[SIZE] +hexadecimal, SIZE bytes per integer +.PP +SIZE is a number. For TYPE in [doux], SIZE may also be C for +sizeof(char), S for sizeof(short), I for sizeof(int) or L for +sizeof(long). If TYPE is f, SIZE may also be F for sizeof(float), D +for sizeof(double) or L for sizeof(long double). +.PP +Adding a z suffix to any type displays printable characters at the end of +each output line. +.SS "BYTES is hex with 0x or 0X prefix, and may have a multiplier suffix:" +.TP +b +512 +.TP +KB +1000 +.TP +K +1024 +.TP +MB +1000*1000 +.TP +M +1024*1024 +.PP +and so on for G, T, P, E, Z, Y, R, Q. +Binary prefixes can be used, too: KiB=K, MiB=M, and so on. +.SH EXAMPLES +.TP +.B od -A x -t x1z -v +Display hexdump format output +.TP +.B od -A o -t oS -w16 +The default output format used by od +.SH AUTHOR +Written by Jim Meyering. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +Full documentation <https://www.gnu.org/software/coreutils/od> +.br +or available locally via: info \(aq(coreutils) od invocation\(aq diff --git a/man/od.x b/man/od.x new file mode 100644 index 0000000..c3382d2 --- /dev/null +++ b/man/od.x @@ -0,0 +1,11 @@ +[NAME] +od \- dump files in octal and other formats +[DESCRIPTION] +.\" Add any additional description here +[EXAMPLES] +.TP +.B od -A x -t x1z -v +Display hexdump format output +.TP +.B od -A o -t oS -w16 +The default output format used by od diff --git a/man/paste.1 b/man/paste.1 new file mode 100644 index 0000000..88dd09f --- /dev/null +++ b/man/paste.1 @@ -0,0 +1,47 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH PASTE "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +paste \- merge lines of files +.SH SYNOPSIS +.B paste +[\fI\,OPTION\/\fR]... [\fI\,FILE\/\fR]... +.SH DESCRIPTION +.\" Add any additional description here +.PP +Write lines consisting of the sequentially corresponding lines from +each FILE, separated by TABs, to standard output. +.PP +With no FILE, or when FILE is \-, read standard input. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\fB\-d\fR, \fB\-\-delimiters\fR=\fI\,LIST\/\fR +reuse characters from LIST instead of TABs +.TP +\fB\-s\fR, \fB\-\-serial\fR +paste one file at a time instead of in parallel +.TP +\fB\-z\fR, \fB\-\-zero\-terminated\fR +line delimiter is NUL, not newline +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.SH AUTHOR +Written by David M. Ihnat and David MacKenzie. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +Full documentation <https://www.gnu.org/software/coreutils/paste> +.br +or available locally via: info \(aq(coreutils) paste invocation\(aq diff --git a/man/paste.x b/man/paste.x new file mode 100644 index 0000000..0af980d --- /dev/null +++ b/man/paste.x @@ -0,0 +1,4 @@ +[NAME] +paste \- merge lines of files +[DESCRIPTION] +.\" Add any additional description here diff --git a/man/pathchk.1 b/man/pathchk.1 new file mode 100644 index 0000000..92d723b --- /dev/null +++ b/man/pathchk.1 @@ -0,0 +1,42 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH PATHCHK "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +pathchk \- check whether file names are valid or portable +.SH SYNOPSIS +.B pathchk +[\fI\,OPTION\/\fR]... \fI\,NAME\/\fR... +.SH DESCRIPTION +.\" Add any additional description here +.PP +Diagnose invalid or non\-portable file names. +.TP +\fB\-p\fR +check for most POSIX systems +.TP +\fB\-P\fR +check for empty names and leading "\-" +.TP +\fB\-\-portability\fR +check for all POSIX systems (equivalent to \fB\-p\fR \fB\-P\fR) +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.SH AUTHOR +Written by Paul Eggert, David MacKenzie, and Jim Meyering. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +Full documentation <https://www.gnu.org/software/coreutils/pathchk> +.br +or available locally via: info \(aq(coreutils) pathchk invocation\(aq diff --git a/man/pathchk.x b/man/pathchk.x new file mode 100644 index 0000000..ad8f09f --- /dev/null +++ b/man/pathchk.x @@ -0,0 +1,4 @@ +[NAME] +pathchk \- check whether file names are valid or portable +[DESCRIPTION] +.\" Add any additional description here diff --git a/man/pinky.1 b/man/pinky.1 new file mode 100644 index 0000000..0d4a597 --- /dev/null +++ b/man/pinky.1 @@ -0,0 +1,62 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH PINKY "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +pinky \- lightweight finger +.SH SYNOPSIS +.B pinky +[\fI\,OPTION\/\fR]... [\fI\,USER\/\fR]... +.SH DESCRIPTION +.\" Add any additional description here +.TP +\fB\-l\fR +produce long format output for the specified USERs +.TP +\fB\-b\fR +omit the user's home directory and shell in long format +.TP +\fB\-h\fR +omit the user's project file in long format +.TP +\fB\-p\fR +omit the user's plan file in long format +.TP +\fB\-s\fR +do short format output, this is the default +.TP +\fB\-f\fR +omit the line of column headings in short format +.TP +\fB\-w\fR +omit the user's full name in short format +.TP +\fB\-i\fR +omit the user's full name and remote host in short format +.TP +\fB\-q\fR +omit the user's full name, remote host and idle time +in short format +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.PP +A lightweight 'finger' program; print user information. +The utmp file will be \fI\,/var/run/utmp\/\fP. +.SH AUTHOR +Written by Joseph Arceneaux, David MacKenzie, and Kaveh Ghazi. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +Full documentation <https://www.gnu.org/software/coreutils/pinky> +.br +or available locally via: info \(aq(coreutils) pinky invocation\(aq diff --git a/man/pinky.x b/man/pinky.x new file mode 100644 index 0000000..91cdb43 --- /dev/null +++ b/man/pinky.x @@ -0,0 +1,4 @@ +[NAME] +pinky \- lightweight finger +[DESCRIPTION] +.\" Add any additional description here diff --git a/man/pr.1 b/man/pr.1 new file mode 100644 index 0000000..2ccdbba --- /dev/null +++ b/man/pr.1 @@ -0,0 +1,132 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH PR "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +pr \- convert text files for printing +.SH SYNOPSIS +.B pr +[\fI\,OPTION\/\fR]... [\fI\,FILE\/\fR]... +.SH DESCRIPTION +.\" Add any additional description here +.PP +Paginate or columnate FILE(s) for printing. +.PP +With no FILE, or when FILE is \-, read standard input. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP ++FIRST_PAGE[:LAST_PAGE], \fB\-\-pages\fR=\fI\,FIRST_PAGE[\/\fR:LAST_PAGE] +begin [stop] printing with page FIRST_[LAST_]PAGE +.TP +\fB\-COLUMN\fR, \fB\-\-columns\fR=\fI\,COLUMN\/\fR +output COLUMN columns and print columns down, +unless \fB\-a\fR is used. Balance number of lines in the +columns on each page +.TP +\fB\-a\fR, \fB\-\-across\fR +print columns across rather than down, used together +with \fB\-COLUMN\fR +.TP +\fB\-c\fR, \fB\-\-show\-control\-chars\fR +use hat notation (^G) and octal backslash notation +.TP +\fB\-d\fR, \fB\-\-double\-space\fR +double space the output +.TP +\fB\-D\fR, \fB\-\-date\-format\fR=\fI\,FORMAT\/\fR +use FORMAT for the header date +.TP +\fB\-e[CHAR[WIDTH]]\fR, \fB\-\-expand\-tabs\fR[=\fI\,CHAR[WIDTH]\/\fR] +expand input CHARs (TABs) to tab WIDTH (8) +.TP +\fB\-F\fR, \fB\-f\fR, \fB\-\-form\-feed\fR +use form feeds instead of newlines to separate pages +(by a 3\-line page header with \fB\-F\fR or a 5\-line header +and trailer without \fB\-F\fR) +.TP +\fB\-h\fR, \fB\-\-header\fR=\fI\,HEADER\/\fR +use a centered HEADER instead of filename in page header, +\fB\-h\fR "" prints a blank line, don't use \fB\-h\fR"" +.TP +\fB\-i[CHAR[WIDTH]]\fR, \fB\-\-output\-tabs\fR[=\fI\,CHAR[WIDTH]\/\fR] +replace spaces with CHARs (TABs) to tab WIDTH (8) +.TP +\fB\-J\fR, \fB\-\-join\-lines\fR +merge full lines, turns off \fB\-W\fR line truncation, no column +alignment, \fB\-\-sep\-string\fR[=\fI\,STRING\/\fR] sets separators +.TP +\fB\-l\fR, \fB\-\-length\fR=\fI\,PAGE_LENGTH\/\fR +set the page length to PAGE_LENGTH (66) lines +(default number of lines of text 56, and with \fB\-F\fR 63). +implies \fB\-t\fR if PAGE_LENGTH <= 10 +.TP +\fB\-m\fR, \fB\-\-merge\fR +print all files in parallel, one in each column, +truncate lines, but join lines of full length with \fB\-J\fR +.TP +\fB\-n[SEP[DIGITS]]\fR, \fB\-\-number\-lines\fR[=\fI\,SEP[DIGITS]\/\fR] +number lines, use DIGITS (5) digits, then SEP (TAB), +default counting starts with 1st line of input file +.TP +\fB\-N\fR, \fB\-\-first\-line\-number\fR=\fI\,NUMBER\/\fR +start counting with NUMBER at 1st line of first +page printed (see +FIRST_PAGE) +.TP +\fB\-o\fR, \fB\-\-indent\fR=\fI\,MARGIN\/\fR +offset each line with MARGIN (zero) spaces, do not +affect \fB\-w\fR or \fB\-W\fR, MARGIN will be added to PAGE_WIDTH +.TP +\fB\-r\fR, \fB\-\-no\-file\-warnings\fR +omit warning when a file cannot be opened +.TP +\fB\-s[CHAR]\fR, \fB\-\-separator\fR[=\fI\,CHAR\/\fR] +separate columns by a single character, default for CHAR +is the <TAB> character without \fB\-w\fR and 'no char' with \fB\-w\fR. +\fB\-s[CHAR]\fR turns off line truncation of all 3 column +options (\fB\-COLUMN\fR|\-a \fB\-COLUMN\fR|\-m) except \fB\-w\fR is set +.TP +\fB\-S[STRING]\fR, \fB\-\-sep\-string\fR[=\fI\,STRING\/\fR] +separate columns by STRING, +without \fB\-S\fR: Default separator <TAB> with \fB\-J\fR and <space> +otherwise (same as \fB\-S\fR" "), no effect on column options +.TP +\fB\-t\fR, \fB\-\-omit\-header\fR +omit page headers and trailers; +implied if PAGE_LENGTH <= 10 +.TP +\fB\-T\fR, \fB\-\-omit\-pagination\fR +omit page headers and trailers, eliminate any pagination +by form feeds set in input files +.TP +\fB\-v\fR, \fB\-\-show\-nonprinting\fR +use octal backslash notation +.TP +\fB\-w\fR, \fB\-\-width\fR=\fI\,PAGE_WIDTH\/\fR +set page width to PAGE_WIDTH (72) characters for +multiple text\-column output only, \fB\-s[char]\fR turns off (72) +.TP +\fB\-W\fR, \fB\-\-page\-width\fR=\fI\,PAGE_WIDTH\/\fR +set page width to PAGE_WIDTH (72) characters always, +truncate lines, except \fB\-J\fR option is set, no interference +with \fB\-S\fR or \fB\-s\fR +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.SH AUTHOR +Written by Pete TerMaat and Roland Huebner. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +Full documentation <https://www.gnu.org/software/coreutils/pr> +.br +or available locally via: info \(aq(coreutils) pr invocation\(aq diff --git a/man/pr.x b/man/pr.x new file mode 100644 index 0000000..4dd836d --- /dev/null +++ b/man/pr.x @@ -0,0 +1,4 @@ +[NAME] +pr \- convert text files for printing +[DESCRIPTION] +.\" Add any additional description here diff --git a/man/printenv.1 b/man/printenv.1 new file mode 100644 index 0000000..b9ce876 --- /dev/null +++ b/man/printenv.1 @@ -0,0 +1,41 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH PRINTENV "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +printenv \- print all or part of environment +.SH SYNOPSIS +.B printenv +[\fI\,OPTION\/\fR]... [\fI\,VARIABLE\/\fR]... +.SH DESCRIPTION +.\" Add any additional description here +.PP +Print the values of the specified environment VARIABLE(s). +If no VARIABLE is specified, print name and value pairs for them all. +.TP +\fB\-0\fR, \fB\-\-null\fR +end each output line with NUL, not newline +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.PP +NOTE: your shell may have its own version of printenv, which usually supersedes +the version described here. Please refer to your shell's documentation +for details about the options it supports. +.SH AUTHOR +Written by David MacKenzie and Richard Mlynarik. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +Full documentation <https://www.gnu.org/software/coreutils/printenv> +.br +or available locally via: info \(aq(coreutils) printenv invocation\(aq diff --git a/man/printenv.x b/man/printenv.x new file mode 100644 index 0000000..7445226 --- /dev/null +++ b/man/printenv.x @@ -0,0 +1,4 @@ +[NAME] +printenv \- print all or part of environment +[DESCRIPTION] +.\" Add any additional description here diff --git a/man/printf.1 b/man/printf.1 new file mode 100644 index 0000000..f73d1c3 --- /dev/null +++ b/man/printf.1 @@ -0,0 +1,104 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH PRINTF "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +printf \- format and print data +.SH SYNOPSIS +.B printf +\fI\,FORMAT \/\fR[\fI\,ARGUMENT\/\fR]... +.br +.B printf +\fI\,OPTION\/\fR +.SH DESCRIPTION +.\" Add any additional description here +.PP +Print ARGUMENT(s) according to FORMAT, or execute according to OPTION: +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.PP +FORMAT controls the output as in C printf. Interpreted sequences are: +.TP +\e" +double quote +.TP +\e\e +backslash +.TP +\ea +alert (BEL) +.TP +\eb +backspace +.TP +\ec +produce no further output +.TP +\ee +escape +.TP +\ef +form feed +.TP +\en +new line +.TP +\er +carriage return +.TP +\et +horizontal tab +.TP +\ev +vertical tab +.TP +\eNNN +byte with octal value NNN (1 to 3 digits) +.TP +\exHH +byte with hexadecimal value HH (1 to 2 digits) +.TP +\euHHHH +Unicode (ISO/IEC 10646) character with hex value HHHH (4 digits) +.TP +\eUHHHHHHHH +Unicode character with hex value HHHHHHHH (8 digits) +.TP +%% +a single % +.TP +%b +ARGUMENT as a string with '\e' escapes interpreted, +except that octal escapes are of the form \e0 or \e0NNN +.TP +%q +ARGUMENT is printed in a format that can be reused as shell input, +escaping non\-printable characters with the proposed POSIX $'' syntax. +.PP +and all C format specifications ending with one of diouxXfeEgGcs, with +ARGUMENTs converted to proper type first. Variable widths are handled. +.PP +NOTE: your shell may have its own version of printf, which usually supersedes +the version described here. Please refer to your shell's documentation +for details about the options it supports. +.SH AUTHOR +Written by David MacKenzie. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +\fBprintf\fP(3) +.PP +.br +Full documentation <https://www.gnu.org/software/coreutils/printf> +.br +or available locally via: info \(aq(coreutils) printf invocation\(aq diff --git a/man/printf.x b/man/printf.x new file mode 100644 index 0000000..22fc5af --- /dev/null +++ b/man/printf.x @@ -0,0 +1,6 @@ +[NAME] +printf \- format and print data +[DESCRIPTION] +.\" Add any additional description here +[SEE ALSO] +printf(3) diff --git a/man/ptx.1 b/man/ptx.1 new file mode 100644 index 0000000..76c3ac2 --- /dev/null +++ b/man/ptx.1 @@ -0,0 +1,91 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH PTX "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +ptx \- produce a permuted index of file contents +.SH SYNOPSIS +.B ptx +[\fI\,OPTION\/\fR]... [\fI\,INPUT\/\fR]... \fI\,(without -G)\/\fR +.br +.B ptx +\fI\,-G \/\fR[\fI\,OPTION\/\fR]... [\fI\,INPUT \/\fR[\fI\,OUTPUT\/\fR]] +.SH DESCRIPTION +.\" Add any additional description here +.PP +Output a permuted index, including context, of the words in the input files. +.PP +With no FILE, or when FILE is \-, read standard input. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\fB\-A\fR, \fB\-\-auto\-reference\fR +output automatically generated references +.TP +\fB\-G\fR, \fB\-\-traditional\fR +behave more like System V 'ptx' +.TP +\fB\-F\fR, \fB\-\-flag\-truncation\fR=\fI\,STRING\/\fR +use STRING for flagging line truncations. +The default is '/' +.TP +\fB\-M\fR, \fB\-\-macro\-name\fR=\fI\,STRING\/\fR +macro name to use instead of 'xx' +.TP +\fB\-O\fR, \fB\-\-format\fR=\fI\,roff\/\fR +generate output as roff directives +.TP +\fB\-R\fR, \fB\-\-right\-side\-refs\fR +put references at right, not counted in \fB\-w\fR +.TP +\fB\-S\fR, \fB\-\-sentence\-regexp\fR=\fI\,REGEXP\/\fR +for end of lines or end of sentences +.TP +\fB\-T\fR, \fB\-\-format\fR=\fI\,tex\/\fR +generate output as TeX directives +.TP +\fB\-W\fR, \fB\-\-word\-regexp\fR=\fI\,REGEXP\/\fR +use REGEXP to match each keyword +.TP +\fB\-b\fR, \fB\-\-break\-file\fR=\fI\,FILE\/\fR +word break characters in this FILE +.TP +\fB\-f\fR, \fB\-\-ignore\-case\fR +fold lower case to upper case for sorting +.TP +\fB\-g\fR, \fB\-\-gap\-size\fR=\fI\,NUMBER\/\fR +gap size in columns between output fields +.TP +\fB\-i\fR, \fB\-\-ignore\-file\fR=\fI\,FILE\/\fR +read ignore word list from FILE +.TP +\fB\-o\fR, \fB\-\-only\-file\fR=\fI\,FILE\/\fR +read only word list from this FILE +.TP +\fB\-r\fR, \fB\-\-references\fR +first field of each line is a reference +.HP +\fB\-t\fR, \fB\-\-typeset\-mode\fR \- not implemented \- +.TP +\fB\-w\fR, \fB\-\-width\fR=\fI\,NUMBER\/\fR +output width in columns, reference excluded +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.SH AUTHOR +Written by F. Pinard. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +Full documentation <https://www.gnu.org/software/coreutils/ptx> +.br +or available locally via: info \(aq(coreutils) ptx invocation\(aq diff --git a/man/ptx.x b/man/ptx.x new file mode 100644 index 0000000..af37770 --- /dev/null +++ b/man/ptx.x @@ -0,0 +1,4 @@ +[NAME] +ptx \- produce a permuted index of file contents +[DESCRIPTION] +.\" Add any additional description here diff --git a/man/pwd.1 b/man/pwd.1 new file mode 100644 index 0000000..a2e1cbf --- /dev/null +++ b/man/pwd.1 @@ -0,0 +1,48 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH PWD "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +pwd \- print name of current/working directory +.SH SYNOPSIS +.B pwd +[\fI\,OPTION\/\fR]... +.SH DESCRIPTION +.\" Add any additional description here +.PP +Print the full filename of the current working directory. +.TP +\fB\-L\fR, \fB\-\-logical\fR +use PWD from environment, even if it contains symlinks +.TP +\fB\-P\fR, \fB\-\-physical\fR +avoid all symlinks +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.PP +If no option is specified, \fB\-P\fR is assumed. +.PP +NOTE: your shell may have its own version of pwd, which usually supersedes +the version described here. Please refer to your shell's documentation +for details about the options it supports. +.SH AUTHOR +Written by Jim Meyering. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +\fBgetcwd\fP(3) +.PP +.br +Full documentation <https://www.gnu.org/software/coreutils/pwd> +.br +or available locally via: info \(aq(coreutils) pwd invocation\(aq diff --git a/man/pwd.x b/man/pwd.x new file mode 100644 index 0000000..65daec0 --- /dev/null +++ b/man/pwd.x @@ -0,0 +1,6 @@ +[NAME] +pwd \- print name of current/working directory +[DESCRIPTION] +.\" Add any additional description here +[SEE ALSO] +getcwd(3) diff --git a/man/readlink.1 b/man/readlink.1 new file mode 100644 index 0000000..5ed05fb --- /dev/null +++ b/man/readlink.1 @@ -0,0 +1,67 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH READLINK "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +readlink \- print resolved symbolic links or canonical file names +.SH SYNOPSIS +.B readlink +[\fI\,OPTION\/\fR]... \fI\,FILE\/\fR... +.SH DESCRIPTION +.\" Add any additional description here +Note \fBrealpath\fP(1) is the preferred command to use +for canonicalization functionality. +.PP +Print value of a symbolic link or canonical file name +.TP +\fB\-f\fR, \fB\-\-canonicalize\fR +canonicalize by following every symlink in +every component of the given name recursively; +all but the last component must exist +.TP +\fB\-e\fR, \fB\-\-canonicalize\-existing\fR +canonicalize by following every symlink in +every component of the given name recursively, +all components must exist +.TP +\fB\-m\fR, \fB\-\-canonicalize\-missing\fR +canonicalize by following every symlink in +every component of the given name recursively, +without requirements on components existence +.TP +\fB\-n\fR, \fB\-\-no\-newline\fR +do not output the trailing delimiter +.HP +\fB\-q\fR, \fB\-\-quiet\fR +.TP +\fB\-s\fR, \fB\-\-silent\fR +suppress most error messages (on by default) +.TP +\fB\-v\fR, \fB\-\-verbose\fR +report error messages +.TP +\fB\-z\fR, \fB\-\-zero\fR +end each output line with NUL, not newline +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.SH AUTHOR +Written by Dmitry V. Levin. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +\fBreadlink\fP(2), \fBrealpath\fP(1), \fBrealpath\fP(3) +.PP +.br +Full documentation <https://www.gnu.org/software/coreutils/readlink> +.br +or available locally via: info \(aq(coreutils) readlink invocation\(aq diff --git a/man/readlink.x b/man/readlink.x new file mode 100644 index 0000000..3141cd2 --- /dev/null +++ b/man/readlink.x @@ -0,0 +1,8 @@ +[NAME] +readlink \- print resolved symbolic links or canonical file names +[DESCRIPTION] +.\" Add any additional description here +Note realpath(1) is the preferred command to use +for canonicalization functionality. +[SEE ALSO] +readlink(2), realpath(1), realpath(3) diff --git a/man/realpath.1 b/man/realpath.1 new file mode 100644 index 0000000..152955f --- /dev/null +++ b/man/realpath.1 @@ -0,0 +1,64 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH REALPATH "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +realpath \- print the resolved path +.SH SYNOPSIS +.B realpath +[\fI\,OPTION\/\fR]... \fI\,FILE\/\fR... +.SH DESCRIPTION +.\" Add any additional description here +.PP +Print the resolved absolute file name; +all but the last component must exist +.TP +\fB\-e\fR, \fB\-\-canonicalize\-existing\fR +all components of the path must exist +.TP +\fB\-m\fR, \fB\-\-canonicalize\-missing\fR +no path components need exist or be a directory +.TP +\fB\-L\fR, \fB\-\-logical\fR +resolve '..' components before symlinks +.TP +\fB\-P\fR, \fB\-\-physical\fR +resolve symlinks as encountered (default) +.TP +\fB\-q\fR, \fB\-\-quiet\fR +suppress most error messages +.TP +\fB\-\-relative\-to\fR=\fI\,DIR\/\fR +print the resolved path relative to DIR +.TP +\fB\-\-relative\-base\fR=\fI\,DIR\/\fR +print absolute paths unless paths below DIR +.TP +\fB\-s\fR, \fB\-\-strip\fR, \fB\-\-no\-symlinks\fR +don't expand symlinks +.TP +\fB\-z\fR, \fB\-\-zero\fR +end each output line with NUL, not newline +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.SH AUTHOR +Written by Padraig Brady. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +\fBreadlink\fP(1), \fBreadlink\fP(2), \fBrealpath\fP(3) +.PP +.br +Full documentation <https://www.gnu.org/software/coreutils/realpath> +.br +or available locally via: info \(aq(coreutils) realpath invocation\(aq diff --git a/man/realpath.x b/man/realpath.x new file mode 100644 index 0000000..a52fa25 --- /dev/null +++ b/man/realpath.x @@ -0,0 +1,6 @@ +[NAME] +realpath \- print the resolved path +[DESCRIPTION] +.\" Add any additional description here +[SEE ALSO] +readlink(1), readlink(2), realpath(3) diff --git a/man/rm.1 b/man/rm.1 new file mode 100644 index 0000000..97788d5 --- /dev/null +++ b/man/rm.1 @@ -0,0 +1,108 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH RM "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +rm \- remove files or directories +.SH SYNOPSIS +.B rm +[\fI\,OPTION\/\fR]... [\fI\,FILE\/\fR]... +.SH DESCRIPTION +This manual page +documents the GNU version of +.BR rm . +.B rm +removes each specified file. By default, it does not remove +directories. +.P +If the \fI\-I\fR or \fI\-\-interactive=once\fR option is given, +and there are more than three files or the \fI\-r\fR, \fI\-R\fR, +or \fI\-\-recursive\fR are given, then +.B rm +prompts the user for whether to proceed with the entire operation. If +the response is not affirmative, the entire command is aborted. +.P +Otherwise, if a file is unwritable, standard input is a terminal, and +the \fI\-f\fR or \fI\-\-force\fR option is not given, or the +\fI\-i\fR or \fI\-\-interactive=always\fR option is given, +.B rm +prompts the user for whether to remove the file. If the response is +not affirmative, the file is skipped. +.SH OPTIONS +.PP +Remove (unlink) the FILE(s). +.TP +\fB\-f\fR, \fB\-\-force\fR +ignore nonexistent files and arguments, never prompt +.TP +\fB\-i\fR +prompt before every removal +.TP +\fB\-I\fR +prompt once before removing more than three files, or +when removing recursively; less intrusive than \fB\-i\fR, +while still giving protection against most mistakes +.TP +\fB\-\-interactive\fR[=\fI\,WHEN\/\fR] +prompt according to WHEN: never, once (\fB\-I\fR), or +always (\fB\-i\fR); without WHEN, prompt always +.TP +\fB\-\-one\-file\-system\fR +when removing a hierarchy recursively, skip any +directory that is on a file system different from +that of the corresponding command line argument +.TP +\fB\-\-no\-preserve\-root\fR +do not treat '/' specially +.TP +\fB\-\-preserve\-root\fR[=\fI\,all\/\fR] +do not remove '/' (default); +with 'all', reject any command line argument +on a separate device from its parent +.TP +\fB\-r\fR, \fB\-R\fR, \fB\-\-recursive\fR +remove directories and their contents recursively +.TP +\fB\-d\fR, \fB\-\-dir\fR +remove empty directories +.TP +\fB\-v\fR, \fB\-\-verbose\fR +explain what is being done +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.PP +By default, rm does not remove directories. Use the \fB\-\-recursive\fR (\fB\-r\fR or \fB\-R\fR) +option to remove each listed directory, too, along with all of its contents. +.PP +To remove a file whose name starts with a '\-', for example '\-foo', +use one of these commands: +.IP +rm \fB\-\-\fR \fB\-foo\fR +.IP +rm ./\-foo +.PP +Note that if you use rm to remove a file, it might be possible to recover +some of its contents, given sufficient expertise and/or time. For greater +assurance that the contents are truly unrecoverable, consider using \fBshred\fP(1). +.SH AUTHOR +Written by Paul Rubin, David MacKenzie, Richard M. Stallman, +and Jim Meyering. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +\fBunlink\fP(1), \fBunlink\fP(2), \fBchattr\fP(1), \fBshred\fP(1) +.PP +.br +Full documentation <https://www.gnu.org/software/coreutils/rm> +.br +or available locally via: info \(aq(coreutils) rm invocation\(aq diff --git a/man/rm.x b/man/rm.x new file mode 100644 index 0000000..6087faf --- /dev/null +++ b/man/rm.x @@ -0,0 +1,31 @@ +'\" Copyright (C) 1998-2023 Free Software Foundation, Inc. +'\" +'\" This is free software. You may redistribute copies of it under the terms +'\" of the GNU General Public License <https://www.gnu.org/licenses/gpl.html>. +'\" There is NO WARRANTY, to the extent permitted by law. +[NAME] +rm \- remove files or directories +[DESCRIPTION] +This manual page +documents the GNU version of +.BR rm . +.B rm +removes each specified file. By default, it does not remove +directories. +.P +If the \fI\-I\fR or \fI\-\-interactive=once\fR option is given, +and there are more than three files or the \fI\-r\fR, \fI\-R\fR, +or \fI\-\-recursive\fR are given, then +.B rm +prompts the user for whether to proceed with the entire operation. If +the response is not affirmative, the entire command is aborted. +.P +Otherwise, if a file is unwritable, standard input is a terminal, and +the \fI\-f\fR or \fI\-\-force\fR option is not given, or the +\fI\-i\fR or \fI\-\-interactive=always\fR option is given, +.B rm +prompts the user for whether to remove the file. If the response is +not affirmative, the file is skipped. +.SH OPTIONS +[SEE ALSO] +unlink(1), unlink(2), chattr(1), shred(1) diff --git a/man/rmdir.1 b/man/rmdir.1 new file mode 100644 index 0000000..2b1722b --- /dev/null +++ b/man/rmdir.1 @@ -0,0 +1,46 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH RMDIR "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +rmdir \- remove empty directories +.SH SYNOPSIS +.B rmdir +[\fI\,OPTION\/\fR]... \fI\,DIRECTORY\/\fR... +.SH DESCRIPTION +.\" Add any additional description here +.PP +Remove the DIRECTORY(ies), if they are empty. +.TP +\fB\-\-ignore\-fail\-on\-non\-empty\fR +ignore each failure to remove a non\-empty directory +.TP +\fB\-p\fR, \fB\-\-parents\fR +remove DIRECTORY and its ancestors; +e.g., 'rmdir \fB\-p\fR a/b' is similar to 'rmdir a/b a' +.TP +\fB\-v\fR, \fB\-\-verbose\fR +output a diagnostic for every directory processed +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.SH AUTHOR +Written by David MacKenzie. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +\fBrmdir\fP(2) +.PP +.br +Full documentation <https://www.gnu.org/software/coreutils/rmdir> +.br +or available locally via: info \(aq(coreutils) rmdir invocation\(aq diff --git a/man/rmdir.x b/man/rmdir.x new file mode 100644 index 0000000..a612f83 --- /dev/null +++ b/man/rmdir.x @@ -0,0 +1,6 @@ +[NAME] +rmdir \- remove empty directories +[DESCRIPTION] +.\" Add any additional description here +[SEE ALSO] +rmdir(2) diff --git a/man/runcon.1 b/man/runcon.1 new file mode 100644 index 0000000..8380026 --- /dev/null +++ b/man/runcon.1 @@ -0,0 +1,80 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH RUNCON "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +runcon \- run command with specified security context +.SH SYNOPSIS +.B runcon +\fI\,CONTEXT COMMAND \/\fR[\fI\,args\/\fR] +.br +.B runcon +[ \fI\,-c \/\fR] [\fI\,-u USER\/\fR] [\fI\,-r ROLE\/\fR] [\fI\,-t TYPE\/\fR] [\fI\,-l RANGE\/\fR] \fI\,COMMAND \/\fR[\fI\,args\/\fR] +.SH DESCRIPTION +Run COMMAND with completely-specified CONTEXT, or with current or +transitioned security context modified by one or more of LEVEL, +ROLE, TYPE, and USER. +.PP +If none of \fI-c\fR, \fI-t\fR, \fI-u\fR, \fI-r\fR, or \fI-l\fR, is specified, +the first argument is used as the complete context. Any additional +arguments after \fICOMMAND\fR are interpreted as arguments to the +command. +.PP +Note that only carefully-chosen contexts are likely to successfully +run. +.PP +Run a program in a different SELinux security context. +With neither CONTEXT nor COMMAND, print the current security context. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +CONTEXT +Complete security context +.TP +\fB\-c\fR, \fB\-\-compute\fR +compute process transition context before modifying +.TP +\fB\-t\fR, \fB\-\-type\fR=\fI\,TYPE\/\fR +type (for same role as parent) +.TP +\fB\-u\fR, \fB\-\-user\fR=\fI\,USER\/\fR +user identity +.TP +\fB\-r\fR, \fB\-\-role\fR=\fI\,ROLE\/\fR +role +.TP +\fB\-l\fR, \fB\-\-range\fR=\fI\,RANGE\/\fR +levelrange +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.SS "Exit status:" +.TP +125 +if the runcon command itself fails +.TP +126 +if COMMAND is found but cannot be invoked +.TP +127 +if COMMAND cannot be found +.TP +\- +the exit status of COMMAND otherwise +.SH AUTHOR +Written by Russell Coker. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +Full documentation <https://www.gnu.org/software/coreutils/runcon> +.br +or available locally via: info \(aq(coreutils) runcon invocation\(aq diff --git a/man/runcon.x b/man/runcon.x new file mode 100644 index 0000000..d2df13e --- /dev/null +++ b/man/runcon.x @@ -0,0 +1,14 @@ +[NAME] +runcon \- run command with specified security context +[DESCRIPTION] +Run COMMAND with completely-specified CONTEXT, or with current or +transitioned security context modified by one or more of LEVEL, +ROLE, TYPE, and USER. +.PP +If none of \fI-c\fR, \fI-t\fR, \fI-u\fR, \fI-r\fR, or \fI-l\fR, is specified, +the first argument is used as the complete context. Any additional +arguments after \fICOMMAND\fR are interpreted as arguments to the +command. +.PP +Note that only carefully-chosen contexts are likely to successfully +run. diff --git a/man/seq.1 b/man/seq.1 new file mode 100644 index 0000000..f9f65c5 --- /dev/null +++ b/man/seq.1 @@ -0,0 +1,62 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH SEQ "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +seq \- print a sequence of numbers +.SH SYNOPSIS +.B seq +[\fI\,OPTION\/\fR]... \fI\,LAST\/\fR +.br +.B seq +[\fI\,OPTION\/\fR]... \fI\,FIRST LAST\/\fR +.br +.B seq +[\fI\,OPTION\/\fR]... \fI\,FIRST INCREMENT LAST\/\fR +.SH DESCRIPTION +.\" Add any additional description here +.PP +Print numbers from FIRST to LAST, in steps of INCREMENT. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\fB\-f\fR, \fB\-\-format\fR=\fI\,FORMAT\/\fR +use printf style floating\-point FORMAT +.TP +\fB\-s\fR, \fB\-\-separator\fR=\fI\,STRING\/\fR +use STRING to separate numbers (default: \en) +.TP +\fB\-w\fR, \fB\-\-equal\-width\fR +equalize width by padding with leading zeroes +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.PP +If FIRST or INCREMENT is omitted, it defaults to 1. That is, an +omitted INCREMENT defaults to 1 even when LAST is smaller than FIRST. +The sequence of numbers ends when the sum of the current number and +INCREMENT would become greater than LAST. +FIRST, INCREMENT, and LAST are interpreted as floating point values. +INCREMENT is usually positive if FIRST is smaller than LAST, and +INCREMENT is usually negative if FIRST is greater than LAST. +INCREMENT must not be 0; none of FIRST, INCREMENT and LAST may be NaN. +FORMAT must be suitable for printing one argument of type 'double'; +it defaults to %.PRECf if FIRST, INCREMENT, and LAST are all fixed point +decimal numbers with maximum precision PREC, and to %g otherwise. +.SH AUTHOR +Written by Ulrich Drepper. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +Full documentation <https://www.gnu.org/software/coreutils/seq> +.br +or available locally via: info \(aq(coreutils) seq invocation\(aq diff --git a/man/seq.x b/man/seq.x new file mode 100644 index 0000000..df7f98c --- /dev/null +++ b/man/seq.x @@ -0,0 +1,4 @@ +[NAME] +seq \- print a sequence of numbers +[DESCRIPTION] +.\" Add any additional description here diff --git a/man/sha1sum.1 b/man/sha1sum.1 new file mode 100644 index 0000000..d399b14 --- /dev/null +++ b/man/sha1sum.1 @@ -0,0 +1,83 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH SHA1SUM "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +sha1sum \- compute and check SHA1 message digest +.SH SYNOPSIS +.B sha1sum +[\fI\,OPTION\/\fR]... [\fI\,FILE\/\fR]... +.SH DESCRIPTION +.\" Add any additional description here +.PP +Print or check SHA1 (160\-bit) checksums. +.PP +With no FILE, or when FILE is \-, read standard input. +.TP +\fB\-b\fR, \fB\-\-binary\fR +read in binary mode +.TP +\fB\-c\fR, \fB\-\-check\fR +read checksums from the FILEs and check them +.TP +\fB\-\-tag\fR +create a BSD\-style checksum +.TP +\fB\-t\fR, \fB\-\-text\fR +read in text mode (default) +.TP +\fB\-z\fR, \fB\-\-zero\fR +end each output line with NUL, not newline, +and disable file name escaping +.SS "The following five options are useful only when verifying checksums:" +.TP +\fB\-\-ignore\-missing\fR +don't fail or report status for missing files +.TP +\fB\-\-quiet\fR +don't print OK for each successfully verified file +.TP +\fB\-\-status\fR +don't output anything, status code shows success +.TP +\fB\-\-strict\fR +exit non\-zero for improperly formatted checksum lines +.TP +\fB\-w\fR, \fB\-\-warn\fR +warn about improperly formatted checksum lines +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.PP +The sums are computed as described in FIPS\-180\-1. +When checking, the input should be a former output of this program. +The default mode is to print a line with: checksum, a space, +a character indicating input mode ('*' for binary, ' ' for text +or where binary is insignificant), and name for each FILE. +.PP +Note: There is no difference between binary mode and text mode on GNU systems. +.SH BUGS +Do not use the SHA-1 algorithm for security related purposes. +Instead, use an SHA\-2 algorithm, implemented in the programs +\fBsha224sum\fP(1), \fBsha256sum\fP(1), \fBsha384sum\fP(1), \fBsha512sum\fP(1), +or the BLAKE2 algorithm, implemented in \fBb2sum\fP(1) +.SH AUTHOR +Written by Ulrich Drepper, Scott Miller, and David Madore. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +\fBcksum\fP(1) +.PP +.br +Full documentation <https://www.gnu.org/software/coreutils/sha1sum> +.br +or available locally via: info \(aq(coreutils) sha1sum invocation\(aq diff --git a/man/sha1sum.x b/man/sha1sum.x new file mode 100644 index 0000000..8fd824f --- /dev/null +++ b/man/sha1sum.x @@ -0,0 +1,11 @@ +[NAME] +sha1sum \- compute and check SHA1 message digest +[DESCRIPTION] +.\" Add any additional description here +[BUGS] +Do not use the SHA-1 algorithm for security related purposes. +Instead, use an SHA\-2 algorithm, implemented in the programs +sha224sum(1), sha256sum(1), sha384sum(1), sha512sum(1), +or the BLAKE2 algorithm, implemented in b2sum(1) +[SEE ALSO] +cksum(1) diff --git a/man/sha224sum.1 b/man/sha224sum.1 new file mode 100644 index 0000000..3c0afe1 --- /dev/null +++ b/man/sha224sum.1 @@ -0,0 +1,78 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH SHA224SUM "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +sha224sum \- compute and check SHA224 message digest +.SH SYNOPSIS +.B sha224sum +[\fI\,OPTION\/\fR]... [\fI\,FILE\/\fR]... +.SH DESCRIPTION +.\" Add any additional description here +.PP +Print or check SHA224 (224\-bit) checksums. +.PP +With no FILE, or when FILE is \-, read standard input. +.TP +\fB\-b\fR, \fB\-\-binary\fR +read in binary mode +.TP +\fB\-c\fR, \fB\-\-check\fR +read checksums from the FILEs and check them +.TP +\fB\-\-tag\fR +create a BSD\-style checksum +.TP +\fB\-t\fR, \fB\-\-text\fR +read in text mode (default) +.TP +\fB\-z\fR, \fB\-\-zero\fR +end each output line with NUL, not newline, +and disable file name escaping +.SS "The following five options are useful only when verifying checksums:" +.TP +\fB\-\-ignore\-missing\fR +don't fail or report status for missing files +.TP +\fB\-\-quiet\fR +don't print OK for each successfully verified file +.TP +\fB\-\-status\fR +don't output anything, status code shows success +.TP +\fB\-\-strict\fR +exit non\-zero for improperly formatted checksum lines +.TP +\fB\-w\fR, \fB\-\-warn\fR +warn about improperly formatted checksum lines +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.PP +The sums are computed as described in RFC 3874. +When checking, the input should be a former output of this program. +The default mode is to print a line with: checksum, a space, +a character indicating input mode ('*' for binary, ' ' for text +or where binary is insignificant), and name for each FILE. +.PP +Note: There is no difference between binary mode and text mode on GNU systems. +.SH AUTHOR +Written by Ulrich Drepper, Scott Miller, and David Madore. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +\fBcksum\fP(1) +.PP +.br +Full documentation <https://www.gnu.org/software/coreutils/sha224sum> +.br +or available locally via: info \(aq(coreutils) sha2 utilities\(aq diff --git a/man/sha224sum.x b/man/sha224sum.x new file mode 100644 index 0000000..38a64d2 --- /dev/null +++ b/man/sha224sum.x @@ -0,0 +1,6 @@ +[NAME] +sha224sum \- compute and check SHA224 message digest +[DESCRIPTION] +.\" Add any additional description here +[SEE ALSO] +cksum(1) diff --git a/man/sha256sum.1 b/man/sha256sum.1 new file mode 100644 index 0000000..0c846c1 --- /dev/null +++ b/man/sha256sum.1 @@ -0,0 +1,78 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH SHA256SUM "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +sha256sum \- compute and check SHA256 message digest +.SH SYNOPSIS +.B sha256sum +[\fI\,OPTION\/\fR]... [\fI\,FILE\/\fR]... +.SH DESCRIPTION +.\" Add any additional description here +.PP +Print or check SHA256 (256\-bit) checksums. +.PP +With no FILE, or when FILE is \-, read standard input. +.TP +\fB\-b\fR, \fB\-\-binary\fR +read in binary mode +.TP +\fB\-c\fR, \fB\-\-check\fR +read checksums from the FILEs and check them +.TP +\fB\-\-tag\fR +create a BSD\-style checksum +.TP +\fB\-t\fR, \fB\-\-text\fR +read in text mode (default) +.TP +\fB\-z\fR, \fB\-\-zero\fR +end each output line with NUL, not newline, +and disable file name escaping +.SS "The following five options are useful only when verifying checksums:" +.TP +\fB\-\-ignore\-missing\fR +don't fail or report status for missing files +.TP +\fB\-\-quiet\fR +don't print OK for each successfully verified file +.TP +\fB\-\-status\fR +don't output anything, status code shows success +.TP +\fB\-\-strict\fR +exit non\-zero for improperly formatted checksum lines +.TP +\fB\-w\fR, \fB\-\-warn\fR +warn about improperly formatted checksum lines +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.PP +The sums are computed as described in FIPS\-180\-2. +When checking, the input should be a former output of this program. +The default mode is to print a line with: checksum, a space, +a character indicating input mode ('*' for binary, ' ' for text +or where binary is insignificant), and name for each FILE. +.PP +Note: There is no difference between binary mode and text mode on GNU systems. +.SH AUTHOR +Written by Ulrich Drepper, Scott Miller, and David Madore. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +\fBcksum\fP(1) +.PP +.br +Full documentation <https://www.gnu.org/software/coreutils/sha256sum> +.br +or available locally via: info \(aq(coreutils) sha2 utilities\(aq diff --git a/man/sha256sum.x b/man/sha256sum.x new file mode 100644 index 0000000..4ad8b35 --- /dev/null +++ b/man/sha256sum.x @@ -0,0 +1,6 @@ +[NAME] +sha256sum \- compute and check SHA256 message digest +[DESCRIPTION] +.\" Add any additional description here +[SEE ALSO] +cksum(1) diff --git a/man/sha384sum.1 b/man/sha384sum.1 new file mode 100644 index 0000000..d3f6c5e --- /dev/null +++ b/man/sha384sum.1 @@ -0,0 +1,78 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH SHA384SUM "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +sha384sum \- compute and check SHA384 message digest +.SH SYNOPSIS +.B sha384sum +[\fI\,OPTION\/\fR]... [\fI\,FILE\/\fR]... +.SH DESCRIPTION +.\" Add any additional description here +.PP +Print or check SHA384 (384\-bit) checksums. +.PP +With no FILE, or when FILE is \-, read standard input. +.TP +\fB\-b\fR, \fB\-\-binary\fR +read in binary mode +.TP +\fB\-c\fR, \fB\-\-check\fR +read checksums from the FILEs and check them +.TP +\fB\-\-tag\fR +create a BSD\-style checksum +.TP +\fB\-t\fR, \fB\-\-text\fR +read in text mode (default) +.TP +\fB\-z\fR, \fB\-\-zero\fR +end each output line with NUL, not newline, +and disable file name escaping +.SS "The following five options are useful only when verifying checksums:" +.TP +\fB\-\-ignore\-missing\fR +don't fail or report status for missing files +.TP +\fB\-\-quiet\fR +don't print OK for each successfully verified file +.TP +\fB\-\-status\fR +don't output anything, status code shows success +.TP +\fB\-\-strict\fR +exit non\-zero for improperly formatted checksum lines +.TP +\fB\-w\fR, \fB\-\-warn\fR +warn about improperly formatted checksum lines +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.PP +The sums are computed as described in FIPS\-180\-2. +When checking, the input should be a former output of this program. +The default mode is to print a line with: checksum, a space, +a character indicating input mode ('*' for binary, ' ' for text +or where binary is insignificant), and name for each FILE. +.PP +Note: There is no difference between binary mode and text mode on GNU systems. +.SH AUTHOR +Written by Ulrich Drepper, Scott Miller, and David Madore. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +\fBcksum\fP(1) +.PP +.br +Full documentation <https://www.gnu.org/software/coreutils/sha384sum> +.br +or available locally via: info \(aq(coreutils) sha2 utilities\(aq diff --git a/man/sha384sum.x b/man/sha384sum.x new file mode 100644 index 0000000..a8c09cd --- /dev/null +++ b/man/sha384sum.x @@ -0,0 +1,6 @@ +[NAME] +sha384sum \- compute and check SHA384 message digest +[DESCRIPTION] +.\" Add any additional description here +[SEE ALSO] +cksum(1) diff --git a/man/sha512sum.1 b/man/sha512sum.1 new file mode 100644 index 0000000..c1a00e9 --- /dev/null +++ b/man/sha512sum.1 @@ -0,0 +1,78 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH SHA512SUM "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +sha512sum \- compute and check SHA512 message digest +.SH SYNOPSIS +.B sha512sum +[\fI\,OPTION\/\fR]... [\fI\,FILE\/\fR]... +.SH DESCRIPTION +.\" Add any additional description here +.PP +Print or check SHA512 (512\-bit) checksums. +.PP +With no FILE, or when FILE is \-, read standard input. +.TP +\fB\-b\fR, \fB\-\-binary\fR +read in binary mode +.TP +\fB\-c\fR, \fB\-\-check\fR +read checksums from the FILEs and check them +.TP +\fB\-\-tag\fR +create a BSD\-style checksum +.TP +\fB\-t\fR, \fB\-\-text\fR +read in text mode (default) +.TP +\fB\-z\fR, \fB\-\-zero\fR +end each output line with NUL, not newline, +and disable file name escaping +.SS "The following five options are useful only when verifying checksums:" +.TP +\fB\-\-ignore\-missing\fR +don't fail or report status for missing files +.TP +\fB\-\-quiet\fR +don't print OK for each successfully verified file +.TP +\fB\-\-status\fR +don't output anything, status code shows success +.TP +\fB\-\-strict\fR +exit non\-zero for improperly formatted checksum lines +.TP +\fB\-w\fR, \fB\-\-warn\fR +warn about improperly formatted checksum lines +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.PP +The sums are computed as described in FIPS\-180\-2. +When checking, the input should be a former output of this program. +The default mode is to print a line with: checksum, a space, +a character indicating input mode ('*' for binary, ' ' for text +or where binary is insignificant), and name for each FILE. +.PP +Note: There is no difference between binary mode and text mode on GNU systems. +.SH AUTHOR +Written by Ulrich Drepper, Scott Miller, and David Madore. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +\fBcksum\fP(1) +.PP +.br +Full documentation <https://www.gnu.org/software/coreutils/sha512sum> +.br +or available locally via: info \(aq(coreutils) sha2 utilities\(aq diff --git a/man/sha512sum.x b/man/sha512sum.x new file mode 100644 index 0000000..308bf51 --- /dev/null +++ b/man/sha512sum.x @@ -0,0 +1,6 @@ +[NAME] +sha512sum \- compute and check SHA512 message digest +[DESCRIPTION] +.\" Add any additional description here +[SEE ALSO] +cksum(1) diff --git a/man/shred.1 b/man/shred.1 new file mode 100644 index 0000000..11cf550 --- /dev/null +++ b/man/shred.1 @@ -0,0 +1,81 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH SHRED "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +shred \- overwrite a file to hide its contents, and optionally delete it +.SH SYNOPSIS +.B shred +[\fI\,OPTION\/\fR]... \fI\,FILE\/\fR... +.SH DESCRIPTION +.\" Add any additional description here +.PP +Overwrite the specified FILE(s) repeatedly, in order to make it harder +for even very expensive hardware probing to recover the data. +.PP +If FILE is \-, shred standard output. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\fB\-f\fR, \fB\-\-force\fR +change permissions to allow writing if necessary +.TP +\fB\-n\fR, \fB\-\-iterations\fR=\fI\,N\/\fR +overwrite N times instead of the default (3) +.TP +\fB\-\-random\-source\fR=\fI\,FILE\/\fR +get random bytes from FILE +.TP +\fB\-s\fR, \fB\-\-size\fR=\fI\,N\/\fR +shred this many bytes (suffixes like K, M, G accepted) +.TP +\fB\-u\fR +deallocate and remove file after overwriting +.TP +\fB\-\-remove\fR[=\fI\,HOW\/\fR] +like \fB\-u\fR but give control on HOW to delete; See below +.TP +\fB\-v\fR, \fB\-\-verbose\fR +show progress +.TP +\fB\-x\fR, \fB\-\-exact\fR +do not round file sizes up to the next full block; +.IP +this is the default for non\-regular files +.TP +\fB\-z\fR, \fB\-\-zero\fR +add a final overwrite with zeros to hide shredding +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.PP +Delete FILE(s) if \fB\-\-remove\fR (\fB\-u\fR) is specified. The default is not to remove +the files because it is common to operate on device files like \fI\,/dev/hda\/\fP, +and those files usually should not be removed. +The optional HOW parameter indicates how to remove a directory entry: +\&'unlink' => use a standard unlink call. +\&'wipe' => also first obfuscate bytes in the name. +\&'wipesync' => also sync each obfuscated byte to the device. +The default mode is 'wipesync', but note it can be expensive. +.PP +CAUTION: shred assumes the file system and hardware overwrite data in place. +Although this is common, many platforms operate otherwise. Also, backups +and mirrors may contain unremovable copies that will let a shredded file +be recovered later. See the GNU coreutils manual for details. +.SH AUTHOR +Written by Colin Plumb. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +Full documentation <https://www.gnu.org/software/coreutils/shred> +.br +or available locally via: info \(aq(coreutils) shred invocation\(aq diff --git a/man/shred.x b/man/shred.x new file mode 100644 index 0000000..5e22616 --- /dev/null +++ b/man/shred.x @@ -0,0 +1,4 @@ +[NAME] +shred \- overwrite a file to hide its contents, and optionally delete it +[DESCRIPTION] +.\" Add any additional description here diff --git a/man/shuf.1 b/man/shuf.1 new file mode 100644 index 0000000..42ed599 --- /dev/null +++ b/man/shuf.1 @@ -0,0 +1,64 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH SHUF "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +shuf \- generate random permutations +.SH SYNOPSIS +.B shuf +[\fI\,OPTION\/\fR]... [\fI\,FILE\/\fR] +.br +.B shuf +\fI\,-e \/\fR[\fI\,OPTION\/\fR]... [\fI\,ARG\/\fR]... +.br +.B shuf +\fI\,-i LO-HI \/\fR[\fI\,OPTION\/\fR]... +.SH DESCRIPTION +.\" Add any additional description here +.PP +Write a random permutation of the input lines to standard output. +.PP +With no FILE, or when FILE is \-, read standard input. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\fB\-e\fR, \fB\-\-echo\fR +treat each ARG as an input line +.TP +\fB\-i\fR, \fB\-\-input\-range\fR=\fI\,LO\-HI\/\fR +treat each number LO through HI as an input line +.TP +\fB\-n\fR, \fB\-\-head\-count\fR=\fI\,COUNT\/\fR +output at most COUNT lines +.TP +\fB\-o\fR, \fB\-\-output\fR=\fI\,FILE\/\fR +write result to FILE instead of standard output +.TP +\fB\-\-random\-source\fR=\fI\,FILE\/\fR +get random bytes from FILE +.TP +\fB\-r\fR, \fB\-\-repeat\fR +output lines can be repeated +.TP +\fB\-z\fR, \fB\-\-zero\-terminated\fR +line delimiter is NUL, not newline +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.SH AUTHOR +Written by Paul Eggert. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +Full documentation <https://www.gnu.org/software/coreutils/shuf> +.br +or available locally via: info \(aq(coreutils) shuf invocation\(aq diff --git a/man/shuf.x b/man/shuf.x new file mode 100644 index 0000000..bda519f --- /dev/null +++ b/man/shuf.x @@ -0,0 +1,4 @@ +[NAME] +shuf \- generate random permutations +[DESCRIPTION] +.\" Add any additional description here diff --git a/man/sleep.1 b/man/sleep.1 new file mode 100644 index 0000000..3cfa44f --- /dev/null +++ b/man/sleep.1 @@ -0,0 +1,42 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH SLEEP "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +sleep \- delay for a specified amount of time +.SH SYNOPSIS +.B sleep +\fI\,NUMBER\/\fR[\fI\,SUFFIX\/\fR]... +.br +.B sleep +\fI\,OPTION\/\fR +.SH DESCRIPTION +.\" Add any additional description here +.PP +Pause for NUMBER seconds. SUFFIX may be 's' for seconds (the default), +\&'m' for minutes, 'h' for hours or 'd' for days. NUMBER need not be an +integer. Given two or more arguments, pause for the amount of time +specified by the sum of their values. +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.SH AUTHOR +Written by Jim Meyering and Paul Eggert. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +\fBsleep\fP(3) +.PP +.br +Full documentation <https://www.gnu.org/software/coreutils/sleep> +.br +or available locally via: info \(aq(coreutils) sleep invocation\(aq diff --git a/man/sleep.x b/man/sleep.x new file mode 100644 index 0000000..f1343e8 --- /dev/null +++ b/man/sleep.x @@ -0,0 +1,6 @@ +[NAME] +sleep \- delay for a specified amount of time +[DESCRIPTION] +.\" Add any additional description here +[SEE ALSO] +sleep(3) diff --git a/man/sort.1 b/man/sort.1 new file mode 100644 index 0000000..01d3e99 --- /dev/null +++ b/man/sort.1 @@ -0,0 +1,158 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH SORT "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +sort \- sort lines of text files +.SH SYNOPSIS +.B sort +[\fI\,OPTION\/\fR]... [\fI\,FILE\/\fR]... +.br +.B sort +[\fI\,OPTION\/\fR]... \fI\,--files0-from=F\/\fR +.SH DESCRIPTION +.\" Add any additional description here +.PP +Write sorted concatenation of all FILE(s) to standard output. +.PP +With no FILE, or when FILE is \-, read standard input. +.PP +Mandatory arguments to long options are mandatory for short options too. +Ordering options: +.TP +\fB\-b\fR, \fB\-\-ignore\-leading\-blanks\fR +ignore leading blanks +.TP +\fB\-d\fR, \fB\-\-dictionary\-order\fR +consider only blanks and alphanumeric characters +.TP +\fB\-f\fR, \fB\-\-ignore\-case\fR +fold lower case to upper case characters +.TP +\fB\-g\fR, \fB\-\-general\-numeric\-sort\fR +compare according to general numerical value +.TP +\fB\-i\fR, \fB\-\-ignore\-nonprinting\fR +consider only printable characters +.TP +\fB\-M\fR, \fB\-\-month\-sort\fR +compare (unknown) < 'JAN' < ... < 'DEC' +.TP +\fB\-h\fR, \fB\-\-human\-numeric\-sort\fR +compare human readable numbers (e.g., 2K 1G) +.TP +\fB\-n\fR, \fB\-\-numeric\-sort\fR +compare according to string numerical value +.TP +\fB\-R\fR, \fB\-\-random\-sort\fR +shuffle, but group identical keys. See \fBshuf\fP(1) +.TP +\fB\-\-random\-source\fR=\fI\,FILE\/\fR +get random bytes from FILE +.TP +\fB\-r\fR, \fB\-\-reverse\fR +reverse the result of comparisons +.TP +\fB\-\-sort\fR=\fI\,WORD\/\fR +sort according to WORD: +general\-numeric \fB\-g\fR, human\-numeric \fB\-h\fR, month \fB\-M\fR, +numeric \fB\-n\fR, random \fB\-R\fR, version \fB\-V\fR +.TP +\fB\-V\fR, \fB\-\-version\-sort\fR +natural sort of (version) numbers within text +.PP +Other options: +.TP +\fB\-\-batch\-size\fR=\fI\,NMERGE\/\fR +merge at most NMERGE inputs at once; +for more use temp files +.TP +\fB\-c\fR, \fB\-\-check\fR, \fB\-\-check\fR=\fI\,diagnose\-first\/\fR +check for sorted input; do not sort +.TP +\fB\-C\fR, \fB\-\-check\fR=\fI\,quiet\/\fR, \fB\-\-check\fR=\fI\,silent\/\fR +like \fB\-c\fR, but do not report first bad line +.TP +\fB\-\-compress\-program\fR=\fI\,PROG\/\fR +compress temporaries with PROG; +decompress them with PROG \fB\-d\fR +.TP +\fB\-\-debug\fR +annotate the part of the line used to sort, +and warn about questionable usage to stderr +.TP +\fB\-\-files0\-from\fR=\fI\,F\/\fR +read input from the files specified by +NUL\-terminated names in file F; +If F is \- then read names from standard input +.TP +\fB\-k\fR, \fB\-\-key\fR=\fI\,KEYDEF\/\fR +sort via a key; KEYDEF gives location and type +.TP +\fB\-m\fR, \fB\-\-merge\fR +merge already sorted files; do not sort +.TP +\fB\-o\fR, \fB\-\-output\fR=\fI\,FILE\/\fR +write result to FILE instead of standard output +.TP +\fB\-s\fR, \fB\-\-stable\fR +stabilize sort by disabling last\-resort comparison +.TP +\fB\-S\fR, \fB\-\-buffer\-size\fR=\fI\,SIZE\/\fR +use SIZE for main memory buffer +.TP +\fB\-t\fR, \fB\-\-field\-separator\fR=\fI\,SEP\/\fR +use SEP instead of non\-blank to blank transition +.TP +\fB\-T\fR, \fB\-\-temporary\-directory\fR=\fI\,DIR\/\fR +use DIR for temporaries, not $TMPDIR or \fI\,/tmp\/\fP; +multiple options specify multiple directories +.TP +\fB\-\-parallel\fR=\fI\,N\/\fR +change the number of sorts run concurrently to N +.TP +\fB\-u\fR, \fB\-\-unique\fR +with \fB\-c\fR, check for strict ordering; +without \fB\-c\fR, output only the first of an equal run +.TP +\fB\-z\fR, \fB\-\-zero\-terminated\fR +line delimiter is NUL, not newline +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.PP +KEYDEF is F[.C][OPTS][,F[.C][OPTS]] for start and stop position, where F is a +field number and C a character position in the field; both are origin 1, and +the stop position defaults to the line's end. If neither \fB\-t\fR nor \fB\-b\fR is in +effect, characters in a field are counted from the beginning of the preceding +whitespace. OPTS is one or more single\-letter ordering options [bdfgiMhnRrV], +which override global ordering options for that key. If no key is given, use +the entire line as the key. Use \fB\-\-debug\fR to diagnose incorrect key usage. +.PP +SIZE may be followed by the following multiplicative suffixes: +% 1% of memory, b 1, K 1024 (default), and so on for M, G, T, P, E, Z, Y, R, Q. +.PP +*** WARNING *** +The locale specified by the environment affects sort order. +Set LC_ALL=C to get the traditional sort order that uses +native byte values. +.SH AUTHOR +Written by Mike Haertel and Paul Eggert. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +\fBshuf\fP(1), \fBuniq\fP(1) +.PP +.br +Full documentation <https://www.gnu.org/software/coreutils/sort> +.br +or available locally via: info \(aq(coreutils) sort invocation\(aq diff --git a/man/sort.x b/man/sort.x new file mode 100644 index 0000000..8d8c67d --- /dev/null +++ b/man/sort.x @@ -0,0 +1,6 @@ +[NAME] +sort \- sort lines of text files +[DESCRIPTION] +.\" Add any additional description here +[SEE ALSO] +shuf(1), uniq(1) diff --git a/man/split.1 b/man/split.1 new file mode 100644 index 0000000..f5b71f6 --- /dev/null +++ b/man/split.1 @@ -0,0 +1,108 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH SPLIT "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +split \- split a file into pieces +.SH SYNOPSIS +.B split +[\fI\,OPTION\/\fR]... [\fI\,FILE \/\fR[\fI\,PREFIX\/\fR]] +.SH DESCRIPTION +.\" Add any additional description here +.PP +Output pieces of FILE to PREFIXaa, PREFIXab, ...; +default size is 1000 lines, and default PREFIX is 'x'. +.PP +With no FILE, or when FILE is \-, read standard input. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\fB\-a\fR, \fB\-\-suffix\-length\fR=\fI\,N\/\fR +generate suffixes of length N (default 2) +.TP +\fB\-\-additional\-suffix\fR=\fI\,SUFFIX\/\fR +append an additional SUFFIX to file names +.TP +\fB\-b\fR, \fB\-\-bytes\fR=\fI\,SIZE\/\fR +put SIZE bytes per output file +.TP +\fB\-C\fR, \fB\-\-line\-bytes\fR=\fI\,SIZE\/\fR +put at most SIZE bytes of records per output file +.TP +\fB\-d\fR +use numeric suffixes starting at 0, not alphabetic +.TP +\fB\-\-numeric\-suffixes\fR[=\fI\,FROM\/\fR] +same as \fB\-d\fR, but allow setting the start value +.TP +\fB\-x\fR +use hex suffixes starting at 0, not alphabetic +.TP +\fB\-\-hex\-suffixes\fR[=\fI\,FROM\/\fR] +same as \fB\-x\fR, but allow setting the start value +.TP +\fB\-e\fR, \fB\-\-elide\-empty\-files\fR +do not generate empty output files with '\-n' +.TP +\fB\-\-filter\fR=\fI\,COMMAND\/\fR +write to shell COMMAND; file name is $FILE +.TP +\fB\-l\fR, \fB\-\-lines\fR=\fI\,NUMBER\/\fR +put NUMBER lines/records per output file +.TP +\fB\-n\fR, \fB\-\-number\fR=\fI\,CHUNKS\/\fR +generate CHUNKS output files; see explanation below +.TP +\fB\-t\fR, \fB\-\-separator\fR=\fI\,SEP\/\fR +use SEP instead of newline as the record separator; +\&'\e0' (zero) specifies the NUL character +.TP +\fB\-u\fR, \fB\-\-unbuffered\fR +immediately copy input to output with '\-n r/...' +.TP +\fB\-\-verbose\fR +print a diagnostic just before each +output file is opened +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.PP +The SIZE argument is an integer and optional unit (example: 10K is 10*1024). +Units are K,M,G,T,P,E,Z,Y,R,Q (powers of 1024) or KB,MB,... (powers of 1000). +Binary prefixes can be used, too: KiB=K, MiB=M, and so on. +.SS "CHUNKS may be:" +.TP +N +split into N files based on size of input +.TP +K/N +output Kth of N to stdout +.TP +l/N +split into N files without splitting lines/records +.TP +l/K/N +output Kth of N to stdout without splitting lines/records +.TP +r/N +like 'l' but use round robin distribution +.TP +r/K/N +likewise but only output Kth of N to stdout +.SH AUTHOR +Written by Torbjorn Granlund and Richard M. Stallman. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +Full documentation <https://www.gnu.org/software/coreutils/split> +.br +or available locally via: info \(aq(coreutils) split invocation\(aq diff --git a/man/split.x b/man/split.x new file mode 100644 index 0000000..6e98e7f --- /dev/null +++ b/man/split.x @@ -0,0 +1,4 @@ +[NAME] +split \- split a file into pieces +[DESCRIPTION] +.\" Add any additional description here diff --git a/man/stat.1 b/man/stat.1 new file mode 100644 index 0000000..f61dde6 --- /dev/null +++ b/man/stat.1 @@ -0,0 +1,223 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH STAT "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +stat \- display file or file system status +.SH SYNOPSIS +.B stat +[\fI\,OPTION\/\fR]... \fI\,FILE\/\fR... +.SH DESCRIPTION +.\" Add any additional description here +.PP +Display file or file system status. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\fB\-L\fR, \fB\-\-dereference\fR +follow links +.TP +\fB\-f\fR, \fB\-\-file\-system\fR +display file system status instead of file status +.TP +\fB\-\-cached\fR=\fI\,MODE\/\fR +specify how to use cached attributes; +useful on remote file systems. See MODE below +.TP +\fB\-c\fR \fB\-\-format\fR=\fI\,FORMAT\/\fR +use the specified FORMAT instead of the default; +output a newline after each use of FORMAT +.TP +\fB\-\-printf\fR=\fI\,FORMAT\/\fR +like \fB\-\-format\fR, but interpret backslash escapes, +and do not output a mandatory trailing newline; +if you want a newline, include \en in FORMAT +.TP +\fB\-t\fR, \fB\-\-terse\fR +print the information in terse form +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.PP +The MODE argument of \fB\-\-cached\fR can be: always, never, or default. +\&'always' will use cached attributes if available, while +\&'never' will try to synchronize with the latest attributes, and +\&'default' will leave it up to the underlying file system. +.PP +The valid format sequences for files (without \fB\-\-file\-system\fR): +.TP +%a +permission bits in octal (note '#' and '0' printf flags) +.TP +%A +permission bits and file type in human readable form +.TP +%b +number of blocks allocated (see %B) +.TP +%B +the size in bytes of each block reported by %b +.TP +%C +SELinux security context string +.TP +%d +device number in decimal (st_dev) +.TP +%D +device number in hex (st_dev) +.TP +%Hd +major device number in decimal +.TP +%Ld +minor device number in decimal +.TP +%f +raw mode in hex +.TP +%F +file type +.TP +%g +group ID of owner +.TP +%G +group name of owner +.TP +%h +number of hard links +.TP +%i +inode number +.TP +%m +mount point +.TP +%n +file name +.TP +%N +quoted file name with dereference if symbolic link +.TP +%o +optimal I/O transfer size hint +.TP +%s +total size, in bytes +.TP +%r +device type in decimal (st_rdev) +.TP +%R +device type in hex (st_rdev) +.TP +%Hr +major device type in decimal, for character/block device special files +.TP +%Lr +minor device type in decimal, for character/block device special files +.TP +%t +major device type in hex, for character/block device special files +.TP +%T +minor device type in hex, for character/block device special files +.TP +%u +user ID of owner +.TP +%U +user name of owner +.TP +%w +time of file birth, human\-readable; \- if unknown +.TP +%W +time of file birth, seconds since Epoch; 0 if unknown +.TP +%x +time of last access, human\-readable +.TP +%X +time of last access, seconds since Epoch +.TP +%y +time of last data modification, human\-readable +.TP +%Y +time of last data modification, seconds since Epoch +.TP +%z +time of last status change, human\-readable +.TP +%Z +time of last status change, seconds since Epoch +.PP +Valid format sequences for file systems: +.TP +%a +free blocks available to non\-superuser +.TP +%b +total data blocks in file system +.TP +%c +total file nodes in file system +.TP +%d +free file nodes in file system +.TP +%f +free blocks in file system +.TP +%i +file system ID in hex +.TP +%l +maximum length of filenames +.TP +%n +file name +.TP +%s +block size (for faster transfers) +.TP +%S +fundamental block size (for block counts) +.TP +%t +file system type in hex +.TP +%T +file system type in human readable form +.SS "--terse is equivalent to the following FORMAT:" +.IP +%n %s %b %f %u %g %D %i %h %t %T %X %Y %Z %W %o +.SS "--terse --file-system is equivalent to the following FORMAT:" +.IP +%n %i %l %t %s %S %b %f %a %c %d +.PP +NOTE: your shell may have its own version of stat, which usually supersedes +the version described here. Please refer to your shell's documentation +for details about the options it supports. +.SH AUTHOR +Written by Michael Meskes. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +\fBstat\fP(2), \fBstatfs\fP(2), \fBstatx\fP(2) +.PP +.br +Full documentation <https://www.gnu.org/software/coreutils/stat> +.br +or available locally via: info \(aq(coreutils) stat invocation\(aq diff --git a/man/stat.x b/man/stat.x new file mode 100644 index 0000000..b9f8c68 --- /dev/null +++ b/man/stat.x @@ -0,0 +1,6 @@ +[NAME] +stat \- display file or file system status +[DESCRIPTION] +.\" Add any additional description here +[SEE ALSO] +stat(2), statfs(2), statx(2) diff --git a/man/stdbuf.1 b/man/stdbuf.1 new file mode 100644 index 0000000..e781ed1 --- /dev/null +++ b/man/stdbuf.1 @@ -0,0 +1,81 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH STDBUF "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +stdbuf \- +Run COMMAND, with modified buffering operations for its standard streams. +.SH SYNOPSIS +.B stdbuf +\fI\,OPTION\/\fR... \fI\,COMMAND\/\fR +.SH DESCRIPTION +.\" Add any additional description here +.PP +Run COMMAND, with modified buffering operations for its standard streams. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\fB\-i\fR, \fB\-\-input\fR=\fI\,MODE\/\fR +adjust standard input stream buffering +.TP +\fB\-o\fR, \fB\-\-output\fR=\fI\,MODE\/\fR +adjust standard output stream buffering +.TP +\fB\-e\fR, \fB\-\-error\fR=\fI\,MODE\/\fR +adjust standard error stream buffering +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.PP +If MODE is 'L' the corresponding stream will be line buffered. +This option is invalid with standard input. +.PP +If MODE is '0' the corresponding stream will be unbuffered. +.PP +Otherwise MODE is a number which may be followed by one of the following: +KB 1000, K 1024, MB 1000*1000, M 1024*1024, and so on for G,T,P,E,Z,Y,R,Q. +Binary prefixes can be used, too: KiB=K, MiB=M, and so on. +In this case the corresponding stream will be fully buffered with the buffer +size set to MODE bytes. +.PP +NOTE: If COMMAND adjusts the buffering of its standard streams ('tee' does +for example) then that will override corresponding changes by 'stdbuf'. +Also some filters (like 'dd' and 'cat' etc.) don't use streams for I/O, +and are thus unaffected by 'stdbuf' settings. +.SS "Exit status:" +.TP +125 +if the stdbuf command itself fails +.TP +126 +if COMMAND is found but cannot be invoked +.TP +127 +if COMMAND cannot be found +.TP +\- +the exit status of COMMAND otherwise +.SH EXAMPLES +.B tail -f access.log | stdbuf -oL cut -d \(aq \(aq -f1 | uniq +.br +This will immediately display unique entries from access.log +.SH BUGS +On GLIBC platforms, specifying a buffer size, i.e., using fully buffered mode +will result in undefined operation. +.SH AUTHOR +Written by Padraig Brady. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +Full documentation <https://www.gnu.org/software/coreutils/stdbuf> +.br +or available locally via: info \(aq(coreutils) stdbuf invocation\(aq diff --git a/man/stdbuf.x b/man/stdbuf.x new file mode 100644 index 0000000..9fd7f9d --- /dev/null +++ b/man/stdbuf.x @@ -0,0 +1,17 @@ +'\" Copyright (C) 2009-2023 Free Software Foundation, Inc. +'\" +'\" This is free software. You may redistribute copies of it under the terms +'\" of the GNU General Public License <https://www.gnu.org/licenses/gpl.html>. +'\" There is NO WARRANTY, to the extent permitted by law. +[NAME] +stdbuf \- +Run COMMAND, with modified buffering operations for its standard streams. +[DESCRIPTION] +.\" Add any additional description here +[EXAMPLES] +.B tail -f access.log | stdbuf -oL cut -d \(aq \(aq -f1 | uniq +.br +This will immediately display unique entries from access.log +[BUGS] +On GLIBC platforms, specifying a buffer size, i.e., using fully buffered mode +will result in undefined operation. diff --git a/man/stty.1 b/man/stty.1 new file mode 100644 index 0000000..a613c76 --- /dev/null +++ b/man/stty.1 @@ -0,0 +1,413 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH STTY "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +stty \- change and print terminal line settings +.SH SYNOPSIS +.B stty +[\fI\,-F DEVICE | --file=DEVICE\/\fR] [\fI\,SETTING\/\fR]... +.br +.B stty +[\fI\,-F DEVICE | --file=DEVICE\/\fR] [\fI\,-a|--all\/\fR] +.br +.B stty +[\fI\,-F DEVICE | --file=DEVICE\/\fR] [\fI\,-g|--save\/\fR] +.SH DESCRIPTION +.\" Add any additional description here +.PP +Print or change terminal characteristics. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\fB\-a\fR, \fB\-\-all\fR +print all current settings in human\-readable form +.TP +\fB\-g\fR, \fB\-\-save\fR +print all current settings in a stty\-readable form +.TP +\fB\-F\fR, \fB\-\-file\fR=\fI\,DEVICE\/\fR +open and use the specified DEVICE instead of stdin +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.PP +Optional \- before SETTING indicates negation. An * marks non\-POSIX +settings. The underlying system defines which settings are available. +.SS "Special characters:" +.TP +* discard CHAR +CHAR will toggle discarding of output +.TP +eof CHAR +CHAR will send an end of file (terminate the input) +.TP +eol CHAR +CHAR will end the line +.TP +* eol2 CHAR +alternate CHAR for ending the line +.TP +erase CHAR +CHAR will erase the last character typed +.TP +intr CHAR +CHAR will send an interrupt signal +.TP +kill CHAR +CHAR will erase the current line +.TP +* lnext CHAR +CHAR will enter the next character quoted +.TP +quit CHAR +CHAR will send a quit signal +.TP +* rprnt CHAR +CHAR will redraw the current line +.TP +start CHAR +CHAR will restart the output after stopping it +.TP +stop CHAR +CHAR will stop the output +.TP +susp CHAR +CHAR will send a terminal stop signal +.TP +* swtch CHAR +CHAR will switch to a different shell layer +.TP +* werase CHAR +CHAR will erase the last word typed +.SS "Special settings:" +.TP +N +set the input and output speeds to N bauds +.TP +* cols N +tell the kernel that the terminal has N columns +.TP +* columns N +same as cols N +.TP +* [\-]drain +wait for transmission before applying settings (on by default) +.TP +ispeed N +set the input speed to N +.TP +* line N +use line discipline N +.TP +min N +with \fB\-icanon\fR, set N characters minimum for a completed read +.TP +ospeed N +set the output speed to N +.TP +* rows N +tell the kernel that the terminal has N rows +.TP +* size +print the number of rows and columns according to the kernel +.TP +speed +print the terminal speed +.TP +time N +with \fB\-icanon\fR, set read timeout of N tenths of a second +.SS "Control settings:" +.TP +[\-]clocal +disable modem control signals +.TP +[\-]cread +allow input to be received +.TP +* [\-]crtscts +enable RTS/CTS handshaking +.TP +csN +set character size to N bits, N in [5..8] +.TP +[\-]cstopb +use two stop bits per character (one with '\-') +.TP +[\-]hup +send a hangup signal when the last process closes the tty +.TP +[\-]hupcl +same as [\-]hup +.TP +[\-]parenb +generate parity bit in output and expect parity bit in input +.TP +[\-]parodd +set odd parity (or even parity with '\-') +.TP +* [\-]cmspar +use "stick" (mark/space) parity +.SS "Input settings:" +.TP +[\-]brkint +breaks cause an interrupt signal +.TP +[\-]icrnl +translate carriage return to newline +.TP +[\-]ignbrk +ignore break characters +.TP +[\-]igncr +ignore carriage return +.TP +[\-]ignpar +ignore characters with parity errors +.TP +* [\-]imaxbel +beep and do not flush a full input buffer on a character +.TP +[\-]inlcr +translate newline to carriage return +.TP +[\-]inpck +enable input parity checking +.TP +[\-]istrip +clear high (8th) bit of input characters +.TP +* [\-]iutf8 +assume input characters are UTF\-8 encoded +.TP +* [\-]iuclc +translate uppercase characters to lowercase +.TP +* [\-]ixany +let any character restart output, not only start character +.TP +[\-]ixoff +enable sending of start/stop characters +.TP +[\-]ixon +enable XON/XOFF flow control +.TP +[\-]parmrk +mark parity errors (with a 255\-0\-character sequence) +.TP +[\-]tandem +same as [\-]ixoff +.SS "Output settings:" +.TP +* bsN +backspace delay style, N in [0..1] +.TP +* crN +carriage return delay style, N in [0..3] +.TP +* ffN +form feed delay style, N in [0..1] +.TP +* nlN +newline delay style, N in [0..1] +.TP +* [\-]ocrnl +translate carriage return to newline +.TP +* [\-]ofdel +use delete characters for fill instead of NUL characters +.TP +* [\-]ofill +use fill (padding) characters instead of timing for delays +.TP +* [\-]olcuc +translate lowercase characters to uppercase +.TP +* [\-]onlcr +translate newline to carriage return\-newline +.TP +* [\-]onlret +newline performs a carriage return +.TP +* [\-]onocr +do not print carriage returns in the first column +.TP +[\-]opost +postprocess output +.TP +* tabN +horizontal tab delay style, N in [0..3] +.TP +* tabs +same as tab0 +.TP +* \fB\-tabs\fR +same as tab3 +.TP +* vtN +vertical tab delay style, N in [0..1] +.SS "Local settings:" +.TP +[\-]crterase +echo erase characters as backspace\-space\-backspace +.TP +* crtkill +kill all line by obeying the echoprt and echoe settings +.TP +* \fB\-crtkill\fR +kill all line by obeying the echoctl and echok settings +.TP +* [\-]ctlecho +echo control characters in hat notation ('^c') +.TP +[\-]echo +echo input characters +.TP +* [\-]echoctl +same as [\-]ctlecho +.TP +[\-]echoe +same as [\-]crterase +.TP +[\-]echok +echo a newline after a kill character +.TP +* [\-]echoke +same as [\-]crtkill +.TP +[\-]echonl +echo newline even if not echoing other characters +.TP +* [\-]echoprt +echo erased characters backward, between '\e' and '/' +.TP +* [\-]extproc +enable "LINEMODE"; useful with high latency links +.TP +* [\-]flusho +discard output +.TP +[\-]icanon +enable special characters: erase, kill, werase, rprnt +.TP +[\-]iexten +enable non\-POSIX special characters +.TP +[\-]isig +enable interrupt, quit, and suspend special characters +.TP +[\-]noflsh +disable flushing after interrupt and quit special characters +.TP +* [\-]prterase +same as [\-]echoprt +.TP +* [\-]tostop +stop background jobs that try to write to the terminal +.TP +* [\-]xcase +with icanon, escape with '\e' for uppercase characters +.SS "Combination settings:" +.TP +* [\-]LCASE +same as [\-]lcase +.TP +cbreak +same as \fB\-icanon\fR +.TP +\fB\-cbreak\fR +same as icanon +.TP +cooked +same as brkint ignpar istrip icrnl ixon opost isig +icanon, eof and eol characters to their default values +.TP +\fB\-cooked\fR +same as raw +.TP +crt +same as echoe echoctl echoke +.TP +dec +same as echoe echoctl echoke \fB\-ixany\fR intr ^c erase 0177 +kill ^u +.TP +* [\-]decctlq +same as [\-]ixany +.TP +ek +erase and kill characters to their default values +.TP +evenp +same as parenb \fB\-parodd\fR cs7 +.TP +\fB\-evenp\fR +same as \fB\-parenb\fR cs8 +.TP +* [\-]lcase +same as xcase iuclc olcuc +.TP +litout +same as \fB\-parenb\fR \fB\-istrip\fR \fB\-opost\fR cs8 +.TP +\fB\-litout\fR +same as parenb istrip opost cs7 +.TP +nl +same as \fB\-icrnl\fR \fB\-onlcr\fR +.TP +\fB\-nl\fR +same as icrnl \fB\-inlcr\fR \fB\-igncr\fR onlcr \fB\-ocrnl\fR \fB\-onlret\fR +.TP +oddp +same as parenb parodd cs7 +.TP +\fB\-oddp\fR +same as \fB\-parenb\fR cs8 +.TP +[\-]parity +same as [\-]evenp +.TP +pass8 +same as \fB\-parenb\fR \fB\-istrip\fR cs8 +.TP +\fB\-pass8\fR +same as parenb istrip cs7 +.TP +raw +same as \fB\-ignbrk\fR \fB\-brkint\fR \fB\-ignpar\fR \fB\-parmrk\fR \fB\-inpck\fR \fB\-istrip\fR +\fB\-inlcr\fR \fB\-igncr\fR \fB\-icrnl\fR \fB\-ixon\fR \fB\-ixoff\fR \fB\-icanon\fR \fB\-opost\fR +\fB\-isig\fR \fB\-iuclc\fR \fB\-ixany\fR \fB\-imaxbel\fR \fB\-xcase\fR min 1 time 0 +.TP +\fB\-raw\fR +same as cooked +.TP +sane +same as cread \fB\-ignbrk\fR brkint \fB\-inlcr\fR \fB\-igncr\fR icrnl +icanon iexten echo echoe echok \fB\-echonl\fR \fB\-noflsh\fR +\fB\-ixoff\fR \fB\-iutf8\fR \fB\-iuclc\fR \fB\-ixany\fR imaxbel \fB\-xcase\fR \fB\-olcuc\fR \fB\-ocrnl\fR +opost \fB\-ofill\fR onlcr \fB\-onocr\fR \fB\-onlret\fR nl0 cr0 tab0 bs0 vt0 ff0 +isig \fB\-tostop\fR \fB\-ofdel\fR \fB\-echoprt\fR echoctl echoke \fB\-extproc\fR \fB\-flusho\fR, +all special characters to their default values +.PP +Handle the tty line connected to standard input. Without arguments, +prints baud rate, line discipline, and deviations from stty sane. In +settings, CHAR is taken literally, or coded as in ^c, 0x37, 0177 or +127; special values ^\- or undef used to disable special characters. +.SH AUTHOR +Written by David MacKenzie. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +Full documentation <https://www.gnu.org/software/coreutils/stty> +.br +or available locally via: info \(aq(coreutils) stty invocation\(aq diff --git a/man/stty.x b/man/stty.x new file mode 100644 index 0000000..f3e1e1f --- /dev/null +++ b/man/stty.x @@ -0,0 +1,4 @@ +[NAME] +stty \- change and print terminal line settings +[DESCRIPTION] +.\" Add any additional description here diff --git a/man/sum.1 b/man/sum.1 new file mode 100644 index 0000000..c43a0bd --- /dev/null +++ b/man/sum.1 @@ -0,0 +1,41 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH SUM "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +sum \- checksum and count the blocks in a file +.SH SYNOPSIS +.B sum +[\fI\,OPTION\/\fR]... [\fI\,FILE\/\fR]... +.SH DESCRIPTION +.\" Add any additional description here +.PP +Print or check BSD (16\-bit) checksums. +.PP +With no FILE, or when FILE is \-, read standard input. +.TP +\fB\-r\fR +use BSD sum algorithm (the default), use 1K blocks +.TP +\fB\-s\fR, \fB\-\-sysv\fR +use System V sum algorithm, use 512 bytes blocks +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.SH AUTHOR +Written by Kayvan Aghaiepour and David MacKenzie. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +Full documentation <https://www.gnu.org/software/coreutils/sum> +.br +or available locally via: info \(aq(coreutils) sum invocation\(aq diff --git a/man/sum.x b/man/sum.x new file mode 100644 index 0000000..a03b9cc --- /dev/null +++ b/man/sum.x @@ -0,0 +1,4 @@ +[NAME] +sum \- checksum and count the blocks in a file +[DESCRIPTION] +.\" Add any additional description here diff --git a/man/sync.1 b/man/sync.1 new file mode 100644 index 0000000..3132ec3 --- /dev/null +++ b/man/sync.1 @@ -0,0 +1,48 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH SYNC "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +sync \- Synchronize cached writes to persistent storage +.SH SYNOPSIS +.B sync +[\fI\,OPTION\/\fR] [\fI\,FILE\/\fR]... +.SH DESCRIPTION +.\" Add any additional description here +.PP +Synchronize cached writes to persistent storage +.PP +If one or more files are specified, sync only them, +or their containing file systems. +.TP +\fB\-d\fR, \fB\-\-data\fR +sync only file data, no unneeded metadata +.TP +\fB\-f\fR, \fB\-\-file\-system\fR +sync the file systems that contain the files +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.SH BUGS +Persistence guarantees vary per system. +See the system calls below for more details. +.SH AUTHOR +Written by Jim Meyering and Giuseppe Scrivano. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +\fBfdatasync\fP(2), \fBfsync\fP(2), \fBsync\fP(2), \fBsyncfs\fP(2) +.PP +.br +Full documentation <https://www.gnu.org/software/coreutils/sync> +.br +or available locally via: info \(aq(coreutils) sync invocation\(aq diff --git a/man/sync.x b/man/sync.x new file mode 100644 index 0000000..18ee3fc --- /dev/null +++ b/man/sync.x @@ -0,0 +1,9 @@ +[NAME] +sync \- Synchronize cached writes to persistent storage +[DESCRIPTION] +.\" Add any additional description here +[BUGS] +Persistence guarantees vary per system. +See the system calls below for more details. +[SEE ALSO] +fdatasync(2), fsync(2), sync(2), syncfs(2) diff --git a/man/tac.1 b/man/tac.1 new file mode 100644 index 0000000..c57bbc7 --- /dev/null +++ b/man/tac.1 @@ -0,0 +1,49 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH TAC "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +tac \- concatenate and print files in reverse +.SH SYNOPSIS +.B tac +[\fI\,OPTION\/\fR]... [\fI\,FILE\/\fR]... +.SH DESCRIPTION +.\" Add any additional description here +.PP +Write each FILE to standard output, last line first. +.PP +With no FILE, or when FILE is \-, read standard input. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\fB\-b\fR, \fB\-\-before\fR +attach the separator before instead of after +.TP +\fB\-r\fR, \fB\-\-regex\fR +interpret the separator as a regular expression +.TP +\fB\-s\fR, \fB\-\-separator\fR=\fI\,STRING\/\fR +use STRING as the separator instead of newline +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.SH AUTHOR +Written by Jay Lepreau and David MacKenzie. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +\fBcat\fP(1), \fBrev\fP(1) +.PP +.br +Full documentation <https://www.gnu.org/software/coreutils/tac> +.br +or available locally via: info \(aq(coreutils) tac invocation\(aq diff --git a/man/tac.x b/man/tac.x new file mode 100644 index 0000000..677da2f --- /dev/null +++ b/man/tac.x @@ -0,0 +1,6 @@ +[NAME] +tac \- concatenate and print files in reverse +[DESCRIPTION] +.\" Add any additional description here +[SEE ALSO] +cat(1), rev(1) diff --git a/man/tail.1 b/man/tail.1 new file mode 100644 index 0000000..bb92b19 --- /dev/null +++ b/man/tail.1 @@ -0,0 +1,99 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH TAIL "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +tail \- output the last part of files +.SH SYNOPSIS +.B tail +[\fI\,OPTION\/\fR]... [\fI\,FILE\/\fR]... +.SH DESCRIPTION +.\" Add any additional description here +.PP +Print the last 10 lines of each FILE to standard output. +With more than one FILE, precede each with a header giving the file name. +.PP +With no FILE, or when FILE is \-, read standard input. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\fB\-c\fR, \fB\-\-bytes\fR=\fI\,[\/\fR+]NUM +output the last NUM bytes; or use \fB\-c\fR +NUM to +output starting with byte NUM of each file +.TP +\fB\-f\fR, \fB\-\-follow[=\fR{name|descriptor}] +output appended data as the file grows; +.IP +an absent option argument means 'descriptor' +.TP +\fB\-F\fR +same as \fB\-\-follow\fR=\fI\,name\/\fR \fB\-\-retry\fR +.TP +\fB\-n\fR, \fB\-\-lines\fR=\fI\,[\/\fR+]NUM +output the last NUM lines, instead of the last 10; +or use \fB\-n\fR +NUM to skip NUM\-1 lines at the start +.TP +\fB\-\-max\-unchanged\-stats\fR=\fI\,N\/\fR +with \fB\-\-follow\fR=\fI\,name\/\fR, reopen a FILE which has not +.IP +changed size after N (default 5) iterations +to see if it has been unlinked or renamed +(this is the usual case of rotated log files); +with inotify, this option is rarely useful +.TP +\fB\-\-pid\fR=\fI\,PID\/\fR +with \fB\-f\fR, terminate after process ID, PID dies +.TP +\fB\-q\fR, \fB\-\-quiet\fR, \fB\-\-silent\fR +never output headers giving file names +.TP +\fB\-\-retry\fR +keep trying to open a file if it is inaccessible +.TP +\fB\-s\fR, \fB\-\-sleep\-interval\fR=\fI\,N\/\fR +with \fB\-f\fR, sleep for approximately N seconds +(default 1.0) between iterations; +with inotify and \fB\-\-pid\fR=\fI\,P\/\fR, check process P at +least once every N seconds +.TP +\fB\-v\fR, \fB\-\-verbose\fR +always output headers giving file names +.TP +\fB\-z\fR, \fB\-\-zero\-terminated\fR +line delimiter is NUL, not newline +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.PP +NUM may have a multiplier suffix: +b 512, kB 1000, K 1024, MB 1000*1000, M 1024*1024, +GB 1000*1000*1000, G 1024*1024*1024, and so on for T, P, E, Z, Y, R, Q. +Binary prefixes can be used, too: KiB=K, MiB=M, and so on. +.PP +With \fB\-\-follow\fR (\fB\-f\fR), tail defaults to following the file descriptor, which +means that even if a tail'ed file is renamed, tail will continue to track +its end. This default behavior is not desirable when you really want to +track the actual name of the file, not the file descriptor (e.g., log +rotation). Use \fB\-\-follow\fR=\fI\,name\/\fR in that case. That causes tail to track the +named file in a way that accommodates renaming, removal and creation. +.SH AUTHOR +Written by Paul Rubin, David MacKenzie, Ian Lance Taylor, +and Jim Meyering. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +\fBhead\fP(1) +.PP +.br +Full documentation <https://www.gnu.org/software/coreutils/tail> +.br +or available locally via: info \(aq(coreutils) tail invocation\(aq diff --git a/man/tail.x b/man/tail.x new file mode 100644 index 0000000..68f2782 --- /dev/null +++ b/man/tail.x @@ -0,0 +1,6 @@ +[NAME] +tail \- output the last part of files +[DESCRIPTION] +.\" Add any additional description here +[SEE ALSO] +head(1) diff --git a/man/tee.1 b/man/tee.1 new file mode 100644 index 0000000..1b9ad93 --- /dev/null +++ b/man/tee.1 @@ -0,0 +1,64 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH TEE "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +tee \- read from standard input and write to standard output and files +.SH SYNOPSIS +.B tee +[\fI\,OPTION\/\fR]... [\fI\,FILE\/\fR]... +.SH DESCRIPTION +.\" Add any additional description here +.PP +Copy standard input to each FILE, and also to standard output. +.TP +\fB\-a\fR, \fB\-\-append\fR +append to the given FILEs, do not overwrite +.TP +\fB\-i\fR, \fB\-\-ignore\-interrupts\fR +ignore interrupt signals +.TP +\fB\-p\fR +operate in a more appropriate MODE with pipes. +.TP +\fB\-\-output\-error\fR[=\fI\,MODE\/\fR] +set behavior on write error. See MODE below +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.SS "MODE determines behavior with write errors on the outputs:" +.TP +warn +diagnose errors writing to any output +.TP +warn\-nopipe +diagnose errors writing to any output not a pipe +.TP +exit +exit on error writing to any output +.TP +exit\-nopipe +exit on error writing to any output not a pipe +.PP +The default MODE for the \fB\-p\fR option is 'warn\-nopipe'. +With "nopipe" MODEs, exit immediately if all outputs become broken pipes. +The default operation when \fB\-\-output\-error\fR is not specified, is to +exit immediately on error writing to a pipe, and diagnose errors +writing to non pipe outputs. +.SH AUTHOR +Written by Mike Parker, Richard M. Stallman, and David MacKenzie. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +Full documentation <https://www.gnu.org/software/coreutils/tee> +.br +or available locally via: info \(aq(coreutils) tee invocation\(aq diff --git a/man/tee.x b/man/tee.x new file mode 100644 index 0000000..e5854cf --- /dev/null +++ b/man/tee.x @@ -0,0 +1,4 @@ +[NAME] +tee \- read from standard input and write to standard output and files +[DESCRIPTION] +.\" Add any additional description here diff --git a/man/test.1 b/man/test.1 new file mode 100644 index 0000000..b5119ce --- /dev/null +++ b/man/test.1 @@ -0,0 +1,179 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH TEST "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +test \- check file types and compare values +.SH SYNOPSIS +.B test +.I EXPRESSION +.br +.B test +.br +.\" \& tells doclifter the brackets are literal (Bug#31803). +.B [\& +.I EXPRESSION +.B ]\& +.br +.B "[\& ]\&" +.br +.B [\& +.I OPTION +.SH DESCRIPTION +.\" Add any additional description here +.PP +Exit with the status determined by EXPRESSION. +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.PP +An omitted EXPRESSION defaults to false. Otherwise, +EXPRESSION is true or false and sets exit status. It is one of: +.TP +( EXPRESSION ) +EXPRESSION is true +.TP +! EXPRESSION +EXPRESSION is false +.TP +EXPRESSION1 \fB\-a\fR EXPRESSION2 +both EXPRESSION1 and EXPRESSION2 are true +.TP +EXPRESSION1 \fB\-o\fR EXPRESSION2 +either EXPRESSION1 or EXPRESSION2 is true +.TP +\fB\-n\fR STRING +the length of STRING is nonzero +.TP +STRING +equivalent to \fB\-n\fR STRING +.TP +\fB\-z\fR STRING +the length of STRING is zero +.TP +STRING1 = STRING2 +the strings are equal +.TP +STRING1 != STRING2 +the strings are not equal +.TP +INTEGER1 \fB\-eq\fR INTEGER2 +INTEGER1 is equal to INTEGER2 +.TP +INTEGER1 \fB\-ge\fR INTEGER2 +INTEGER1 is greater than or equal to INTEGER2 +.TP +INTEGER1 \fB\-gt\fR INTEGER2 +INTEGER1 is greater than INTEGER2 +.TP +INTEGER1 \fB\-le\fR INTEGER2 +INTEGER1 is less than or equal to INTEGER2 +.TP +INTEGER1 \fB\-lt\fR INTEGER2 +INTEGER1 is less than INTEGER2 +.TP +INTEGER1 \fB\-ne\fR INTEGER2 +INTEGER1 is not equal to INTEGER2 +.TP +FILE1 \fB\-ef\fR FILE2 +FILE1 and FILE2 have the same device and inode numbers +.TP +FILE1 \fB\-nt\fR FILE2 +FILE1 is newer (modification date) than FILE2 +.TP +FILE1 \fB\-ot\fR FILE2 +FILE1 is older than FILE2 +.TP +\fB\-b\fR FILE +FILE exists and is block special +.TP +\fB\-c\fR FILE +FILE exists and is character special +.TP +\fB\-d\fR FILE +FILE exists and is a directory +.TP +\fB\-e\fR FILE +FILE exists +.TP +\fB\-f\fR FILE +FILE exists and is a regular file +.TP +\fB\-g\fR FILE +FILE exists and is set\-group\-ID +.TP +\fB\-G\fR FILE +FILE exists and is owned by the effective group ID +.TP +\fB\-h\fR FILE +FILE exists and is a symbolic link (same as \fB\-L\fR) +.TP +\fB\-k\fR FILE +FILE exists and has its sticky bit set +.TP +\fB\-L\fR FILE +FILE exists and is a symbolic link (same as \fB\-h\fR) +.TP +\fB\-N\fR FILE +FILE exists and has been modified since it was last read +.TP +\fB\-O\fR FILE +FILE exists and is owned by the effective user ID +.TP +\fB\-p\fR FILE +FILE exists and is a named pipe +.TP +\fB\-r\fR FILE +FILE exists and the user has read access +.TP +\fB\-s\fR FILE +FILE exists and has a size greater than zero +.TP +\fB\-S\fR FILE +FILE exists and is a socket +.TP +\fB\-t\fR FD +file descriptor FD is opened on a terminal +.TP +\fB\-u\fR FILE +FILE exists and its set\-user\-ID bit is set +.TP +\fB\-w\fR FILE +FILE exists and the user has write access +.TP +\fB\-x\fR FILE +FILE exists and the user has execute (or search) access +.PP +Except for \fB\-h\fR and \fB\-L\fR, all FILE\-related tests dereference symbolic links. +Beware that parentheses need to be escaped (e.g., by backslashes) for shells. +INTEGER may also be \fB\-l\fR STRING, which evaluates to the length of STRING. +.PP +NOTE: Binary \fB\-a\fR and \fB\-o\fR are inherently ambiguous. Use 'test EXPR1 && test +EXPR2' or 'test EXPR1 || test EXPR2' instead. +.PP +NOTE: [ honors the \fB\-\-help\fR and \fB\-\-version\fR options, but test does not. +test treats each of those as it treats any other nonempty STRING. +.PP +NOTE: your shell may have its own version of test and/or [, which usually supersedes +the version described here. Please refer to your shell's documentation +for details about the options it supports. +.SH AUTHOR +Written by Kevin Braunsdorf and Matthew Bradburn. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +\fBaccess\fP(2) +.PP +.br +Full documentation <https://www.gnu.org/software/coreutils/test> +.br +or available locally via: info \(aq(coreutils) test invocation\(aq diff --git a/man/test.x b/man/test.x new file mode 100644 index 0000000..aaed55d --- /dev/null +++ b/man/test.x @@ -0,0 +1,26 @@ +'\" Copyright (C) 1998-2023 Free Software Foundation, Inc. +'\" +'\" This is free software. You may redistribute copies of it under the terms +'\" of the GNU General Public License <https://www.gnu.org/licenses/gpl.html>. +'\" There is NO WARRANTY, to the extent permitted by law. +[NAME] +test \- check file types and compare values +[SYNOPSIS] +.B test +.I EXPRESSION +.br +.B test +.br +.\" \& tells doclifter the brackets are literal (Bug#31803). +.B [\& +.I EXPRESSION +.B ]\& +.br +.B "[\& ]\&" +.br +.B [\& +.I OPTION +[DESCRIPTION] +.\" Add any additional description here +[SEE ALSO] +access(2) diff --git a/man/timeout.1 b/man/timeout.1 new file mode 100644 index 0000000..3141d96 --- /dev/null +++ b/man/timeout.1 @@ -0,0 +1,99 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH TIMEOUT "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +timeout \- run a command with a time limit +.SH SYNOPSIS +.B timeout +[\fI\,OPTION\/\fR] \fI\,DURATION COMMAND \/\fR[\fI\,ARG\/\fR]... +.br +.B timeout +[\fI\,OPTION\/\fR] +.SH DESCRIPTION +.\" Add any additional description here +.PP +Start COMMAND, and kill it if still running after DURATION. +.PP +Mandatory arguments to long options are mandatory for short options too. +.HP +\fB\-\-preserve\-status\fR +.IP +exit with the same status as COMMAND, even when the +.IP +command times out +.HP +\fB\-\-foreground\fR +.IP +when not running timeout directly from a shell prompt, +.IP +allow COMMAND to read from the TTY and get TTY signals; +in this mode, children of COMMAND will not be timed out +.HP +\fB\-k\fR, \fB\-\-kill\-after\fR=\fI\,DURATION\/\fR +.IP +also send a KILL signal if COMMAND is still running +.IP +this long after the initial signal was sent +.HP +\fB\-s\fR, \fB\-\-signal\fR=\fI\,SIGNAL\/\fR +.IP +specify the signal to be sent on timeout; +.IP +SIGNAL may be a name like 'HUP' or a number; +see 'kill \fB\-l\fR' for a list of signals +.TP +\fB\-v\fR, \fB\-\-verbose\fR +diagnose to stderr any signal sent upon timeout +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.PP +DURATION is a floating point number with an optional suffix: +\&'s' for seconds (the default), 'm' for minutes, 'h' for hours or 'd' for days. +A duration of 0 disables the associated timeout. +.PP +Upon timeout, send the TERM signal to COMMAND, if no other SIGNAL specified. +The TERM signal kills any process that does not block or catch that signal. +It may be necessary to use the KILL signal, since this signal can't be caught. +.SS "Exit status:" +.TP +124 +if COMMAND times out, and \fB\-\-preserve\-status\fR is not specified +.TP +125 +if the timeout command itself fails +.TP +126 +if COMMAND is found but cannot be invoked +.TP +127 +if COMMAND cannot be found +.TP +137 +if COMMAND (or timeout itself) is sent the KILL (9) signal (128+9) +.TP +\- +the exit status of COMMAND otherwise +.SH BUGS +Some platforms don't currently support timeouts beyond the year 2038. +.SH AUTHOR +Written by Padraig Brady. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +\fBkill\fP(1) +.PP +.br +Full documentation <https://www.gnu.org/software/coreutils/timeout> +.br +or available locally via: info \(aq(coreutils) timeout invocation\(aq diff --git a/man/timeout.x b/man/timeout.x new file mode 100644 index 0000000..ddb3092 --- /dev/null +++ b/man/timeout.x @@ -0,0 +1,8 @@ +[NAME] +timeout \- run a command with a time limit +[DESCRIPTION] +.\" Add any additional description here +[SEE ALSO] +kill(1) +[BUGS] +Some platforms don't currently support timeouts beyond the year 2038. diff --git a/man/touch.1 b/man/touch.1 new file mode 100644 index 0000000..4108f15 --- /dev/null +++ b/man/touch.1 @@ -0,0 +1,84 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH TOUCH "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +touch \- change file timestamps +.SH SYNOPSIS +.B touch +[\fI\,OPTION\/\fR]... \fI\,FILE\/\fR... +.SH DESCRIPTION +.\" Add any additional description here +.PP +Update the access and modification times of each FILE to the current time. +.PP +A FILE argument that does not exist is created empty, unless \fB\-c\fR or \fB\-h\fR +is supplied. +.PP +A FILE argument string of \- is handled specially and causes touch to +change the times of the file associated with standard output. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\fB\-a\fR +change only the access time +.TP +\fB\-c\fR, \fB\-\-no\-create\fR +do not create any files +.TP +\fB\-d\fR, \fB\-\-date\fR=\fI\,STRING\/\fR +parse STRING and use it instead of current time +.TP +\fB\-f\fR +(ignored) +.TP +\fB\-h\fR, \fB\-\-no\-dereference\fR +affect each symbolic link instead of any referenced +file (useful only on systems that can change the +timestamps of a symlink) +.TP +\fB\-m\fR +change only the modification time +.TP +\fB\-r\fR, \fB\-\-reference\fR=\fI\,FILE\/\fR +use this file's times instead of current time +.TP +\fB\-t\fR STAMP +use [[CC]YY]MMDDhhmm[.ss] instead of current time +.TP +\fB\-\-time\fR=\fI\,WORD\/\fR +change the specified time: +WORD is access, atime, or use: equivalent to \fB\-a\fR +WORD is modify or mtime: equivalent to \fB\-m\fR +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.PP +Note that the \fB\-d\fR and \fB\-t\fR options accept different time\-date formats. +.SH "DATE STRING" +.\" NOTE: keep this paragraph in sync with the one in date.x +The --date=STRING is a mostly free format human readable date string +such as "Sun, 29 Feb 2004 16:21:42 -0800" or "2004-02-29 16:21:42" or +even "next Thursday". A date string may contain items indicating +calendar date, time of day, time zone, day of week, relative time, +relative date, and numbers. An empty string indicates the beginning +of the day. The date string format is more complex than is easily +documented here but is fully described in the info documentation. +.SH AUTHOR +Written by Paul Rubin, Arnold Robbins, Jim Kingdon, +David MacKenzie, and Randy Smith. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +Full documentation <https://www.gnu.org/software/coreutils/touch> +.br +or available locally via: info \(aq(coreutils) touch invocation\(aq diff --git a/man/touch.x b/man/touch.x new file mode 100644 index 0000000..6c3aac2 --- /dev/null +++ b/man/touch.x @@ -0,0 +1,13 @@ +[NAME] +touch \- change file timestamps +[DESCRIPTION] +.\" Add any additional description here +[DATE STRING] +.\" NOTE: keep this paragraph in sync with the one in date.x +The --date=STRING is a mostly free format human readable date string +such as "Sun, 29 Feb 2004 16:21:42 -0800" or "2004-02-29 16:21:42" or +even "next Thursday". A date string may contain items indicating +calendar date, time of day, time zone, day of week, relative time, +relative date, and numbers. An empty string indicates the beginning +of the day. The date string format is more complex than is easily +documented here but is fully described in the info documentation. diff --git a/man/tr.1 b/man/tr.1 new file mode 100644 index 0000000..f014d35 --- /dev/null +++ b/man/tr.1 @@ -0,0 +1,143 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH TR "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +tr \- translate or delete characters +.SH SYNOPSIS +.B tr +[\fI\,OPTION\/\fR]... \fI\,STRING1 \/\fR[\fI\,STRING2\/\fR] +.SH DESCRIPTION +.\" Add any additional description here +.PP +Translate, squeeze, and/or delete characters from standard input, +writing to standard output. STRING1 and STRING2 specify arrays of +characters ARRAY1 and ARRAY2 that control the action. +.TP +\fB\-c\fR, \fB\-C\fR, \fB\-\-complement\fR +use the complement of ARRAY1 +.TP +\fB\-d\fR, \fB\-\-delete\fR +delete characters in ARRAY1, do not translate +.TP +\fB\-s\fR, \fB\-\-squeeze\-repeats\fR +replace each sequence of a repeated character +that is listed in the last specified ARRAY, +with a single occurrence of that character +.TP +\fB\-t\fR, \fB\-\-truncate\-set1\fR +first truncate ARRAY1 to length of ARRAY2 +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.PP +ARRAYs are specified as strings of characters. Most represent themselves. +Interpreted sequences are: +.TP +\eNNN +character with octal value NNN (1 to 3 octal digits) +.TP +\e\e +backslash +.TP +\ea +audible BEL +.TP +\eb +backspace +.TP +\ef +form feed +.TP +\en +new line +.TP +\er +return +.TP +\et +horizontal tab +.TP +\ev +vertical tab +.TP +CHAR1\-CHAR2 +all characters from CHAR1 to CHAR2 in ascending order +.TP +[CHAR*] +in ARRAY2, copies of CHAR until length of ARRAY1 +.TP +[CHAR*REPEAT] +REPEAT copies of CHAR, REPEAT octal if starting with 0 +.TP +[:alnum:] +all letters and digits +.TP +[:alpha:] +all letters +.TP +[:blank:] +all horizontal whitespace +.TP +[:cntrl:] +all control characters +.TP +[:digit:] +all digits +.TP +[:graph:] +all printable characters, not including space +.TP +[:lower:] +all lower case letters +.TP +[:print:] +all printable characters, including space +.TP +[:punct:] +all punctuation characters +.TP +[:space:] +all horizontal or vertical whitespace +.TP +[:upper:] +all upper case letters +.TP +[:xdigit:] +all hexadecimal digits +.TP +[=CHAR=] +all characters which are equivalent to CHAR +.PP +Translation occurs if \fB\-d\fR is not given and both STRING1 and STRING2 appear. +\fB\-t\fR is only significant when translating. ARRAY2 is extended to length of +ARRAY1 by repeating its last character as necessary. Excess characters +of ARRAY2 are ignored. Character classes expand in unspecified order; +while translating, [:lower:] and [:upper:] may be used in pairs to +specify case conversion. Squeezing occurs after translation or deletion. +.SH BUGS +.PP +Full support is available only for safe single-byte locales, +in which every possible input byte represents a single character. +The C locale is safe in GNU systems, so you can avoid this issue +in the shell by running +.B "LC_ALL=C tr" +instead of plain +.BR tr . +.SH AUTHOR +Written by Jim Meyering. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +Full documentation <https://www.gnu.org/software/coreutils/tr> +.br +or available locally via: info \(aq(coreutils) tr invocation\(aq diff --git a/man/tr.x b/man/tr.x new file mode 100644 index 0000000..b531032 --- /dev/null +++ b/man/tr.x @@ -0,0 +1,13 @@ +[NAME] +tr \- translate or delete characters +[DESCRIPTION] +.\" Add any additional description here +[BUGS] +.PP +Full support is available only for safe single-byte locales, +in which every possible input byte represents a single character. +The C locale is safe in GNU systems, so you can avoid this issue +in the shell by running +.B "LC_ALL=C tr" +instead of plain +.BR tr . diff --git a/man/true.1 b/man/true.1 new file mode 100644 index 0000000..3dbe26e --- /dev/null +++ b/man/true.1 @@ -0,0 +1,40 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH TRUE "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +true \- do nothing, successfully +.SH SYNOPSIS +.B true +[\fI\,ignored command line arguments\/\fR] +.br +.B true +\fI\,OPTION\/\fR +.SH DESCRIPTION +.\" Add any additional description here +.PP +Exit with a status code indicating success. +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.PP +NOTE: your shell may have its own version of true, which usually supersedes +the version described here. Please refer to your shell's documentation +for details about the options it supports. +.SH AUTHOR +Written by Jim Meyering. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +Full documentation <https://www.gnu.org/software/coreutils/true> +.br +or available locally via: info \(aq(coreutils) true invocation\(aq diff --git a/man/true.x b/man/true.x new file mode 100644 index 0000000..8eb4151 --- /dev/null +++ b/man/true.x @@ -0,0 +1,4 @@ +[NAME] +true \- do nothing, successfully +[DESCRIPTION] +.\" Add any additional description here diff --git a/man/truncate.1 b/man/truncate.1 new file mode 100644 index 0000000..1d8f24b --- /dev/null +++ b/man/truncate.1 @@ -0,0 +1,64 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH TRUNCATE "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +truncate \- shrink or extend the size of a file to the specified size +.SH SYNOPSIS +.B truncate +\fI\,OPTION\/\fR... \fI\,FILE\/\fR... +.SH DESCRIPTION +.\" Add any additional description here +.PP +Shrink or extend the size of each FILE to the specified size +.PP +A FILE argument that does not exist is created. +.PP +If a FILE is larger than the specified size, the extra data is lost. +If a FILE is shorter, it is extended and the sparse extended part (hole) +reads as zero bytes. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\fB\-c\fR, \fB\-\-no\-create\fR +do not create any files +.TP +\fB\-o\fR, \fB\-\-io\-blocks\fR +treat SIZE as number of IO blocks instead of bytes +.TP +\fB\-r\fR, \fB\-\-reference\fR=\fI\,RFILE\/\fR +base size on RFILE +.TP +\fB\-s\fR, \fB\-\-size\fR=\fI\,SIZE\/\fR +set or adjust the file size by SIZE bytes +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.PP +The SIZE argument is an integer and optional unit (example: 10K is 10*1024). +Units are K,M,G,T,P,E,Z,Y,R,Q (powers of 1024) or KB,MB,... (powers of 1000). +Binary prefixes can be used, too: KiB=K, MiB=M, and so on. +.PP +SIZE may also be prefixed by one of the following modifying characters: +\&'+' extend by, '\-' reduce by, '<' at most, '>' at least, +\&'/' round down to multiple of, '%' round up to multiple of. +.SH AUTHOR +Written by Padraig Brady. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +\fBdd\fP(1), \fBtruncate\fP(2), \fBftruncate\fP(2) +.PP +.br +Full documentation <https://www.gnu.org/software/coreutils/truncate> +.br +or available locally via: info \(aq(coreutils) truncate invocation\(aq diff --git a/man/truncate.x b/man/truncate.x new file mode 100644 index 0000000..27a54b9 --- /dev/null +++ b/man/truncate.x @@ -0,0 +1,6 @@ +[NAME] +truncate \- shrink or extend the size of a file to the specified size +[DESCRIPTION] +.\" Add any additional description here +[SEE ALSO] +dd(1), truncate(2), ftruncate(2) diff --git a/man/tsort.1 b/man/tsort.1 new file mode 100644 index 0000000..78d1b1c --- /dev/null +++ b/man/tsort.1 @@ -0,0 +1,35 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH TSORT "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +tsort \- perform topological sort +.SH SYNOPSIS +.B tsort +[\fI\,OPTION\/\fR] [\fI\,FILE\/\fR] +.SH DESCRIPTION +.\" Add any additional description here +.PP +Write totally ordered list consistent with the partial ordering in FILE. +.PP +With no FILE, or when FILE is \-, read standard input. +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.SH AUTHOR +Written by Mark Kettenis. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +Full documentation <https://www.gnu.org/software/coreutils/tsort> +.br +or available locally via: info \(aq(coreutils) tsort invocation\(aq diff --git a/man/tsort.x b/man/tsort.x new file mode 100644 index 0000000..8ed3de9 --- /dev/null +++ b/man/tsort.x @@ -0,0 +1,4 @@ +[NAME] +tsort \- perform topological sort +[DESCRIPTION] +.\" Add any additional description here diff --git a/man/tty.1 b/man/tty.1 new file mode 100644 index 0000000..5ef7e0a --- /dev/null +++ b/man/tty.1 @@ -0,0 +1,36 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH TTY "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +tty \- print the file name of the terminal connected to standard input +.SH SYNOPSIS +.B tty +[\fI\,OPTION\/\fR]... +.SH DESCRIPTION +.\" Add any additional description here +.PP +Print the file name of the terminal connected to standard input. +.TP +\fB\-s\fR, \fB\-\-silent\fR, \fB\-\-quiet\fR +print nothing, only return an exit status +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.SH AUTHOR +Written by David MacKenzie. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +Full documentation <https://www.gnu.org/software/coreutils/tty> +.br +or available locally via: info \(aq(coreutils) tty invocation\(aq diff --git a/man/tty.x b/man/tty.x new file mode 100644 index 0000000..7f0996f --- /dev/null +++ b/man/tty.x @@ -0,0 +1,4 @@ +[NAME] +tty \- print the file name of the terminal connected to standard input +[DESCRIPTION] +.\" Add any additional description here diff --git a/man/uname.1 b/man/uname.1 new file mode 100644 index 0000000..3552fe9 --- /dev/null +++ b/man/uname.1 @@ -0,0 +1,64 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH UNAME "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +uname \- print system information +.SH SYNOPSIS +.B uname +[\fI\,OPTION\/\fR]... +.SH DESCRIPTION +.\" Add any additional description here +.PP +Print certain system information. With no OPTION, same as \fB\-s\fR. +.TP +\fB\-a\fR, \fB\-\-all\fR +print all information, in the following order, +except omit \fB\-p\fR and \fB\-i\fR if unknown: +.TP +\fB\-s\fR, \fB\-\-kernel\-name\fR +print the kernel name +.TP +\fB\-n\fR, \fB\-\-nodename\fR +print the network node hostname +.TP +\fB\-r\fR, \fB\-\-kernel\-release\fR +print the kernel release +.TP +\fB\-v\fR, \fB\-\-kernel\-version\fR +print the kernel version +.TP +\fB\-m\fR, \fB\-\-machine\fR +print the machine hardware name +.TP +\fB\-p\fR, \fB\-\-processor\fR +print the processor type (non\-portable) +.TP +\fB\-i\fR, \fB\-\-hardware\-platform\fR +print the hardware platform (non\-portable) +.TP +\fB\-o\fR, \fB\-\-operating\-system\fR +print the operating system +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.SH AUTHOR +Written by David MacKenzie. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +\fBarch\fP(1), \fBuname\fP(2) +.PP +.br +Full documentation <https://www.gnu.org/software/coreutils/uname> +.br +or available locally via: info \(aq(coreutils) uname invocation\(aq diff --git a/man/uname.x b/man/uname.x new file mode 100644 index 0000000..b27e86f --- /dev/null +++ b/man/uname.x @@ -0,0 +1,6 @@ +[NAME] +uname \- print system information +[DESCRIPTION] +.\" Add any additional description here +[SEE ALSO] +arch(1), uname(2) diff --git a/man/unexpand.1 b/man/unexpand.1 new file mode 100644 index 0000000..21bcfb6 --- /dev/null +++ b/man/unexpand.1 @@ -0,0 +1,57 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH UNEXPAND "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +unexpand \- convert spaces to tabs +.SH SYNOPSIS +.B unexpand +[\fI\,OPTION\/\fR]... [\fI\,FILE\/\fR]... +.SH DESCRIPTION +.\" Add any additional description here +.PP +Convert blanks in each FILE to tabs, writing to standard output. +.PP +With no FILE, or when FILE is \-, read standard input. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\fB\-a\fR, \fB\-\-all\fR +convert all blanks, instead of just initial blanks +.TP +\fB\-\-first\-only\fR +convert only leading sequences of blanks (overrides \fB\-a\fR) +.TP +\fB\-t\fR, \fB\-\-tabs\fR=\fI\,N\/\fR +have tabs N characters apart instead of 8 (enables \fB\-a\fR) +.TP +\fB\-t\fR, \fB\-\-tabs\fR=\fI\,LIST\/\fR +use comma separated list of tab positions. +The last specified position can be prefixed with '/' +to specify a tab size to use after the last +explicitly specified tab stop. Also a prefix of '+' +can be used to align remaining tab stops relative to +the last specified tab stop instead of the first column +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.SH AUTHOR +Written by David MacKenzie. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +\fBexpand\fP(1) +.PP +.br +Full documentation <https://www.gnu.org/software/coreutils/unexpand> +.br +or available locally via: info \(aq(coreutils) unexpand invocation\(aq diff --git a/man/unexpand.x b/man/unexpand.x new file mode 100644 index 0000000..08bc2ad --- /dev/null +++ b/man/unexpand.x @@ -0,0 +1,6 @@ +[NAME] +unexpand \- convert spaces to tabs +[DESCRIPTION] +.\" Add any additional description here +[SEE ALSO] +expand(1) diff --git a/man/uniq.1 b/man/uniq.1 new file mode 100644 index 0000000..b24de62 --- /dev/null +++ b/man/uniq.1 @@ -0,0 +1,83 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH UNIQ "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +uniq \- report or omit repeated lines +.SH SYNOPSIS +.B uniq +[\fI\,OPTION\/\fR]... [\fI\,INPUT \/\fR[\fI\,OUTPUT\/\fR]] +.SH DESCRIPTION +.\" Add any additional description here +.PP +Filter adjacent matching lines from INPUT (or standard input), +writing to OUTPUT (or standard output). +.PP +With no options, matching lines are merged to the first occurrence. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\fB\-c\fR, \fB\-\-count\fR +prefix lines by the number of occurrences +.TP +\fB\-d\fR, \fB\-\-repeated\fR +only print duplicate lines, one for each group +.TP +\fB\-D\fR +print all duplicate lines +.TP +\fB\-\-all\-repeated\fR[=\fI\,METHOD\/\fR] +like \fB\-D\fR, but allow separating groups +with an empty line; +METHOD={none(default),prepend,separate} +.TP +\fB\-f\fR, \fB\-\-skip\-fields\fR=\fI\,N\/\fR +avoid comparing the first N fields +.TP +\fB\-\-group\fR[=\fI\,METHOD\/\fR] +show all items, separating groups with an empty line; +METHOD={separate(default),prepend,append,both} +.TP +\fB\-i\fR, \fB\-\-ignore\-case\fR +ignore differences in case when comparing +.TP +\fB\-s\fR, \fB\-\-skip\-chars\fR=\fI\,N\/\fR +avoid comparing the first N characters +.TP +\fB\-u\fR, \fB\-\-unique\fR +only print unique lines +.TP +\fB\-z\fR, \fB\-\-zero\-terminated\fR +line delimiter is NUL, not newline +.TP +\fB\-w\fR, \fB\-\-check\-chars\fR=\fI\,N\/\fR +compare no more than N characters in lines +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.PP +A field is a run of blanks (usually spaces and/or TABs), then non\-blank +characters. Fields are skipped before chars. +.PP +Note: 'uniq' does not detect repeated lines unless they are adjacent. +You may want to sort the input first, or use 'sort \fB\-u\fR' without 'uniq'. +.SH AUTHOR +Written by Richard M. Stallman and David MacKenzie. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +\fBcomm\fP(1), \fBjoin\fP(1), \fBsort\fP(1) +.PP +.br +Full documentation <https://www.gnu.org/software/coreutils/uniq> +.br +or available locally via: info \(aq(coreutils) uniq invocation\(aq diff --git a/man/uniq.x b/man/uniq.x new file mode 100644 index 0000000..013cef3 --- /dev/null +++ b/man/uniq.x @@ -0,0 +1,6 @@ +[NAME] +uniq \- report or omit repeated lines +[DESCRIPTION] +.\" Add any additional description here +[SEE ALSO] +comm(1), join(1), sort(1) diff --git a/man/unlink.1 b/man/unlink.1 new file mode 100644 index 0000000..b7b5490 --- /dev/null +++ b/man/unlink.1 @@ -0,0 +1,39 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH UNLINK "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +unlink \- call the unlink function to remove the specified file +.SH SYNOPSIS +.B unlink +\fI\,FILE\/\fR +.br +.B unlink +\fI\,OPTION\/\fR +.SH DESCRIPTION +.\" Add any additional description here +.PP +Call the unlink function to remove the specified FILE. +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.SH AUTHOR +Written by Michael Stone. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +\fBunlink\fP(2) +.PP +.br +Full documentation <https://www.gnu.org/software/coreutils/unlink> +.br +or available locally via: info \(aq(coreutils) unlink invocation\(aq diff --git a/man/unlink.x b/man/unlink.x new file mode 100644 index 0000000..d12cc2e --- /dev/null +++ b/man/unlink.x @@ -0,0 +1,6 @@ +[NAME] +unlink \- call the unlink function to remove the specified file +[DESCRIPTION] +.\" Add any additional description here +[SEE ALSO] +unlink(2) diff --git a/man/uptime.1 b/man/uptime.1 new file mode 100644 index 0000000..ddc66fa --- /dev/null +++ b/man/uptime.1 @@ -0,0 +1,37 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH UPTIME "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +uptime \- tell how long the system has been running +.SH SYNOPSIS +.B uptime +[\fI\,OPTION\/\fR]... [\fI\,FILE\/\fR] +.SH DESCRIPTION +.\" Add any additional description here +.PP +Print the current time, the length of time the system has been up, +the number of users on the system, and the average number of jobs +in the run queue over the last 1, 5 and 15 minutes. Processes in +an uninterruptible sleep state also contribute to the load average. +If FILE is not specified, use \fI\,/var/run/utmp\/\fP. \fI\,/var/log/wtmp\/\fP as FILE is common. +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.SH AUTHOR +Written by Joseph Arceneaux, David MacKenzie, and Kaveh Ghazi. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +Full documentation <https://www.gnu.org/software/coreutils/uptime> +.br +or available locally via: info \(aq(coreutils) uptime invocation\(aq diff --git a/man/uptime.x b/man/uptime.x new file mode 100644 index 0000000..5a86581 --- /dev/null +++ b/man/uptime.x @@ -0,0 +1,4 @@ +[NAME] +uptime \- tell how long the system has been running +[DESCRIPTION] +.\" Add any additional description here diff --git a/man/users.1 b/man/users.1 new file mode 100644 index 0000000..0a5643f --- /dev/null +++ b/man/users.1 @@ -0,0 +1,37 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH USERS "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +users \- print the user names of users currently logged in to the current host +.SH SYNOPSIS +.B users +[\fI\,OPTION\/\fR]... [\fI\,FILE\/\fR] +.SH DESCRIPTION +.\" Add any additional description here +.PP +Output who is currently logged in according to FILE. +If FILE is not specified, use \fI\,/var/run/utmp\/\fP. \fI\,/var/log/wtmp\/\fP as FILE is common. +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.SH AUTHOR +Written by Joseph Arceneaux and David MacKenzie. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +\fBgetent\fP(1), \fBwho\fP(1) +.PP +.br +Full documentation <https://www.gnu.org/software/coreutils/users> +.br +or available locally via: info \(aq(coreutils) users invocation\(aq diff --git a/man/users.x b/man/users.x new file mode 100644 index 0000000..d15001e --- /dev/null +++ b/man/users.x @@ -0,0 +1,6 @@ +[NAME] +users \- print the user names of users currently logged in to the current host +[DESCRIPTION] +.\" Add any additional description here +[SEE ALSO] +getent(1), who(1) diff --git a/man/vdir.1 b/man/vdir.1 new file mode 100644 index 0000000..bafd22d --- /dev/null +++ b/man/vdir.1 @@ -0,0 +1,265 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH VDIR "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +vdir \- list directory contents +.SH SYNOPSIS +.B vdir +[\fI\,OPTION\/\fR]... [\fI\,FILE\/\fR]... +.SH DESCRIPTION +.\" Add any additional description here +.PP +List information about the FILEs (the current directory by default). +Sort entries alphabetically if none of \fB\-cftuvSUX\fR nor \fB\-\-sort\fR is specified. +.PP +Mandatory arguments to long options are mandatory for short options too. +.TP +\fB\-a\fR, \fB\-\-all\fR +do not ignore entries starting with . +.TP +\fB\-A\fR, \fB\-\-almost\-all\fR +do not list implied . and .. +.TP +\fB\-\-author\fR +with \fB\-l\fR, print the author of each file +.TP +\fB\-b\fR, \fB\-\-escape\fR +print C\-style escapes for nongraphic characters +.TP +\fB\-\-block\-size\fR=\fI\,SIZE\/\fR +with \fB\-l\fR, scale sizes by SIZE when printing them; +e.g., '\-\-block\-size=M'; see SIZE format below +.TP +\fB\-B\fR, \fB\-\-ignore\-backups\fR +do not list implied entries ending with ~ +.TP +\fB\-c\fR +with \fB\-lt\fR: sort by, and show, ctime (time of last +change of file status information); +with \fB\-l\fR: show ctime and sort by name; +otherwise: sort by ctime, newest first +.TP +\fB\-C\fR +list entries by columns +.TP +\fB\-\-color\fR[=\fI\,WHEN\/\fR] +color the output WHEN; more info below +.TP +\fB\-d\fR, \fB\-\-directory\fR +list directories themselves, not their contents +.TP +\fB\-D\fR, \fB\-\-dired\fR +generate output designed for Emacs' dired mode +.TP +\fB\-f\fR +list all entries in directory order +.TP +\fB\-F\fR, \fB\-\-classify\fR[=\fI\,WHEN\/\fR] +append indicator (one of */=>@|) to entries WHEN +.TP +\fB\-\-file\-type\fR +likewise, except do not append '*' +.TP +\fB\-\-format\fR=\fI\,WORD\/\fR +across \fB\-x\fR, commas \fB\-m\fR, horizontal \fB\-x\fR, long \fB\-l\fR, +single\-column \fB\-1\fR, verbose \fB\-l\fR, vertical \fB\-C\fR +.TP +\fB\-\-full\-time\fR +like \fB\-l\fR \fB\-\-time\-style\fR=\fI\,full\-iso\/\fR +.TP +\fB\-g\fR +like \fB\-l\fR, but do not list owner +.TP +\fB\-\-group\-directories\-first\fR +group directories before files; +can be augmented with a \fB\-\-sort\fR option, but any +use of \fB\-\-sort\fR=\fI\,none\/\fR (\fB\-U\fR) disables grouping +.TP +\fB\-G\fR, \fB\-\-no\-group\fR +in a long listing, don't print group names +.TP +\fB\-h\fR, \fB\-\-human\-readable\fR +with \fB\-l\fR and \fB\-s\fR, print sizes like 1K 234M 2G etc. +.TP +\fB\-\-si\fR +likewise, but use powers of 1000 not 1024 +.TP +\fB\-H\fR, \fB\-\-dereference\-command\-line\fR +follow symbolic links listed on the command line +.TP +\fB\-\-dereference\-command\-line\-symlink\-to\-dir\fR +follow each command line symbolic link +that points to a directory +.TP +\fB\-\-hide\fR=\fI\,PATTERN\/\fR +do not list implied entries matching shell PATTERN +(overridden by \fB\-a\fR or \fB\-A\fR) +.TP +\fB\-\-hyperlink\fR[=\fI\,WHEN\/\fR] +hyperlink file names WHEN +.TP +\fB\-\-indicator\-style\fR=\fI\,WORD\/\fR +append indicator with style WORD to entry names: +none (default), slash (\fB\-p\fR), +file\-type (\fB\-\-file\-type\fR), classify (\fB\-F\fR) +.TP +\fB\-i\fR, \fB\-\-inode\fR +print the index number of each file +.TP +\fB\-I\fR, \fB\-\-ignore\fR=\fI\,PATTERN\/\fR +do not list implied entries matching shell PATTERN +.TP +\fB\-k\fR, \fB\-\-kibibytes\fR +default to 1024\-byte blocks for file system usage; +used only with \fB\-s\fR and per directory totals +.TP +\fB\-l\fR +use a long listing format +.TP +\fB\-L\fR, \fB\-\-dereference\fR +when showing file information for a symbolic +link, show information for the file the link +references rather than for the link itself +.TP +\fB\-m\fR +fill width with a comma separated list of entries +.TP +\fB\-n\fR, \fB\-\-numeric\-uid\-gid\fR +like \fB\-l\fR, but list numeric user and group IDs +.TP +\fB\-N\fR, \fB\-\-literal\fR +print entry names without quoting +.TP +\fB\-o\fR +like \fB\-l\fR, but do not list group information +.TP +\fB\-p\fR, \fB\-\-indicator\-style\fR=\fI\,slash\/\fR +append / indicator to directories +.TP +\fB\-q\fR, \fB\-\-hide\-control\-chars\fR +print ? instead of nongraphic characters +.TP +\fB\-\-show\-control\-chars\fR +show nongraphic characters as\-is (the default, +unless program is 'ls' and output is a terminal) +.TP +\fB\-Q\fR, \fB\-\-quote\-name\fR +enclose entry names in double quotes +.TP +\fB\-\-quoting\-style\fR=\fI\,WORD\/\fR +use quoting style WORD for entry names: +literal, locale, shell, shell\-always, +shell\-escape, shell\-escape\-always, c, escape +(overrides QUOTING_STYLE environment variable) +.TP +\fB\-r\fR, \fB\-\-reverse\fR +reverse order while sorting +.TP +\fB\-R\fR, \fB\-\-recursive\fR +list subdirectories recursively +.TP +\fB\-s\fR, \fB\-\-size\fR +print the allocated size of each file, in blocks +.TP +\fB\-S\fR +sort by file size, largest first +.TP +\fB\-\-sort\fR=\fI\,WORD\/\fR +sort by WORD instead of name: none (\fB\-U\fR), size (\fB\-S\fR), +time (\fB\-t\fR), version (\fB\-v\fR), extension (\fB\-X\fR), width +.TP +\fB\-\-time\fR=\fI\,WORD\/\fR +select which timestamp used to display or sort; +access time (\fB\-u\fR): atime, access, use; +metadata change time (\fB\-c\fR): ctime, status; +modified time (default): mtime, modification; +birth time: birth, creation; +.IP +with \fB\-l\fR, WORD determines which time to show; +with \fB\-\-sort\fR=\fI\,time\/\fR, sort by WORD (newest first) +.TP +\fB\-\-time\-style\fR=\fI\,TIME_STYLE\/\fR +time/date format with \fB\-l\fR; see TIME_STYLE below +.TP +\fB\-t\fR +sort by time, newest first; see \fB\-\-time\fR +.TP +\fB\-T\fR, \fB\-\-tabsize\fR=\fI\,COLS\/\fR +assume tab stops at each COLS instead of 8 +.TP +\fB\-u\fR +with \fB\-lt\fR: sort by, and show, access time; +with \fB\-l\fR: show access time and sort by name; +otherwise: sort by access time, newest first +.TP +\fB\-U\fR +do not sort; list entries in directory order +.TP +\fB\-v\fR +natural sort of (version) numbers within text +.TP +\fB\-w\fR, \fB\-\-width\fR=\fI\,COLS\/\fR +set output width to COLS. 0 means no limit +.TP +\fB\-x\fR +list entries by lines instead of by columns +.TP +\fB\-X\fR +sort alphabetically by entry extension +.TP +\fB\-Z\fR, \fB\-\-context\fR +print any security context of each file +.TP +\fB\-\-zero\fR +end each output line with NUL, not newline +.TP +\fB\-1\fR +list one file per line +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.PP +The SIZE argument is an integer and optional unit (example: 10K is 10*1024). +Units are K,M,G,T,P,E,Z,Y,R,Q (powers of 1024) or KB,MB,... (powers of 1000). +Binary prefixes can be used, too: KiB=K, MiB=M, and so on. +.PP +The TIME_STYLE argument can be full\-iso, long\-iso, iso, locale, or +FORMAT. +FORMAT is interpreted like in \fBdate\fP(1). If FORMAT is FORMAT1<newline>FORMAT2, +then FORMAT1 applies to non\-recent files and FORMAT2 to recent files. +TIME_STYLE prefixed with 'posix\-' takes effect only outside the POSIX locale. +Also the TIME_STYLE environment variable sets the default style to use. +.PP +The WHEN argument defaults to 'always' and can also be 'auto' or 'never'. +.PP +Using color to distinguish file types is disabled both by default and +with \fB\-\-color\fR=\fI\,never\/\fR. With \fB\-\-color\fR=\fI\,auto\/\fR, ls emits color codes only when +standard output is connected to a terminal. The LS_COLORS environment +variable can change the settings. Use the \fBdircolors\fP(1) command to set it. +.SS "Exit status:" +.TP +0 +if OK, +.TP +1 +if minor problems (e.g., cannot access subdirectory), +.TP +2 +if serious trouble (e.g., cannot access command\-line argument). +.SH AUTHOR +Written by Richard M. Stallman and David MacKenzie. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +Full documentation <https://www.gnu.org/software/coreutils/vdir> +.br +or available locally via: info \(aq(coreutils) vdir invocation\(aq diff --git a/man/vdir.x b/man/vdir.x new file mode 100644 index 0000000..60c02b7 --- /dev/null +++ b/man/vdir.x @@ -0,0 +1,4 @@ +[NAME] +vdir \- list directory contents +[DESCRIPTION] +.\" Add any additional description here diff --git a/man/wc.1 b/man/wc.1 new file mode 100644 index 0000000..878255b --- /dev/null +++ b/man/wc.1 @@ -0,0 +1,67 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH WC "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +wc \- print newline, word, and byte counts for each file +.SH SYNOPSIS +.B wc +[\fI\,OPTION\/\fR]... [\fI\,FILE\/\fR]... +.br +.B wc +[\fI\,OPTION\/\fR]... \fI\,--files0-from=F\/\fR +.SH DESCRIPTION +.\" Add any additional description here +.PP +Print newline, word, and byte counts for each FILE, and a total line if +more than one FILE is specified. A word is a non\-zero\-length sequence of +printable characters delimited by white space. +.PP +With no FILE, or when FILE is \-, read standard input. +.PP +The options below may be used to select which counts are printed, always in +the following order: newline, word, character, byte, maximum line length. +.TP +\fB\-c\fR, \fB\-\-bytes\fR +print the byte counts +.TP +\fB\-m\fR, \fB\-\-chars\fR +print the character counts +.TP +\fB\-l\fR, \fB\-\-lines\fR +print the newline counts +.TP +\fB\-\-files0\-from\fR=\fI\,F\/\fR +read input from the files specified by +NUL\-terminated names in file F; +If F is \- then read names from standard input +.TP +\fB\-L\fR, \fB\-\-max\-line\-length\fR +print the maximum display width +.TP +\fB\-w\fR, \fB\-\-words\fR +print the word counts +.TP +\fB\-\-total\fR=\fI\,WHEN\/\fR +when to print a line with total counts; +WHEN can be: auto, always, only, never +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.SH AUTHOR +Written by Paul Rubin and David MacKenzie. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +Full documentation <https://www.gnu.org/software/coreutils/wc> +.br +or available locally via: info \(aq(coreutils) wc invocation\(aq diff --git a/man/wc.x b/man/wc.x new file mode 100644 index 0000000..e1d9b4b --- /dev/null +++ b/man/wc.x @@ -0,0 +1,4 @@ +[NAME] +wc \- print newline, word, and byte counts for each file +[DESCRIPTION] +.\" Add any additional description here diff --git a/man/who.1 b/man/who.1 new file mode 100644 index 0000000..300dcf3 --- /dev/null +++ b/man/who.1 @@ -0,0 +1,84 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH WHO "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +who \- show who is logged on +.SH SYNOPSIS +.B who +[\fI\,OPTION\/\fR]... [ \fI\,FILE | ARG1 ARG2 \/\fR] +.SH DESCRIPTION +.\" Add any additional description here +.PP +Print information about users who are currently logged in. +.TP +\fB\-a\fR, \fB\-\-all\fR +same as \fB\-b\fR \fB\-d\fR \fB\-\-login\fR \fB\-p\fR \fB\-r\fR \fB\-t\fR \fB\-T\fR \fB\-u\fR +.TP +\fB\-b\fR, \fB\-\-boot\fR +time of last system boot +.TP +\fB\-d\fR, \fB\-\-dead\fR +print dead processes +.TP +\fB\-H\fR, \fB\-\-heading\fR +print line of column headings +.TP +\fB\-l\fR, \fB\-\-login\fR +print system login processes +.TP +\fB\-\-lookup\fR +attempt to canonicalize hostnames via DNS +.TP +\fB\-m\fR +only hostname and user associated with stdin +.TP +\fB\-p\fR, \fB\-\-process\fR +print active processes spawned by init +.TP +\fB\-q\fR, \fB\-\-count\fR +all login names and number of users logged on +.TP +\fB\-r\fR, \fB\-\-runlevel\fR +print current runlevel +.TP +\fB\-s\fR, \fB\-\-short\fR +print only name, line, and time (default) +.TP +\fB\-t\fR, \fB\-\-time\fR +print last system clock change +.TP +\fB\-T\fR, \fB\-w\fR, \fB\-\-mesg\fR +add user's message status as +, \- or ? +.TP +\fB\-u\fR, \fB\-\-users\fR +list users logged in +.TP +\fB\-\-message\fR +same as \fB\-T\fR +.TP +\fB\-\-writable\fR +same as \fB\-T\fR +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.PP +If FILE is not specified, use \fI\,/var/run/utmp\/\fP. \fI\,/var/log/wtmp\/\fP as FILE is common. +If ARG1 ARG2 given, \fB\-m\fR presumed: 'am i' or 'mom likes' are usual. +.SH AUTHOR +Written by Joseph Arceneaux, David MacKenzie, and Michael Stone. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +Full documentation <https://www.gnu.org/software/coreutils/who> +.br +or available locally via: info \(aq(coreutils) who invocation\(aq diff --git a/man/who.x b/man/who.x new file mode 100644 index 0000000..02b039e --- /dev/null +++ b/man/who.x @@ -0,0 +1,4 @@ +[NAME] +who \- show who is logged on +[DESCRIPTION] +.\" Add any additional description here diff --git a/man/whoami.1 b/man/whoami.1 new file mode 100644 index 0000000..70dc83f --- /dev/null +++ b/man/whoami.1 @@ -0,0 +1,34 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH WHOAMI "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +whoami \- print effective user name +.SH SYNOPSIS +.B whoami +[\fI\,OPTION\/\fR]... +.SH DESCRIPTION +.\" Add any additional description here +.PP +Print the user name associated with the current effective user ID. +Same as id \fB\-un\fR. +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.SH AUTHOR +Written by Richard Mlynarik. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +Full documentation <https://www.gnu.org/software/coreutils/whoami> +.br +or available locally via: info \(aq(coreutils) whoami invocation\(aq diff --git a/man/whoami.x b/man/whoami.x new file mode 100644 index 0000000..e7521e5 --- /dev/null +++ b/man/whoami.x @@ -0,0 +1,4 @@ +[NAME] +whoami \- print effective user name +[DESCRIPTION] +.\" Add any additional description here diff --git a/man/yes.1 b/man/yes.1 new file mode 100644 index 0000000..5aa5392 --- /dev/null +++ b/man/yes.1 @@ -0,0 +1,36 @@ +.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.48.5. +.TH YES "1" "August 2023" "GNU coreutils 9.4" "User Commands" +.SH NAME +yes \- output a string repeatedly until killed +.SH SYNOPSIS +.B yes +[\fI\,STRING\/\fR]... +.br +.B yes +\fI\,OPTION\/\fR +.SH DESCRIPTION +.\" Add any additional description here +.PP +Repeatedly output a line with all specified STRING(s), or 'y'. +.TP +\fB\-\-help\fR +display this help and exit +.TP +\fB\-\-version\fR +output version information and exit +.SH AUTHOR +Written by David MacKenzie. +.SH "REPORTING BUGS" +GNU coreutils online help: <https://www.gnu.org/software/coreutils/> +.br +Report any translation bugs to <https://translationproject.org/team/> +.SH COPYRIGHT +Copyright \(co 2023 Free Software Foundation, Inc. +License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>. +.br +This is free software: you are free to change and redistribute it. +There is NO WARRANTY, to the extent permitted by law. +.SH "SEE ALSO" +Full documentation <https://www.gnu.org/software/coreutils/yes> +.br +or available locally via: info \(aq(coreutils) yes invocation\(aq diff --git a/man/yes.x b/man/yes.x new file mode 100644 index 0000000..ff0a9e3 --- /dev/null +++ b/man/yes.x @@ -0,0 +1,4 @@ +[NAME] +yes \- output a string repeatedly until killed +[DESCRIPTION] +.\" Add any additional description here |