finfo$ (6) --- return directory information about a file  09/10/84


          | _C_a_l_l_i_n_g _I_n_f_o_r_m_a_t_i_o_n

                 integer function finfo$ (path, entry, attach)
                 character path (ARB)
          |      integer entry (MAXDIRENTRY), attach

                 Library:  vswtlb  (standard Subsystem library)


            _F_u_n_c_t_i_o_n

                 'Finfo$' is an internal Subsystem routine used to return the
                 Primos  directory  entry  associated with a named file.  The
                 'path' argument is the pathname of the file whose  entry  is
                 desired;  'entry'  is  a buffer to receive the entry itself;
                 'attach' is set to YES if the user's attach point changed as
                 a side effect of obtaining the directory  entry,  NO  other-
                 wise.   The function return is OK if the directory entry was
                 obtained, ERR otherwise.

                 See Prime's File Management System guide for information  on
          |      the structure of directory entries as returned by the Primos
          |      routines DIR$RD and ENT$RD.


            _I_m_p_l_e_m_e_n_t_a_t_i_o_n

                 'Getto'  is  called to attach to the parent directory of the
                 named file.  The 'attach' parameter is set as a side  effect
                 of  this  action.  The Primos routine SRCH$$ is then used to
          |      open the current  directory  for  reading,  and  the  Primos
          |      routine  ENT$RD  to fetch the entry for the named file.  The
                 current directory is then  closed  by  SRCH$$  and  'finfo$'
                 returns.


            _A_r_g_u_m_e_n_t_s _M_o_d_i_f_i_e_d

                 entry, attach


            _C_a_l_l_s

          |      getto, Primos srch$$, Primos ent$rd


            _S_e_e _A_l_s_o

                 filtst (2), file (1), lf (1)









            finfo$ (6)                    - 1 -                    finfo$ (6)