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-2008, 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 2, 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. See the GNU General Public License --
17 -- for more details. You should have received a copy of the GNU General --
18 -- Public License distributed with GNAT; see file COPYING. If not, write --
19 -- to the Free Software Foundation, 51 Franklin Street, Fifth Floor, --
20 -- Boston, MA 02110-1301, USA. --
22 -- As a special exception, if other files instantiate generics from this --
23 -- unit, or you link this unit with other files to produce an executable, --
24 -- this unit does not by itself cause the resulting executable to be --
25 -- covered by the GNU General Public License. This exception does not --
26 -- however invalidate any other reasons why the executable file might be --
27 -- covered by the GNU Public License. --
29 -- GNAT was originally developed by the GNAT team at New York University. --
30 -- Extensive contributions were provided by Ada Core Technologies Inc. --
32 ------------------------------------------------------------------------------
34 -- This package provides a target dependent thin interface to the sockets
35 -- layer for use by the GNAT.Sockets package (g-socket.ads). This package
36 -- should not be directly with'ed by an applications program.
38 -- This is the default version
40 with Interfaces.C.Strings;
43 with GNAT.Sockets.Thin_Common;
47 package GNAT.Sockets.Thin is
49 -- This package is intended for hosts implementing BSD sockets with a
50 -- standard interface. It will be used as a default for all the platforms
51 -- that do not have a specific version of this file.
55 package C renames Interfaces.C;
57 function Socket_Errno return Integer renames GNAT.OS_Lib.Errno;
58 -- Returns last socket error number
60 function Socket_Error_Message (Errno : Integer) return C.Strings.chars_ptr;
61 -- Returns the error message string for the error number Errno. If Errno is
62 -- not known, returns "Unknown system error".
64 function Host_Errno return Integer;
65 pragma Import (C, Host_Errno, "__gnat_get_h_errno");
66 -- Returns last host error number
68 package Host_Error_Messages is
70 function Host_Error_Message
71 (H_Errno : Integer) return C.Strings.chars_ptr;
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;
123 Arg : access C.int) return C.int;
127 Backlog : C.int) return C.int;
131 Iov : System.Address;
132 Iovcnt : C.int) return C.int;
136 Msg : System.Address;
138 Flags : C.int) return C.int;
142 Msg : System.Address;
145 From : Sockaddr_In_Access;
146 Fromlen : not null access C.int) return C.int;
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;
160 To : Sockaddr_In_Access;
161 Tolen : C.int) return C.int;
163 function C_Setsockopt
167 Optval : System.Address;
168 Optlen : C.int) return C.int;
172 How : C.int) return C.int;
177 Protocol : C.int) return C.int;
180 (Errnum : C.int) return C.Strings.chars_ptr;
183 (Command : System.Address) return C.int;
187 Iov : System.Address;
188 Iovcnt : C.int) return C.int;
190 -------------------------------------------------------
191 -- Signalling file descriptors for selector abortion --
192 -------------------------------------------------------
194 package Signalling_Fds is
196 function Create (Fds : not null access Fd_Pair) return C.int;
197 pragma Convention (C, Create);
198 -- Create a pair of connected descriptors suitable for use with C_Select
199 -- (used for signalling in Selector objects).
201 function Read (Rsig : C.int) return C.int;
202 pragma Convention (C, Read);
203 -- Read one byte of data from rsig, the read end of a pair of signalling
204 -- fds created by Create_Signalling_Fds.
206 function Write (Wsig : C.int) return C.int;
207 pragma Convention (C, Write);
208 -- Write one byte of data to wsig, the write end of a pair of signalling
209 -- fds created by Create_Signalling_Fds.
211 procedure Close (Sig : C.int);
212 pragma Convention (C, Close);
213 -- Close one end of a pair of signalling fds (ignoring any error)
217 -------------------------------------------
218 -- Nonreentrant network databases access --
219 -------------------------------------------
221 -- The following are used only on systems that have nonreentrant
222 -- getXXXbyYYY functions, and do NOT have corresponding getXXXbyYYY_
223 -- functions. Currently, LynxOS is the only such system.
225 function Nonreentrant_Gethostbyname
226 (Name : C.char_array) return Hostent_Access;
228 function Nonreentrant_Gethostbyaddr
229 (Addr : System.Address;
231 Addr_Type : C.int) return Hostent_Access;
233 function Nonreentrant_Getservbyname
234 (Name : C.char_array;
235 Proto : C.char_array) return Servent_Access;
237 function Nonreentrant_Getservbyport
239 Proto : C.char_array) return Servent_Access;
241 procedure Initialize;
245 pragma Import (C, C_Bind, "bind");
246 pragma Import (C, C_Close, "close");
247 pragma Import (C, C_Gethostname, "gethostname");
248 pragma Import (C, C_Getpeername, "getpeername");
249 pragma Import (C, C_Getsockname, "getsockname");
250 pragma Import (C, C_Getsockopt, "getsockopt");
251 pragma Import (C, C_Listen, "listen");
252 pragma Import (C, C_Readv, "readv");
253 pragma Import (C, C_Select, "select");
254 pragma Import (C, C_Setsockopt, "setsockopt");
255 pragma Import (C, C_Shutdown, "shutdown");
256 pragma Import (C, C_Strerror, "strerror");
257 pragma Import (C, C_System, "system");
258 pragma Import (C, C_Writev, "writev");
260 pragma Import (C, Nonreentrant_Gethostbyname, "gethostbyname");
261 pragma Import (C, Nonreentrant_Gethostbyaddr, "gethostbyaddr");
262 pragma Import (C, Nonreentrant_Getservbyname, "getservbyname");
263 pragma Import (C, Nonreentrant_Getservbyport, "getservbyport");
265 end GNAT.Sockets.Thin;