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)