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 (Errnum
: C
.int
) return C
.Strings
.chars_ptr
;
193 (Command
: System
.Address
) return C
.int
;
195 -------------------------------------------------------
196 -- Signalling file descriptors for selector abortion --
197 -------------------------------------------------------
199 package Signalling_Fds
is
201 function Create
(Fds
: not null access Fd_Pair
) return C
.int
;
202 pragma Convention
(C
, Create
);
203 -- Create a pair of connected descriptors suitable for use with C_Select
204 -- (used for signalling in Selector objects).
206 function Read
(Rsig
: C
.int
) return C
.int
;
207 pragma Convention
(C
, Read
);
208 -- Read one byte of data from rsig, the read end of a pair of signalling
209 -- fds created by Create_Signalling_Fds.
211 function Write
(Wsig
: C
.int
) return C
.int
;
212 pragma Convention
(C
, Write
);
213 -- Write one byte of data to wsig, the write end of a pair of signalling
214 -- fds created by Create_Signalling_Fds.
216 procedure Close
(Sig
: C
.int
);
217 pragma Convention
(C
, Close
);
218 -- Close one end of a pair of signalling fds (ignoring any error)
222 -------------------------------------------
223 -- Nonreentrant network databases access --
224 -------------------------------------------
226 -- The following are used only on systems that have nonreentrant
227 -- getXXXbyYYY functions, and do NOT have corresponding getXXXbyYYY_
228 -- functions. Currently, LynxOS is the only such system.
230 function Nonreentrant_Gethostbyname
231 (Name
: C
.char_array
) return Hostent_Access
;
233 function Nonreentrant_Gethostbyaddr
234 (Addr
: System
.Address
;
236 Addr_Type
: C
.int
) return Hostent_Access
;
238 function Nonreentrant_Getservbyname
239 (Name
: C
.char_array
;
240 Proto
: C
.char_array
) return Servent_Access
;
242 function Nonreentrant_Getservbyport
244 Proto
: C
.char_array
) return Servent_Access
;
246 procedure Initialize
;
250 pragma Import
(C
, C_Bind
, "bind");
251 pragma Import
(C
, C_Close
, "close");
252 pragma Import
(C
, C_Gethostname
, "gethostname");
253 pragma Import
(C
, C_Getpeername
, "getpeername");
254 pragma Import
(C
, C_Getsockname
, "getsockname");
255 pragma Import
(C
, C_Getsockopt
, "getsockopt");
256 pragma Import
(C
, C_Listen
, "listen");
257 pragma Import
(C
, C_Select
, "select");
258 pragma Import
(C
, C_Setsockopt
, "setsockopt");
259 pragma Import
(C
, C_Shutdown
, "shutdown");
260 pragma Import
(C
, C_Strerror
, "strerror");
261 pragma Import
(C
, C_System
, "system");
263 pragma Import
(C
, Nonreentrant_Gethostbyname
, "gethostbyname");
264 pragma Import
(C
, Nonreentrant_Gethostbyaddr
, "gethostbyaddr");
265 pragma Import
(C
, Nonreentrant_Getservbyname
, "getservbyname");
266 pragma Import
(C
, Nonreentrant_Getservbyport
, "getservbyport");
268 end GNAT
.Sockets
.Thin
;