TEST(1)                              BSD                               TEST(1)


NAME
     test - condition command

SYNOPSIS
     test expr

DESCRIPTION
     test evaluates the expression expr, and if its value is true then returns
     zero exit status; otherwise, a nonzero exit status is returned.  test
     returns a nonzero exit if there are no arguments.

     The following primitives are used to construct expr.

     -r file   True if the file exists and is readable.

     -w file   True if the file exists and is writable.

     -f file   True if the file exists and is not a directory.

     -d file   True if the file exists and is a directory.

     -s file   True if the file exists and has a size greater than zero.

     -L file   True if the file exists and is a soft link.

|    -S file   True if the file exists and is a special file of type socket.

     -t [ fildes ]
               True if the open file whose file descriptor number is fildes (1
               by default) is associated with a terminal device.

     -z s1     True if the length of string s1 is zero.

     -n s1     True if the length of the string s1 is nonzero.

     s1 = s2   True if the strings s1 and s2 are equal.

     s1 != s2  True if the strings s1 and s2 are not equal.

     s1        True if s1 is not the null string.

     n1 -eq n2 True if the integers n1 and n2 are algebraically equal.  Any of
               the comparisons -ne, -gt, -ge, -lt, or -le may be used in place
               of -eq.

     These primaries may be combined with the following operators:

     !         unary negation operator

     -a        binary and operator

     -o        binary or operator

     ( expr )  parentheses for grouping.

     -a has higher precedence than -o. Notice that all the operators and flags
     are separate arguments to test.  Notice also that parentheses are
     meaningful to the shell and must be escaped.

SEE ALSO
     sh(1), find(1)

     Updated 1/94