123456789_123456789_123456789_123456789_123456789_

Module: Process::GID

Relationships & Source Files
Defined in: process.c

Overview

The GID module contains a collection of module functions which can be used to portably get, set, and switch the current process's real, effective, and saved group IDs.

Class Attribute Summary

Class Method Summary

Class Attribute Details

.re_exchangeable? ⇒ Boolean (readonly, mod_func)

Returns true if the real and effective group IDs of a process may be exchanged on the current platform.

.rid ⇒ Integer (readonly, mod_func)

Alias for Process.gid.

.sid_available? ⇒ Boolean (readonly, mod_func)

Returns true if the current platform has saved group ID functionality.

Class Method Details

.change_privilege(group) ⇒ Integer (mod_func)

Change the current process's real and effective group ID to that specified by group. Returns the new group ID. Not available on all platforms.

[Process.gid, Process.egid]          #=> [0, 0]
Process::GID.change_privilege(33)    #=> 33
[Process.gid, Process.egid]          #=> [33, 33]

.eid ⇒ Integer (mod_func)

Alias for Process.egid.

.from_name(name) ⇒ GID (mod_func)

Get the group ID by the name. If the group is not found, ::ArgumentError will be raised.

Process::GID.from_name("wheel") #=> 0
Process::GID.from_name("nosuchgroup") #=> can't find group for nosuchgroup (ArgumentError)

.grant_privilege(group) ⇒ Integer (mod_func) .eid=(group) ⇒ Integer

Set the effective group ID, and if possible, the saved group ID of the process to the given group. Returns the new effective group ID. Not available on all platforms.

[Process.gid, Process.egid]          #=> [0, 0]
Process::GID.grant_privilege(31)     #=> 33
[Process.gid, Process.egid]          #=> [0, 33]

.re_exchange ⇒ Integer (mod_func)

Exchange real and effective group IDs and return the new effective group ID. Not available on all platforms.

[Process.gid, Process.egid]   #=> [0, 33]
Process::GID.re_exchange      #=> 0
[Process.gid, Process.egid]   #=> [33, 0]

.switch ⇒ Integer (mod_func) .switch ⇒ Object

Switch the effective and real group IDs of the current process. If a block is given, the group IDs will be switched back after the block is executed. Returns the new effective group ID if called without a block, and the return value of the block if one is given.