Subversion Repositories HelenOS

Rev

Rev 4559 | Go to most recent revision | Details | Compare with Previous | Last modification | View Log | RSS feed

Rev Author Line No. Line
3846 mejdrech 1
/*
3912 mejdrech 2
 * Copyright (c) 2009 Lukas Mejdrech
3846 mejdrech 3
 * All rights reserved.
4
 *
5
 * Redistribution and use in source and binary forms, with or without
6
 * modification, are permitted provided that the following conditions
7
 * are met:
8
 *
9
 * - Redistributions of source code must retain the above copyright
10
 *   notice, this list of conditions and the following disclaimer.
11
 * - Redistributions in binary form must reproduce the above copyright
12
 *   notice, this list of conditions and the following disclaimer in the
13
 *   documentation and/or other materials provided with the distribution.
14
 * - The name of the author may not be used to endorse or promote products
15
 *   derived from this software without specific prior written permission.
16
 *
17
 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
18
 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
19
 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
20
 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
21
 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
22
 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
23
 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
24
 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
25
 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
26
 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
27
 */
28
 
29
/** @addtogroup net
3912 mejdrech 30
 *  @{
3846 mejdrech 31
 */
32
 
33
/** @file
4704 mejdrech 34
 *  Internet common definitions.
3846 mejdrech 35
 */
36
 
4559 mejdrech 37
#ifndef __NET_INET_H__
38
#define __NET_INET_H__
3846 mejdrech 39
 
40
#include <sys/types.h>
41
 
4559 mejdrech 42
#include "byteorder.h"
3846 mejdrech 43
 
4704 mejdrech 44
/** Type definition of the socket address.
45
 *  @see sockaddr
46
 */
3846 mejdrech 47
typedef struct sockaddr     sockaddr_t;
4704 mejdrech 48
 
49
/** Type definition of the address information.
50
 *  @see addrinfo
51
 */
3846 mejdrech 52
typedef struct addrinfo     addrinfo_t;
53
 
4704 mejdrech 54
/** Prints the address into the character buffer.
55
 *  @param family The address family. Input parameter.
56
 *  @param data The address data. Input parameter.
57
 *  @param address The character buffer to be filled. Output parameter.
58
 *  @param length The buffer length. Input parameter.
59
 *  @returns EOK on success.
60
 *  @returns EINVAL if the data or address parameter is NULL.
61
 *  @returns ENOMEM if the character buffer is not long enough.
62
 *  @returns ENOTSUP if the address family is not supported.
63
 */
3846 mejdrech 64
int inet_ntop( uint16_t family, const uint8_t * data, char * address, size_t length );
4704 mejdrech 65
 
66
/** Parses the character string into the address.
67
 *  If the string is shorter than the full address, zero bytes are added.
68
 *  @param family The address family. Input parameter.
69
 *  @param address The character buffer to be parsed. Input parameter.
70
 *  @param data The address data to be filled. Output parameter.
71
 *  @returns EOK on success.
72
 *  @returns EINVAL if the data parameter is NULL.
73
 *  @returns ENOENT if the address parameter is NULL.
74
 *  @returns ENOTSUP if the address family is not supported.
75
 */
3846 mejdrech 76
int inet_pton( uint16_t family, const char * address, uint8_t * data );
77
 
4704 mejdrech 78
/** Socket address.
79
 */
3846 mejdrech 80
struct sockaddr{
4704 mejdrech 81
    /** Address family.
82
     *  @see socket.h
83
     */
84
    uint16_t        sa_family;
85
    /** 14 byte protocol address.
86
     */
87
    uint8_t         sa_data[ 14 ];
3846 mejdrech 88
};
89
 
4704 mejdrech 90
/** Address information.
91
 * \todo
92
 */
3846 mejdrech 93
struct addrinfo{
94
    int             ai_flags;       // AI_PASSIVE, AI_CANONNAME, etc.
95
    uint16_t        ai_family;      // AF_INET, AF_INET6, AF_UNSPEC
96
    int             ai_socktype;    // SOCK_STREAM, SOCK_DGRAM
97
    int             ai_protocol;    // use 0 for "any"
98
    size_t          ai_addrlen;     // size of ai_addr in bytes
99
    struct sockaddr *   ai_addr;    // struct sockaddr_in or _in6
100
    char *          ai_canonname;   // full canonical hostname
101
    struct addrinfo *   ai_next;    // linked list, next node
102
};
103
 
104
/*int getaddrinfo(const char *node, // e.g. "www.example.com" or IP
105
const char *service, // e.g. "http" or port number
106
const struct addrinfo *hints,
107
struct addrinfo **res);
108
 
109
getnameinfo
110
*/
111
 
112
#endif
113
 
114
/** @}
115
 */