system(3)

system3

Pass a command to the shell

Usage

#include <stdlib.h>

int

system(const char *command);

Library

Standard C Library (libc, -lc)

Overview

The system() function hands the argument command to the command interpreter sh(1). The calling process waits for the shell to finish executing the command, ignoring SIGINT and SIGQUIT, and blocking SIGCHLD.

If command is a NULL pointer, system() will return non-zero if the command interpreter sh(1) is available, and zero if it is not.

Return values

The system() function returns the exit status of the shell as returned by waitpid(2), or -1 if an error occurred when invoking fork(2) or waitpid(2). A return value of 127 means the execution of the shell failed.

Releases

163 releases since Mac OS X 10.0; the text changed 4 times.

  1. 10.0–10.1.5
  2. 10.2–10.2.8
  3. 10.3–10.4.11
  4. 10.5–10.6.8
  5. 10.7–26.5

Standards

The system() function conforms to ISO/IEC 9899:1990 (“ISO C90”) and is expected to be IEEE Std 1003.2 (“POSIX.2”) compatible.

From Libc 1752.120.2 in macOS 26.5. Parsed by carta from the page's mdoc source.