plucky (2) PR_SET_DUMPABLE.2const.gz

NAME

       PR_SET_DUMPABLE - set the "dumpable" attribute of the calling process

LIBRARY

       Standard C library (libc, -lc)

SYNOPSIS

       #include <linux/prctl.h>  /* Definition of PR_* constants */
       #include <sys/prctl.h>

       int prctl(PR_SET_DUMPABLE, long dumpable);

DESCRIPTION

       Set  the  state  of  the  "dumpable"  attribute, which determines whether core dumps are produced for the
       calling process upon delivery of a signal whose default behavior is to produce a core dump.

       dumpable must be either 0L (SUID_DUMP_DISABLE, process is not dumpable) or 1L (SUID_DUMP_USER, process is
       dumpable).

       Normally, the "dumpable" attribute is set to 1.  However, it is reset to the current value  contained  in
       the file /proc/sys/fs/suid_dumpable (which by default has the value 0), in the following circumstances:

       •  The process's effective user or group ID is changed.

       •  The process's filesystem user or group ID is changed (see credentials(7)).

       •  The  process  executes  (execve(2))  a  set-user-ID  or set-group-ID program, resulting in a change of
          either the effective user ID or the effective group ID.

       •  The process executes (execve(2)) a program that has file capabilities (see capabilities(7)), but  only
          if the permitted capabilities gained exceed those already permitted for the process.

       Processes  that  are  not  dumpable  can  not  be attached via ptrace(2) PTRACE_ATTACH; see ptrace(2) for
       further details.

       If a process is not dumpable, the ownership of files in the process's /proc/pid directory is affected  as
       described in proc_pid(5).

RETURN VALUE

       On success, 0 is returned.  On error, -1 is returned, and errno is set to indicate the error.

ERRORS

       EINVAL arg2 is neither SUID_DUMP_DISABLE nor SUID_DUMP_USER.

FILES

       /proc/sys/fs/suid_dumpable

       /proc/pid/

STANDARDS

       Linux.

HISTORY

       Linux 2.3.20.

       Between  Linux  2.6.13  and  Linux 2.6.17, the value 2L was also permitted, which caused any binary which
       normally would not be dumped to be dumped readable by root only; for security reasons, this  feature  has
       been removed.  (See also the description of /proc/sys/fs/suid_dumpable in proc_sys_fs(5).)

SEE ALSO

       prctl(2), PR_SET_DUMPABLE(2const)

Linux man-pages 6.9.1                              2024-06-02                            PR_SET_DUMPABLE(2const)