]> pilppa.org Git - linux-2.6-omap-h63xx.git/blobdiff - include/net/netlink.h
[XFRM] STATE: Introduce care-of address.
[linux-2.6-omap-h63xx.git] / include / net / netlink.h
index 640c26a90cf1f57cc6415f76892fc9be8d62fdf6..47044da167c50793377d257029fd71e919236bb9 100644 (file)
  *   nlmsg_put()                       add a netlink message to an skb
  *   nlmsg_put_answer()                        callback based nlmsg_put()
  *   nlmsg_end()                       finanlize netlink message
+ *   nlmsg_get_pos()                   return current position in message
+ *   nlmsg_trim()                      trim part of message
  *   nlmsg_cancel()                    cancel message construction
  *   nlmsg_free()                      free a netlink message
  *
  * Message Sending:
  *   nlmsg_multicast()                 multicast message to several groups
  *   nlmsg_unicast()                   unicast a message to a single socket
+ *   nlmsg_notify()                    send notification message
  *
  * Message Length Calculations:
  *   nlmsg_msg_size(payload)           length of message w/o padding
@@ -62,6 +65,9 @@
  *   nlmsg_validate()                  validate netlink message incl. attrs
  *   nlmsg_for_each_attr()             loop over all attributes
  *
+ * Misc:
+ *   nlmsg_report()                    report back to application?
+ *
  * ------------------------------------------------------------------------
  *                          Attributes Interface
  * ------------------------------------------------------------------------
  *   struct nlattr                     netlink attribtue header
  *
  * Attribute Construction:
- *   nla_reserve(skb, type, len)       reserve skb tailroom for an attribute
+ *   nla_reserve(skb, type, len)       reserve room for an attribute
+ *   nla_reserve_nohdr(skb, len)       reserve room for an attribute w/o hdr
  *   nla_put(skb, type, len, data)     add attribute to skb
+ *   nla_put_nohdr(skb, len, data)     add attribute w/o hdr
  *
  * Attribute Construction for Basic Types:
  *   nla_put_u8(skb, type, value)      add u8 attribute to skb
  *   nla_next(nla, remaining)          get next netlink attribute
  *   nla_validate()                    validate a stream of attributes
  *   nla_find()                                find attribute in stream of attributes
+ *   nla_find_nested()                 find attribute in nested attributes
  *   nla_parse()                       parse and validate stream of attrs
  *   nla_parse_nested()                        parse nested attribuets
  *   nla_for_each_attr()               loop over all attributes
@@ -183,11 +192,24 @@ struct nla_policy {
        u16             minlen;
 };
 
+/**
+ * struct nl_info - netlink source information
+ * @nlh: Netlink message header of original request
+ * @pid: Netlink PID of requesting application
+ */
+struct nl_info {
+       struct nlmsghdr         *nlh;
+       u32                     pid;
+};
+
 extern void            netlink_run_queue(struct sock *sk, unsigned int *qlen,
                                          int (*cb)(struct sk_buff *,
                                                    struct nlmsghdr *, int *));
 extern void            netlink_queue_skip(struct nlmsghdr *nlh,
                                           struct sk_buff *skb);
+extern int             nlmsg_notify(struct sock *sk, struct sk_buff *skb,
+                                    u32 pid, unsigned int group, int report,
+                                    gfp_t flags);
 
 extern int             nla_validate(struct nlattr *head, int len, int maxtype,
                                     struct nla_policy *policy);
@@ -203,12 +225,18 @@ extern int                nla_memcmp(const struct nlattr *nla, const void *data,
 extern int             nla_strcmp(const struct nlattr *nla, const char *str);
 extern struct nlattr * __nla_reserve(struct sk_buff *skb, int attrtype,
                                      int attrlen);
+extern void *          __nla_reserve_nohdr(struct sk_buff *skb, int attrlen);
 extern struct nlattr * nla_reserve(struct sk_buff *skb, int attrtype,
                                    int attrlen);
+extern void *          nla_reserve_nohdr(struct sk_buff *skb, int attrlen);
 extern void            __nla_put(struct sk_buff *skb, int attrtype,
                                  int attrlen, const void *data);
+extern void            __nla_put_nohdr(struct sk_buff *skb, int attrlen,
+                                       const void *data);
 extern int             nla_put(struct sk_buff *skb, int attrtype,
                                int attrlen, const void *data);
+extern int             nla_put_nohdr(struct sk_buff *skb, int attrlen,
+                                     const void *data);
 
 /**************************************************************************
  * Netlink Messages
@@ -363,6 +391,17 @@ static inline int nlmsg_validate(struct nlmsghdr *nlh, int hdrlen, int maxtype,
                            nlmsg_attrlen(nlh, hdrlen), maxtype, policy);
 }
 
+/**
+ * nlmsg_report - need to report back to application?
+ * @nlh: netlink message header
+ *
+ * Returns 1 if a report back to the application is requested.
+ */
+static inline int nlmsg_report(struct nlmsghdr *nlh)
+{
+       return !!(nlh->nlmsg_flags & NLM_F_ECHO);
+}
+
 /**
  * nlmsg_for_each_attr - iterate over a stream of attributes
  * @pos: loop counter, set to current attribute
@@ -453,12 +492,13 @@ static inline struct nlmsghdr *nlmsg_put_answer(struct sk_buff *skb,
 /**
  * nlmsg_new - Allocate a new netlink message
  * @size: maximum size of message
+ * @flags: the type of memory to allocate.
  *
  * Use NLMSG_GOODSIZE if size isn't know and you need a good default size.
  */
-static inline struct sk_buff *nlmsg_new(int size)
+static inline struct sk_buff *nlmsg_new(int size, gfp_t flags)
 {
-       return alloc_skb(NLMSG_GOODSIZE, GFP_KERNEL);
+       return alloc_skb(size, flags);
 }
 
 /**
@@ -479,6 +519,32 @@ static inline int nlmsg_end(struct sk_buff *skb, struct nlmsghdr *nlh)
        return skb->len;
 }
 
+/**
+ * nlmsg_get_pos - return current position in netlink message
+ * @skb: socket buffer the message is stored in
+ *
+ * Returns a pointer to the current tail of the message.
+ */
+static inline void *nlmsg_get_pos(struct sk_buff *skb)
+{
+       return skb->tail;
+}
+
+/**
+ * nlmsg_trim - Trim message to a mark
+ * @skb: socket buffer the message is stored in
+ * @mark: mark to trim to
+ *
+ * Trims the message to the provided mark. Returns -1.
+ */
+static inline int nlmsg_trim(struct sk_buff *skb, void *mark)
+{
+       if (mark)
+               skb_trim(skb, (unsigned char *) mark - skb->data);
+
+       return -1;
+}
+
 /**
  * nlmsg_cancel - Cancel construction of a netlink message
  * @skb: socket buffer the message is stored in
@@ -489,9 +555,7 @@ static inline int nlmsg_end(struct sk_buff *skb, struct nlmsghdr *nlh)
  */
 static inline int nlmsg_cancel(struct sk_buff *skb, struct nlmsghdr *nlh)
 {
-       skb_trim(skb, (unsigned char *) nlh - skb->data);
-
-       return -1;
+       return nlmsg_trim(skb, nlh);
 }
 
 /**
@@ -509,15 +573,16 @@ static inline void nlmsg_free(struct sk_buff *skb)
  * @skb: netlink message as socket buffer
  * @pid: own netlink pid to avoid sending to yourself
  * @group: multicast group id
+ * @flags: allocation flags
  */
 static inline int nlmsg_multicast(struct sock *sk, struct sk_buff *skb,
-                                 u32 pid, unsigned int group)
+                                 u32 pid, unsigned int group, gfp_t flags)
 {
        int err;
 
        NETLINK_CB(skb).dst_group = group;
 
-       err = netlink_broadcast(sk, skb, pid, group, GFP_KERNEL);
+       err = netlink_broadcast(sk, skb, pid, group, flags);
        if (err > 0)
                err = 0;
 
@@ -630,6 +695,18 @@ static inline struct nlattr *nla_next(const struct nlattr *nla, int *remaining)
        return (struct nlattr *) ((char *) nla + totlen);
 }
 
+/**
+ * nla_find_nested - find attribute in a set of nested attributes
+ * @nla: attribute containing the nested attributes
+ * @attrtype: type of attribute to look for
+ *
+ * Returns the first attribute which matches the specified type.
+ */
+static inline struct nlattr *nla_find_nested(struct nlattr *nla, int attrtype)
+{
+       return nla_find(nla_data(nla), nla_len(nla), attrtype);
+}
+
 /**
  * nla_parse_nested - parse nested attributes
  * @tb: destination array with maxtype+1 elements
@@ -862,10 +939,7 @@ static inline int nla_nest_end(struct sk_buff *skb, struct nlattr *start)
  */
 static inline int nla_nest_cancel(struct sk_buff *skb, struct nlattr *start)
 {
-       if (start)
-               skb_trim(skb, (unsigned char *) start - skb->data);
-
-       return -1;
+       return nlmsg_trim(skb, start);
 }
 
 /**
@@ -880,4 +954,13 @@ static inline int nla_nest_cancel(struct sk_buff *skb, struct nlattr *start)
             nla_ok(pos, rem); \
             pos = nla_next(pos, &(rem)))
 
+/**
+ * nla_for_each_nested - iterate over nested attributes
+ * @pos: loop counter, set to current attribute
+ * @nla: attribute containing the nested attributes
+ * @rem: initialized to len, holds bytes currently remaining in stream
+ */
+#define nla_for_each_nested(pos, nla, rem) \
+       nla_for_each_attr(pos, nla_data(nla), nla_len(nla), rem)
+
 #endif