From owner-freebsd-doc@FreeBSD.ORG Sat Apr 30 08:10:09 2005 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 9DA0616A4CE for ; Sat, 30 Apr 2005 08:10:09 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 5EB9143D3F for ; Sat, 30 Apr 2005 08:10:09 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.13.3/8.13.3) with ESMTP id j3U8A9L3086698 for ; Sat, 30 Apr 2005 08:10:09 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.13.3/8.13.1/Submit) id j3U8A9W8086697; Sat, 30 Apr 2005 08:10:09 GMT (envelope-from gnats) Date: Sat, 30 Apr 2005 08:10:09 GMT Message-Id: <200504300810.j3U8A9W8086697@freefall.freebsd.org> To: freebsd-doc@FreeBSD.org From: Roland Smith Subject: [PATCH] Re: docs/63808: No manpage for devfs.conf X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: Roland Smith List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 30 Apr 2005 08:10:09 -0000 The following reply was made to PR docs/63808; it has been noted by GNATS. From: Roland Smith To: bug-followup@freebsd.org Cc: Subject: [PATCH] Re: docs/63808: No manpage for devfs.conf Date: Sat, 30 Apr 2005 10:02:57 +0200 --dc+cDN39EJAMEtIO Content-Type: multipart/mixed; boundary="n8g4imXOkfNTN/H1" Content-Disposition: inline --n8g4imXOkfNTN/H1 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable Attached is a manpage for devfs.conf. Could this be included in 5.4? Roland --=20 R.F. Smith /"\ ASCII Ribbon Campaign r s m i t h @ x s 4 a l l . n l \ / No HTML/RTF in e-mail http://www.xs4all.nl/~rsmith/ X No Word docs in e-mail public key: http://www.keyserver.net / \ Respect for open standards --n8g4imXOkfNTN/H1 Content-Type: text/plain; charset=us-ascii Content-Disposition: attachment; filename="devfs.conf.5" Content-Transfer-Encoding: quoted-printable =2E\" Copyright (c) 2004 Roland Smith =2E\" All rights reserved. =2E\" =2E\" Redistribution and use in source and binary forms, with or without =2E\" modification, are permitted provided that the following conditions =2E\" are met: =2E\" 1. Redistributions of source code must retain the above copyright =2E\" notice, this list of conditions and the following disclaimer. =2E\" 2. Redistributions in binary form must reproduce the above copyright =2E\" notice, this list of conditions and the following disclaimer in the =2E\" documentation and/or other materials provided with the distributio= n. =2E\" =2E\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND =2E\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE =2E\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PU= RPOSE =2E\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE =2E\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUE= NTIAL =2E\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOO= DS =2E\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) =2E\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, S= TRICT =2E\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY= WAY =2E\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF =2E\" SUCH DAMAGE. =2E\" =2E\" $FreeBSD$ =2E\" =2EDd December 23, 2004 =2EDt DEVFS.CONF 5 =2EOs =2ESh NAME =2ENm devfs.conf =2ENd boot-time devfs configuration information =2ESh DESCRIPTION The =2ENm file provides an easy way to set ownership and premissions and create links for devices available at boot. =2EPp It does not work for devices plugged in and out during operations, e.g. usb devices. See =2EXr devfs.rules 5 for setting ownership and permissions for all device nodes, and =2EXr usbd.conf 5=20 for actions to be taken when USB devices are attached or detached. =2EPp Lines starting with a hash sign '#' and empty lines are ignored. Lines consist of three parameters separated by whitespace. The first parameter is always the action to take, the second is always the existing device created by devfs, and the last is the argument to the action. Possible actions are =2EPa link , =2EPa own and =2EPa perm. The name of the action is only significant to the first unique character. =2EPp The =2EPa link action creates a symbolic link from a device created by devfs to the name you specified as the third parameter. =2EPp The=20 =2EPa own action changes the ownership of a device. The third parameter must be in the form of an : pair as in =2EXr chown 8 . =2EPp The=20 =2EPa perm action changes the permissions of a device. The third paramater must be a =2EPa mode as explained in =2EXr chmod 1 . =2ESh EXAMPLES =2EBl -tag -width "own cd0 root:cdrom" =2EIt Li "link cd0 cdrom" create a link named =2EPa cdrom to the =2EPa cd0 device. =2EIt Li "own cd0 root:cdrom" set the group for the =2EPa cd0 device to =2EPa cdrom . =2EIt Li "perm cd0 0660" make the =2EPa cd0 device owner and group read- and writable. =2EEl =2ESh FILES =2EBl -tag -compact =2EIt Pa /etc/devfs.conf =2EIt Pa /usr/share/examples/etc/devfs.conf =2EEl =2ESh SEE ALSO =2EXr chmod 1 , =2EXr chown 8 , =2EXr devfs 8 , =2EXr devfs 5 , =2EXr devfs.rules 5 , =2EXr usbd.conf 5 =2ESh AUTHORS =2EAn "Roland Smith" Aq rsmith@xs4all.nl . --n8g4imXOkfNTN/H1-- --dc+cDN39EJAMEtIO Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.1 (FreeBSD) iD8DBQFCczuxEnfvsMMhpyURAgM6AKCc6MKM4WD3RTfwwnxrkDIh5Tz5DwCeLImH 2/New4tEiQBfDr58NZTpvnk= =GpPZ -----END PGP SIGNATURE----- --dc+cDN39EJAMEtIO--