diff options
Diffstat (limited to 'usr.sbin/rwhod/rwhod.8')
-rw-r--r-- | usr.sbin/rwhod/rwhod.8 | 36 |
1 files changed, 24 insertions, 12 deletions
diff --git a/usr.sbin/rwhod/rwhod.8 b/usr.sbin/rwhod/rwhod.8 index e072697..0d861cc 100644 --- a/usr.sbin/rwhod/rwhod.8 +++ b/usr.sbin/rwhod/rwhod.8 @@ -51,7 +51,8 @@ utility is the server which maintains the database used by the .Xr rwho 1 and .Xr ruptime 1 -programs. Its operation is predicated on the ability to +programs. +Its operation is predicated on the ability to .Em broadcast or .Em multicast @@ -82,7 +83,8 @@ to ignore the source port on incoming packets. .It Fl p Ignore all .Dv POINTOPOINT -interfaces. This is useful if you do not wish to keep dial on demand +interfaces. +This is useful if you do not wish to keep dial on demand interfaces permanently active. .It Fl l Enable listen mode, which causes @@ -97,7 +99,8 @@ Cause to use IP multicast (instead of broadcast) on all interfaces that have the IFF_MULTICAST flag set in their "ifnet" structs -(excluding the loopback interface). The multicast +(excluding the loopback interface). +The multicast reports are sent with a time-to-live of 1, to prevent forwarding beyond the directly-connected subnet(s). .Pp @@ -114,7 +117,8 @@ via a SINGLE interface rather than all interfaces. .Ar ttl must be between 0 and -32 (or MAX_MULTICAST_SCOPE). Note that +32 (or MAX_MULTICAST_SCOPE). +Note that .Fl m Ar 1 is different from .Fl m , @@ -128,14 +132,17 @@ is used without a .Ar ttl argument, the program accepts multicast .Nm -reports from all multicast-capable interfaces. If a +reports from all multicast-capable interfaces. +If a .Ar ttl argument is given, it accepts multicast reports from only one interface, the one on which reports are sent (which may be controlled via the host's routing -table). Regardless of the +table). +Regardless of the .Fl m option, the program accepts broadcast or -unicast reports from all interfaces. Thus, this program will hear the +unicast reports from all interfaces. +Thus, this program will hear the reports of old, non-multicasting .Nm Ns s , but, if multicasting is used, @@ -172,16 +179,19 @@ struct whod { .Ed .Pp All fields are converted to network byte order prior to -transmission. The load averages are as calculated by the +transmission. +The load averages are as calculated by the .Xr w 1 program, and represent load averages over the 5, 10, and 15 minute intervals prior to a server's transmission; they are multiplied by 100 -for representation in an integer. The host name +for representation in an integer. +The host name included is that returned by the .Xr gethostname 3 system call, with any trailing domain name omitted. The array at the end of the message contains information about -the users logged in to the sending machine. This information +the users logged in to the sending machine. +This information includes the contents of the .Xr utmp 5 entry for each non-idle terminal line and a value indicating the @@ -193,11 +203,13 @@ server are discarded unless they originated at an .Nm rwho server's port or the .Fl i -option was specified. In addition, if the host's name, as specified +option was specified. +In addition, if the host's name, as specified in the message, contains any unprintable .Tn ASCII characters, the -message is discarded. Valid messages received by +message is discarded. +Valid messages received by .Nm are placed in files named .Pa whod.hostname |