pcntl_unshare

Dissociates parts of the process execution context

Description

bool pcntl_unshare(int $flags)

pcntl_unshare allows a process to disassociate parts of its execution context that are currently being shared with other processes. The main use of pcntl_unshare is to allow a process to control its shared execution context without creating a new process.

Parameters

flags

The flags parameter is a bitmask that specifies which parts of the execution context should be unshared. This parameter is specified by ORing together zero or more of the CLONE_* constants:

  • CLONE_NEWNS
  • CLONE_NEWIPC
  • CLONE_NEWUTS
  • CLONE_NEWNET
  • CLONE_NEWPID
  • CLONE_NEWUSER
  • CLONE_NEWCGROUP

Return Values

Returns 0 on success, -1 otherwise. On failure it sets an error code, that can be retrieved with pcntl_get_last_error.

See Also