Spec-Zone.ru › Ruby 3.4
  1. Process::
  2. Sys

module Process::Sys

Модуль Process::Sys содержит функции UID и GID, которые обеспечивают прямые привязки к системным вызовам с такими же именами вместо более переносимых версий той же функциональности, доступных в модулях Process, Process::UID и Process::GID.

Публичные методы класса

egid → integer Показать исходный код
Process::GID.eid → integer
Process::Sys.geteid → integer
static VALUE
proc_getegid(VALUE obj)
{
    rb_gid_t egid = getegid();

    return GIDT2NUM(egid);
}

Возвращает эффективный идентификатор группы текущего процесса:

Process.egid # => 500

Доступно не на всех платформах.

euid → integer Показать исходный код
Process::UID.eid → integer
Process::Sys.geteuid → integer
static VALUE
proc_geteuid(VALUE obj)
{
    rb_uid_t euid = geteuid();
    return UIDT2NUM(euid);
}

Возвращает эффективный идентификатор пользователя текущего процесса.

Process.euid # => 501
gid → integer Показать исходный код
Process::GID.rid → integer
Process::Sys.getgid → integer
static VALUE
proc_getgid(VALUE obj)
{
    rb_gid_t gid = getgid();
    return GIDT2NUM(gid);
}

Возвращает (реальный) идентификатор группы текущего процесса:

Process.gid # => 1000
uid → integer Показать исходный код
Process::UID.rid → integer
Process::Sys.getuid → integer
static VALUE
proc_getuid(VALUE obj)
{
    rb_uid_t uid = getuid();
    return UIDT2NUM(uid);
}

Возвращает (реальный) идентификатор пользователя текущего процесса.

Process.uid # => 1000
Process::Sys.issetugid → true or false Показать исходный код
static VALUE
p_sys_issetugid(VALUE obj)
{
    return RBOOL(issetugid());
}

Возвращает true, если процесс был создан в результате системного вызова execve(2), для которого был установлен один из битов setuid или setgid (и в результате были предоставлены дополнительные привилегии), либо если после начала выполнения процесс изменил любой из своих реальных, эффективных или сохранённых идентификаторов пользователя или группы.

Process::Sys.setegid(group) → nil Показать исходный код
static VALUE
p_sys_setegid(VALUE obj, VALUE id)
{
    check_gid_switch();
    if (setegid(OBJ2GID(id)) != 0) rb_sys_fail(0);
    return Qnil;
}

Устанавливает эффективный идентификатор группы вызывающего процесса в значение group. Доступно не на всех платформах.

Process::Sys.seteuid(user) → nil Показать исходный код
static VALUE
p_sys_seteuid(VALUE obj, VALUE id)
{
    check_uid_switch();
    if (seteuid(OBJ2UID(id)) != 0) rb_sys_fail(0);
    return Qnil;
}

Устанавливает эффективный идентификатор пользователя вызывающего процесса в значение user. Доступно не на всех платформах.

Process::Sys.setgid(group) → nil Показать исходный код
static VALUE
p_sys_setgid(VALUE obj, VALUE id)
{
    check_gid_switch();
    if (setgid(OBJ2GID(id)) != 0) rb_sys_fail(0);
    return Qnil;
}

Устанавливает идентификатор группы текущего процесса в значение group. Доступно не на всех платформах.

Process::Sys.setregid(rid, eid) → nil Показать исходный код
static VALUE
p_sys_setregid(VALUE obj, VALUE rid, VALUE eid)
{
    rb_gid_t rgid, egid;
    check_gid_switch();
    rgid = OBJ2GID(rid);
    egid = OBJ2GID(eid);
    if (setregid(rgid, egid) != 0) rb_sys_fail(0);
    return Qnil;
}

Устанавливает реальный и/или эффективный идентификаторы группы текущего процесса в значения rid и eid соответственно. Значение -1 для любого из параметров означает, что соответствующий идентификатор останется неизменным. Доступно не на всех платформах.

Process::Sys.setresgid(rid, eid, sid) → nil Показать исходный код
static VALUE
p_sys_setresgid(VALUE obj, VALUE rid, VALUE eid, VALUE sid)
{
    rb_gid_t rgid, egid, sgid;
    check_gid_switch();
    rgid = OBJ2GID(rid);
    egid = OBJ2GID(eid);
    sgid = OBJ2GID(sid);
    if (setresgid(rgid, egid, sgid) != 0) rb_sys_fail(0);
    return Qnil;
}

Устанавливает реальные, эффективные и сохранённые идентификаторы пользователя группы текущего процесса в значения rid, eid и sid соответственно. Значение -1 для любого параметра означает, что соответствующий идентификатор останется неизменным. Доступно не на всех платформах.

Process::Sys.setresuid(rid, eid, sid) → nil Показать исходный код
static VALUE
p_sys_setresuid(VALUE obj, VALUE rid, VALUE eid, VALUE sid)
{
    rb_uid_t ruid, euid, suid;
    PREPARE_GETPWNAM;
    check_uid_switch();
    ruid = OBJ2UID1(rid);
    euid = OBJ2UID1(eid);
    suid = OBJ2UID1(sid);
    FINISH_GETPWNAM;
    if (setresuid(ruid, euid, suid) != 0) rb_sys_fail(0);
    return Qnil;
}

Устанавливает реальные, эффективные и сохранённые идентификаторы пользователя текущего процесса в значения rid, eid и sid соответственно. Значение -1 для любого параметра означает, что соответствующий идентификатор останется неизменным. Доступно не на всех платформах.

Process::Sys.setreuid(rid, eid) → nil Показать исходный код
static VALUE
p_sys_setreuid(VALUE obj, VALUE rid, VALUE eid)
{
    rb_uid_t ruid, euid;
    PREPARE_GETPWNAM;
    check_uid_switch();
    ruid = OBJ2UID1(rid);
    euid = OBJ2UID1(eid);
    FINISH_GETPWNAM;
    if (setreuid(ruid, euid) != 0) rb_sys_fail(0);
    return Qnil;
}

Устанавливает реальные и/или эффективные идентификаторы пользователя текущего процесса в значения rid и eid соответственно. Значение -1 для любого из параметров означает, что соответствующий идентификатор останется неизменным. Доступно не на всех платформах.

Process::Sys.setrgid(group) → nil Показать исходный код
static VALUE
p_sys_setrgid(VALUE obj, VALUE id)
{
    check_gid_switch();
    if (setrgid(OBJ2GID(id)) != 0) rb_sys_fail(0);
    return Qnil;
}

Устанавливает реальный идентификатор группы вызывающего процесса в значение group. Доступно не на всех платформах.

Process::Sys.setruid(user) → nil Показать исходный код
static VALUE
p_sys_setruid(VALUE obj, VALUE id)
{
    check_uid_switch();
    if (setruid(OBJ2UID(id)) != 0) rb_sys_fail(0);
    return Qnil;
}

Устанавливает реальный идентификатор пользователя вызывающего процесса в значение user. Доступно не на всех платформах.

Process::Sys.setuid(user) → nil Показать исходный код
static VALUE
p_sys_setuid(VALUE obj, VALUE id)
{
    check_uid_switch();
    if (setuid(OBJ2UID(id)) != 0) rb_sys_fail(0);
    return Qnil;
}

Устанавливает идентификатор пользователя текущего процесса в значение user. Доступно не на всех платформах.

Ruby Core © 1993–2025 Yukihiro Matsumoto
Licensed under the Ruby License.
Ruby Standard Library © contributors
Licensed under their own licenses.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API