man/man3/system.3

   1 .\"     @(#)system.3    6.1 (Berkeley) 5/15/85
   2 .\"
   3 .TH SYSTEM 3 "May 15, 1985"
   4 .AT 3
   5 .SH NAME
   6 system \- issue a shell command
   7 .SH SYNOPSIS
   8 .nf
   9 .ft B
  10 #include <stdlib.h>
  11
  12 int system(const char *\fIstring\fP)
  13 .fi
  14 .SH DESCRIPTION
  15 .B System
  16 causes the
  17 .I string
  18 to be given to
  19 .BR  sh (1)
  20 as input as if the string had been typed as a command
  21 at a terminal.
  22 The current process waits until the shell has
  23 completed, then returns the exit status of the shell.
  24 .SH "SEE ALSO"
  25 .BR sh (1),
  26 .BR popen (3),
  27 .BR execve (2),
  28 .BR wait (2).
  29 .SH DIAGNOSTICS
  30 Exit status 127 indicates the shell couldn't be executed.