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-2010, 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
38 with Interfaces
.C
.Strings
;
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 C
.Strings
.chars_ptr
;
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
72 (H_Errno
: Integer) return C
.Strings
.chars_ptr
;
73 -- Returns the error message string for the host error number H_Errno.
74 -- If H_Errno is not known, returns "Unknown system error".
76 end Host_Error_Messages
;
78 --------------------------------
79 -- Standard library functions --
80 --------------------------------
84 Addr
: System
.Address
;
85 Addrlen
: not null access C
.int
) return C
.int
;
89 Name
: System
.Address
;
90 Namelen
: C
.int
) return C
.int
;
93 (Fd
: C
.int
) return C
.int
;
97 Name
: System
.Address
;
98 Namelen
: C
.int
) return C
.int
;
100 function C_Gethostname
101 (Name
: System
.Address
;
102 Namelen
: C
.int
) return C
.int
;
104 function C_Getpeername
106 Name
: System
.Address
;
107 Namelen
: not null access C
.int
) return C
.int
;
109 function C_Getsockname
111 Name
: System
.Address
;
112 Namelen
: not null access C
.int
) return C
.int
;
114 function C_Getsockopt
118 Optval
: System
.Address
;
119 Optlen
: not null access C
.int
) return C
.int
;
121 function Socket_Ioctl
124 Arg
: access C
.int
) return C
.int
;
128 Backlog
: C
.int
) return C
.int
;
132 Msg
: System
.Address
;
134 Flags
: C
.int
) return C
.int
;
138 Msg
: System
.Address
;
141 From
: System
.Address
;
142 Fromlen
: not null access C
.int
) return C
.int
;
146 Msg
: System
.Address
;
147 Flags
: C
.int
) return System
.CRTL
.ssize_t
;
151 Readfds
: access Fd_Set
;
152 Writefds
: access Fd_Set
;
153 Exceptfds
: access Fd_Set
;
154 Timeout
: Timeval_Access
) return C
.int
;
158 Msg
: System
.Address
;
159 Flags
: C
.int
) return System
.CRTL
.ssize_t
;
163 Msg
: System
.Address
;
167 Tolen
: C
.int
) return C
.int
;
169 function C_Setsockopt
173 Optval
: System
.Address
;
174 Optlen
: C
.int
) return C
.int
;
178 How
: C
.int
) return C
.int
;
183 Protocol
: C
.int
) return C
.int
;
186 (Command
: System
.Address
) return C
.int
;
188 -------------------------------------------------------
189 -- Signalling file descriptors for selector abortion --
190 -------------------------------------------------------
192 package Signalling_Fds
is
194 function Create
(Fds
: not null access Fd_Pair
) return C
.int
;
195 pragma Convention
(C
, Create
);
196 -- Create a pair of connected descriptors suitable for use with C_Select
197 -- (used for signalling in Selector objects).
199 function Read
(Rsig
: C
.int
) return C
.int
;
200 pragma Convention
(C
, Read
);
201 -- Read one byte of data from rsig, the read end of a pair of signalling
202 -- fds created by Create_Signalling_Fds.
204 function Write
(Wsig
: C
.int
) return C
.int
;
205 pragma Convention
(C
, Write
);
206 -- Write one byte of data to wsig, the write end of a pair of signalling
207 -- fds created by Create_Signalling_Fds.
209 procedure Close
(Sig
: C
.int
);
210 pragma Convention
(C
, Close
);
211 -- Close one end of a pair of signalling fds (ignoring any error)
215 -------------------------------------------
216 -- Nonreentrant network databases access --
217 -------------------------------------------
219 -- The following are used only on systems that have nonreentrant
220 -- getXXXbyYYY functions, and do NOT have corresponding getXXXbyYYY_
221 -- functions. Currently, LynxOS is the only such system.
223 function Nonreentrant_Gethostbyname
224 (Name
: C
.char_array
) return Hostent_Access
;
226 function Nonreentrant_Gethostbyaddr
227 (Addr
: System
.Address
;
229 Addr_Type
: C
.int
) return Hostent_Access
;
231 function Nonreentrant_Getservbyname
232 (Name
: C
.char_array
;
233 Proto
: C
.char_array
) return Servent_Access
;
235 function Nonreentrant_Getservbyport
237 Proto
: C
.char_array
) return Servent_Access
;
239 procedure Initialize
;
243 pragma Import
(C
, C_Bind
, "bind");
244 pragma Import
(C
, C_Close
, "close");
245 pragma Import
(C
, C_Gethostname
, "gethostname");
246 pragma Import
(C
, C_Getpeername
, "getpeername");
247 pragma Import
(C
, C_Getsockname
, "getsockname");
248 pragma Import
(C
, C_Getsockopt
, "getsockopt");
249 pragma Import
(C
, C_Listen
, "listen");
250 pragma Import
(C
, C_Select
, "select");
251 pragma Import
(C
, C_Setsockopt
, "setsockopt");
252 pragma Import
(C
, C_Shutdown
, "shutdown");
253 pragma Import
(C
, C_System
, "system");
255 pragma Import
(C
, Nonreentrant_Gethostbyname
, "gethostbyname");
256 pragma Import
(C
, Nonreentrant_Gethostbyaddr
, "gethostbyaddr");
257 pragma Import
(C
, Nonreentrant_Getservbyname
, "getservbyname");
258 pragma Import
(C
, Nonreentrant_Getservbyport
, "getservbyport");
260 end GNAT
.Sockets
.Thin
;