4.10 Interfacing with the file system

The library (vicare posix) reexports the following bindings from (vicare language-extensions posix) ((vicare-scheme)Pathnames handling):

file-pathname?
file-string-pathname?           file-bytevector-pathname?
file-absolute-pathname?         file-relative-pathname?
split-pathname-root-and-tail
file-colon-search-path?
file-string-colon-search-path?  file-bytevector-colon-search-path?
split-search-path               split-pathname
split-search-path-bytevector    split-pathname-bytevector
split-search-path-string        split-pathname-string
search-file-in-environment-path search-file-in-list-path

Function: chown pathname owner group

Interface to the C function chown(), (libc)chown. Changes the owner and group of the file system entry selected by pathname. owner and group must be fixnums. If successful return zero, else raise an exception.

Function: fchown fd owner group

Interface to the C function fchown(), (libc)fchown. Changes the owner and group of the file system entry selected by fd, which must be a fixnum representing a platform file descriptor. owner and group must be fixnums. If successful return zero, else raise an exception.

Function: chmod pathname mode

Interface to the C function chmod(), (libc)chmod. Change to mode, which must be a fixnum, the access permissions for the file system entry selected by pathname. If successful return zero, else raise an exception.

Function: fchmod fd mode

Interface to the C function fchmod(), (libc)fchmod. Change to mode, which must be a fixnum, the access permissions for the file system entry associated to fd, which must be a fixnum representing a platform file descriptor. If successful return zero, else raise an exception.

Function: umask mask

Interface to the C function umask(), (libc)umask. Set the current file creation mask to mask, which must be a fixnum, and return the previous mask as a fixnum.

Function: getumask

Interface to the C function getumask(), (libc)getumask. Return the current file creation mask as a fixnum.

Function: utime pathname atime_sec mtime_sec

Interface to the C function utime(), (libc)utime. Set the access and modification times of the file system entry selected by pathname to the specified counts of seconds; both atime_sec and mtime_sec must be fixnums. If successful return zero, else raise an exception.

Function: utimes pathname atime_sec atime_usec mtime_sec mtime_usec

Function: lutimes pathname atime_sec atime_usec mtime_sec mtime_usec

Interface to the C functions utimes() and lutimes(), (libc)utimes. Set the access and modification times of the file system entry selected by pathname to the specified counts of seconds and microseconds; all the numeric arguments must be fixnums. If successful return zero, else raise an exception.

Function: futimes fd atime_sec atime_usec mtime_sec mtime_usec

Interface to the C function futimes(), (libc)futimes. Set the access and modification times of the file system entry associated to fd to the specified counts of seconds and microseconds; all the numeric arguments must be fixnums. If successful return zero, else raise an exception.