diff options
| author | Richard Lowe <richlowe@richlowe.net> | 2011-03-14 14:05:30 -0400 |
|---|---|---|
| committer | Richard Lowe <richlowe@richlowe.net> | 2011-03-14 14:05:30 -0400 |
| commit | c10c16dec587a0662068f6e2991c29ed3a9db943 (patch) | |
| tree | f414286f4bba41d75683ed4fbbaa6bfa4bf7fabd /usr/src/man/man3ucb/syscall.3ucb | |
| parent | 68caef18a23a498d9e3017b983562c0f4fd8ab23 (diff) | |
| download | illumos-joyent-c10c16dec587a0662068f6e2991c29ed3a9db943.tar.gz | |
243 system manual pages should live with the software
Reviewed by: garrett@nexenta.com
Reviewed by: gwr@nexenta.com
Reviewed by: trisk@opensolaris.org
Approved by: gwr@nexenta.com
--HG--
extra : rebase_source : 0c599d0bec0dc8865fbba67721a7a6cd6b1feefb
Diffstat (limited to 'usr/src/man/man3ucb/syscall.3ucb')
| -rw-r--r-- | usr/src/man/man3ucb/syscall.3ucb | 52 |
1 files changed, 52 insertions, 0 deletions
diff --git a/usr/src/man/man3ucb/syscall.3ucb b/usr/src/man/man3ucb/syscall.3ucb new file mode 100644 index 0000000000..e936521f3d --- /dev/null +++ b/usr/src/man/man3ucb/syscall.3ucb @@ -0,0 +1,52 @@ +'\" te +.\" Copyright (c) 2007, Sun Microsystems, Inc. All Rights Reserved. +.\" Copyright (c) 1980 Regents of the University of California. All rights reserved. The Berkeley software License Agreement specifies the terms and conditions for redistribution. +.TH syscall 3UCB "30 Oct 2007" "SunOS 5.11" "SunOS/BSD Compatibility Library Functions" +.SH NAME +syscall \- indirect system call +.SH SYNOPSIS +.LP +.nf +\fB/usr/ucb/cc\fR [ \fIflag\fR ... ] \fIfile\fR ... +#include <sys/syscall.h> + +\fBint\fR \fBsyscall\fR(\fInumber\fR, \fIarg\fR, \fI\&...\fR) +\fBint\fR \fInumber\fR; +.fi + +.SH DESCRIPTION +.sp +.LP +\fBsyscall()\fR performs the function whose assembly language interface has the +specified \fInumber\fR, and arguments \fIarg .\|.\|.\fR. Symbolic constants for +functions can be found in the header \fB<sys/syscall.h>\fR. +.SH RETURN VALUES +.sp +.LP +On error \fBsyscall()\fR returns \(mi1 and sets the external variable +\fBerrno\fR (see \fBIntro\fR(2)). +.SH FILES +.sp +.LP +\fB<sys/syscall.h>\fR +.SH SEE ALSO +.sp +.LP +\fBIntro\fR(2), \fBpipe\fR(2) +.SH NOTES +.sp +.LP +Use of these interfaces should be restricted to only applications written on +BSD platforms. Use of these interfaces with any of the system libraries or in +multi-thread applications is unsupported. +.SH WARNINGS +.sp +.LP +There is no way to use \fBsyscall()\fR to call functions such as \fBpipe\fR(2) +which return values that do not fit into one hardware register. +.sp +.LP +Since many system calls are implemented as library wrappers around traps to the +kernel, these calls may not behave as documented when called from +\fBsyscall()\fR, which bypasses these wrappers. For these reasons, using +\fBsyscall()\fR is not recommended. |