1

"""

     2

    Internal module to keep the abstract sockaddr types out of the address module, which must contain backreferences to

     3

    the concrete implementations.

     4

"""

     5

     6

cimport qmsk.net.socket.platform as platform

     7

     8

cdef class sockaddr :

     9

    """

    10

        A network-level socket address

    11

    12

        XXX: not abstract enough. Functions/properties like getnameinfo/addr/port do not work for e.g. sockaddr_un

    13

    14

        >>> sockaddr().family

    15

        0

    16

        >>> sockaddr().port

    17

        Traceback (most recent call last):

    18

          ...

    19

        NotImplementedError

    20

        >>> sockaddr().getnameinfo()

    21

        Traceback (most recent call last):

    22

          ...

    23

        NotImplementedError

    24

    """

    25

    26

    # address family

    27

    # XXX: this should be a class constant! It's part of our type safety!

    28

    cdef readonly platform.sa_family_t family

    29

    30

    cdef void _init_family (self, platform.sa_family_t family = ?)

    31

    32

    # get the sockaddr/socklen

    33

    # each of these can be NULL to ignore it

    34

    cdef int _get_sockaddr (self, platform.sockaddr **sa_ptr, platform.socklen_t *sa_len) except -1

    35

    36

    cdef platform.sockaddr* _get_sockaddr_ptr (self) except NULL

    37

    cdef platform.socklen_t _get_sockaddr_len (self) except -1

    38

    39

    # set the sockaddr, socklen must match

    40

    cdef int _set_sockaddr (self, platform.sockaddr *sa, size_t sa_len) except -1

    41

    42