don't use hash mark for comments
[unix-history] / usr / src / lib / libc / sys / syscall.2
CommitLineData
695ad0b4
KM
1.\" Copyright (c) 1980 Regents of the University of California.
2.\" All rights reserved. The Berkeley software License Agreement
3.\" specifies the terms and conditions for redistribution.
4.\"
cdd5eb15 5.\" @(#)syscall.2 6.2 (Berkeley) %G%
695ad0b4 6.\"
f9effee3 7.TH SYSCALL 2 ""
695ad0b4
KM
8.UC 4
9.SH NAME
10syscall \- indirect system call
11.SH SYNOPSIS
12.nf
cdd5eb15
KM
13.ft B
14#include <syscall.h>
15.PP
695ad0b4
KM
16.BR "syscall(number, arg, ...)" \ \ (VAX-11)
17.fi
18.SH DESCRIPTION
19.I Syscall
20performs the system call whose assembly language
21interface has the specified
22.I number,
23register arguments
24.I r0
25and
26.I r1
92a92bd0 27and further arguments
695ad0b4 28.IR arg .
cdd5eb15
KM
29Symbolic constants for system calls can be found in the header file
30.I <syscall.h>.
695ad0b4
KM
31.PP
32The r0 value of the system call is returned.
33.SH DIAGNOSTICS
34When the C-bit is set,
35.I syscall
36returns \-1 and sets the
37external variable
38.I errno
39(see
40.IR intro (2)).
41.SH BUGS
42There is no way to simulate system calls
43such as
44.IR pipe (2),
45which return values in register r1.