| 1 |
/*
|
1 |
/*
|
| 2 |
* This file is part of the pkgnet package - the SvarDOS package manager.
|
2 |
* This file is part of the pkgnet package - the SvarDOS package manager.
|
| 3 |
* Copyright (C) Mateusz Viste 2013-2021
|
3 |
* Copyright (C) Mateusz Viste 2013-2021
|
| 4 |
*/
|
4 |
*/
|
| 5 |
|
5 |
|
| 6 |
|
6 |
|
| 7 |
#ifndef libtcp_hdr
|
7 |
#ifndef libtcp_hdr
|
| 8 |
#define libtcp_hdr
|
8 |
#define libtcp_hdr
|
| 9 |
|
9 |
|
| 10 |
struct net_tcpsocket {
|
- |
|
| 11 |
int s; /* used by platforms with BSD-style sockets */
|
- |
|
| 12 |
void *sock; /* used by other exotic things (like Watt-32) */
|
10 |
struct net_tcpsocket; /* opaque struct, exact implementation in net.c */
|
| 13 |
char buffer[1];
|
- |
|
| 14 |
};
|
- |
|
| 15 |
|
11 |
|
| 16 |
/* resolves name and fills resovled addr into ip. returns 0 on success. */
|
12 |
/* resolves name and fills resovled addr into ip. returns 0 on success. */
|
| 17 |
int net_dnsresolve(char *ip, const char *name);
|
13 |
int net_dnsresolve(char *ip, const char *name);
|
| 18 |
|
14 |
|
| 19 |
/* must be called before using libtcp. returns 0 on success, or non-zero if network subsystem is not available. */
|
15 |
/* must be called before using libtcp. returns 0 on success, or non-zero if network subsystem is not available. */
|
| 20 |
int net_init(void);
|
16 |
int net_init(void);
|
| 21 |
|
17 |
|
| 22 |
/* initiates a connection to an IP host and returns a socket pointer (or NULL
|
18 |
/* initiates a connection to an IP host and returns a socket pointer (or NULL
|
| 23 |
* on error) - note that connection is NOT established at this point!
|
19 |
* on error) - note that connection is NOT established at this point!
|
| 24 |
* use net_isconnected() to know when the connection is connected. */
|
20 |
* use net_isconnected() to know when the connection is connected. */
|
| 25 |
struct net_tcpsocket *net_connect(const char *ip, unsigned short port);
|
21 |
struct net_tcpsocket *net_connect(const char *ip, unsigned short port);
|
| 26 |
|
22 |
|
| 27 |
/* checks whether or not a socket is connected. returns:
|
23 |
/* checks whether or not a socket is connected. returns:
|
| 28 |
* 0 = not connected,
|
24 |
* 0 = not connected,
|
| 29 |
* 1 = connected
|
25 |
* 1 = connected
|
| 30 |
* -1 = error */
|
26 |
* -1 = error */
|
| 31 |
int net_isconnected(struct net_tcpsocket *s);
|
27 |
int net_isconnected(struct net_tcpsocket *s);
|
| 32 |
|
28 |
|
| 33 |
/* Sends data on socket 'socket'.
|
29 |
/* Sends data on socket 'socket'.
|
| 34 |
Returns the number of bytes sent on success, and <0 otherwise. The error code can be translated into a human error message via libtcp_strerr(). */
|
30 |
Returns the number of bytes sent on success, and <0 otherwise. The error code can be translated into a human error message via libtcp_strerr(). */
|
| 35 |
int net_send(struct net_tcpsocket *socket, const void *line, long len);
|
31 |
int net_send(struct net_tcpsocket *socket, const void *line, long len);
|
| 36 |
|
32 |
|
| 37 |
/* Reads data from socket 'sock' and write it into buffer 'buff', until end of connection. Will fall into error if the amount of data is bigger than 'maxlen' bytes.
|
33 |
/* Reads data from socket 'sock' and write it into buffer 'buff', until end of connection. Will fall into error if the amount of data is bigger than 'maxlen' bytes.
|
| 38 |
Returns the amount of data read (in bytes) on success, or a negative value otherwise. The error code can be translated into a human error message via libtcp_strerr(). */
|
34 |
Returns the amount of data read (in bytes) on success, or a negative value otherwise. The error code can be translated into a human error message via libtcp_strerr(). */
|
| 39 |
int net_recv(struct net_tcpsocket *socket, void *buff, long maxlen);
|
35 |
int net_recv(struct net_tcpsocket *socket, void *buff, long maxlen);
|
| 40 |
|
36 |
|
| 41 |
/* Close the 'sock' socket. */
|
37 |
/* Close the 'sock' socket. */
|
| 42 |
void net_close(struct net_tcpsocket *socket);
|
38 |
void net_close(struct net_tcpsocket *socket);
|
| 43 |
|
39 |
|
| 44 |
/* Close the 'sock' socket immediately (to be used when the peer is behaving wrongly) - this is much faster than net_close(). */
|
- |
|
| 45 |
void net_abort(struct net_tcpsocket *socket);
|
- |
|
| 46 |
|
- |
|
| 47 |
/* Returns an info string about the networking engine being used */
|
40 |
/* Returns an info string about the networking engine being used */
|
| 48 |
const char *net_engine(void);
|
41 |
const char *net_engine(void);
|
| 49 |
|
42 |
|
| 50 |
#endif
|
43 |
#endif
|
| 51 |
|
44 |
|