diff options
| author | Michael Kerrisk <mtk.manpages@gmail.com> | 2007-12-19 05:53:30 +0000 |
|---|---|---|
| committer | Michael Kerrisk <mtk.manpages@gmail.com> | 2007-12-19 05:53:30 +0000 |
| commit | a08ea57c202088519f95dfa510434668adc3803f (patch) | |
| tree | 2444cf9a408bbf6449fff630e86ede0b21af0ded /man7 | |
| parent | 8a35999094a6c7f5125fb9d0f87704d0e029dc7a (diff) | |
| download | man-pages-a08ea57c202088519f95dfa510434668adc3803f.tar.gz | |
Make the standard indent for code samples, shell session
logs, etc. to be ".in +4n".
Diffstat (limited to 'man7')
| -rw-r--r-- | man7/arp.7 | 14 | ||||
| -rw-r--r-- | man7/ddp.7 | 2 | ||||
| -rw-r--r-- | man7/inotify.7 | 4 | ||||
| -rw-r--r-- | man7/ip.7 | 16 | ||||
| -rw-r--r-- | man7/ipv6.7 | 2 | ||||
| -rw-r--r-- | man7/mq_overview.7 | 12 | ||||
| -rw-r--r-- | man7/netdevice.7 | 2 | ||||
| -rw-r--r-- | man7/netlink.7 | 24 | ||||
| -rw-r--r-- | man7/packet.7 | 18 | ||||
| -rw-r--r-- | man7/socket.7 | 8 | ||||
| -rw-r--r-- | man7/spufs.7 | 6 | ||||
| -rw-r--r-- | man7/unix.7 | 8 | ||||
| -rw-r--r-- | man7/x25.7 | 2 |
13 files changed, 62 insertions, 56 deletions
diff --git a/man7/arp.7 b/man7/arp.7 index 5a04eab3d3..e6a8fda46f 100644 --- a/man7/arp.7 +++ b/man7/arp.7 @@ -74,15 +74,17 @@ They take a pointer to a .I struct arpreq as their parameter. +.RS 4 .nf struct arpreq { - struct sockaddr arp_pa; /* protocol address */ - struct sockaddr arp_ha; /* hardware address */ - int arp_flags; /* flags */ - struct sockaddr arp_netmask; /* netmask of protocol address */ + struct sockaddr arp_pa; /* protocol address */ + struct sockaddr arp_ha; /* hardware address */ + int arp_flags; /* flags */ + struct sockaddr arp_netmask; /* netmask of protocol address */ char arp_dev[16]; }; .fi +.RE .BR SIOCSARP ", " SIOCDARP " and " SIOCGARP respectively set, delete and get an ARP mapping. @@ -245,7 +247,9 @@ It is replaced by automatic proxy arp setup by the kernel for all reachable hosts on other interfaces (when forwarding and proxy arp is enabled for the interface). -The neigh/* sysctls did not exist before Linux 2.2. +The +.I neigh/* +sysctls did not exist before Linux 2.2. .SH BUGS Some timer settings are specified in jiffies, which is architecture and kernel version dependent; see diff --git a/man7/ddp.7 b/man7/ddp.7 index 4c2d35b88d..6f46ef6dc5 100644 --- a/man7/ddp.7 +++ b/man7/ddp.7 @@ -61,7 +61,7 @@ capability. An Appletalk socket address is defined as a combination of a network number, a node number, and a port number. .PP -.RS +.RS 4 .nf struct at_addr { u_short s_net; diff --git a/man7/inotify.7 b/man7/inotify.7 index 909779c6d0..3b1a14e861 100644 --- a/man7/inotify.7 +++ b/man7/inotify.7 @@ -77,7 +77,7 @@ will block until at least one event occurs. Each successful .BR read (2) returns a buffer containing one or more of the following structures: -.RS 4 +.in +4n .nf struct inotify_event { @@ -89,7 +89,7 @@ struct inotify_event { char name[]; /* Optional null-terminated name */ }; .fi -.RE +.in .I wd identifies the watch for which this event occurs. @@ -111,7 +111,7 @@ On raw sockets .I sin_port is set to the IP protocol. .PP -.in +0.25i +.in +4n .nf struct sockaddr_in { sa_family_t sin_family; /* address family: AF_INET */ @@ -124,7 +124,7 @@ struct in_addr { u_int32_t s_addr; /* address in network byte order */ }; .fi -.in -0.25i +.in .PP .I sin_family is always set to @@ -253,7 +253,7 @@ as control message with a packet using or .BR sendmsg (2). .IP -.in +0.25i +.in +4n .nf struct in_pktinfo { unsigned int ipi_ifindex; /* Interface index */ @@ -262,7 +262,7 @@ struct in_pktinfo { address */ }; .fi -.in -0.25i +.in .IP .\" FIXME elaborate on that. .I ipi_ifindex @@ -399,7 +399,7 @@ control message contains a .I sock_extended_err structure: .IP -.in +0.25i +.in +4n .ne 18 .nf #define SO_EE_ORIGIN_NONE 0 @@ -420,7 +420,7 @@ struct sock_extended_err { struct sockaddr *SO_EE_OFFENDER(struct sock_extended_err *); .fi -.in -0.25i +.in .IP .I ee_errno contains the @@ -633,7 +633,7 @@ Argument is an .I ip_mreqn structure. .sp -.in +0.25i +.in +4n .nf struct ip_mreqn { struct in_addr imr_multiaddr; /* IP multicast group @@ -643,7 +643,7 @@ struct ip_mreqn { int imr_ifindex; /* interface index */ }; .fi -.in -0.25i +.in .sp .I imr_multiaddr contains the address of the multicast group the application diff --git a/man7/ipv6.7 b/man7/ipv6.7 index 63c6faf927..ef23a8e8ef 100644 --- a/man7/ipv6.7 +++ b/man7/ipv6.7 @@ -62,7 +62,7 @@ or packet to a IPv6 socket its source address will be mapped to v6 and it will be mapped to v6. .SS "Address Format" .sp -.RS +.RS 4 .nf struct sockaddr_in6 { u_int16_t sin6_family; /* AF_INET6 */ diff --git a/man7/mq_overview.7 b/man7/mq_overview.7 index 99260a32fa..d78b098179 100644 --- a/man7/mq_overview.7 +++ b/man7/mq_overview.7 @@ -93,7 +93,7 @@ In most cases the library interfaces listed above are implemented on top of underlying system calls of the same name. Deviations from this scheme are indicated in the following table: -.in +0.25i +.in +4n .TS lB lB l l. @@ -108,7 +108,7 @@ mq_timedreceive(3) mq_timedreceive(2) mq_timedsend(3) mq_timedsend(2) mq_unlink(3) mq_unlink(2) .TE -.in -0.25i +.in .SS Versions POSIX message queues have been supported on Linux since kernel 2.6.6. Glibc support has been provided since version 2.3.4. @@ -186,14 +186,14 @@ On Linux, message queues are created in a virtual file system. (Other implementations may also provide such a feature, but the details are likely to differ.) This file system can be mounted using the following commands: -.in +0.25i +.in +4n .nf $ mkdir /dev/mqueue $ mount -t mqueue none /dev/mqueue .fi -.in -0.25i +.in The sticky bit is automatically enabled on the mount directory. After the file system has been mounted, the message queues on the system @@ -205,7 +205,7 @@ and The contents of each file in the directory consist of a single line containing information about the queue: -.in +0.25i +.in +4n .nf $ ls /dev/mqueue/mymq @@ -213,7 +213,7 @@ QSIZE:129 NOTIFY:2 SIGNO:0 NOTIFY_PID:8260 $ mount -t mqueue none /dev/mqueue .fi -.in -0.25i +.in These fields are as follows: .TP .B diff --git a/man7/netdevice.7 b/man7/netdevice.7 index 57ce8ed8eb..da63b55683 100644 --- a/man7/netdevice.7 +++ b/man7/netdevice.7 @@ -27,6 +27,7 @@ They pass an .I ifreq structure: +.RS 4 .nf struct ifreq { char ifr_name[IFNAMSIZ]; /* Interface name */ @@ -55,6 +56,7 @@ struct ifconf { }; }; .fi +.RE Normally, the user specifies which device to affect by setting .I ifr_name diff --git a/man7/netlink.7 b/man7/netlink.7 index bac30accca..eae64acb66 100644 --- a/man7/netlink.7 +++ b/man7/netlink.7 @@ -134,7 +134,7 @@ After each .I nlmsghdr the payload follows. -.in +0.25i +.in +4n .nf struct nlmsghdr { __u32 nlmsg_len; /* Length of message including header. */ @@ -144,7 +144,7 @@ struct nlmsghdr { __u32 nlmsg_pid; /* PID of the sending process. */ }; .fi -.in -0.25i +.in .I nlmsg_type can be one of the standard message types: @@ -157,14 +157,14 @@ structure, .B NLMSG_DONE message terminates a multipart message. -.in +0.25i +.in +4n .nf struct nlmsgerr { int error; /* Negative errno or 0 for acknowledgements */ struct nlmsghdr msg; /* Message header that caused the error */ }; .fi -.in -0.25i +.in A netlink family usually specifies more message types, see the appropriate manual pages for that, for example, @@ -282,7 +282,7 @@ netlink multicast groups .RI ( nl_groups not equal 0). -.in +0.25i +.in +4n .nf struct sockaddr_nl { sa_family_t nl_family; /* AF_NETLINK */ @@ -291,7 +291,7 @@ struct sockaddr_nl { __u32 nl_groups; /* Multicast groups mask. */ }; .fi -.in -0.25i +.in .I nl_pid is the unicast address of netlink socket. @@ -381,7 +381,7 @@ netlink socket which will listen to the .B RTMGRP_IPV4_IFADDR (IPv4 addresses add/delete events) multicast groups. -.in +0.25i +.in +4n .nf struct sockaddr_nl sa; @@ -392,14 +392,14 @@ snl.nl_groups = RTMGRP_LINK | RTMGRP_IPV4_IFADDR; fd = socket(AF_NETLINK, SOCK_RAW, NETLINK_ROUTE); bind(fd, (struct sockaddr*)&sa, sizeof(sa)); .fi -.in -0.25i +.in The next example demonstrates how to send a netlink message to the kernel (pid 0). Note that application must take care of message sequence numbers in order to reliably track acknowledgements. -.in +0.25i +.in +4n .nf struct nlmsghdr *nh; /* The nlmsghdr with payload to send. */ struct sockaddr_nl sa; @@ -416,11 +416,11 @@ nh\->nlmsg_flags |= NLM_F_ACK; sendmsg(fd, &msg, 0); .fi -.in -0.25i +.in And the last example is about reading netlink message. -.in +0.25i +.in +4n .nf int len; char buf[4096]; @@ -446,7 +446,7 @@ for (nh = (struct nlmsghdr *) buf; NLMSG_OK (nh, len); ... } .fi -.in -0.25i +.in .SH "SEE ALSO" .BR cmsg (3), .BR netlink (3), diff --git a/man7/packet.7 b/man7/packet.7 index aa47329980..917a885f0c 100644 --- a/man7/packet.7 +++ b/man7/packet.7 @@ -105,7 +105,7 @@ even when it is longer than the buffer. .SS Address Types The sockaddr_ll is a device independent physical layer address. -.in +0.25i +.in +4n .nf struct sockaddr_ll { unsigned short sll_family; /* Always AF_PACKET */ @@ -117,7 +117,7 @@ struct sockaddr_ll { unsigned char sll_addr[8]; /* Physical layer address */ }; .fi -.in -0.25i +.in .I sll_protocol is the standard ethernet protocol type in network order as defined @@ -187,7 +187,7 @@ They both expect a .B packet_mreq structure as argument: -.in +0.25i +.in +4n .nf struct packet_mreq { int mr_ifindex; /* interface index */ @@ -196,7 +196,7 @@ struct packet_mreq { unsigned char mr_address[8]; /* physical layer address */ }; .fi -.in -0.25i +.in .B mr_ifindex contains the interface index for the interface whose status @@ -284,7 +284,7 @@ The include file is present since glibc 2.1. Older systems need: .sp -.in +0.5i +.in +4n .nf #include <asm/types.h> #include <linux/if_packet.h> @@ -333,7 +333,7 @@ uses the old to specify an interface, which doesn't provide physical layer independence. -.in +0.25i +.in +4n .nf struct sockaddr_pkt { unsigned short spkt_family; @@ -341,7 +341,7 @@ struct sockaddr_pkt { unsigned short spkt_protocol; }; .fi -.in -0.25i +.in .I spkt_family contains @@ -358,7 +358,7 @@ This structure is obsolete and should not be used in new code. glibc 2.1 does not have a define for .BR SOL_PACKET . The suggested workaround is to use: -.in +0.5i +.in +4n .nf #ifndef SOL_PACKET @@ -366,7 +366,7 @@ The suggested workaround is to use: #endif .fi -.in -0.5i +.in This is fixed in later glibc versions and also does not occur on libc5 systems. diff --git a/man7/socket.7 b/man7/socket.7 index 0bd94e16d6..85dd96e816 100644 --- a/man7/socket.7 +++ b/man7/socket.7 @@ -285,14 +285,14 @@ The argument is a .I linger structure. .sp -.in +0.25i +.in +4n .nf struct linger { int l_onoff; /* linger active */ int l_linger; /* how many seconds to linger for */ }; .fi -.in -0.25i +.in .IP When enabled, a .BR close (2) @@ -587,11 +587,11 @@ per socket. These operations can be accessed using .BR ioctl (2): -.in +0.25i +.in +4n .nf .IB error " = ioctl(" ip_socket ", " ioctl_type ", " &value_result ");" .fi -.in -0.25i +.in .TP .B SIOCGSTAMP Return a diff --git a/man7/spufs.7 b/man7/spufs.7 index a39811d938..8cfce049d2 100644 --- a/man7/spufs.7 +++ b/man7/spufs.7 @@ -555,7 +555,7 @@ The file contains the contents of the SPU MFC DMA queue, represented as the following structure: -.in +0.25i +.in +0.5i .nf struct spu_dma_info { uint64_t dma_info_type; @@ -574,7 +574,7 @@ The .I mfc_cq_sr structure is defined as: -.in +0.25i +.in +0.5i .nf struct mfc_cq_sr { uint64_t mfc_cq_data0_RW; @@ -640,7 +640,7 @@ The following operations are supported: Writes to this file need to be in the format of a MFC DMA command, defined as follows: -.in +0.25i +.in +0.5i .nf struct mfc_dma_command { int32_t pad; /* reserved */ diff --git a/man7/unix.7 b/man7/unix.7 index 5099e38242..f6988ae184 100644 --- a/man7/unix.7 +++ b/man7/unix.7 @@ -62,7 +62,7 @@ The local address can be set using When a socket is connected and it doesn't already have a local address a unique address in the abstract namespace will be generated automatically. -.in +0.25i +.in +4n .nf #define UNIX_PATH_MAX 108 @@ -71,7 +71,7 @@ struct sockaddr_un { char sun_path[UNIX_PATH_MAX]; /* pathname */ }; .fi -.in -0.25i +.in .I sun_family always contains @@ -171,7 +171,7 @@ The credentials are passed as a .I struct ucred ancillary message. -.in +0.25i +.in +4n .nf struct ucred { pid_t pid; /* process ID of the sending process */ @@ -179,7 +179,7 @@ struct ucred { gid_t gid; /* group ID of the sending process */ }; .fi -.in -0.25i +.in The credentials which the sender specifies are checked by the kernel. A process with effective user ID 0 is allowed to specify values that do diff --git a/man7/x25.7 b/man7/x25.7 index 8176521ea6..936cce005d 100644 --- a/man7/x25.7 +++ b/man7/x25.7 @@ -47,7 +47,7 @@ socket address family uses the for representing network addresses as defined in ITU-T recommendation X.121. .PP -.RS +.RS 4 .nf struct sockaddr_x25 { sa_family_t sx25_family; /* must be AF_X25 */ |
