Return to system.3 CVS log

Up to [CSRG BSD Unix] / 43BSDReno / lib / libc / stdlib

BSD 4.3reno

.\" Copyright (c) 1990 The Regents of the University of California.
.\" All rights reserved.
.\"
.\" 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
.ft B
#include <stdlib.h>

system(const char *string);
.ft R
.fi
.SH DESCRIPTION
.I System
hands
.I string
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(1), execve(2), wait(2), popen(3)
.SH STANDARDS
.B System
conforms to ANSI X3.159-1989 (``ANSI C'').

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.