commit: 83674e6a3bb8f97a7853b16cdd82dbb114a0d8ed
parent 9418f1e1b11321d1e4da952aeb655272d01e99db
Author: Haelwenn (lanodan) Monnier <contact@hacktivis.me>
Date: Mon, 29 Sep 2025 19:53:17 +0200
oasis 771cb9e0f4
Diffstat:
3 files changed, 211 insertions(+), 0 deletions(-)
diff --git a/share/man/man1/getconf.1 b/share/man/man1/getconf.1
@@ -0,0 +1,90 @@
+.\" utils-std: Collection of commonly available Unix tools
+.\" Copyright 2017 Haelwenn (lanodan) Monnier <contact+utils@hacktivis.me>
+.\" SPDX-License-Identifier: 0BSD
+.Dd March 17, 2025
+.Dt GETCONF 1
+.Os
+.Sh NAME
+.Nm getconf
+.Nd get configuration values
+.Sh SYNOPSIS
+.Nm
+.Ar system_var
+.Nm
+.Ar path_var
+.Ar path
+.Nm
+.Fl a
+.Op Ar path
+.Sh DESCRIPTION
+In the first synopsis form,
+.Nm
+prints the system variable specified by the
+.Ar system_var
+operand.
+Which are obtained, in order, by:
+.Xr sysconf 3 ;
+.Xr confstr 3 ;
+.Xr limits.h 0 .
+.Pp
+In the second synopsis form,
+.Nm
+prints the variable specified by the
+.Ar path_var
+operand for the path specified by the
+.Ar path
+operand.
+Which are obtained via
+.Xr pathconf 3 .
+.Pp
+When
+.Fl a
+is set
+.Nm
+prints all the known system and path variables.
+If
+.Ar path
+is unspecified,
+.Nm
+behaves as if it was set to
+.Ql \&.
+.Sh STDOUT
+If the specified variable is found, it is printed out as-is,
+when it isn't found but valid it is printed as "undefined".
+.Pp
+When
+.Fl a
+is used,
+each variable is printed on a line in "name: value" format,
+with "value" being
+.Ql undefined
+when not found.
+.Sh EXIT STATUS
+.Ex -std
+.Sh EXAMPLES
+Getting the maximum amount of supplemental groups:
+.Dl Cm getconf NGROUPS_MAX
+.Pp
+Getting the maximum amount of bytes a filename can hold in
+the current directory:
+.Dl Cm getconf NAME_MAX ./
+.Sh SEE ALSO
+.Xr limits.h 0p ,
+.Xr confstr 3 ,
+.Xr pathconf 3 ,
+.Xr sysconf 3
+.Sh STANDARDS
+Except for it's lack of support of the
+.Fl v Ar specification
+argument,
+.Nm
+should be compliant with the
+IEEE Std 1003.1-2024 (“POSIX.1”)
+specification.
+.Pp
+The
+.Fl a
+option was added in
+.Lk https://www.austingroupbugs.net/view.php?id=1808 "0001808: Add option -a to getconf utility - Austin Group Issue Tracker"
+.Sh AUTHORS
+.An Haelwenn (lanodan) Monnier Aq Mt contact+utils@hacktivis.me
diff --git a/share/man/man1/readlink.1 b/share/man/man1/readlink.1
@@ -0,0 +1,77 @@
+.\" utils-std: Collection of commonly available Unix tools
+.\" Copyright 2017 Haelwenn (lanodan) Monnier <contact+utils@hacktivis.me>
+.\" SPDX-License-Identifier: MPL-2.0
+.Dd July 25, 2024
+.Dt READLINK 1
+.Os
+.Sh NAME
+.Nm readlink
+.Nd print content of a symbolic link
+.Sh SYNOPSIS
+.Nm
+.Op Fl f Ns | Ns Fl e
+.Op Fl n Ns | Ns Fl z
+.Ar path
+.Sh DESCRIPTION
+Note: For canonicalization of a path, use the
+.Xr realpath 1
+utility instead for better portability.
+.Pp
+The
+.Nm
+utility reads the symbolic link of each
+.Ar path
+and prints it.
+.Pp
+If
+.Ar path
+is not a symbolic link,
+.Nm
+errors out.
+.Sh OPTIONS
+.Bl -tag -width _n
+.It Fl f
+Canonicalize
+.Ar path
+with following every symlink, all but the last path component are required to exists.
+.It Fl e
+Canonicalize
+.Ar path
+with following every symlink, all path component must exists.
+.It Fl n
+Do not print a trailing separator.
+.It Fl z
+Use NULL byte as separator instead of newlines.
+.El
+.Sh EXIT STATUS
+.Ex -std
+.Sh EXAMPLES
+Assign
+.Pa //example.org/
+to
+.Pa foobar
+and read it:
+.Bd -literal
+ $ ln -s //example.org/ foobar
+ $ readlink foobar
+ //example.org/
+.Ed
+.Sh SEE ALSO
+.Xr ln 1 ,
+.Xr readlink 3
+.Sh STANDARDS
+.Nm
+should be compliant with the
+IEEE Std 1003.1-2024 (“POSIX.1”)
+specification.
+.Pp
+The options
+.Fl f ,
+.Fl e
+and
+.Fl z
+and support for multiple
+.Ar path
+arguments are extensions present for compatibility with existing software.
+.Sh AUTHORS
+.An Haelwenn (lanodan) Monnier Aq Mt contact+utils@hacktivis.me
diff --git a/share/man/man1/uuencode.1 b/share/man/man1/uuencode.1
@@ -0,0 +1,44 @@
+.\" utils-std: Collection of commonly available Unix tools
+.\" Copyright 2017 Haelwenn (lanodan) Monnier <contact+utils@hacktivis.me>
+.\" SPDX-License-Identifier: MPL-2.0
+.Dd March 25, 2025
+.Dt UUENCODE 1
+.Os
+.Sh NAME
+.Nm uuencode
+.Nd encode data into uuencoding/base64 to standard output
+.Sh SYNOPSIS
+.Nm
+.Op Fl m
+.Op Oo Ar file Oc Ar decode_pathname
+.Sh DESCRIPTION
+.Nm
+reads
+.Ar file ,
+encode it in uuencoding or base64 and writes the results into standard output.
+If no
+.Ar file
+is given,
+.Nm
+reads from the standard input.
+If no
+.Ar decode_pathname
+is given for the path printed in the output, then
+.Ql -
+is used.
+.Sh OPTIONS
+.Bl -tag -width _m
+.It Fl m
+Encode data into base64
+.El
+.Sh EXIT STATUS
+.Ex -std
+.Sh SEE ALSO
+.Xr base64 1
+.Sh STANDARDS
+.Nm
+should be compliant with the
+IEEE Std 1003.1-2024 (“POSIX.1”)
+specification.
+.Sh AUTHORS
+.An Haelwenn (lanodan) Monnier Aq Mt contact+utils@hacktivis.me
