


     FFFFTTTTIIIIMMMMEEEESSSS((((1111))))                   XXXXEEEENNNNIIIIXXXX 3333....0000                   FFFFTTTTIIIIMMMMEEEESSSS((((1111))))



     NNNNAAAAMMMMEEEE
          ftimes - display access, change and modify times of a file
          newer, older - compare access, change and modify times of a
          file

     SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
          ffffttttiiiimmmmeeeessss [ ----aaaaccccmmmmvvvvffff_f_o_r_m_a_t ] [++++_f_o_r_m_a_t] file
          nnnneeeewwwweeeerrrr||||oooollllddddeeeerrrr [ ----aaaaccccmmmmnnnnttttvvvvwwwwffff_f_o_r_m_a_t ] [++++_f_o_r_m_a_t] file1 file2

     DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
          _F_t_i_m_e_s displays the access, change and modify times of a
          file in seconds past the epoch (1 January 1970).

          _N_e_w_e_r|_o_l_d_e_r exit with _t_r_u_e status if ffffiiiilllleeee1111 rrrreeeellllaaaattttiiiioooonnnn ffffiiiilllleeee2222 is
          true.

          The format of the time displayed may be controlled by either
          the ----ffff or the ++++ options.  The display format is similar to
          that of the first argument of the _p_r_i_n_t_f (3S) subroutine or
          the _d_a_t_e(1) command.  All output fields are of fixed size
          and are zero padded if necessary.

     CCCCOOOOMMMMMMMMAAAANNNNDDDD LLLLIIIINNNNEEEE OOOOPPPPTTTTIIIIOOOONNNNSSSS
          ----aaaa,,,,cccc,,,,mmmm  Display the access, change or modify times of the
                  file.  If none of the above are given, the default
                  is modify time.

          ----vvvv      Display in human readable format.

          ----ffff,,,, ++++   Display the selected times in the format which
                  follows this option.  All output fields are of fixed
                  size (zero padded if necessary).  Each field
                  descriptor is preceded by ``%'' and will be replaced
                  in the output by its corresponding value.  A single
                  ``%'' is encoded by ``%%''.  All other characters
                  are copied to the output without change.  The string
                  is always terminated with a newline.

                  Field descriptors:
                         nnnn     insert a new-line character
                         tttt     insert a tab character
                         mmmm     month of year - 01 to 12
                         dddd     day of month - 01 to 31
                         yyyy     last 2 digits of year - 00 to 99
                         DDDD     date as in mm/dd/yy
                         HHHH     hour - 00 to 23
                         MMMM     minute - 00 to 59
                         SSSS     second - 00 to 59
                         TTTT     time as HH:MM:SS
                         jjjj     day of year - 001 to 366
                         wwww     day of week - Sunday = 0
                         aaaa     abbreviated weekday - Sun to Sat



     Page 1                                          (printed 8/18/89)






     FFFFTTTTIIIIMMMMEEEESSSS((((1111))))                   XXXXEEEENNNNIIIIXXXX 3333....0000                   FFFFTTTTIIIIMMMMEEEESSSS((((1111))))



                         hhhh     abbreviated month - Jan to Dec

                  The default field descriptor is:
                         +%a %h %d %H:%M:%S 19%y

          The following options apply to _n_e_w_e_r|_o_l_d_e_r only:

          ----nnnn   Display the name of the first file if the relation was
               true.

          ----tttt   Display the times of the first file if the relation was
               true.  The aaaa,,,,cccc,,,,mmmm flags can be used to choose a subset
               as for _f_t_i_m_e_s and the same default applies. The first
               type of time specified is used in the comparison.

          ----wwww   When used with the nnnn oooorrrr tttt flags, displays the winner of
               the comparison regardless of the truth value of the
               relation.

     EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
                    ftimes -v foo.c

          displays the last modify time of foo.c.

                    newer -cnw filea fileb

          prinss the file that was created more recently.

                 ftimes '+DATE:%m/%d/%y%nTIME: %H:%M:%S' file
          would have generated as output:
                 DATE: 08/01/76
                 TIME: 14:45:05

     UUUUSSSSEEEEFFFFUUUULLLL FFFFOOOORRRR
          ffffttttiiiimmmmeeeessss is usefule for adding the last modification date to
          printouts of databases etc.

     SSSSEEEEEEEE AAAALLLLSSSSOOOO
          _s_t_a_t(3), _d_a_t_e(1), _p_r_i_n_t_f(3S)

     DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
          An error message is displayed if a file cannot be _s_t_a_t'ed.

     AAAAUUUUTTTTHHHHOOOORRRRSSSS
          Ken Yap (University of Rochester)
          Rich Salz
          R. O. Domitz (Concurrent Computer Corporation)








     Page 2                                          (printed 8/18/89)



