1 ------------------------------------------------------------------------------
3 -- GNAT COMPILER COMPONENTS --
5 -- G N A T . S O C K E T S . T H I N --
9 -- Copyright (C) 2001-2013, AdaCore --
11 -- GNAT is free software; you can redistribute it and/or modify it under --
12 -- terms of the GNU General Public License as published by the Free Soft- --
13 -- ware Foundation; either version 3, or (at your option) any later ver- --
14 -- sion. GNAT is distributed in the hope that it will be useful, but WITH- --
15 -- OUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY --
16 -- or FITNESS FOR A PARTICULAR PURPOSE. --
18 -- As a special exception under Section 7 of GPL version 3, you are granted --
19 -- additional permissions described in the GCC Runtime Library Exception, --
20 -- version 3.1, as published by the Free Software Foundation. --
22 -- You should have received a copy of the GNU General Public License and --
23 -- a copy of the GCC Runtime Library Exception along with this program; --
24 -- see the files COPYING3 and COPYING.RUNTIME respectively. If not, see --
25 -- <http://www.gnu.org/licenses/>. --
27 -- GNAT was originally developed by the GNAT team at New York University. --
28 -- Extensive contributions were provided by Ada Core Technologies Inc. --
30 ------------------------------------------------------------------------------
32 -- This package provides a target dependent thin interface to the sockets
33 -- layer for use by the GNAT.Sockets package (g-socket.ads). This package
34 -- should not be directly with'ed by an applications program.
36 -- This is the default version
41 with GNAT.Sockets.Thin_Common;
46 package GNAT.Sockets.Thin is
48 -- This package is intended for hosts implementing BSD sockets with a
49 -- standard interface. It will be used as a default for all the platforms
50 -- that do not have a specific version of this file.
54 package C renames Interfaces.C;
56 use type System.CRTL.ssize_t;
58 function Socket_Errno return Integer renames GNAT.OS_Lib.Errno;
59 -- Returns last socket error number
61 function Socket_Error_Message (Errno : Integer) return String;
62 -- Returns the error message string for the error number Errno. If Errno is
63 -- not known, returns "Unknown system error".
65 function Host_Errno return Integer;
66 pragma Import (C, Host_Errno, "__gnat_get_h_errno");
67 -- Returns last host error number
69 package Host_Error_Messages is
71 function Host_Error_Message (H_Errno : Integer) return String;
72 -- Returns the error message string for the host error number H_Errno.
73 -- If H_Errno is not known, returns "Unknown system error".
75 end Host_Error_Messages;
77 --------------------------------
78 -- Standard library functions --
79 --------------------------------
83 Addr : System.Address;
84 Addrlen : not null access C.int) return C.int;
88 Name : System.Address;
89 Namelen : C.int) return C.int;
92 (Fd : C.int) return C.int;
96 Name : System.Address;
97 Namelen : C.int) return C.int;
99 function C_Gethostname
100 (Name : System.Address;
101 Namelen : C.int) return C.int;
103 function C_Getpeername
105 Name : System.Address;
106 Namelen : not null access C.int) return C.int;
108 function C_Getsockname
110 Name : System.Address;
111 Namelen : not null access C.int) return C.int;
113 function C_Getsockopt
117 Optval : System.Address;
118 Optlen : not null access C.int) return C.int;
120 function Socket_Ioctl
122 Req : SOSC.IOCTL_Req_T;
123 Arg : access C.int) return C.int;
127 Backlog : C.int) return C.int;
131 Msg : System.Address;
133 Flags : C.int) return C.int;
137 Msg : System.Address;
140 From : System.Address;
141 Fromlen : not null access C.int) return C.int;
145 Msg : System.Address;
146 Flags : C.int) return System.CRTL.ssize_t;
150 Readfds : access Fd_Set;
151 Writefds : access Fd_Set;
152 Exceptfds : access Fd_Set;
153 Timeout : Timeval_Access) return C.int;
157 Msg : System.Address;
158 Flags : C.int) return System.CRTL.ssize_t;
162 Msg : System.Address;
166 Tolen : C.int) return C.int;
168 function C_Setsockopt
172 Optval : System.Address;
173 Optlen : C.int) return C.int;
177 How : C.int) return C.int;
182 Protocol : C.int) return C.int;
185 (Command : System.Address) return C.int;
187 -------------------------------------------------------
188 -- Signalling file descriptors for selector abortion --
189 -------------------------------------------------------
191 package Signalling_Fds is
193 function Create (Fds : not null access Fd_Pair) return C.int;
194 pragma Convention (C, Create);
195 -- Create a pair of connected descriptors suitable for use with C_Select
196 -- (used for signalling in Selector objects).
198 function Read (Rsig : C.int) return C.int;
199 pragma Convention (C, Read);
200 -- Read one byte of data from rsig, the read end of a pair of signalling
201 -- fds created by Create_Signalling_Fds.
203 function Write (Wsig : C.int) return C.int;
204 pragma Convention (C, Write);
205 -- Write one byte of data to wsig, the write end of a pair of signalling
206 -- fds created by Create_Signalling_Fds.
208 procedure Close (Sig : C.int);
209 pragma Convention (C, Close);
210 -- Close one end of a pair of signalling fds (ignoring any error)
214 -------------------------------------------
215 -- Nonreentrant network databases access --
216 -------------------------------------------
218 -- The following are used only on systems that have nonreentrant
219 -- getXXXbyYYY functions, and do NOT have corresponding getXXXbyYYY_
220 -- functions. Currently, LynxOS is the only such system.
222 function Nonreentrant_Gethostbyname
223 (Name : C.char_array) return Hostent_Access;
225 function Nonreentrant_Gethostbyaddr
226 (Addr : System.Address;
228 Addr_Type : C.int) return Hostent_Access;
230 function Nonreentrant_Getservbyname
231 (Name : C.char_array;
232 Proto : C.char_array) return Servent_Access;
234 function Nonreentrant_Getservbyport
236 Proto : C.char_array) return Servent_Access;
238 procedure Initialize;
242 pragma Import (C, C_Bind, "bind");
243 pragma Import (C, C_Close, "close");
244 pragma Import (C, C_Gethostname, "gethostname");
245 pragma Import (C, C_Getpeername, "getpeername");
246 pragma Import (C, C_Getsockname, "getsockname");
247 pragma Import (C, C_Getsockopt, "getsockopt");
248 pragma Import (C, C_Listen, "listen");
249 pragma Import (C, C_Select, "select");
250 pragma Import (C, C_Setsockopt, "setsockopt");
251 pragma Import (C, C_Shutdown, "shutdown");
252 pragma Import (C, C_System, "system");
254 pragma Import (C, Nonreentrant_Gethostbyname, "gethostbyname");
255 pragma Import (C, Nonreentrant_Gethostbyaddr, "gethostbyaddr");
256 pragma Import (C, Nonreentrant_Getservbyname, "getservbyname");
257 pragma Import (C, Nonreentrant_Getservbyport, "getservbyport");
259 end GNAT.Sockets.Thin;