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)