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) | ||
