aboutsummaryrefslogtreecommitdiff
path: root/stest.1
diff options
context:
space:
mode:
Diffstat (limited to 'stest.1')
-rw-r--r--stest.187
1 files changed, 87 insertions, 0 deletions
diff --git a/stest.1 b/stest.1
new file mode 100644
index 0000000..cafd4bb
--- /dev/null
+++ b/stest.1
@@ -0,0 +1,87 @@
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 [ -bcdefghpqrsuwx ]
7.RB [ -C
8.IR dir ]
9.RB [ -n
10.IR file ]
11.RB [ -o
12.IR file ]
13.RI [ file ...]
14.SH DESCRIPTION
15.B stest
16takes a list of files and filters by the files' properties, analogous to
17.IR test (1).
18Files which pass all tests are printed to stdout. If no files are given as
19arguments, stest will read a list of files from stdin, one path per line.
20.SH OPTIONS
21.TP
22.BI \-C " dir"
23Tests files relative to directory
24.IR dir .
25.TP
26.B \-b
27Test that files are block specials.
28.TP
29.B \-c
30Test that files are character specials.
31.TP
32.B \-d
33Test that files are directories.
34.TP
35.B \-e
36Test that files exist.
37.TP
38.B \-f
39Test that files are regular files.
40.TP
41.B \-g
42Test that files have their set-group-ID flag set.
43.TP
44.B \-h
45Test that files are symbolic links.
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 \-w
71Test that files are writable.
72.TP
73.B \-x
74Test that files are executable.
75.SH EXIT STATUS
76.TP
77.B 0
78At least one file passed all tests.
79.TP
80.B 1
81No files passed all tests.
82.TP
83.B 2
84An error occurred.
85.SH SEE ALSO
86.IR dmenu (1),
87.IR test (1)