18269e767SBrooks Davis.\" Copyright (c) 1983, 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 February 10, 2018 298269e767SBrooks Davis.Dt SOCKETPAIR 2 308269e767SBrooks Davis.Os 318269e767SBrooks Davis.Sh NAME 328269e767SBrooks Davis.Nm socketpair 338269e767SBrooks Davis.Nd create a pair of connected sockets 348269e767SBrooks Davis.Sh LIBRARY 358269e767SBrooks Davis.Lb libc 368269e767SBrooks Davis.Sh SYNOPSIS 378269e767SBrooks Davis.In sys/types.h 388269e767SBrooks Davis.In sys/socket.h 398269e767SBrooks Davis.Ft int 408269e767SBrooks Davis.Fn socketpair "int domain" "int type" "int protocol" "int *sv" 418269e767SBrooks Davis.Sh DESCRIPTION 428269e767SBrooks DavisThe 438269e767SBrooks Davis.Fn socketpair 448269e767SBrooks Davissystem call creates an unnamed pair of connected sockets in 458269e767SBrooks Davisthe specified communications 468269e767SBrooks Davis.Fa domain , 478269e767SBrooks Davisof the specified 488269e767SBrooks Davis.Fa type , 498269e767SBrooks Davisand using the optionally specified 508269e767SBrooks Davis.Fa protocol . 518269e767SBrooks DavisThe descriptors used in referencing the new sockets 528269e767SBrooks Davisare returned in 538269e767SBrooks Davis.Fa sv Ns [0] 548269e767SBrooks Davisand 558269e767SBrooks Davis.Fa sv Ns [1] . 568269e767SBrooks DavisThe two sockets are indistinguishable. 578269e767SBrooks Davis.Pp 588269e767SBrooks DavisThe 598269e767SBrooks Davis.Dv SOCK_CLOEXEC 608269e767SBrooks Davisand 618269e767SBrooks Davis.Dv SOCK_NONBLOCK 628269e767SBrooks Davisflags in the 638269e767SBrooks Davis.Fa type 648269e767SBrooks Davisargument apply to both descriptors. 658269e767SBrooks Davis.Sh RETURN VALUES 668269e767SBrooks Davis.Rv -std socketpair 678269e767SBrooks Davis.Sh ERRORS 688269e767SBrooks DavisThe call succeeds unless: 698269e767SBrooks Davis.Bl -tag -width Er 708269e767SBrooks Davis.It Bq Er EMFILE 718269e767SBrooks DavisToo many descriptors are in use by this process. 728269e767SBrooks Davis.It Bq Er EAFNOSUPPORT 738269e767SBrooks DavisThe specified address family is not supported on this machine. 748269e767SBrooks Davis.It Bq Er EPROTONOSUPPORT 758269e767SBrooks DavisThe specified protocol is not supported on this machine. 768269e767SBrooks Davis.It Bq Er EOPNOTSUPP 778269e767SBrooks DavisThe specified protocol does not support creation of socket pairs. 788269e767SBrooks Davis.It Bq Er EFAULT 798269e767SBrooks DavisThe address 808269e767SBrooks Davis.Fa sv 818269e767SBrooks Davisdoes not specify a valid part of the 828269e767SBrooks Davisprocess address space. 838269e767SBrooks Davis.El 848269e767SBrooks Davis.Sh SEE ALSO 858269e767SBrooks Davis.Xr pipe 2 , 868269e767SBrooks Davis.Xr read 2 , 878269e767SBrooks Davis.Xr socket 2 , 888269e767SBrooks Davis.Xr write 2 898269e767SBrooks Davis.Sh STANDARDS 908269e767SBrooks DavisThe 918269e767SBrooks Davis.Fn socketpair 928269e767SBrooks Davissystem call conforms to 938269e767SBrooks Davis.St -p1003.1-2001 948269e767SBrooks Davisand 958269e767SBrooks Davis.St -p1003.1-2008 . 968269e767SBrooks Davis.Sh HISTORY 978269e767SBrooks DavisThe 988269e767SBrooks Davis.Fn socketpair 998269e767SBrooks Davissystem call appeared in 1008269e767SBrooks Davis.Bx 4.2 . 1018269e767SBrooks Davis.Sh BUGS 1028269e767SBrooks DavisThis call is currently implemented only for the 1038269e767SBrooks Davis.Ux 1048269e767SBrooks Davisdomain. 105