Return to system.3 CVS log

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

Annotation of 43BSDReno/lib/libc/stdlib/system.3, revision 1.1.1.1

1.1       root        1: .\" Copyright (c) 1990 The Regents of the University of California.
                      2: .\" All rights reserved.
                      3: .\"
                      4: .\" Redistribution and use in source and binary forms are permitted
                      5: .\" provided that: (1) source distributions retain this entire copyright
                      6: .\" notice and comment, and (2) distributions including binaries display
                      7: .\" the following acknowledgement:  ``This product includes software
                      8: .\" developed by the University of California, Berkeley and its contributors''
                      9: .\" in the documentation or other materials provided with the distribution
                     10: .\" and in all advertising materials mentioning features or use of this
                     11: .\" software. Neither the name of the University nor the names of its
                     12: .\" contributors may be used to endorse or promote products derived
                     13: .\" from this software without specific prior written permission.
                     14: .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
                     15: .\" IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
                     16: .\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
                     17: .\"
                     18: .\"    @(#)system.3    6.3 (Berkeley) 5/17/90
                     19: .\"
                     20: .TH SYSTEM 3 "May 17, 1990"
                     21: .AT 3
                     22: .SH NAME
                     23: system \- issue a shell command
                     24: .SH SYNOPSIS
                     25: .nf
                     26: .ft B
                     27: #include <stdlib.h>
                     28: 
                     29: system(const char *string);
                     30: .ft R
                     31: .fi
                     32: .SH DESCRIPTION
                     33: .I System
                     34: hands
                     35: .I string
                     36: to the command interpreter
                     37: .IR sh (1).
                     38: The calling process waits until the shell has completed,
                     39: ignoring SIGINT and SIGQUIT, and blocking SIGCHLD.
                     40: .PP
                     41: If
                     42: .I string
                     43: is a NULL pointer,
                     44: .I system
                     45: will return non-zero if the command interpreter
                     46: .IR sh (1)
                     47: is available, and zero if it is not.
                     48: .PP
                     49: .I System
                     50: returns the exit status of the shell, or \-1 if the
                     51: .IR wait (3)
                     52: for the shell failed.
                     53: A return status of 127 indicates that the execution of the shell
                     54: failed.
                     55: .SH "SEE ALSO"
                     56: sh(1), execve(2), wait(2), popen(3)
                     57: .SH STANDARDS
                     58: .B System
                     59: 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.