# stat(1)

    NAME
         stat, lstat - provide a shell interface to the stat(2) system call

    SYNOPSIS
         stat [-] [-fd] [-all] [-s] [-field ...]  [file1 ...]

    DESCRIPTION
         Stat does little more than provide access to the  fields  in  the  struct
         stat  as  defined  in  the stat(2) manual page.  Each field that is to be
         listed is specified as the field name without the leading st_.  This  and
         the  other two options are described below.  All options are then applied
         to the files listed.  If stat is called as lstat then the lstat(2) system
         call is used, otherwise symbolic links are expanded with stat(2).

         If no fields are named then all fields are  printed.   If  no  files  are
         listed then all open filedescriptors are printed.

    OPTIONS

         -    If the first argument is ``-'', the list of files is assumed to come
              from  stdin.   This  is  useful  for  things  like  ``ls | stat -uid
              -mtime.''  -fd If an argument is a ``-'' followed by a  number  then
              that  number is used as a file descriptor whose information is to be
              printed.

         -all List all fields for each file.

         -s   Use lstat(2).

         -mode
              List the mode field.  Similarly for ino, dev, rdev, nlink, uid, gid,
              size,  atime,  mtime, and ctime.  Under BSD derived systems you also
              have blksize and blocks.

         -Atime
         -Mtime
         -Ctime
              The lower case versions of these three options display the  time  as
              an integer that is the ``seconds since 00:00 Jan 1. 1970.''  Listing
              the fields with the first letter in caps  causes  the  times  to  be
              printed in ctime(3) format (i.e., human readable).

    EXAMPLES

         # Find out the number of links to each file
         $ stat -nlink *.c

         # sort files by age (much like ls -t)
         $ stat -atime * | sort +1

         # Find out which file is older in sh(1)
         if test `stat -mtime $1` -lt `stat -mtime $2`; then
                 echo $1 is older than $2
         else
                 echo $2 is older than $1
         fi

    SEE ALSO
         stat(2).

    AUTHOR
         Larry McVoy (mcvoy@rsch.wisc.edu)