files2                 package:base                 R Documentation

_M_a_n_i_p_u_l_a_t_o_n _o_f _D_i_r_e_c_t_o_r_i_e_s _a_n_d _f_i_l_e _P_e_r_m_i_s_s_i_o_n_s

_D_e_s_c_r_i_p_t_i_o_n:

     These functions provide a low-level interface to the computer's
     file system.

_U_s_a_g_e:

     dir.create(path, showWarnings = TRUE, recursive = FALSE, mode = "0777")
     Sys.chmod(paths, mode = "0777")
     Sys.umask(mode = "0000")

_A_r_g_u_m_e_n_t_s:

    path: a character vector containing a single path name.

   paths: character vectors containing file or directory paths.

showWarnings: logical; should the warnings on failure be shown?

recursive: logical. Should elements of the path other than the last be
          created?  If true, like Unix's 'mkdir -p'.

    mode: the file mode to be used on Unix-alikes: it will be coerced
          by 'as.octmode'.

_D_e_t_a_i_l_s:

     'dir.create' creates the last element of the path, unless
     'recursive = TRUE'.  Trailing path separators are removed. The
     mode will be modified by the 'umask' setting in the same way as
     for the system function 'mkdir'.  What modes can be set is
     OS-dependent, and it is unsafe to assume that more than three
     octal digits will be used.  For more details see your OS's
     documentation on the system call 'mkdir' (and not that on the
     command-line utility of that name). 

     'Sys.chmod' sets the file permissions of one or more files. It may
     not be supported (when a warning is issued). See the comments for
     'dir.create' for how modes are interpreted. Changing mode on a
     symbolic link is unlikely to work (nor be necessary).  For more
     details see your OS's documentation on the system call 'chmod'
     (and not that on the command-line utility of that name). 

     'Sys.umask' sets the 'umask'. It may not be supported (when a
     warning is issued and '"0000"' returned).  For more details see
     your OS's documentation on the system call 'umask'.

_V_a_l_u_e:

     'dir.create' and 'Sys.chmod' return a logical vector indicating
     which operation succeeded for each of the files attempted. Using a
     missing value for a path name will always be regarded as a
     failure.  'dir.create' indicates failure if the dirwctory already
     exiss.  If 'showWarnings = TRUE', 'dir.create' will give a warning
     for an unexpected failure (e.g. not for a missing value nor for an
     already existing component for 'recursive = TRUE').

     'Sys.umask' returns the previous value of the 'umask', invisibly,
     as a length-one object of class '"octmode"'.

_A_u_t_h_o_r(_s):

     Ross Ihaka, Brian Ripley

_S_e_e _A_l_s_o:

     'file.info', 'file.exists', 'file.path', 'list.files', 'unlink',
     'basename', 'path.expand'.

