From 9f8d1b629a97b3efe8a5af5eaeb4bc084a27f8ed Mon Sep 17 00:00:00 2001 From: Mattias Andrée Date: Wed, 28 Dec 2016 13:58:05 +0100 Subject: Add readme MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Mattias Andrée --- README | 59 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 59 insertions(+) create mode 100644 README diff --git a/README b/README new file mode 100644 index 0000000..2e8b2ac --- /dev/null +++ b/README @@ -0,0 +1,59 @@ +NAME + xtest - test file types and permissions of multiple files + +SYNOPSIS + xtest [-0bcdefghkLprSstuwx] [+bcdefghkLprSstuwx] [file ...] + +DESCRIPTION + xtest tests the file types and permissions of each specified + file, if not file has been specified, a list file is read + from stdin. + + All files that pass at least on of the tests are printed to + stdout. + +OPTIONS + -0 Use NUL byte instead of to delimit files in + both the input and the output. + + -f | -d | -p | -hL | -S | -b | -c + File exists and is a (regular file [-f] | directory + [-d] | named pipe [-p] | symbolic link [-h | -L] | + socket [-S] | block special [-b] | character special + [-c]). + + -k | -g | -u | -r | -w | -x + File exists and has (sticky(1) [-k] | setgid(2) [-g] | + setuid(4) [-u] | read(4) [-r] | write(2) [-w] | + execute(1) [-x]) permissions. + + -t + Input is an file descriptor and is associated with a + terminal. + + +f | +d | +p | +hL | +S | +b | +c + File does not exist or is not a (regular file [+f] | + directory [+d] | named pipe [+p] | symbolic link [+h | + +L] | socket [+S] | block special [+b] | character + special [+c]). + + +k | +g | +u | +r | +w | +x + File does not exist or does not has (sticky(1) [+k] | + setgid(2) [+g] | setuid(4) [+u] | read(4) [+r] | + write(2) [+w] | execute(1) [+x]) permissions. + + +t + Input is not a file descriptor or is not associated + with a terminal. + +RATIONALE + +-flags are included because it is too cumbersome to use + comm(1). + + Only one test need to pass because this allows the user to + represent the required condition in conjunctive normal form + by pipe together multiple instances of xtest for conjunction. + Disjunctive normal form is not as simple. + +SEE ALSO + test(1), find(1), xargs(1) -- cgit v1.2.3-70-g09d2