| LIBBLOCKLIST(3) | Library Functions Manual | LIBBLOCKLIST(3) | 
blocklist_open, blocklist_close,
  blocklist_r, blocklist,
  blocklist_sa, blocklist_sa_r
  —
#include <blocklist.h>
struct blocklist *
  
  blocklist_open(void);
void
  
  blocklist_close(struct
    blocklist *cookie);
int
  
  blocklist(int
    action, int fd,
    const char *msg);
int
  
  blocklist_r(struct
    blocklist *cookie, int
    action, int fd,
    const char *msg);
int
  
  blocklist_sa(int
    action, int fd,
    const struct sockaddr
    *sa, socklen_t
    salen, const char
    *msg);
int
  
  blocklist_sa_r(struct
    blocklist *cookie, int
    action, int fd,
    const struct sockaddr
    *sa, socklen_t
    salen, const char
    *msg);
The function blocklist_open() creates the
    necessary state to communicate with
    blocklistd(8) and returns
    a pointer to it, or NULL on failure.
The blocklist_close() function frees all
    memory and resources used.
The blocklist() function sends a message
    to blocklistd(8), with an
    integer action argument specifying the type of
    notification, a file descriptor fd specifying the
    accepted file descriptor connected to the client, and an optional message in
    the msg argument.
The action parameter can take these values:
The blocklist_r() function is more
    efficient because it keeps the blocklist state around.
The blocklist_sa() and
    blocklist_sa_r() functions can be used with
    unconnected sockets, where
    getpeername(2) will not
    work, the server will pass the peer name in the message.
In all cases the file descriptor passed in the fd argument must be pointing to a valid socket so that blocklistd(8) can establish ownership of the local endpoint using getsockname(2).
By default,
    syslogd(8) is used for
    message logging. The internal bl_create() function
    can be used to create the required internal state and specify a custom
    logging function.
blocklist_open() returns a cookie on
  success and NULL on failure setting
  errno to an appropriate value.
The functions blocklist(),
    blocklist_sa(), and
    blocklist_sa_r() return 0 on
    success and -1 on failure setting
    errno to an appropriate value.
| March 30, 2020 | NetBSD 10.0 |