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>

    10

    11

/*

    12

 * The generic socket handle

    13

 */

    14

struct sock_stream;

    15

    16

/*

    28

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

    31

 */

    33

    34

/*

    35

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

    36

 * *sock_ptr. In case of errors, additional error information is stored in *err.

    37

 *

    38

 * @return zero on success, nonzero on error

    39

 *

    40

 * XXX: blocking

    41

 */

    42

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

    43

    44

/*

    45

 * A simple blocking SSL connect to the given host/service. The connected/handshake'd SSL socket is returned via

    46

 * *sock_ptr. In case of errors, additional error information is stored in *err.

    47

 *

    48

 * XXX: blocking

    49

 * XXX: doesn't do any certificate verification.

    50

 */

    51

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

    52

    53

/*

    59

 * The generic read/write API for stream sockets.

    60

 */

    61

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

    62

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

    63

    64

/**

    65

 * Get current error_info for \a sock.

    66

 */

    67

const struct error_info* sock_stream_error (struct sock_stream *sock);

    68

    69

#endif