2 * netlink/socket.h Netlink Socket
4 * This library is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU Lesser General Public
6 * License as published by the Free Software Foundation version 2.1
9 * Copyright (c) 2003-2008 Thomas Graf <tgraf@suug.ch>
12 #ifndef NETLINK_SOCKET_H_
13 #define NETLINK_SOCKET_H_
15 #include <netlink/types.h>
16 #include <netlink/handlers.h>
22 #define NL_SOCK_BUFSIZE_SET (1<<0)
23 #define NL_SOCK_PASSCRED (1<<1)
24 #define NL_OWN_PORT (1<<2)
25 #define NL_MSG_PEEK (1<<3)
26 #define NL_NO_AUTO_ACK (1<<4)
31 struct sockaddr_nl s_local
;
32 struct sockaddr_nl s_peer
;
35 unsigned int s_seq_next
;
36 unsigned int s_seq_expect
;
42 extern struct nl_sock
* nl_socket_alloc(void);
43 extern struct nl_sock
* nl_socket_alloc_cb(struct nl_cb
*);
44 extern void nl_socket_free(struct nl_sock
*);
46 extern void nl_socket_set_local_port(struct nl_sock
*, uint32_t);
48 extern int nl_socket_add_memberships(struct nl_sock
*, int, ...);
49 extern int nl_socket_drop_memberships(struct nl_sock
*, int, ...);
51 extern int nl_socket_set_buffer_size(struct nl_sock
*, int, int);
52 extern int nl_socket_set_passcred(struct nl_sock
*, int);
53 extern int nl_socket_recv_pktinfo(struct nl_sock
*, int);
55 extern void nl_socket_disable_seq_check(struct nl_sock
*);
57 extern int nl_socket_set_nonblocking(struct nl_sock
*);
60 * Use next sequence number
61 * @arg sk Netlink socket.
63 * Uses the next available sequence number and increases the counter
64 * by one for subsequent calls.
66 * @return Unique serial sequence number
68 static inline unsigned int nl_socket_use_seq(struct nl_sock
*sk
)
70 return sk
->s_seq_next
++;
74 * Disable automatic request for ACK
75 * @arg sk Netlink socket.
77 * The default behaviour of a socket is to request an ACK for
78 * each message sent to allow for the caller to synchronize to
79 * the completion of the netlink operation. This function
80 * disables this behaviour and will result in requests being
81 * sent which will not have the NLM_F_ACK flag set automatically.
82 * However, it is still possible for the caller to set the
83 * NLM_F_ACK flag explicitely.
85 static inline void nl_socket_disable_auto_ack(struct nl_sock
*sk
)
87 sk
->s_flags
|= NL_NO_AUTO_ACK
;
91 * Enable automatic request for ACK (default)
92 * @arg sk Netlink socket.
93 * @see nl_socket_disable_auto_ack
95 static inline void nl_socket_enable_auto_ack(struct nl_sock
*sk
)
97 sk
->s_flags
&= ~NL_NO_AUTO_ACK
;
101 * @name Source Idenficiation
105 static inline uint32_t nl_socket_get_local_port(struct nl_sock
*sk
)
107 return sk
->s_local
.nl_pid
;
111 * Join multicast groups (deprecated)
112 * @arg sk Netlink socket.
113 * @arg groups Bitmask of groups to join.
115 * This function defines the old way of joining multicast group which
116 * has to be done prior to calling nl_connect(). It works on any kernel
117 * version but is very limited as only 32 groups can be joined.
119 static inline void nl_join_groups(struct nl_sock
*sk
, int groups
)
121 sk
->s_local
.nl_groups
|= groups
;
125 * @name Peer Identfication
129 static inline uint32_t nl_socket_get_peer_port(struct nl_sock
*sk
)
131 return sk
->s_peer
.nl_pid
;
134 static inline void nl_socket_set_peer_port(struct nl_sock
*sk
, uint32_t port
)
136 sk
->s_peer
.nl_pid
= port
;
142 * @name File Descriptor
146 static inline int nl_socket_get_fd(struct nl_sock
*sk
)
152 * Enable use of MSG_PEEK when reading from socket
153 * @arg sk Netlink socket.
155 static inline void nl_socket_enable_msg_peek(struct nl_sock
*sk
)
157 sk
->s_flags
|= NL_MSG_PEEK
;
161 * Disable use of MSG_PEEK when reading from socket
162 * @arg sk Netlink socket.
164 static inline void nl_socket_disable_msg_peek(struct nl_sock
*sk
)
166 sk
->s_flags
&= ~NL_MSG_PEEK
;
170 * @name Callback Handler
174 static inline struct nl_cb
*nl_socket_get_cb(struct nl_sock
*sk
)
176 return nl_cb_get(sk
->s_cb
);
179 static inline void nl_socket_set_cb(struct nl_sock
*sk
, struct nl_cb
*cb
)
182 sk
->s_cb
= nl_cb_get(cb
);
186 * Modify the callback handler associated to the socket
187 * @arg sk Netlink socket.
188 * @arg type which type callback to set
189 * @arg kind kind of callback
190 * @arg func callback function
191 * @arg arg argument to be passwd to callback function
195 static inline int nl_socket_modify_cb(struct nl_sock
*sk
, enum nl_cb_type type
,
196 enum nl_cb_kind kind
, nl_recvmsg_msg_cb_t func
,
199 return nl_cb_set(sk
->s_cb
, type
, kind
, func
, arg
);
204 static inline int nl_socket_add_membership(struct nl_sock
*sk
, int group
)
206 return nl_socket_add_memberships(sk
, group
, 0);
210 static inline int nl_socket_drop_membership(struct nl_sock
*sk
, int group
)
212 return nl_socket_drop_memberships(sk
, group
, 0);
This page took 0.04935 seconds and 5 git commands to generate.