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
|
2013-08-14 01:15:04 +08:00
|
|
|
.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)
|