test.1 - sbase - suckless unix tools
 (HTM) git clone git://git.suckless.org/sbase
 (DIR) Log
 (DIR) Files
 (DIR) Refs
 (DIR) README
 (DIR) LICENSE
       ---
       test.1 (1767B)
       ---
            1 .Dd October 8, 2015
            2 .Dt TEST 1
            3 .Os sbase
            4 .Sh NAME
            5 .Nm test
            6 .Nd evaluate expression
            7 .Sh SYNOPSIS
            8 .Nm
            9 .Ar expression
           10 .Sh DESCRIPTION
           11 .Nm
           12 returns the status of the
           13 .Ar expression .
           14 .Sh OPTIONS
           15 .Bl -tag -width Ds
           16 .It ! Ar expression
           17 invert
           18 .Ar expression .
           19 .It ( Fl e | Fl s ) Ar file
           20 .Ar file
           21 exists and has (any size
           22 .Op Fl e
           23 | non-zero size
           24 .Op Fl s ) .
           25 .It ( Fl f | Fl d | Fl p | Fl hL | Fl S | Fl b | Fl c ) Ar file
           26 .Ar file
           27 exists and is a
           28 (regular file
           29 .Op Fl f
           30 | directory
           31 .Op Fl d
           32 | named pipe
           33 .Op Fl p
           34 | symbolic link
           35 .Op Fl h | Fl L
           36 | socket
           37 .Op Fl S
           38 | block special
           39 .Op Fl b
           40 | character special
           41 .Op Fl c ) .
           42 .It ( Fl k | Fl g | Fl u | Fl r | Fl w | Fl x ) Ar file
           43 .Ar file
           44 exists and has
           45 .Xr ( sticky 1
           46 .Op Fl k
           47 |
           48 .Xr setgid 2
           49 .Op Fl g
           50 |
           51 .Xr setuid 4
           52 .Op Fl u
           53 |
           54 .Xr read 4
           55 .Op Fl r
           56 |
           57 .Xr write 2
           58 .Op Fl w
           59 |
           60 .Xr execute 1
           61 .Op Fl x )
           62 permissions.
           63 .It Fl t Ar fd
           64 .Ar fd
           65 as a file descriptor is associated with a terminal.
           66 .It Ar string
           67 True if
           68 .Ar string
           69 is not the null string.
           70 .It ( Fl z | Fl n ) Ar string
           71 True if
           72 .Ar string
           73 has (zero
           74 .Op Fl z
           75 | non-zero
           76 .Op Fl n )
           77 length.
           78 .It Ar s1 Sy ( = | != ) Ar s2
           79 True if strings
           80 .Ar s1
           81 and
           82 .Ar s2
           83 are
           84 (identical
           85 .Oo Sy = Oc
           86 | different
           87 .Oo Sy != Oc ) .
           88 .It Ar n1 ( Fl eq | Fl ne | Fl gt | Fl ge | Fl le | Fl lt ) Ar n2
           89 True if integers
           90 .Ar n1
           91 and
           92 .Ar n2
           93 are (=
           94 .Op Fl eq
           95 | !=
           96 .Op Fl ne
           97 | >
           98 .Op Fl gt
           99 | >=
          100 .Op Fl ge
          101 | <=
          102 .Op Fl le
          103 | <
          104 .Op Fl lt ) .
          105 .It Ar f1 ( Fl ef | Fl ot | Fl nt ) Ar f2
          106 True if file
          107 .Ar f1
          108 (refer to the same inode as
          109 .Op Fl ef
          110 | has an older mtime than
          111 .Op Fl ot
          112 | has a newer mtime than
          113 .Op Fl nt )
          114 file
          115 .Ar f2 .
          116 .El
          117 .Sh EXIT STATUS
          118 .Bl -tag -width Ds
          119 .It 0
          120 .Ar expression
          121 is true.
          122 .It 1
          123 .Ar expression
          124 is false.
          125 .It > 1
          126 An error occurred.
          127 .El
          128 .Sh SEE ALSO
          129 .Xr expr 1
          130 .Sh STANDARDS
          131 POSIX.1-2013.