some discussion of devices, logs, and permissions;

help/feedback from nick, krw, miod, todd, and deraadt
millert ok'd an earlier version of this diff

2 files changed, 58 insertions, 4 deletions

diff --git a/usr.bin/tip/cu.1 b/usr.bin/tip/cu.1
index 5065035839b..1ec112c5879 100644
--- a/usr.bin/tip/cu.1
+++ b/usr.bin/tip/cu.1
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: cu.1,v 1.4 2007/05/31 19:20:18 jmc Exp $
+.\"	$OpenBSD: cu.1,v 1.5 2007/07/06 07:13:41 jmc Exp $
 .\"
 .\" Copyright (c) 1980, 1990, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -29,7 +29,7 @@
 .\"
 .\"	@(#)tip.1	8.4 (Berkeley) 4/18/94
 .\"
-.Dd $Mdocdate: May 31 2007 $
+.Dd $Mdocdate: July 6 2007 $
 .Dt CU 1
 .Os
 .Sh NAME
@@ -70,6 +70,26 @@ Either of the forms like
 or
 .Pa /dev/tty00
 are permitted.
+.Pp
+For reasons outlined in
+.Xr tty 4 ,
+.Xr cua 4
+devices should be used on architectures which have them.
+For those which do not,
+.Xr tty 4
+devices can be used.
+Users in group
+.Dq dialer
+are permitted to use
+.Xr cua 4
+devices by default;
+permissions on
+.Pa /dev/tty00
+or
+.Pa /dev/ttya
+can be changed,
+but they will revert to their defaults
+after an upgrade or (re)install.
 .It Fl o
 Use odd parity.
 If both
@@ -85,6 +105,11 @@ The default is 9600.
 Connect via a hard-wired connection to a host on a dial-up line.
 .El
 .Pp
+Line access is logged to
+.Pa /var/log/aculog .
+This file does not exist by default and has to be created
+to enable logging.
+.Pp
 Typed characters are normally transmitted directly to the remote
 machine (which does the echoing as well).
 A tilde
diff --git a/usr.bin/tip/tip.1 b/usr.bin/tip/tip.1
index da80d045043..bb055e610f6 100644
--- a/usr.bin/tip/tip.1
+++ b/usr.bin/tip/tip.1
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: tip.1,v 1.38 2007/05/31 19:20:18 jmc Exp $
+.\"	$OpenBSD: tip.1,v 1.39 2007/07/06 07:13:41 jmc Exp $
 .\"	$NetBSD: tip.1,v 1.7 1994/12/08 09:31:05 jtc Exp $
 .\"
 .\" Copyright (c) 1980, 1990, 1993
@@ -30,7 +30,7 @@
 .\"
 .\"	@(#)tip.1	8.4 (Berkeley) 4/18/94
 .\"
-.Dd $Mdocdate: May 31 2007 $
+.Dd $Mdocdate: July 6 2007 $
 .Dt TIP 1
 .Os
 .Sh NAME
@@ -86,6 +86,11 @@ will set
 .Ar system-name
 to 'tip1200'.
 .Pp
+Line access is logged to
+.Pa /var/log/aculog .
+This file does not exist by default and has to be created
+to enable logging.
+.Pp
 Typed characters are normally transmitted directly to the remote
 machine (which does the echoing as well).
 A tilde
@@ -249,6 +254,30 @@ If the value specified is not suitable, the baud rate to be used may
 be given on the command line, e.g.\&
 .Ql tip -300 mds .
 .Pp
+The
+.Ar dv
+capability is used to specify the device
+with which to establish a connection.
+For reasons outlined in
+.Xr tty 4 ,
+.Xr cua 4
+devices should be used on architectures which have them.
+For those which do not,
+.Xr tty 4
+devices can be used.
+Users in group
+.Dq dialer
+are permitted to use
+.Xr cua 4
+devices by default;
+permissions on
+.Pa /dev/tty00
+or
+.Pa /dev/ttya
+can be changed,
+but they will revert to their defaults
+after an upgrade or (re)install.
+.Pp
 When
 .Nm
 establishes a connection, it sends out the connection message