aboutsummaryrefslogtreecommitdiffstats
path: root/man7
diff options
context:
space:
mode:
authorMichael Kerrisk <mtk.manpages@gmail.com>2007-12-19 05:53:30 +0000
committerMichael Kerrisk <mtk.manpages@gmail.com>2007-12-19 05:53:30 +0000
commita08ea57c202088519f95dfa510434668adc3803f (patch)
tree2444cf9a408bbf6449fff630e86ede0b21af0ded /man7
parent8a35999094a6c7f5125fb9d0f87704d0e029dc7a (diff)
downloadman-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.714
-rw-r--r--man7/ddp.72
-rw-r--r--man7/inotify.74
-rw-r--r--man7/ip.716
-rw-r--r--man7/ipv6.72
-rw-r--r--man7/mq_overview.712
-rw-r--r--man7/netdevice.72
-rw-r--r--man7/netlink.724
-rw-r--r--man7/packet.718
-rw-r--r--man7/socket.78
-rw-r--r--man7/spufs.76
-rw-r--r--man7/unix.78
-rw-r--r--man7/x25.72
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.
diff --git a/man7/ip.7 b/man7/ip.7
index 84e494098d..4d1c4c6632 100644
--- a/man7/ip.7
+++ b/man7/ip.7
@@ -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 */