NAME

POSIX::1003::Proc - POSIX handling processes

INHERITANCE

POSIX::1003::Proc
  is a POSIX::1003

SYNOPSIS

use POSIX::1003::Proc qw/abort setpgid/;

abort();
setpgid($pid, $pgid);

DESCRIPTION

Exporter

Functions which are bound to each separate process.

FUNCTIONS

Standard POSIX functions from stdlib.h

abort()

Abnormal process exit.

Standard POSIX functions from sys/wait.h

These functions have captial names because in C they are implemented as macro's (which are capitalized by convension)

WEXITSTATUS($?)

Returns the normal exit status of the child process. Only meaningful if WIFEXITED($?) is true.

WIFEXITED($?)

Returns true if the child process exited normally: "exit()" or by falling off the end of "main()".

WIFSIGNALED($?)

Returns true if the child process terminated because of a signal.

WIFSTOPPED($?)

Returns true if the child process is currently stopped. Can happen only if you specified the WUNTRACED flag to waitpid().

WSTOPSIG($?)

Returns the signal the child process was stopped for. Only meaningful if WIFSTOPPED($?) is true.

WTERMSIG($?)

Returns the signal the child process terminated for. Only meaningful if WIFSIGNALED($?) is true.

wait()

Simply "wait" in perlfunc.

waitpid(PID)

Simply "waitpid" in perlfunc.

Standard POSIX functions from unistd.h

_exit(CODE)

Leave the program without calling handlers registered with atexit (which is not available in Perl)

ctermid()

Generates the path name for the controlling terminal of this process. my $path = ctermid();

cuserid()

Get the login name of the effective user of the current process. See also perldoc -f getlogin my $name = cuserid();

getcwd()

Returns the name of the current working directory. See also Cwd.

nice(INTEGER)

use POSIX::1003::Proc 'nice';
$new_prio = nice($increment);

pause()

setpgid(PID, PPID)

setsid()

tcgetpgrp(FD)

tcsetpgrp(FD, PID)

times5()

The CORE times() function returns four values, conveniently converted into seconds (float). The POSIX times() returns five values in clocktics. To disambique those two, we offer the POSIX function under a slightly different name.

         ($user, $sys, $cuser, $csys) = CORE::times();
($elapse, $user, $sys, $cuser, $csys) = POSIX::times();
($elapse, $user, $sys, $cuser, $csys) = times5();

CONSTANTS

Constants from stdlib.h

EXIT_FAILURE
EXIT_SUCCESS

Constants from limits.h

CHILD_MAX

SEE ALSO

This module is part of POSIX-1003 distribution version 0.05, built on December 23, 2011. Website: http://perl.overmeer.net. The code is based on POSIX, which is released with Perl itself.

COPYRIGHTS

Copyrights of the perl code and the related documentation by 2011 by Mark Overmeer. For other contributors see ChangeLog.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. See http://www.perl.com/perl/misc/Artistic.html