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-2009, 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
;
58 type ssize_t
is range -(2 ** (C
.size_t
'Size - 1))
59 .. +(2 ** (C
.size_t
'Size - 1) - 1);
60 -- Signed type of the same size as size_t
62 function Socket_Errno
return Integer renames GNAT
.OS_Lib
.Errno
;
63 -- Returns last socket error number
65 function Socket_Error_Message
(Errno
: Integer) return C
.Strings
.chars_ptr
;
66 -- Returns the error message string for the error number Errno. If Errno is
67 -- not known, returns "Unknown system error".
69 function Host_Errno
return Integer;
70 pragma Import
(C
, Host_Errno
, "__gnat_get_h_errno");
71 -- Returns last host error number
73 package Host_Error_Messages
is
75 function Host_Error_Message
76 (H_Errno
: Integer) return C
.Strings
.chars_ptr
;
77 -- Returns the error message string for the host error number H_Errno.
78 -- If H_Errno is not known, returns "Unknown system error".
80 end Host_Error_Messages
;
82 --------------------------------
83 -- Standard library functions --
84 --------------------------------
88 Addr
: System
.Address
;
89 Addrlen
: not null access C
.int
) return C
.int
;
93 Name
: System
.Address
;
94 Namelen
: C
.int
) return C
.int
;
97 (Fd
: C
.int
) return C
.int
;
101 Name
: System
.Address
;
102 Namelen
: C
.int
) return C
.int
;
104 function C_Gethostname
105 (Name
: System
.Address
;
106 Namelen
: C
.int
) return C
.int
;
108 function C_Getpeername
110 Name
: System
.Address
;
111 Namelen
: not null access C
.int
) return C
.int
;
113 function C_Getsockname
115 Name
: System
.Address
;
116 Namelen
: not null access C
.int
) return C
.int
;
118 function C_Getsockopt
122 Optval
: System
.Address
;
123 Optlen
: not null access C
.int
) return C
.int
;
125 function Socket_Ioctl
128 Arg
: access C
.int
) return C
.int
;
132 Backlog
: C
.int
) return C
.int
;
136 Msg
: System
.Address
;
138 Flags
: C
.int
) return C
.int
;
142 Msg
: System
.Address
;
145 From
: System
.Address
;
146 Fromlen
: not null access C
.int
) return C
.int
;
150 Msg
: System
.Address
;
151 Flags
: C
.int
) return ssize_t
;
155 Readfds
: access Fd_Set
;
156 Writefds
: access Fd_Set
;
157 Exceptfds
: access Fd_Set
;
158 Timeout
: Timeval_Access
) return C
.int
;
162 Msg
: System
.Address
;
163 Flags
: C
.int
) return ssize_t
;
167 Msg
: System
.Address
;
171 Tolen
: C
.int
) return C
.int
;
173 function C_Setsockopt
177 Optval
: System
.Address
;
178 Optlen
: C
.int
) return C
.int
;
182 How
: C
.int
) return C
.int
;
187 Protocol
: C
.int
) return C
.int
;
190 (Command
: System
.Address
) return C
.int
;
192 -------------------------------------------------------
193 -- Signalling file descriptors for selector abortion --
194 -------------------------------------------------------
196 package Signalling_Fds
is
198 function Create
(Fds
: not null access Fd_Pair
) return C
.int
;
199 pragma Convention
(C
, Create
);
200 -- Create a pair of connected descriptors suitable for use with C_Select
201 -- (used for signalling in Selector objects).
203 function Read
(Rsig
: C
.int
) return C
.int
;
204 pragma Convention
(C
, Read
);
205 -- Read one byte of data from rsig, the read end of a pair of signalling
206 -- fds created by Create_Signalling_Fds.
208 function Write
(Wsig
: C
.int
) return C
.int
;
209 pragma Convention
(C
, Write
);
210 -- Write one byte of data to wsig, the write end of a pair of signalling
211 -- fds created by Create_Signalling_Fds.
213 procedure Close
(Sig
: C
.int
);
214 pragma Convention
(C
, Close
);
215 -- Close one end of a pair of signalling fds (ignoring any error)
219 -------------------------------------------
220 -- Nonreentrant network databases access --
221 -------------------------------------------
223 -- The following are used only on systems that have nonreentrant
224 -- getXXXbyYYY functions, and do NOT have corresponding getXXXbyYYY_
225 -- functions. Currently, LynxOS is the only such system.
227 function Nonreentrant_Gethostbyname
228 (Name
: C
.char_array
) return Hostent_Access
;
230 function Nonreentrant_Gethostbyaddr
231 (Addr
: System
.Address
;
233 Addr_Type
: C
.int
) return Hostent_Access
;
235 function Nonreentrant_Getservbyname
236 (Name
: C
.char_array
;
237 Proto
: C
.char_array
) return Servent_Access
;
239 function Nonreentrant_Getservbyport
241 Proto
: C
.char_array
) return Servent_Access
;
243 procedure Initialize
;
247 pragma Import
(C
, C_Bind
, "bind");
248 pragma Import
(C
, C_Close
, "close");
249 pragma Import
(C
, C_Gethostname
, "gethostname");
250 pragma Import
(C
, C_Getpeername
, "getpeername");
251 pragma Import
(C
, C_Getsockname
, "getsockname");
252 pragma Import
(C
, C_Getsockopt
, "getsockopt");
253 pragma Import
(C
, C_Listen
, "listen");
254 pragma Import
(C
, C_Select
, "select");
255 pragma Import
(C
, C_Setsockopt
, "setsockopt");
256 pragma Import
(C
, C_Shutdown
, "shutdown");
257 pragma Import
(C
, C_System
, "system");
259 pragma Import
(C
, Nonreentrant_Gethostbyname
, "gethostbyname");
260 pragma Import
(C
, Nonreentrant_Gethostbyaddr
, "gethostbyaddr");
261 pragma Import
(C
, Nonreentrant_Getservbyname
, "getservbyname");
262 pragma Import
(C
, Nonreentrant_Getservbyport
, "getservbyport");
264 end GNAT
.Sockets
.Thin
;