err.3: EXAMPLES: use EXIT_FAILURE rather than 1 as exit status

[thirdparty/man-pages.git] / man3 / rtnetlink.3

diff --git a/man3/rtnetlink.3 b/man3/rtnetlink.3
index 0fdfddf1f7bd48d1c39b1be80b0a041c0f4fca7f..89f4f59c2cd05083e2139026e25f392e87867812 100644 (file)
--- a/man3/rtnetlink.3
+++ b/man3/rtnetlink.3
@@ -1,10 +1,15 @@
 .\" This man page is Copyright (C) 1999 Andi Kleen <ak@muc.de>.
+.\"
+.\" %%%LICENSE_START(VERBATIM_ONE_PARA)
 .\" Permission is granted to distribute possibly modified copies
 .\" of this page provided the header is included verbatim,
 .\" and in case of nontrivial modification author and date
 .\" of the modification is added to the header.
+.\" %%%LICENSE_END
+.\"
 .\" $Id: rtnetlink.3,v 1.2 1999/05/18 10:35:10 freitag Exp $
-.TH RTNETLINK 3 1999-05-14 "GNU" "Linux Programmer's Manual"
+.\"
+.TH RTNETLINK 3 2014-09-06 "GNU" "Linux Programmer's Manual"
 .SH NAME
 rtnetlink \- macros to manipulate rtnetlink messages
 .SH SYNOPSIS
@@ -15,21 +20,21 @@ rtnetlink \- macros to manipulate rtnetlink messages
 .B #include <linux/rtnetlink.h>
 .br
 .B #include <sys/socket.h>
-
-.BI "rtnetlink_socket = socket(PF_NETLINK, int " socket_type \
+.PP
+.BI "rtnetlink_socket = socket(AF_NETLINK, int " socket_type \
 ", NETLINK_ROUTE);"
-.sp
+.PP
 .BI "int RTA_OK(struct rtattr *" rta ", int " rtabuflen );
-.sp
+.PP
 .BI "void *RTA_DATA(struct rtattr *" rta );
-.sp
+.PP
 .BI "unsigned int RTA_PAYLOAD(struct rtattr *" rta );
-.sp
+.PP
 .BI "struct rtattr *RTA_NEXT(struct rtattr *" rta \
 ", unsigned int " rtabuflen );
-.sp
+.PP
 .BI "unsigned int RTA_LENGTH(unsigned int " length );
-.sp
+.PP
 .BI "unsigned int RTA_SPACE(unsigned int "length );
 .SH DESCRIPTION
 All
@@ -37,19 +42,18 @@ All
 messages consist of a
 .BR netlink (7)
 message header and appended attributes.
-The attributes should be only
-manipulated using the macros provided here.
+The attributes should be manipulated only using the macros provided here.
 .PP
 .BI RTA_OK( rta ", " attrlen )
 returns true if
 .I rta
 points to a valid routing attribute;
 .I attrlen
-is the  running length of the attribute buffer.
+is the running length of the attribute buffer.
 When not true then you must assume there are no more attributes in the
 message, even if
 .I attrlen
-is non-zero.
+is nonzero.
 .PP
 .BI RTA_DATA( rta )
 returns a pointer to the start of this attribute's data.
@@ -75,44 +79,49 @@ bytes of data plus the header.
 returns the amount of space which will be needed in a message with
 .I len
 bytes of data.
-.SH CONFORMING
-These macros are non-standard Linux extensions.
+.SH CONFORMING TO
+These macros are nonstandard Linux extensions.
 .SH BUGS
 This manual page is incomplete.
-.SH EXAMPLE
-.\" FIXME ? would be better to use libnetlink in the EXAMPLE code here
-
+.SH EXAMPLES
+.\" FIXME . ? would be better to use libnetlink in the EXAMPLE code here
 Creating a rtnetlink message to set the MTU of a device:
-.nf
+.PP
+.in +4n
+.EX
+#include <linux/rtnetlink.h>
+
+\&...
 
-    struct {
-        struct nlmsghdr  nh;
-        struct ifinfomsg if;
-        char             attrbuf[512];
-    } req;
+struct {
+    struct nlmsghdr  nh;
+    struct ifinfomsg if;
+    char             attrbuf[512];
+} req;
 
-    struct rtattr *rta;
-    unsigned int mtu = 1000;
+struct rtattr *rta;
+unsigned int mtu = 1000;
 
-    int rtnetlink_sk = socket(PF_NETLINK, SOCK_DGRAM, NETLINK_ROUTE);
+int rtnetlink_sk = socket(AF_NETLINK, SOCK_DGRAM, NETLINK_ROUTE);
 
-    memset(&req, 0, sizeof(req));
-    req.nh.nlmsg_len = NLMSG_LENGTH(sizeof(struct ifinfomsg));
-    req.nh.nlmsg_flags = NLM_F_REQUEST;
-    req.nh.nlmsg_type = RTML_NEWLINK;
-    req.if.ifi_family = AF_UNSPEC;
-    req.if.ifi_index = INTERFACE_INDEX;
-    req.if.ifi_change = 0xffffffff; /* ???*/
-    rta = (struct rtattr *)(((char *) &req) +
-                                  NLMSG_ALIGN(n\->nlmsg_len));
-    rta\->rta_type = IFLA_MTU;
-    rta\->rta_len = sizeof(unsigned int);
-    req.n.nlmsg_len = NLMSG_ALIGN(req.n.nlmsg_len) +
-                                  RTA_LENGTH(sizeof(mtu));
-    memcpy(RTA_DATA(rta), &mtu, sizeof(mtu));
-    send(rtnetlink_sk, &req, req.n.nlmsg_len);
-.fi
-.SH "SEE ALSO"
+memset(&req, 0, sizeof(req));
+req.nh.nlmsg_len = NLMSG_LENGTH(sizeof(struct ifinfomsg));
+req.nh.nlmsg_flags = NLM_F_REQUEST;
+req.nh.nlmsg_type = RTM_NEWLINK;
+req.if.ifi_family = AF_UNSPEC;
+req.if.ifi_index = INTERFACE_INDEX;
+req.if.ifi_change = 0xffffffff; /* ??? */
+rta = (struct rtattr *)(((char *) &req) +
+                         NLMSG_ALIGN(req.nh.nlmsg_len));
+rta\->rta_type = IFLA_MTU;
+rta\->rta_len = RTA_LENGTH(sizeof(unsigned int));
+req.nh.nlmsg_len = NLMSG_ALIGN(req.nh.nlmsg_len) +
+                              RTA_LENGTH(sizeof(mtu));
+memcpy(RTA_DATA(rta), &mtu, sizeof(mtu));
+send(rtnetlink_sk, &req, req.nh.nlmsg_len, 0);
+.EE
+.in
+.SH SEE ALSO
 .BR netlink (3),
 .BR netlink (7),
 .BR rtnetlink (7)