18269e767SBrooks Davis.\" Copyright (c) 1980, 1991, 1993 28269e767SBrooks Davis.\" The Regents of the University of California. All rights reserved. 38269e767SBrooks Davis.\" 48269e767SBrooks Davis.\" Redistribution and use in source and binary forms, with or without 58269e767SBrooks Davis.\" modification, are permitted provided that the following conditions 68269e767SBrooks Davis.\" are met: 78269e767SBrooks Davis.\" 1. Redistributions of source code must retain the above copyright 88269e767SBrooks Davis.\" notice, this list of conditions and the following disclaimer. 98269e767SBrooks Davis.\" 2. Redistributions in binary form must reproduce the above copyright 108269e767SBrooks Davis.\" notice, this list of conditions and the following disclaimer in the 118269e767SBrooks Davis.\" documentation and/or other materials provided with the distribution. 128269e767SBrooks Davis.\" 3. Neither the name of the University nor the names of its contributors 138269e767SBrooks Davis.\" may be used to endorse or promote products derived from this software 148269e767SBrooks Davis.\" without specific prior written permission. 158269e767SBrooks Davis.\" 168269e767SBrooks Davis.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND 178269e767SBrooks Davis.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 188269e767SBrooks Davis.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 198269e767SBrooks Davis.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE 208269e767SBrooks Davis.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 218269e767SBrooks Davis.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 228269e767SBrooks Davis.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 238269e767SBrooks Davis.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 248269e767SBrooks Davis.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 258269e767SBrooks Davis.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 268269e767SBrooks Davis.\" SUCH DAMAGE. 278269e767SBrooks Davis.\" 288269e767SBrooks Davis.Dd June 16, 1993 298269e767SBrooks Davis.Dt SYSCALL 2 308269e767SBrooks Davis.Os 318269e767SBrooks Davis.Sh NAME 328269e767SBrooks Davis.Nm syscall , 338269e767SBrooks Davis.Nm __syscall 348269e767SBrooks Davis.Nd indirect system call 358269e767SBrooks Davis.Sh LIBRARY 368269e767SBrooks Davis.Lb libc 378269e767SBrooks Davis.Sh SYNOPSIS 388269e767SBrooks Davis.In sys/syscall.h 398269e767SBrooks Davis.In unistd.h 408269e767SBrooks Davis.Ft int 418269e767SBrooks Davis.Fn syscall "int number" ... 428269e767SBrooks Davis.Ft off_t 438269e767SBrooks Davis.Fn __syscall "quad_t number" ... 448269e767SBrooks Davis.Sh DESCRIPTION 458269e767SBrooks DavisThe 468269e767SBrooks Davis.Fn syscall 478269e767SBrooks Davisfunction 488269e767SBrooks Davisperforms the system call whose assembly language 498269e767SBrooks Davisinterface has the specified 508269e767SBrooks Davis.Fa number 518269e767SBrooks Daviswith the specified arguments. 528269e767SBrooks DavisSymbolic constants for system calls can be found in the header file 538269e767SBrooks Davis.In sys/syscall.h . 548269e767SBrooks DavisThe 558269e767SBrooks Davis.Fn __syscall 568269e767SBrooks Davisform should be used when one or more of the arguments is a 578269e767SBrooks Davis64-bit argument to ensure that argument alignment is correct. 588269e767SBrooks DavisThis system call is useful for testing new system calls that 598269e767SBrooks Davisdo not have entries in the C library. 608269e767SBrooks Davis.Sh RETURN VALUES 618269e767SBrooks DavisThe return values are defined by the system call being invoked. 628269e767SBrooks DavisIn general, a 0 return value indicates success. 638269e767SBrooks DavisA -1 return value indicates an error, 648269e767SBrooks Davisand an error code is stored in 658269e767SBrooks Davis.Va errno . 668269e767SBrooks Davis.Sh HISTORY 678269e767SBrooks DavisThe 688269e767SBrooks Davis.Fn syscall 698269e767SBrooks Davisfunction appeared in 708269e767SBrooks Davis.Bx 4.0 . 718269e767SBrooks Davis.Sh BUGS 728269e767SBrooks DavisThere is no way to simulate system calls that have multiple return values 738269e767SBrooks Davissuch as 748269e767SBrooks Davis.Xr pipe 2 . 75