2024-02-16 08:40:38 +00:00
|
|
|
.\" Copyright (c) 2024 DTB <trinity@trinity.moe>
|
2024-03-27 00:26:51 +00:00
|
|
|
.\" Copyright (c) 2024 Emma Tebibyte <emma@tebibyte.media>
|
2024-02-16 08:40:38 +00:00
|
|
|
.\"
|
|
|
|
.\" This work is licensed under CC BY-SA 4.0. To see a copy of this license,
|
|
|
|
.\" visit <http://creativecommons.org/licenses/by-sa/4.0/>.
|
2024-06-03 00:47:14 +00:00
|
|
|
.\"
|
2024-02-16 08:40:38 +00:00
|
|
|
.TH scrut 1
|
|
|
|
.SH NAME
|
2024-02-18 06:12:39 +00:00
|
|
|
scrut \(en scrutinize file properties
|
2024-02-16 08:40:38 +00:00
|
|
|
.SH SYNOPSIS
|
2024-06-03 00:47:14 +00:00
|
|
|
.\"
|
2024-02-16 08:40:38 +00:00
|
|
|
scrut
|
|
|
|
.RB ( -bcdefgkprsuwxLS )
|
|
|
|
.RB [ file... ]
|
2024-06-03 00:47:14 +00:00
|
|
|
.\"
|
2024-02-16 08:40:38 +00:00
|
|
|
.SH DESCRIPTION
|
2024-06-03 00:47:14 +00:00
|
|
|
.\"
|
2024-03-27 01:22:30 +00:00
|
|
|
Determine if files comply with requirements.
|
2024-06-03 00:47:14 +00:00
|
|
|
.\"
|
2024-02-16 08:40:38 +00:00
|
|
|
.SH OPTIONS
|
2024-06-03 00:47:14 +00:00
|
|
|
.\"
|
|
|
|
.IP -L
|
2024-03-27 00:26:51 +00:00
|
|
|
Requires the given files to exist and be symbolic links.
|
2024-06-03 00:47:14 +00:00
|
|
|
.IP -S
|
2024-03-27 00:26:51 +00:00
|
|
|
Requires the given files to exist and be sockets.
|
2024-06-03 00:47:14 +00:00
|
|
|
.IP -b
|
2024-03-27 00:26:51 +00:00
|
|
|
Requires the given files to exist and be block special files.
|
2024-06-03 00:47:14 +00:00
|
|
|
.IP -c
|
2024-03-27 00:26:51 +00:00
|
|
|
Requires the given files to exist and be character special files.
|
2024-06-03 00:47:14 +00:00
|
|
|
.IP -d
|
2024-03-27 00:26:51 +00:00
|
|
|
Requires the given files to exist and be directories.
|
2024-06-03 00:47:14 +00:00
|
|
|
.IP -e
|
2024-03-27 00:26:51 +00:00
|
|
|
Requires the given files to exist, and is redundant to any other option.
|
2024-06-03 00:47:14 +00:00
|
|
|
.IP -e
|
2024-03-27 00:26:51 +00:00
|
|
|
Requires the given files to exist and be regular files.
|
2024-06-03 00:47:14 +00:00
|
|
|
.IP -g
|
2024-03-27 00:26:51 +00:00
|
|
|
Requires the given files to exist and have their set group ID flags set.
|
2024-06-03 00:47:14 +00:00
|
|
|
.IP -k
|
2024-03-27 00:26:51 +00:00
|
|
|
Requires the given files to exist and have their sticky bit set.
|
2024-06-03 00:47:14 +00:00
|
|
|
.IP -p
|
2024-03-27 00:26:51 +00:00
|
|
|
Requires the given files to exist and be named pipes.
|
2024-06-03 00:47:14 +00:00
|
|
|
.IP -r
|
2024-03-27 00:26:51 +00:00
|
|
|
Requires the given files to exist and be readable.
|
2024-06-03 00:47:14 +00:00
|
|
|
.IP -u
|
2024-03-27 00:26:51 +00:00
|
|
|
Requires the given files to exist and have their set user ID flags set.
|
2024-06-03 00:47:14 +00:00
|
|
|
.IP -w
|
2024-03-27 00:26:51 +00:00
|
|
|
Requires the given files to exist and be writable.
|
2024-06-03 00:47:14 +00:00
|
|
|
.IP -x
|
2024-03-27 00:26:51 +00:00
|
|
|
Requires the given files to exist and be executable.
|
2024-06-03 00:47:14 +00:00
|
|
|
.\"
|
|
|
|
.SH DIAGNOSTICS
|
|
|
|
.\"
|
2024-03-27 01:22:30 +00:00
|
|
|
If the given files comply with the specified requirements, the program will exit
|
|
|
|
successfully. If not, it exits unsuccessfully.
|
|
|
|
|
|
|
|
When invoked incorrectly, a debug message will be printed and the program will
|
2024-06-03 00:47:14 +00:00
|
|
|
exit with the appropriate
|
|
|
|
.BR sysexits.h (3)
|
|
|
|
error code.
|
|
|
|
.\"
|
|
|
|
.SH RATIONALE
|
|
|
|
.\"
|
|
|
|
The
|
|
|
|
.BR test (1p)
|
|
|
|
utility contains functionality that was broken out into separate programs. Thus,
|
|
|
|
the scope of this program is narrower than it. Notably, the
|
2024-02-16 08:40:38 +00:00
|
|
|
.B -h
|
2024-02-18 06:12:39 +00:00
|
|
|
option is now invalid and therefore shows usage information instead of being an
|
|
|
|
alias to the modern
|
2024-02-16 08:40:38 +00:00
|
|
|
.B -L
|
|
|
|
option.
|
2024-06-03 00:47:14 +00:00
|
|
|
.\"
|
2024-02-16 08:40:38 +00:00
|
|
|
.SH AUTHOR
|
2024-06-03 00:47:14 +00:00
|
|
|
.\"
|
|
|
|
Written by DTB
|
|
|
|
.MT trinity@trinity.moe
|
|
|
|
.ME .
|
|
|
|
.\"
|
2024-02-16 08:40:38 +00:00
|
|
|
.SH COPYRIGHT
|
|
|
|
|
2024-06-03 00:47:14 +00:00
|
|
|
Copyright \(co 2024 DTB. License AGPLv3+: GNU AGPL version 3 or later
|
2024-02-16 08:40:38 +00:00
|
|
|
<https://gnu.org/licenses/agpl.html>.
|
|
|
|
|
|
|
|
.SH SEE ALSO
|
|
|
|
|
2024-06-03 00:47:14 +00:00
|
|
|
.BR access (3p),
|
|
|
|
.BR lstat (3p),
|
|
|
|
.BR test (1p)
|