| ------------------------------------------------------------------------------ |
| -- -- |
| -- GNAT COMPILER COMPONENTS -- |
| -- -- |
| -- G N A T . S O C K E T S . T H I N -- |
| -- -- |
| -- S p e c -- |
| -- -- |
| -- Copyright (C) 2001-2022, AdaCore -- |
| -- -- |
| -- GNAT is free software; you can redistribute it and/or modify it under -- |
| -- terms of the GNU General Public License as published by the Free Soft- -- |
| -- ware Foundation; either version 3, or (at your option) any later ver- -- |
| -- sion. GNAT is distributed in the hope that it will be useful, but WITH- -- |
| -- OUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY -- |
| -- or FITNESS FOR A PARTICULAR PURPOSE. -- |
| -- -- |
| -- As a special exception under Section 7 of GPL version 3, you are granted -- |
| -- additional permissions described in the GCC Runtime Library Exception, -- |
| -- version 3.1, as published by the Free Software Foundation. -- |
| -- -- |
| -- You should have received a copy of the GNU General Public License and -- |
| -- a copy of the GCC Runtime Library Exception along with this program; -- |
| -- see the files COPYING3 and COPYING.RUNTIME respectively. If not, see -- |
| -- <http://www.gnu.org/licenses/>. -- |
| -- -- |
| -- GNAT was originally developed by the GNAT team at New York University. -- |
| -- Extensive contributions were provided by Ada Core Technologies Inc. -- |
| -- -- |
| ------------------------------------------------------------------------------ |
| |
| -- This package provides a target dependent thin interface to the sockets |
| -- layer for use by the GNAT.Sockets package (g-socket.ads). This package |
| -- should not be directly with'ed by an applications program. |
| |
| -- This version is for NT |
| |
| with Interfaces.C; |
| |
| with GNAT.Sockets.Thin_Common; |
| |
| with System; |
| with System.CRTL; |
| |
| package GNAT.Sockets.Thin is |
| |
| use Thin_Common; |
| |
| package C renames Interfaces.C; |
| |
| function Socket_Errno return Integer; |
| -- Returns last socket error number |
| |
| procedure Set_Socket_Errno (Errno : Integer); |
| -- Set last socket error number |
| |
| function Socket_Error_Message (Errno : Integer) return String; |
| -- Returns the error message string for the error number Errno. If Errno is |
| -- not known, returns "Unknown system error". |
| |
| function Host_Errno return Integer; |
| pragma Import (C, Host_Errno, "__gnat_get_h_errno"); |
| -- Returns last host error number |
| |
| package Host_Error_Messages is |
| |
| function Host_Error_Message (H_Errno : Integer) return String; |
| -- Returns the error message string for the host error number H_Errno. |
| -- If H_Errno is not known, returns "Unknown system error". |
| |
| end Host_Error_Messages; |
| |
| -------------------------------- |
| -- Standard library functions -- |
| -------------------------------- |
| |
| function C_Accept |
| (S : C.int; |
| Addr : System.Address; |
| Addrlen : not null access C.int) return C.int; |
| |
| function C_Bind |
| (S : C.int; |
| Name : System.Address; |
| Namelen : C.int) return C.int; |
| |
| function C_Close |
| (Fd : C.int) return C.int; |
| |
| function C_Connect |
| (S : C.int; |
| Name : System.Address; |
| Namelen : C.int) return C.int; |
| |
| function C_Gethostname |
| (Name : System.Address; |
| Namelen : C.int) return C.int; |
| |
| function C_Getpeername |
| (S : C.int; |
| Name : System.Address; |
| Namelen : not null access C.int) return C.int; |
| |
| function C_Getsockname |
| (S : C.int; |
| Name : System.Address; |
| Namelen : not null access C.int) return C.int; |
| |
| function C_Getsockopt |
| (S : C.int; |
| Level : C.int; |
| Optname : C.int; |
| Optval : System.Address; |
| Optlen : not null access C.int) return C.int; |
| |
| function Socket_Ioctl |
| (S : C.int; |
| Req : SOSC.IOCTL_Req_T; |
| Arg : access C.int) return C.int; |
| |
| function C_Listen |
| (S : C.int; |
| Backlog : C.int) return C.int; |
| |
| function C_Recv |
| (S : C.int; |
| Msg : System.Address; |
| Len : C.int; |
| Flags : C.int) return C.int; |
| |
| function C_Recvfrom |
| (S : C.int; |
| Msg : System.Address; |
| Len : C.int; |
| Flags : C.int; |
| From : System.Address; |
| Fromlen : not null access C.int) return C.int; |
| |
| function C_Recvmsg |
| (S : C.int; |
| Msg : System.Address; |
| Flags : C.int) return System.CRTL.ssize_t; |
| |
| function C_Select |
| (Nfds : C.int; |
| Readfds : access Fd_Set; |
| Writefds : access Fd_Set; |
| Exceptfds : access Fd_Set; |
| Timeout : Timeval_Access) return C.int; |
| |
| function C_Sendmsg |
| (S : C.int; |
| Msg : System.Address; |
| Flags : C.int) return System.CRTL.ssize_t; |
| |
| function C_Sendto |
| (S : C.int; |
| Msg : System.Address; |
| Len : C.int; |
| Flags : C.int; |
| To : System.Address; |
| Tolen : C.int) return C.int; |
| |
| function C_Setsockopt |
| (S : C.int; |
| Level : C.int; |
| Optname : C.int; |
| Optval : System.Address; |
| Optlen : C.int) return C.int; |
| |
| function C_Shutdown |
| (S : C.int; |
| How : C.int) return C.int; |
| |
| function C_Socket |
| (Domain : C.int; |
| Typ : C.int; |
| Protocol : C.int) return C.int; |
| |
| Default_Socket_Pair_Family : constant := SOSC.AF_INET; |
| -- Windows has not socketpair system call, and C_Socketpair below is |
| -- implemented on loopback connected network sockets. |
| |
| function C_Socketpair |
| (Domain : C.int; |
| Typ : C.int; |
| Protocol : C.int; |
| Fds : not null access Fd_Pair) return C.int; |
| -- Creates pair of connected sockets |
| |
| function C_System |
| (Command : System.Address) return C.int; |
| |
| function WSAStartup |
| (WS_Version : Interfaces.C.unsigned_short; |
| WSADataAddress : System.Address) return Interfaces.C.int; |
| |
| ------------------------------------------------------- |
| -- Signalling file descriptors for selector abortion -- |
| ------------------------------------------------------- |
| |
| package Signalling_Fds is |
| |
| function Create (Fds : not null access Fd_Pair) return C.int; |
| pragma Convention (C, Create); |
| -- Create a pair of connected descriptors suitable for use with C_Select |
| -- (used for signalling in Selector objects). |
| |
| function Read (Rsig : C.int) return C.int; |
| pragma Convention (C, Read); |
| -- Read one byte of data from rsig, the read end of a pair of signalling |
| -- fds created by Create_Signalling_Fds. |
| |
| function Write (Wsig : C.int) return C.int; |
| pragma Convention (C, Write); |
| -- Write one byte of data to wsig, the write end of a pair of signalling |
| -- fds created by Create_Signalling_Fds. |
| |
| procedure Close (Sig : C.int); |
| pragma Convention (C, Close); |
| -- Close one end of a pair of signalling fds (ignoring any error) |
| |
| end Signalling_Fds; |
| |
| procedure WSACleanup; |
| |
| procedure Initialize; |
| procedure Finalize; |
| |
| private |
| pragma Import (Stdcall, C_Accept, "accept"); |
| pragma Import (Stdcall, C_Bind, "bind"); |
| pragma Import (Stdcall, C_Close, "closesocket"); |
| pragma Import (Stdcall, C_Gethostname, "gethostname"); |
| pragma Import (Stdcall, C_Getpeername, "getpeername"); |
| pragma Import (Stdcall, C_Getsockname, "getsockname"); |
| pragma Import (Stdcall, C_Getsockopt, "getsockopt"); |
| pragma Import (Stdcall, C_Listen, "listen"); |
| pragma Import (Stdcall, C_Recv, "recv"); |
| pragma Import (Stdcall, C_Recvfrom, "recvfrom"); |
| pragma Import (Stdcall, C_Sendto, "sendto"); |
| pragma Import (Stdcall, C_Setsockopt, "setsockopt"); |
| pragma Import (Stdcall, C_Shutdown, "shutdown"); |
| pragma Import (Stdcall, C_Socket, "socket"); |
| pragma Import (C, C_System, "_system"); |
| pragma Import (Stdcall, Socket_Errno, "WSAGetLastError"); |
| pragma Import (Stdcall, Set_Socket_Errno, "WSASetLastError"); |
| pragma Import (Stdcall, WSAStartup, "WSAStartup"); |
| pragma Import (Stdcall, WSACleanup, "WSACleanup"); |
| |
| end GNAT.Sockets.Thin; |