man2/socketcall.2

   1 .\" Copyright (c) 1995 Michael Chastain (mec@shell.portal.com), 15 April 1995.
   2 .\"
   3 .\" %%%LICENSE_START(GPLv2+_DOC_FULL)
   4 .\" This is free documentation; you can redistribute it and/or
   5 .\" modify it under the terms of the GNU General Public License as
   6 .\" published by the Free Software Foundation; either version 2 of
   7 .\" the License, or (at your option) any later version.
   8 .\"
   9 .\" The GNU General Public License's references to "object code"
  10 .\" and "executables" are to be interpreted as the output of any
  11 .\" document formatting or typesetting system, including
  12 .\" intermediate and printed output.
  13 .\"
  14 .\" This manual is distributed in the hope that it will be useful,
  15 .\" but WITHOUT ANY WARRANTY; without even the implied warranty of
  16 .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  17 .\" GNU General Public License for more details.
  18 .\"
  19 .\" You should have received a copy of the GNU General Public
  20 .\" License along with this manual; if not, see
  21 .\" <http://www.gnu.org/licenses/>.
  22 .\" %%%LICENSE_END
  23 .\"
  24 .\" Modified Tue Oct 22 22:11:53 1996 by Eric S. Raymond <esr@thyrsus.com>
  25 .TH SOCKETCALL 2 2021-03-22 "Linux" "Linux Programmer's Manual"
  26 .SH NAME
  27 socketcall \- socket system calls
  28 .SH SYNOPSIS
  29 .nf
  30 .BR "#include <linux/net.h>" "        /* Definition of " SYS_* " constants */"
  31 .BR "#include <sys/syscall.h>" "      /* Definition of " SYS_socketcall " */"
  32 .B #include <unistd.h>
  33 .PP
  34 .BI "int syscall(SYS_socketcall, int " call ", unsigned long *" args );
  35 .fi
  36 .PP
  37 .IR Note :
  38 glibc provides no wrapper for
  39 .BR socketcall (),
  40 necessitating the use of
  41 .BR syscall (2).
  42 .SH DESCRIPTION
  43 .BR socketcall ()
  44 is a common kernel entry point for the socket system calls.
  45 .I call
  46 determines which socket function to invoke.
  47 .I args
  48 points to a block containing the actual arguments,
  49 which are passed through to the appropriate call.
  50 .PP
  51 User programs should call the appropriate functions by their usual names.
  52 Only standard library implementors and kernel hackers need to know about
  53 .BR socketcall ().
  54 .PP
  55 .TS
  56 tab(:);
  57 l l.
  58 \fIcall\fR:Man page
  59 T{
  60 .B SYS_SOCKET
  61 T}:T{
  62 .BR socket (2)
  63 T}
  64 T{
  65 .B SYS_BIND
  66 T}:T{
  67 .BR bind (2)
  68 T}
  69 T{
  70 .B SYS_CONNECT
  71 T}:T{
  72 .BR connect (2)
  73 T}
  74 T{
  75 .B SYS_LISTEN
  76 T}:T{
  77 .BR listen (2)
  78 T}
  79 T{
  80 .B SYS_ACCEPT
  81 T}:T{
  82 .BR accept (2)
  83 T}
  84 T{
  85 .B SYS_GETSOCKNAME
  86 T}:T{
  87 .BR getsockname (2)
  88 T}
  89 T{
  90 .B SYS_GETPEERNAME
  91 T}:T{
  92 .BR getpeername (2)
  93 T}
  94 T{
  95 .B SYS_SOCKETPAIR
  96 T}:T{
  97 .BR socketpair (2)
  98 T}
  99 T{
 100 .B SYS_SEND
 101 T}:T{
 102 .BR send (2)
 103 T}
 104 T{
 105 .B SYS_RECV
 106 T}:T{
 107 .BR recv (2)
 108 T}
 109 T{
 110 .B SYS_SENDTO
 111 T}:T{
 112 .BR sendto (2)
 113 T}
 114 T{
 115 .B SYS_RECVFROM
 116 T}:T{
 117 .BR recvfrom (2)
 118 T}
 119 T{
 120 .B SYS_SHUTDOWN
 121 T}:T{
 122 .BR shutdown (2)
 123 T}
 124 T{
 125 .B SYS_SETSOCKOPT
 126 T}:T{
 127 .BR setsockopt (2)
 128 T}
 129 T{
 130 .B SYS_GETSOCKOPT
 131 T}:T{
 132 .BR getsockopt (2)
 133 T}
 134 T{
 135 .B SYS_SENDMSG
 136 T}:T{
 137 .BR sendmsg (2)
 138 T}
 139 T{
 140 .B SYS_RECVMSG
 141 T}:T{
 142 .BR recvmsg (2)
 143 T}
 144 T{
 145 .B SYS_ACCEPT4
 146 T}:T{
 147 .BR accept4 (2)
 148 T}
 149 T{
 150 .B SYS_RECVMMSG
 151 T}:T{
 152 .BR recvmmsg (2)
 153 T}
 154 T{
 155 .B SYS_SENDMMSG
 156 T}:T{
 157 .BR sendmmsg (2)
 158 T}
 159 .TE
 160 .SH CONFORMING TO
 161 This call is specific to Linux, and should not be used in programs
 162 intended to be portable.
 163 .SH NOTES
 164 On some architectures\(emfor example, x86-64 and ARM\(emthere is no
 165 .BR socketcall ()
 166 system call; instead
 167 .BR socket (2),
 168 .BR accept (2),
 169 .BR bind (2),
 170 and so on really are implemented as separate system calls.
 171 .PP
 172 On x86-32,
 173 .BR socketcall ()
 174 was historically the only entry point for the sockets API.
 175 However, starting in Linux 4.3,
 176 .\" commit 9dea5dc921b5f4045a18c63eb92e84dc274d17eb
 177 direct system calls are provided on x86-32 for the sockets API.
 178 This facilitates the creation of
 179 .BR seccomp (2)
 180 filters that filter sockets system calls
 181 (for new user-space binaries that are compiled
 182 to use the new entry points)
 183 and also provides a (very) small performance improvement.
 184 .SH SEE ALSO
 185 .BR accept (2),
 186 .BR bind (2),
 187 .BR connect (2),
 188 .BR getpeername (2),
 189 .BR getsockname (2),
 190 .BR getsockopt (2),
 191 .BR listen (2),
 192 .BR recv (2),
 193 .BR recvfrom (2),
 194 .BR recvmsg (2),
 195 .BR send (2),
 196 .BR sendmsg (2),
 197 .BR sendto (2),
 198 .BR setsockopt (2),
 199 .BR shutdown (2),
 200 .BR socket (2),
 201 .BR socketpair (2)