stest.1

   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 [ -abcdefghlpqrsuwx ]
   7 .RB [ -n
   8 .IR file ]
   9 .RB [ -o
  10 .IR file ]
  11 .RI [ file ...]
  12 .SH DESCRIPTION
  13 .B stest
  14 takes a list of files and filters by the files' properties, analogous to
  15 .IR test (1).
  16 Files which pass all tests are printed to stdout. If no files are given, stest
  17 reads files from stdin.
  18 .SH OPTIONS
  19 .TP
  20 .B \-a
  21 Test hidden files.
  22 .TP
  23 .B \-b
  24 Test that files are block specials.
  25 .TP
  26 .B \-c
  27 Test that files are character specials.
  28 .TP
  29 .B \-d
  30 Test that files are directories.
  31 .TP
  32 .B \-e
  33 Test that files exist.
  34 .TP
  35 .B \-f
  36 Test that files are regular files.
  37 .TP
  38 .B \-g
  39 Test that files have their set-group-ID flag set.
  40 .TP
  41 .B \-h
  42 Test that files are symbolic links.
  43 .TP
  44 .B \-l
  45 Test the contents of a directory given as an argument.
  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 \-v
  71 Invert the sense of tests, only failing files pass.
  72 .TP
  73 .B \-w
  74 Test that files are writable.
  75 .TP
  76 .B \-x
  77 Test that files are executable.
  78 .SH EXIT STATUS
  79 .TP
  80 .B 0
  81 At least one file passed all tests.
  82 .TP
  83 .B 1
  84 No files passed all tests.
  85 .TP
  86 .B 2
  87 An error occurred.
  88 .SH SEE ALSO
  89 .IR dmenu (1),
  90 .IR test (1)