Module: Process::Sys (Ruby 2.3.4)

    In Files

    • process.c

    Class/Module Index [+]

    Quicksearch

    Process::Sys

    The Process::Sys module contains UID and GID functions which provide direct bindings to the system calls of the same names instead of the more-portable versions of the same functionality found in the Process, Process::UID, and Process::GID modules.

    Public Class Methods

    egid → fixnum click to toggle source
    Process::GID.eid → fixnum
    Process::Sys.geteid → fixnum

    Returns the effective group ID for this process. Not available on all platforms.

    Process.egid   #=> 500
    
     
                   static VALUE
    proc_getegid(VALUE obj)
    {
        rb_gid_t egid = getegid();
    
        return GIDT2NUM(egid);
    }
                
    euid → fixnum click to toggle source
    Process::UID.eid → fixnum
    Process::Sys.geteuid → fixnum

    Returns the effective user ID for this process.

    Process.euid   #=> 501
    
     
                   static VALUE
    proc_geteuid(VALUE obj)
    {
        rb_uid_t euid = geteuid();
        return UIDT2NUM(euid);
    }
                
    gid → fixnum click to toggle source
    Process::GID.rid → fixnum
    Process::Sys.getgid → fixnum

    Returns the (real) group ID for this process.

    Process.gid   #=> 500
    
     
                   static VALUE
    proc_getgid(VALUE obj)
    {
        rb_gid_t gid = getgid();
        return GIDT2NUM(gid);
    }
                
    uid → fixnum click to toggle source
    Process::UID.rid → fixnum
    Process::Sys.getuid → fixnum

    Returns the (real) user ID of this process.

    Process.uid   #=> 501
    
     
                   static VALUE
    proc_getuid(VALUE obj)
    {
        rb_uid_t uid = getuid();
        return UIDT2NUM(uid);
    }
                
    Process::Sys.issetugid → true or false click to toggle source

    Returns true if the process was created as a result of an execve(2) system call which had either of the setuid or setgid bits set (and extra privileges were given as a result) or if it has changed any of its real, effective or saved user or group IDs since it began execution.

     
                   static VALUE
    p_sys_issetugid(VALUE obj)
    {
        if (issetugid()) {
            return Qtrue;
        }
        else {
            return Qfalse;
        }
    }
                
    Process::Sys.setegid(group) → nil click to toggle source

    Set the effective group ID of the calling process to group. Not available on all platforms.

     
                   static VALUE
    p_sys_setegid(VALUE obj, VALUE id)
    {
        check_gid_switch();
        if (setegid(OBJ2GID(id)) != 0) rb_sys_fail(0);
        return Qnil;
    }
                
    Process::Sys.seteuid(user) → nil click to toggle source

    Set the effective user ID of the calling process to user. Not available on all platforms.

     
                   static VALUE
    p_sys_seteuid(VALUE obj, VALUE id)
    {
        check_uid_switch();
        if (seteuid(OBJ2UID(id)) != 0) rb_sys_fail(0);
        return Qnil;
    }
                
    Process::Sys.setgid(group) → nil click to toggle source

    Set the group ID of the current process to group. Not available on all platforms.

     
                   static VALUE
    p_sys_setgid(VALUE obj, VALUE id)
    {
        check_gid_switch();
        if (setgid(OBJ2GID(id)) != 0) rb_sys_fail(0);
        return Qnil;
    }
                
    Process::Sys.setregid(rid, eid) → nil click to toggle source

    Sets the (group) real and/or effective group IDs of the current process to rid and eid, respectively. A value of -1 for either means to leave that ID unchanged. Not available on all platforms.

     
                   static VALUE
    p_sys_setregid(VALUE obj, VALUE rid, VALUE eid)
    {
        rb_gid_t rgid, egid;
        PREPARE_GETGRNAM;
        check_gid_switch();
        rgid = OBJ2GID(rid);
        egid = OBJ2GID(eid);
        FINISH_GETGRNAM;
        if (setregid(rgid, egid) != 0) rb_sys_fail(0);
        return Qnil;
    }
                
    Process::Sys.setresgid(rid, eid, sid) → nil click to toggle source

    Sets the (group) real, effective, and saved user IDs of the current process to rid, eid, and sid respectively. A value of -1 for any value means to leave that ID unchanged. Not available on all platforms.

     
                   static VALUE
    p_sys_setresgid(VALUE obj, VALUE rid, VALUE eid, VALUE sid)
    {
        rb_gid_t rgid, egid, sgid;
        PREPARE_GETGRNAM;
        check_gid_switch();
        rgid = OBJ2GID(rid);
        egid = OBJ2GID(eid);
        sgid = OBJ2GID(sid);
        FINISH_GETGRNAM;
        if (setresgid(rgid, egid, sgid) != 0) rb_sys_fail(0);
        return Qnil;
    }
                
    Process::Sys.setresuid(rid, eid, sid) → nil click to toggle source

    Sets the (user) real, effective, and saved user IDs of the current process to rid, eid, and sid respectively. A value of -1 for any value means to leave that ID unchanged. Not available on all platforms.

     
                   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;
    }
                
    Process::Sys.setreuid(rid, eid) → nil click to toggle source

    Sets the (user) real and/or effective user IDs of the current process to rid and eid, respectively. A value of -1 for either means to leave that ID unchanged. Not available on all platforms.

     
                   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;
    }
                
    Process::Sys.setrgid(group) → nil click to toggle source

    Set the real group ID of the calling process to group. Not available on all platforms.

     
                   static VALUE
    p_sys_setrgid(VALUE obj, VALUE id)
    {
        check_gid_switch();
        if (setrgid(OBJ2GID(id)) != 0) rb_sys_fail(0);
        return Qnil;
    }
                
    Process::Sys.setruid(user) → nil click to toggle source

    Set the real user ID of the calling process to user. Not available on all platforms.

     
                   static VALUE
    p_sys_setruid(VALUE obj, VALUE id)
    {
        check_uid_switch();
        if (setruid(OBJ2UID(id)) != 0) rb_sys_fail(0);
        return Qnil;
    }
                
    Process::Sys.setuid(user) → nil click to toggle source

    Set the user ID of the current process to user. Not available on all platforms.

     
                   static VALUE
    p_sys_setuid(VALUE obj, VALUE id)
    {
        check_uid_switch();
        if (setuid(OBJ2UID(id)) != 0) rb_sys_fail(0);
        return Qnil;
    }