diff options
Diffstat (limited to 'stest.1')
-rw-r--r-- | stest.1 | 87 |
1 files changed, 87 insertions, 0 deletions
@@ -0,0 +1,87 @@ | |||
1 | .TH STEST 1 dmenu\-VERSION | ||
2 | .SH NAME | ||
3 | stest \- 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 | ||
16 | takes a list of files and filters by the files' properties, analogous to | ||
17 | .IR test (1). | ||
18 | Files which pass all tests are printed to stdout. If no files are given as | ||
19 | arguments, stest will read a list of files from stdin, one path per line. | ||
20 | .SH OPTIONS | ||
21 | .TP | ||
22 | .BI \-C " dir" | ||
23 | Tests files relative to directory | ||
24 | .IR dir . | ||
25 | .TP | ||
26 | .B \-b | ||
27 | Test that files are block specials. | ||
28 | .TP | ||
29 | .B \-c | ||
30 | Test that files are character specials. | ||
31 | .TP | ||
32 | .B \-d | ||
33 | Test that files are directories. | ||
34 | .TP | ||
35 | .B \-e | ||
36 | Test that files exist. | ||
37 | .TP | ||
38 | .B \-f | ||
39 | Test that files are regular files. | ||
40 | .TP | ||
41 | .B \-g | ||
42 | Test that files have their set-group-ID flag set. | ||
43 | .TP | ||
44 | .B \-h | ||
45 | Test that files are symbolic links. | ||
46 | .TP | ||
47 | .BI \-n " file" | ||
48 | Test that files are newer than | ||
49 | .IR file . | ||
50 | .TP | ||
51 | .BI \-o " file" | ||
52 | Test that files are older than | ||
53 | .IR file . | ||
54 | .TP | ||
55 | .B \-p | ||
56 | Test that files are named pipes. | ||
57 | .TP | ||
58 | .B \-q | ||
59 | No files are printed, only the exit status is returned. | ||
60 | .TP | ||
61 | .B \-r | ||
62 | Test that files are readable. | ||
63 | .TP | ||
64 | .B \-s | ||
65 | Test that files are not empty. | ||
66 | .TP | ||
67 | .B \-u | ||
68 | Test that files have their set-user-ID flag set. | ||
69 | .TP | ||
70 | .B \-w | ||
71 | Test that files are writable. | ||
72 | .TP | ||
73 | .B \-x | ||
74 | Test that files are executable. | ||
75 | .SH EXIT STATUS | ||
76 | .TP | ||
77 | .B 0 | ||
78 | At least one file passed all tests. | ||
79 | .TP | ||
80 | .B 1 | ||
81 | No files passed all tests. | ||
82 | .TP | ||
83 | .B 2 | ||
84 | An error occurred. | ||
85 | .SH SEE ALSO | ||
86 | .IR dmenu (1), | ||
87 | .IR test (1) | ||