Rudiments
Static Public Member Functions | List of all members
permissions Class Reference

Static Public Member Functions

static bool setFilePermissions (const char *filename, mode_t perms)
 
static bool setFilePermissions (int32_t fd, mode_t perms)
 
static mode_t parsePermString (const char *permstring)
 
static char * parsePermOctal (mode_t mode)
 
static mode_t getEveryoneReadWrite ()
 
static mode_t getEveryoneReadWriteExecute ()
 
static mode_t getOwnerRead ()
 
static mode_t getOwnerWrite ()
 
static mode_t getOwnerExecute ()
 
static mode_t getOwnerReadWrite ()
 
static mode_t getOwnerReadExecute ()
 
static mode_t getOwnerReadWriteExecute ()
 
static mode_t getGroupRead ()
 
static mode_t getGroupWrite ()
 
static mode_t getGroupExecute ()
 
static mode_t getGroupReadWrite ()
 
static mode_t getGroupReadExecute ()
 
static mode_t getGroupReadWriteExecute ()
 
static mode_t getOthersRead ()
 
static mode_t getOthersWrite ()
 
static mode_t getOthersExecute ()
 
static mode_t getOthersReadWrite ()
 
static mode_t getOthersReadExecute ()
 
static mode_t getOthersReadWriteExecute ()
 
static mode_t getSaveInSwapSpace ()
 
static mode_t getSetUserId ()
 
static mode_t getSetGroupId ()
 

Detailed Description

Permissions are access priveleges. Files, directories, semaphores and shared memory segments all have permissions associated with them.

There are 3 types of permissions: read, write and execute.

These permissions can be granted to:

  1. The user that owns the object.
  2. Other users in the group of the user that owns the object.
  3. All other users.

The execute permission has 2 modifications which can be applied to it:

  1. Set user id - the program will run as the user that owns it instead of as the user that ran it
  1. Set group id - the program will run as the group that owns it instead of as the group of the user that ran it

The "sticky bit" may also be set on platforms that support it. When set, the file is saved in the system's swap space. As a side-effect, it cannot be deleted by a user other than the one that created it.

Member Function Documentation

◆ getEveryoneReadWrite()

static mode_t permissions::getEveryoneReadWrite ( )
static

Returns rw-rw-rw- (666) permissions.

May be or'ed together with the result of another method to define a permission.

◆ getEveryoneReadWriteExecute()

static mode_t permissions::getEveryoneReadWriteExecute ( )
static

Returns rwxrwxrwx (777) permissions.

May be or'ed together with the result of another method to define a permission.

◆ getGroupExecute()

static mode_t permissions::getGroupExecute ( )
static

Returns --—x— (010) permissions.

May be or'ed together with the result of another method to define a permission.

◆ getGroupRead()

static mode_t permissions::getGroupRead ( )
static

Returns —r--— (040) permissions.

May be or'ed together with the result of another method to define a permission.

◆ getGroupReadExecute()

static mode_t permissions::getGroupReadExecute ( )
static

Returns —r-x— (050) permissions.

May be or'ed together with the result of another method to define a permission.

◆ getGroupReadWrite()

static mode_t permissions::getGroupReadWrite ( )
static

Returns —rw-— (060) permissions.

May be or'ed together with the result of another method to define a permission.

◆ getGroupReadWriteExecute()

static mode_t permissions::getGroupReadWriteExecute ( )
static

Returns —rwx— (070) permissions.

May be or'ed together with the result of another method to define a permission.

◆ getGroupWrite()

static mode_t permissions::getGroupWrite ( )
static

Returns -—w-— (020) permissions.

May be or'ed together with the result of another method to define a permission.

◆ getOthersExecute()

static mode_t permissions::getOthersExecute ( )
static

Returns -----—x (001) permissions.

May be or'ed together with the result of another method to define a permission.

◆ getOthersRead()

static mode_t permissions::getOthersRead ( )
static

Returns ---—r– (004) permissions.

May be or'ed together with the result of another method to define a permission.

◆ getOthersReadExecute()

static mode_t permissions::getOthersReadExecute ( )
static

Returns ---—r-x (005) permissions.

May be or'ed together with the result of another method to define a permission.

◆ getOthersReadWrite()

static mode_t permissions::getOthersReadWrite ( )
static

Returns ---—rw- (006) permissions.

May be or'ed together with the result of another method to define a permission.

◆ getOthersReadWriteExecute()

static mode_t permissions::getOthersReadWriteExecute ( )
static

Returns ---—rwx (007) permissions.

May be or'ed together with the result of another method to define a permission.

◆ getOthersWrite()

static mode_t permissions::getOthersWrite ( )
static

Returns ----—w- (002) permissions.

May be or'ed together with the result of another method to define a permission.

◆ getOwnerExecute()

static mode_t permissions::getOwnerExecute ( )
static

Returns –x---— (100) permissions.

May be or'ed together with the result of another method to define a permission.

◆ getOwnerRead()

static mode_t permissions::getOwnerRead ( )
static

Returns r-----— (400) permissions.

May be or'ed together with the result of another method to define a permission.

◆ getOwnerReadExecute()

static mode_t permissions::getOwnerReadExecute ( )
static

Returns r-x---— (500) permissions.

May be or'ed together with the result of another method to define a permission.

◆ getOwnerReadWrite()

static mode_t permissions::getOwnerReadWrite ( )
static

Returns rw----— (600) permissions.

May be or'ed together with the result of another method to define a permission.

◆ getOwnerReadWriteExecute()

static mode_t permissions::getOwnerReadWriteExecute ( )
static

Returns rwx---— (700) permissions.

May be or'ed together with the result of another method to define a permission.

◆ getOwnerWrite()

static mode_t permissions::getOwnerWrite ( )
static

Returns -w----— (200) permissions.

May be or'ed together with the result of another method to define a permission.

◆ getSaveInSwapSpace()

static mode_t permissions::getSaveInSwapSpace ( )
static

Returns -----—t permissions.

May be or'ed together with the result of another method to define a permission.

◆ getSetGroupId()

static mode_t permissions::getSetGroupId ( )
static

Returns --—s— (g+s) permissions.

May be or'ed together with the result of another method to define a permission.

◆ getSetUserId()

static mode_t permissions::getSetUserId ( )
static

Returns –s---— (u+s) permissions.

May be or'ed together with the result of another method to define a permission.

◆ parsePermOctal()

static char* permissions::parsePermOctal ( mode_t  mode)
static

The inverse of parsePermString(). Evaluates "mode" and returns a string representing the permissions.

◆ parsePermString()

static mode_t permissions::parsePermString ( const char *  permstring)
static

Returns the permission defined in "permstring".

"permstring" should be the same format as displayed by the "ls -l" command.

The first 3 characters set permissions for the owner. The next 3 characters set permissions for the group. The next 3 characters set permissions for all others.

For example: rwxr-xr-x : read/execute for everyone and write for the owner rw-rw-r– : read for everyone and write for the owner and owner's group rw-r–r– : read for everyone and write for the owner rwsr-sr-x : read/execute for everyone, write for the owner and run as the user/group that owns the file rw-rw-rwt : read/write for everyone, and save the file in swap space

◆ setFilePermissions() [1/2]

static bool permissions::setFilePermissions ( const char *  filename,
mode_t  perms 
)
static

Set the permissions on "filename" to "perms".

Returns true on success and false on failure.

◆ setFilePermissions() [2/2]

static bool permissions::setFilePermissions ( int32_t  fd,
mode_t  perms 
)
static

Set the permissions on the file associated with file descriptor "fd" to "perms".

Returns true on success and false on failure.