From owner-freebsd-doc Fri Feb 9 11:10:21 2001 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by hub.freebsd.org (Postfix) with ESMTP id 376AD37B69D for ; Fri, 9 Feb 2001 11:10:03 -0800 (PST) Received: (from gnats@localhost) by freefall.freebsd.org (8.11.1/8.11.1) id f19JA3A01641; Fri, 9 Feb 2001 11:10:03 -0800 (PST) (envelope-from gnats) Date: Fri, 9 Feb 2001 11:10:03 -0800 (PST) Message-Id: <200102091910.f19JA3A01641@freefall.freebsd.org> To: freebsd-doc@freebsd.org Cc: From: Nik Clayton Subject: Re: docs/24786: missing FILES descriptions in sa(4) Reply-To: Nik Clayton Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org The following reply was made to PR docs/24786; it has been noted by GNATS. From: Nik Clayton To: Rich Morin Cc: FreeBSD-gnats-submit@freebsd.org, julian@freebsd.org, mjacob@freebsd.org Subject: Re: docs/24786: missing FILES descriptions in sa(4) Date: Fri, 9 Feb 2001 00:36:51 +0000 I'm copying Julian and Matt on this, who know more about this subsystem than I do. On Thu, Feb 01, 2001 at 03:51:47PM -0800, Rich Morin wrote: > >Number: 24786 > >Category: docs > >Synopsis: missing FILES descriptions in sa(4) <...> > The sa(4) man page neglects to give definitions for > /dev/[en][r]sa0. Yes it does. The device name takes the form /dev/[n][e]sa[0-9] If it's just /dev/sa then the device will try and rewind the tape when the device is closed. If there's a leading 'n' then the device will not be rewound. If there's a leading 'e' then the device will be ejected on close. So if your application opens /dev/nesa0, and then closes the device, the tape will not be rewound, and the driver will tell the drive to eject the tape. This is all in the FILES section. 'r' means 'raw', but that isn't used on FreeBSD any more. It looks as if MAKEDEV wasn't updated to remove the code that creates the rsa* devices. > It also fails to describe the meaning > of the ".[0-3]" extensions (e.g., /dev/sa0.1). Covered in the SUB-MODES section in the man page (I think), although this is somewhat cryptic. We could probably add something like /dev/sa0.0 Corresponds to sub-mode 00 /dev/sa0.1 Corresponds to sub-mode 01 /dev/sa0.2 Corresponds to sub-mode 10 /dev/sa0.3 Corresponds to sub-mode 11 to the FILES section. Matt, Julian, any thoughts on 1. Adding the above to the FILES section. 2. Remove the code from MAKEDEV that creates /dev/rsa* If it's OK, I'll go and commit. N -- Internet connection, $19.95 a month. Computer, $799.95. Modem, $149.95. Telephone line, $24.95 a month. Software, free. USENET transmission, hundreds if not thousands of dollars. Thinking before posting, priceless. Somethings in life you can't buy. For everything else, there's MasterCard. -- Graham Reed, in the Scary Devil Monastery To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message