stest.1
1.TH STEST 1 dmenu\-VERSION
2.SH NAME
3stest \- filter a list of files by properties
4.SH SYNOPSIS
5.B stest
6.RB [ -abcdefghlpqrsuwx ]
7.RB [ -n
8.IR file ]
9.RB [ -o
10.IR file ]
11.RI [ file ...]
12.SH DESCRIPTION
13.B stest
14takes a list of files and filters by the files' properties, analogous to
15.IR test (1).
16Files which pass all tests are printed to stdout. If no files are given, stest
17reads files from stdin.
18.SH OPTIONS
19.TP
20.B \-a
21Test hidden files.
22.TP
23.B \-b
24Test that files are block specials.
25.TP
26.B \-c
27Test that files are character specials.
28.TP
29.B \-d
30Test that files are directories.
31.TP
32.B \-e
33Test that files exist.
34.TP
35.B \-f
36Test that files are regular files.
37.TP
38.B \-g
39Test that files have their set-group-ID flag set.
40.TP
41.B \-h
42Test that files are symbolic links.
43.TP
44.B \-l
45Test the contents of a directory given as an argument.
46.TP
47.BI \-n " file"
48Test that files are newer than
49.IR file .
50.TP
51.BI \-o " file"
52Test that files are older than
53.IR file .
54.TP
55.B \-p
56Test that files are named pipes.
57.TP
58.B \-q
59No files are printed, only the exit status is returned.
60.TP
61.B \-r
62Test that files are readable.
63.TP
64.B \-s
65Test that files are not empty.
66.TP
67.B \-u
68Test that files have their set-user-ID flag set.
69.TP
70.B \-v
71Invert the sense of tests, only failing files pass.
72.TP
73.B \-w
74Test that files are writable.
75.TP
76.B \-x
77Test that files are executable.
78.SH EXIT STATUS
79.TP
80.B 0
81At least one file passed all tests.
82.TP
83.B 1
84No files passed all tests.
85.TP
86.B 2
87An error occurred.
88.SH SEE ALSO
89.IR dmenu (1),
90.IR test (1)
