dmenu/stest.1

91 lines
1.5 KiB
Groff
Raw Normal View History

2011-11-20 02:54:55 +08:00
.TH STEST 1 dmenu\-VERSION
.SH NAME
stest \- filter a list of files by properties
.SH SYNOPSIS
.B stest
2011-11-28 06:35:09 +08:00
.RB [ -abcdefghlpqrsuwx ]
2011-11-20 02:54:55 +08:00
.RB [ -n
.IR file ]
.RB [ -o
.IR file ]
.RI [ file ...]
.SH DESCRIPTION
.B stest
takes a list of files and filters by the files' properties, analogous to
.IR test (1).
2011-12-09 18:49:44 +08:00
Files which pass all tests are printed to stdout. If no files are given, stest
reads files from stdin.
2011-11-20 02:54:55 +08:00
.SH OPTIONS
.TP
2011-11-28 06:35:09 +08:00
.B \-a
Test hidden files.
2011-11-20 02:54:55 +08:00
.TP
.B \-b
Test that files are block specials.
.TP
.B \-c
Test that files are character specials.
.TP
.B \-d
Test that files are directories.
.TP
.B \-e
Test that files exist.
.TP
.B \-f
Test that files are regular files.
.TP
.B \-g
Test that files have their set-group-ID flag set.
.TP
.B \-h
Test that files are symbolic links.
.TP
2011-11-28 06:35:09 +08:00
.B \-l
Test the contents of a directory given as an argument.
.TP
2011-11-20 02:54:55 +08:00
.BI \-n " file"
Test that files are newer than
.IR file .
.TP
.BI \-o " file"
Test that files are older than
.IR file .
.TP
.B \-p
Test that files are named pipes.
.TP
.B \-q
No files are printed, only the exit status is returned.
.TP
.B \-r
Test that files are readable.
.TP
.B \-s
Test that files are not empty.
.TP
.B \-u
Test that files have their set-user-ID flag set.
.TP
.B \-v
Invert the sense of tests, only failing files pass.
.TP
2011-11-20 02:54:55 +08:00
.B \-w
Test that files are writable.
.TP
.B \-x
Test that files are executable.
.SH EXIT STATUS
.TP
.B 0
At least one file passed all tests.
.TP
.B 1
No files passed all tests.
.TP
.B 2
An error occurred.
.SH SEE ALSO
.IR dmenu (1),
.IR test (1)