test(1)                        DG/UX R4.11MU05                       test(1)


NAME
       test - condition evaluation command

SYNOPSIS
       test expr
       [ expr ]

DESCRIPTION
       Test evaluates the expression expr and, if its value is true, returns
       a zero (true) exit status; otherwise, a non-zero (false) exit status
       is returned; test also returns a non-zero exit status if there are no
       arguments.  The following primitives are used to construct expr:

       -r file     True if file exists and is readable.

       -w file     True if file exists and is writable.

       -x file     True if file exists and is executable.

       -f file     True if file exists and is a regular file.

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

       -% file     True if file exists and is a control point directory.

       -c file     True if file exists and is a character-special file.

       -b file     True if file exists and is a block-special file.

       -h file     True if file exists and is a symbolic-link. With all
                   other primitives, the symbolic links are followed by
                   default.

       -p file     True if file exists and is a named pipe (fifo).

       -u file     True if file exists and its set-user-ID bit is set.

       -g file     True if file exists and its set-group-ID bit is set.

       -k file     True if file exists and its sticky bit is set.

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

       -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 non-zero.

       s1 = s2     True if strings s1 and s2 are identical.

       s1 != s2    True if strings s1 and s2 are not identical.

       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, and -le may be
                   used in place of -eq.

       You can combine these primaries with the following operators:

       !           Unary negation operator.

       -a          Binary and operator.

       -o          Binary or operator (-a has higher precedence than -o).

       ( expr)     Parentheses for grouping.

       All the operators and flags are separate arguments to test.
       Parentheses are meaningful to the shell and, therefore, must be
       escaped.


   International Features
       test can process characters from supplementary code sets in expr.

EXAMPLES
       $ test -r exercise.1

       Tests the expression -r exercise.1.  Checks if the file exercise.1
       exists and is readable.  If it exists and is readable, then test sets
       the exit status to zero.

       $ [ "$a" = "yes" ]

       Checks if the value for the variable a is the string "yes".  If it
       is, test sets the exit status to zero.  Note that the square brackets
       must be delimited by blanks for this form of test to work.

       $ if
             test -s exercise.1
         then
             pr exercise.1
         fi

       This is an example of using test in a shell program.  The test in
       this shell program tests the expression -s exercise.1, which checks
       if exercise.1 is a file with at least one character.  If exercise.1
       is a file and has at least one character, the program prints the
       file.  Otherwise, the program does not print exercise.1.

SEE ALSO
       find(1), sh(1).

CAUTION
       In the second form of the command (i.e., the one that uses [], rather
       than the word test), the square brackets must be delimited by blanks.


Licensed material--property of copyright holder(s)