file.info                package:base                R Documentation

_E_x_t_r_a_c_t _F_i_l_e _I_n_f_o_r_m_a_t_i_o_n

_D_e_s_c_r_i_p_t_i_o_n:

     Utility function to extract information about files on the user's
     file systems.

_U_s_a_g_e:

     file.info(...)

_A_r_g_u_m_e_n_t_s:

     ...: character vectors containing file names.

_D_e_t_a_i_l_s:

     What is meant by "file access" and hence the last access time is
     system-dependent.

     On most systems symbolic links are followed, so information is
     given about the file to which the link points rather than about
     the link.

_V_a_l_u_e:

     A data frame with row names the file names and columns 

    size: double: File size in bytes.

   isdir: logical: Is the file a directory?

    mode: integer of class '"octmode"'.  The file permissions, printed
          in octal, for example '644'.

mtime, ctime, atime: integer of class '"POSIXct"': file modification,
          creation and last access times.

     uid: integer: the user ID of the file's owner.

     gid: integer: the group ID of the file's group.

   uname: character: 'uid' interpreted as a user name.

  grname: character: 'gid' interpreted as a group name.

     Unknown user and group names will be 'NA'.

     Entries for non-existent or non-readable files will be 'NA'. The
     'uid', 'gid', 'uname' and 'grname' columns may not be supplied on
     a non-POSIX Unix system.

_N_o_t_e:

     This function will only be operational on systems with the 'stat'
     system call, but that seems very widely available.

     Some (broken) systems allow files of more than 2Gb to be created
     but not accessed by the 'stat' system call.  Such files will show
     up as non-readable (and very likely not be readable by any of R's
     input functions).

_S_e_e _A_l_s_o:

     'files', 'file.access', 'list.files', and 'DateTimeClasses' for
     the date formats.

_E_x_a_m_p_l_e_s:

     ncol(finf <- file.info(dir()))# at least six
     ## Not run: finf # the whole list
     ## Those that are more than 100 days old :
     finf[difftime(Sys.time(), finf[,"mtime"], units="days") > 100 , 1:4]

     file.info("no-such-file-exists")

