1

#ifndef SOCK_H

     2

#define SOCK_H

     3

     4

/*

     5

 * Low-level socket-related functions

     6

 */

     7

#include "error.h"

     8

#include <sys/types.h>

     9

    10

/*

    11

 * The generic socket handle

    12

 */

    13

struct sock_stream;

    14

    15

/*

    16

 * Initialize the socket module's global state. Call this before calling any other sock_* functions.

    17

 */

    18

err_t sock_init (struct error_info *err);

    19

    20

/*

    21

 * A simple blocking TCP connect to the given host/service, using getaddrinfo. The connected socket is returned via

    23

 *

    24

 * @return zero on success, nonzero on error

    25

 *

    26

 * XXX: blocking

    27

 */

    28

err_t sock_tcp_connect (struct sock_stream **sock_ptr, const char *host, const char *service, struct error_info *err);

    29

    30

/*

    33

 *

    34

 * XXX: blocking

    35

 * XXX: doesn't do any certificate verification.

    36

 */

    38

    39

/*

    40

 * The generic read/write API for stream sockets.

    41

 */

    42

err_t sock_stream_read (struct sock_stream *sock, void *buf, size_t len);

    43

err_t sock_stream_write (struct sock_stream *sock, const void *buf, size_t len);

    44

    45

/**

    46

 * Get last err_info for \a sock, returned via \a *err.

    47

 */

    48

void sock_stream_error (struct sock_stream *sock, struct error_info *err);

    49

    50

#endif