| Name : perl-Proc-SyncExec
| |
| Version : 1.01
| Vendor : obs://build_opensuse_org/devel:languages:perl
|
| Release : lp155.7.1
| Date : 2023-07-20 15:34:46
|
| Group : Development/Libraries/Perl
| Source RPM : perl-Proc-SyncExec-1.01-lp155.7.1.src.rpm
|
| Size : 0.01 MB
| |
| Packager : https://www_suse_com/
| |
| Summary : Spawn processes but report exec() errors
|
Description :
This module contains functions for synchronized process spawning with full
error return. If the child\'s exec() call fails the reason for the failure
is reported back to the parent.
These functions will croak() if they encounter an unexpected system error,
such as a pipe() failure or a repeated fork() failure.
Nothing is exported by default.
* *fork_retry* [_max-retries_ [_sleep-between_]]
This function runs fork() until it succeeds or until _max-retries_
(default 5) attempts have been made, sleeping _sleep-between_ seconds
(default 5) between attempts. If the last fork() fails *fork_retry*
croak()s.
* *sync_exec* [_code_] _command_...
This function is similar to a fork()/exec() sequence but with a few
twists.
*sync_exec* does not return until after the fork()ed child has already
performed its exec(). The synchronization this provides is useful in some
unusual circumstances.
Normally the pid of the child process is returned. However, if the child
fails its exec() *sync_exec* returns undef and sets $! to the reason for
the child\'s exec() failure.
Since the AATTcmd array is passed directly to Perl\'s exec() Perl might
choose to invoke the command via the shell if AATTcmd contains only one
element and it looks like it needs a shell to interpret it. If this
happens the return value of *sync_exec* only indicates whether the exec()
of the shell worked.
The optional initial _code_ argument must be a code reference. If it is
present it is run in the child just before exec() is called. You can use
this to set up redirections or whatever. If _code_ returns false no exec
is performed, instead a failure is returned using the current $! value
(or EINTR if $! is 0).
If the fork() fails or if there is some other unexpected system error
*sync_exec* croak()s rather than returning.
* *sync_fhpopen_noshell* _fh_ _type_ _cmd_ [_arg_]...
This is a popen() but it never invokes the shell and it uses sync_exec()
under the covers. See the /sync_exec manpage.
The _type_ is either \'\'r\'\' to read from the process or \'\'w\'\' to write to
it.
The return value is the pid of the forked process.
* *sync_popen_noshell* _type_ _cmd_ _arg_...
This is like *sync_fhpopen_noshell*, but you don\'t have to supply the
filehandle.
If called in an array context the return value is a list consisting of
the filehandle and the PID of the child. In a scalar context only the
filehandle is returned.
* *sync_open* _fh_ [_open-spec_]
This is like a Perl open() except that if a pipe is involved and the
implied exec() fails sync_open() fails with $! set appropriately. See the
/sync_exec manpage.
Like *sync_exec*, *sync_open* croak()s if there is an unexpected system
error (such as a failed pipe()).
Also like *sync_exec*, if you use a command which Perl needs to use the
shell to interpret you\'ll only know if the exec of the shell worked. Use
*sync_fhpopen_noshell* or *sync_exec* to be sure that this doesn\'t
happen.
|
RPM found in directory: /packages/linux-pbone/ftp5.gwdg.de/pub/opensuse/repositories/devel:/languages:/perl:/CPAN-P/15.5/noarch |
