Hallo, dies ist ein Test.

PWD: /www/data-lst1/unixsoft/unixsoft/kaempfer/.public_html

Running in File Mode
Relative path: ./../../.././../../../usr/man/man3proc/Pcreate.3proc
Real path: /usr/share/man/man3proc/Pcreate.3proc
Zurück

'\" te .\" Copyright (c) 2016, Oracle and/or its affiliates. All rights reserved. .TH Pcreate 3PROC "8 Mar 2016" "Oracle Solaris 11.4" "Process Control Library Functions" .SH NAME Pcreate, Pcreate_error \- create a victim process .SH SYNOPSIS .LP .nf #include <libproc.h> .fi .LP .nf ps_prochandle_t *Pcreate(const char *file, char *const *argv, char *const *envp, int *perr, char *path, size_t len); .fi .LP .nf const char *Pcreate_error(int error); .fi .SH DESCRIPTION .sp .LP The \fBPcreate()\fR function creates a victim process, a child of the controlling process. On successful return of \fBPcreate()\fR, the victim process is in a stopped state, stopped on completion of the \fBexec()\fR function that created it, before it has executed its first user-level instruction. .sp .LP The \fBfile\fR, \fBargv\fR, and \fBenvp\fR arguments are the same as those passed to \fBexecve\fR. However, if \fBfile\fR contains no slash character, it is treated as in \fBexecve\fR, that is, the path prefix for this \fBfile\fR is obtained by a search of the directories contained in the \fBPATH\fR environment variable. If the \fBenvp\fR argument is \fBNULL\fR, the environment of the victim process is the same as that of the controlling process. For more information, see the \fBenviron\fR(7) man page. .sp .LP The \fBperr\fR variable points to an integer that will contain an error code in the event that the \fBPcreate()\fR function fails. .sp .LP On successful completion of the \fBPcreate()\fR function, if the \fBpath\fR argument is not \fBNULL\fR and the \fBlen\fR argument is non-zero, the character array pointed to by path is filled with the path name of the executable file found by the search of the \fBPATH\fR environment variable. .sp .LP The \fBPcreate_error()\fR function maps the error code from a failing call to \fBPcreate()\fR to an error message string and returns a pointer to that string. .SH RETURN VALUES .sp .LP On successful completion, the \fBPcreate()\fR function returns a pointer to an opaque structure, allocated by the library, which must be used by almost all of the remaining functions in \fBlibproc\fR to effect inspection and control of the victim process. On failure, \fBPcreate()\fR returns a \fBNULL\fR pointer and sets the integer pointed to by the \fBperr\fR argument to an error code. For more information, see the \fBlibproc.h\fR(3HEAD) man page. .SH ERRORS .sp .LP If a \fBPcreate()\fR failure occurs, the following possible values are returned in the integer pointed to by the \fBperr\fR argument: .sp .ne 2 .mk .na \fB\fBC_STRANGE\fR\fR .ad .RS 13n .rt Unanticipated error, \fBerrno\fR is meaningful .RE .sp .ne 2 .mk .na \fB\fBC_FORK\fR\fR .ad .RS 13n .rt Unable to \fBfork\fR .RE .sp .ne 2 .mk .na \fB\fBC_PERM\fR\fR .ad .RS 13n .rt No permission (file set-id or unreadable) .RE .sp .ne 2 .mk .na \fB\fBC_NOEXEC\fR\fR .ad .RS 13n .rt Cannot execute file .RE .sp .ne 2 .mk .na \fB\fBC_INTR\fR\fR .ad .RS 13n .rt Interrupt received while creating .RE .sp .ne 2 .mk .na \fB\fBC_LP64\fR\fR .ad .RS 13n .rt Program is \fB_LP64\fR, self is \fB_ILP32\fR .RE .sp .ne 2 .mk .na \fB\fBC_NOENT\fR\fR .ad .RS 13n .rt Cannot find executable file .RE .SH ATTRIBUTES .sp .LP See \fBattributes\fR(7) for descriptions of the following attributes: .sp .TS tab( ) box; cw(2.75i) |cw(2.75i) lw(2.75i) |lw(2.75i) . ATTRIBUTE TYPE ATTRIBUTE VALUE _ Interface Stability Committed _ MT-Level Unsafe .TE .sp .SH SEE ALSO .sp .LP \fBlibproc.h\fR(3HEAD), \fBlibproc\fR(3LIB), \fBPgrab\fR(3PROC), \fBPrelease\fR(3PROC)