HIPL Documentation

1.0

Welcome to Host Identity Protocol for Linux (HIPL) Doxygen page.

Project Documents

• HIPL source code
• Web-based version control browser
• doc/HACKING. This file contains developer information on policies in the HIPL project.
• HIPL User Manual. Run make doc/HOWTO.html to generate it.. Periodically prebuilt manual is also available (from the trunk branch).

• Launchpad bug tracker

Links

• Project home page.

• Linux Man Pages. See section 3 for C-library functions.
• C/C++ Reference.
• The C Library Reference Guide by Eric Huss.
• C Language Keywords.

• Standard C Library by Dinkumware Ltd.
• The GNU C Programming Tutorial.
• C Language Gotchas. A description of some easy-to-make mistakes in C.
• Inline Functions In C. Notes on GCC and standard C inline functions.
• Specifying Attributes of Variables. Information about specifying special attributes of variables or structure fields. For example, what does the __attribute__ ((packed)) after a structure definition really mean.
• Frequently Asked Questions at comp.lang.c.

• DocBook: The Definitive Guide. A guide for the docbook tool that is used to create the HIPL user manual.

Frequently asked questions (FAQ)

The Socket Interface

Since the socket interface issues keep on popping up, we have gathered links related to sockaddr, sockaddr_in, sockaddr_in6 and sockaddr_storage data structures here.

• RFC 2553: Basic Socket Interface Extensions for IPv6.
• Implementing AF-independent application. A document that describes how a programmer can handle multiple address families at ease.
• sockaddr_in is defined in /usr/include/linux/in.h. See ip(7) - Linux man page.

       struct sockaddr_in {
              sa_family_t    sin_family;
              __be16         sin_port;
              struct in_addr sin_addr;
              unsigned char  __pad[__SOCK_SIZE__ - sizeof(short int) -
                             sizeof(unsigned short int) - sizeof(struct in_addr)];
       };

• sockaddr_in6 is defined in /usr/include/linux/in6.h. See ipv6(7) - Linux man page.

       struct sockaddr_in6 {
              unsigned short int sin6_family;
              __be16             sin6_port;
              __be32             sin6_flowinfo;
             struct in6_addr     sin6_addr;
             __u32               sin6_scope_id;
       };

• sockaddr is defined in /usr/include/linux/socket.h. See socket(7) - Linux man page.

       struct sockaddr {
              sa_family_t sa_family;
              char        sa_data[14];
       };

• sockaddr_storage is defined in /usr/include/linux/socket.h. See socket(7) - Linux man page.

       struct sockaddr_storage {
              unsigned short ss_family;
              char     __data[_K_SS_MAXSIZE - sizeof(unsigned short)];
       } __attribute__ ((aligned(_K_SS_ALIGNSIZE)));