NAME

src/pmc/os.pmc - Files and Directories PMC

DESCRIPTION

OS is a singleton class which provides access to the filesystem files and directories.

Methods

void *get_pointer()
void set_pointer(void *ptr)
These two functions are part of the singleton creation interface. For more information see src/pmc.c.
STRING *cwd()
Returns the current working directory.
void chdir(STRING *path)
Changes the current working directory to the one specified by path.
void rm(STRING *path)
Calls remove to remove the file or empty directory specified by path.
void mkdir(STRING *path, STRING *mode)
Creates a directory specified by path with mode mode.
fixedpmcarray *stat(STRING *path)
Stats a file, and returns a 13 position array as in Perl:
     0 dev      device number of filesystem
     1 ino      inode number
     2 mode     file mode  (type and permissions)
     3 nlink    number of (hard) links to the file
     4 uid      numeric user ID of file's owner
     5 gid      numeric group ID of file's owner
     6 rdev     the device identifier (special files only)
     7 size     total size of file, in bytes
     8 atime    last access time in seconds since the epoch
     9 mtime    last modify time in seconds since the epoch
    10 ctime    inode change time in seconds since the epoch (*)
    11 blksize  preferred block size for file system I/O
    12 blocks   actual number of blocks allocated
11 and 12 are not available under Windows.
fixedpmcarray *lstat(STRING *path)
Stats a file, and returns a 13 position array as in Perl:
     0 dev      device number of filesystem
     1 ino      inode number
     2 mode     file mode  (type and permissions)
     3 nlink    number of (hard) links to the file
     4 uid      numeric user ID of file's owner
     5 gid      numeric group ID of file's owner
     6 rdev     the device identifier (special files only)
     7 size     total size of file, in bytes
     8 atime    last access time in seconds since the epoch
     9 mtime    last modify time in seconds since the epoch
    10 ctime    inode change time in seconds since the epoch (*)
    11 blksize  preferred block size for file system I/O
    12 blocks   actual number of blocks allocated
11 and 12 are not available under Windows.
void symlink(STRING *from, STRING *to)
Creates a symlink, where available
void link(STRING *from, STRING *to)
Creates a hard link, where available(?)
INTVAL umask(INTVAL mask)
umask sets the process's file mode creation mask (and returns the previous one).
INTVAL chroot(STRING *path)
it makes the named directory the new root directory for all further pathnames that begin with a "/" by your process and all its children.NOTE: perl restricts this operation to superusers. It might be a good idea to do the same with parrot.
PMC *readdir(STRING *path)
reads entries from a directory.
rename(STRING *oldpath, STRING *newpath)
This method is a wrapper for rename(2). On error a SystemError exception is thrown.

SEE ALS0

   chdir(2), getcwd(3), unlink(2), mkdir(2), stat(2), lstat(2),
   symlink(2), link(2), umask(2), chroot(2)