1*8269e767SBrooks Davis.\" Copyright (c) 1980, 1991, 1993 2*8269e767SBrooks Davis.\" The Regents of the University of California. All rights reserved. 3*8269e767SBrooks Davis.\" 4*8269e767SBrooks Davis.\" Redistribution and use in source and binary forms, with or without 5*8269e767SBrooks Davis.\" modification, are permitted provided that the following conditions 6*8269e767SBrooks Davis.\" are met: 7*8269e767SBrooks Davis.\" 1. Redistributions of source code must retain the above copyright 8*8269e767SBrooks Davis.\" notice, this list of conditions and the following disclaimer. 9*8269e767SBrooks Davis.\" 2. Redistributions in binary form must reproduce the above copyright 10*8269e767SBrooks Davis.\" notice, this list of conditions and the following disclaimer in the 11*8269e767SBrooks Davis.\" documentation and/or other materials provided with the distribution. 12*8269e767SBrooks Davis.\" 3. Neither the name of the University nor the names of its contributors 13*8269e767SBrooks Davis.\" may be used to endorse or promote products derived from this software 14*8269e767SBrooks Davis.\" without specific prior written permission. 15*8269e767SBrooks Davis.\" 16*8269e767SBrooks Davis.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND 17*8269e767SBrooks Davis.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 18*8269e767SBrooks Davis.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 19*8269e767SBrooks Davis.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE 20*8269e767SBrooks Davis.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 21*8269e767SBrooks Davis.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 22*8269e767SBrooks Davis.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 23*8269e767SBrooks Davis.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 24*8269e767SBrooks Davis.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 25*8269e767SBrooks Davis.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 26*8269e767SBrooks Davis.\" SUCH DAMAGE. 27*8269e767SBrooks Davis.\" 28*8269e767SBrooks Davis.Dd June 16, 1993 29*8269e767SBrooks Davis.Dt SYSCALL 2 30*8269e767SBrooks Davis.Os 31*8269e767SBrooks Davis.Sh NAME 32*8269e767SBrooks Davis.Nm syscall , 33*8269e767SBrooks Davis.Nm __syscall 34*8269e767SBrooks Davis.Nd indirect system call 35*8269e767SBrooks Davis.Sh LIBRARY 36*8269e767SBrooks Davis.Lb libc 37*8269e767SBrooks Davis.Sh SYNOPSIS 38*8269e767SBrooks Davis.In sys/syscall.h 39*8269e767SBrooks Davis.In unistd.h 40*8269e767SBrooks Davis.Ft int 41*8269e767SBrooks Davis.Fn syscall "int number" ... 42*8269e767SBrooks Davis.Ft off_t 43*8269e767SBrooks Davis.Fn __syscall "quad_t number" ... 44*8269e767SBrooks Davis.Sh DESCRIPTION 45*8269e767SBrooks DavisThe 46*8269e767SBrooks Davis.Fn syscall 47*8269e767SBrooks Davisfunction 48*8269e767SBrooks Davisperforms the system call whose assembly language 49*8269e767SBrooks Davisinterface has the specified 50*8269e767SBrooks Davis.Fa number 51*8269e767SBrooks Daviswith the specified arguments. 52*8269e767SBrooks DavisSymbolic constants for system calls can be found in the header file 53*8269e767SBrooks Davis.In sys/syscall.h . 54*8269e767SBrooks DavisThe 55*8269e767SBrooks Davis.Fn __syscall 56*8269e767SBrooks Davisform should be used when one or more of the arguments is a 57*8269e767SBrooks Davis64-bit argument to ensure that argument alignment is correct. 58*8269e767SBrooks DavisThis system call is useful for testing new system calls that 59*8269e767SBrooks Davisdo not have entries in the C library. 60*8269e767SBrooks Davis.Sh RETURN VALUES 61*8269e767SBrooks DavisThe return values are defined by the system call being invoked. 62*8269e767SBrooks DavisIn general, a 0 return value indicates success. 63*8269e767SBrooks DavisA -1 return value indicates an error, 64*8269e767SBrooks Davisand an error code is stored in 65*8269e767SBrooks Davis.Va errno . 66*8269e767SBrooks Davis.Sh HISTORY 67*8269e767SBrooks DavisThe 68*8269e767SBrooks Davis.Fn syscall 69*8269e767SBrooks Davisfunction appeared in 70*8269e767SBrooks Davis.Bx 4.0 . 71*8269e767SBrooks Davis.Sh BUGS 72*8269e767SBrooks DavisThere is no way to simulate system calls that have multiple return values 73*8269e767SBrooks Davissuch as 74*8269e767SBrooks Davis.Xr pipe 2 . 75