BSD 4_3_Reno release

[unix-history] / usr / src / lib / libc / stdlib / system.3

diff --git a/usr/src/lib/libc/stdlib/system.3 b/usr/src/lib/libc/stdlib/system.3
index cb47ac9..0aad859 100644 (file)
--- a/usr/src/lib/libc/stdlib/system.3
+++ b/usr/src/lib/libc/stdlib/system.3
@@ -1,27 +1,59 @@
-.\"    @(#)system.3    6.1 (Berkeley) %G%
+.\" Copyright (c) 1990 The Regents of the University of California.
+.\" All rights reserved.

 .\"
 .\"

-.TH SYSTEM 3 ""
+.\" Redistribution and use in source and binary forms are permitted
+.\" provided that: (1) source distributions retain this entire copyright
+.\" notice and comment, and (2) distributions including binaries display
+.\" the following acknowledgement:  ``This product includes software
+.\" developed by the University of California, Berkeley and its contributors''
+.\" in the documentation or other materials provided with the distribution
+.\" and in all advertising materials mentioning features or use of this
+.\" software. Neither the name of the University nor the names of its
+.\" contributors may be used to endorse or promote products derived
+.\" from this software without specific prior written permission.
+.\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
+.\" IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
+.\"
+.\"    @(#)system.3    6.3 (Berkeley) 5/17/90
+.\"
+.TH SYSTEM 3 "May 17, 1990"

 .AT 3
 .SH NAME
 system \- issue a shell command
 .SH SYNOPSIS
 .nf
 .AT 3
 .SH NAME
 system \- issue a shell command
 .SH SYNOPSIS
 .nf

-.B system(string)
-.B char *string;
+.ft B
+#include <stdlib.h>
+
+system(const char *string);
+.ft R

 .fi
 .SH DESCRIPTION
 .I System
 .fi
 .SH DESCRIPTION
 .I System

-causes the
+hands

 .I string
 .I string

-to be given to
-.IR  sh (1)
-as input as if the string had been typed as a command
-at a terminal.
-The current process waits until the shell has
-completed, then returns the exit status of the shell.
+to the command interpreter
+.IR sh (1).
+The calling process waits until the shell has completed,
+ignoring SIGINT and SIGQUIT, and blocking SIGCHLD.
+.PP
+If
+.I string
+is a NULL pointer,
+.I system
+will return non-zero if the command interpreter
+.IR sh (1)
+is available, and zero if it is not.
+.PP
+.I System
+returns the exit status of the shell, or \-1 if the
+.IR wait (3)
+for the shell failed.
+A return status of 127 indicates that the execution of the shell
+failed.

 .SH "SEE ALSO"
 .SH "SEE ALSO"

-popen(3S),
-execve(2),
-wait(2)
-.SH DIAGNOSTICS
-Exit status 127 indicates the shell couldn't be executed.
+sh(1), execve(2), wait(2), popen(3)
+.SH STANDARDS
+.B System
+conforms to ANSI X3.159-1989 (``ANSI C'').