From owner-svn-src-all@FreeBSD.ORG Sat Jan 3 10:37:39 2009 Return-Path: Delivered-To: svn-src-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 45D3A106568C; Sat, 3 Jan 2009 10:37:39 +0000 (UTC) (envelope-from brueffer@FreeBSD.org) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:4f8:fff6::2c]) by mx1.freebsd.org (Postfix) with ESMTP id 2CD198FC60; Sat, 3 Jan 2009 10:37:39 +0000 (UTC) (envelope-from brueffer@FreeBSD.org) Received: from svn.freebsd.org (localhost [127.0.0.1]) by svn.freebsd.org (8.14.3/8.14.3) with ESMTP id n03AbdWn025537; Sat, 3 Jan 2009 10:37:39 GMT (envelope-from brueffer@svn.freebsd.org) Received: (from brueffer@localhost) by svn.freebsd.org (8.14.3/8.14.3/Submit) id n03AbdOG025536; Sat, 3 Jan 2009 10:37:39 GMT (envelope-from brueffer@svn.freebsd.org) Message-Id: <200901031037.n03AbdOG025536@svn.freebsd.org> From: Christian Brueffer Date: Sat, 3 Jan 2009 10:37:39 +0000 (UTC) To: src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-head@freebsd.org X-SVN-Group: head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Cc: Subject: svn commit: r186714 - head/share/man/man9 X-BeenThere: svn-src-all@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: "SVN commit messages for the entire src tree \(except for " user" and " projects" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 03 Jan 2009 10:37:41 -0000 Author: brueffer Date: Sat Jan 3 10:37:38 2009 New Revision: 186714 URL: http://svn.freebsd.org/changeset/base/186714 Log: Mdoc and language cleanup. Modified: head/share/man/man9/dev_clone.9 Modified: head/share/man/man9/dev_clone.9 ============================================================================== --- head/share/man/man9/dev_clone.9 Sat Jan 3 10:14:01 2009 (r186713) +++ head/share/man/man9/dev_clone.9 Sat Jan 3 10:37:38 2009 (r186714) @@ -24,7 +24,9 @@ .\" .\" $FreeBSD$ .\" -.Dd September 8, 2008 +.Dd January 3, 2009 +.Dt DEV_CLONE 9 +.Os .Sh NAME .Nm dev_clone , .Nm drain_dev_clone_events @@ -40,11 +42,11 @@ EVENTHANDLER_REGISTER(dev_clone, clone_h .Ft void .Fn drain_dev_clone_events .Sh DESCRIPTION -Device driver may register a listener that will be notified each time -name lookup on the -.Xr devfs +A device driver may register a listener that will be notified each time +a name lookup on the +.Xr devfs 5 mount point fails to find the vnode. -Listener shall be registered for the +A listener shall be registered for the .Va dev_clone event. When called, it is supplied with the first argument @@ -52,23 +54,25 @@ When called, it is supplied with the fir that was specified at handler registration time, appropriate credentials .Va cr , +and a name .Va name -of the length +of length .Va namelen -that was looked for. -If handler decides that the name is appropriate and want to create device -that will be associated with the name, it should return it to the devfs +that we look for. +If the handler decides that the name is appropriate and wants to create the device +that will be associated with the name, it should return it to devfs in the -.Va dev . +.Va dev +argument. .Pp The .Fn drain_dev_clone_events function is a barrier. -It is guaranteed that all calls to eventhandlers for dev_clone that were -started before +It is guaranteed that all calls to eventhandlers for +.Nm dev_clone +that were started before .Fn drain_dev_clone_events call, are finished before it returns control. -.Pp .Sh SEE ALSO .Xr devfs 5 , .Xr namei 9