Assorted mdoc(7) fixes.

This commit is contained in:
Ruslan Ermilov 2003-06-02 15:02:06 +00:00
parent b2bb9f9bfd
commit 09f84dd1d3
Notes: svn2git 2020-12-20 02:59:44 +00:00
svn path=/head/; revision=115697
7 changed files with 63 additions and 57 deletions

View File

@ -1,5 +1,3 @@
.\" $FreeBSD$
.\"
.\" Copyright (c) 1995 Paul Kranenburg
.\" All rights reserved.
.\"
@ -28,7 +26,9 @@
.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
.\"
.Dd January 28, 2000
.\" $FreeBSD$
.\"
.Dd May 31, 2003
.Dt RTLD 1
.Os
.Sh NAME
@ -82,9 +82,9 @@ utility
recognizes a number of environment variables that can be used to modify
its behaviour as follows:
.Pp
.Bl -tag -width ".Ev LD_LIBRARY_PATH"
.Bl -tag -width ".Ev LD_LIBMAP_DISABLE"
.It Ev LD_LIBMAP_DISABLE
If set disables the use of
If set, disables the use of
.Xr libmap.conf 5 .
.It Ev LD_LIBRARY_PATH
A colon separated list of directories, overriding the default search path

View File

@ -32,9 +32,9 @@
.Nm acpi
.Nd Advanced Configuration and Power Management support
.Sh SYNOPSIS
.Cd device acpi
.Cd "device acpi"
.Pp
.Cd options ACPI_DEBUG
.Cd "options ACPI_DEBUG"
.Sh DESCRIPTION
The
.Nm
@ -203,8 +203,7 @@ To disable the
.Nm
driver completely, set the kernel environment variable
.Va hint.acpi.0.disabled
to
.Dq 1 .
to 1.
Some i386 machines totally fail to operate with some or all of ACPI disabled.
Other i386 machines fail with ACPI enabled.
Non-i386 platforms do not support operating systems which do not use ACPI.
@ -295,27 +294,27 @@ utilities from the
.Pa devel/acpicatools
port, and some ACPI knowledge.
.Sh TUNABLES
.Bl -tag -width children
.It Li acpi_dsdt_load
Enables loading of a custom acpi DSDT.
.It Li acpi_dsdt_name
.Bl -tag -width indent
.It Va acpi_dsdt_load
Enables loading of a custom ACPI DSDT.
.It Va acpi_dsdt_name
Name of the DSDT table to load, if loading is enabled.
.It Li debug.acpi.disable
.It Va debug.acpi.disable
Selectively disables portions of ACPI for debugging purposes.
.It Li hint.acpi.0.disabled
Disables all of ACPI
.It Li hw.acpi.cpu.performance_speed
.It Va hint.acpi.0.disabled
Disables all of ACPI.
.It Va hw.acpi.cpu.performance_speed
Sets the speed of the CPU, if it supports multiple speeds, while in
the performance power profile.
.It Li hw.acpi.cpu.economy_speed
.It Va hw.acpi.cpu.economy_speed
Sets the speed of the CPU, if it supports multiple speeds, while in
the economy power profile.
.It Li hw.acpi.ec.event_driven
.It Va hw.acpi.ec.event_driven
Enables or disables the event driven model for the embedded controller
driver.
.It Li hw.acpi.pci.link.%d.%d.%d.irq
.It Va hw.acpi.pci.link.%d.%d.%d.irq
Override the interrupt to use.
.It Li hw.acpi.verbose
.It Va hw.acpi.verbose
Turn on verbose debugging information about what ACPI is doing.
.El
.Sh COMPATIBILITY

View File

@ -934,8 +934,9 @@ the X server to start before disk I/O bandwidth is monopolized by
.Xr fsck 8 .
.It Va netfs_types
.Pq Vt str
List of file system types that are network-based. This list should
generally not be modified by end users. Use
List of file system types that are network-based.
This list should generally not be modified by end users.
Use
.Va extra_netfs_types
instead.
.It Va extra_netfs_types

View File

@ -57,7 +57,7 @@ as the event handler.
Possible values for the
.Fa flags
argument are documented below:
.Bl -hang -width VFCF_SYNTHETIC
.Bl -hang -width ".Dv VFCF_SYNTHETIC"
.It Dv VFCF_STATIC
File system should be statically available in the kernel.
.It Dv VFCF_NETWORK

View File

@ -44,7 +44,7 @@
This converts an inode number into a locked vnode.
.Pp
Its arguments are:
.Bl -tag -width flags
.Bl -tag -width ".Fa flags"
.It Fa mp
The file system.
.It Fa ino

View File

@ -1,6 +1,6 @@
.\"
.\" Copyright (c) 1998, 1999 Eivind Eklund
.\" Copyright (c) 2003, Hiten M. Pandya
.\" Copyright (c) 2003 Hiten M. Pandya
.\"
.\" All rights reserved.
.\"
@ -47,7 +47,10 @@
.Ft int
.Fn namei "struct nameidata *ndp"
.Ft void
.Fn NDINIT "struct nameidata *ndp" "u_long op" "u_long flags" "enum uio_seg segflg" "const char *namep" "struct thread *td"
.Fo NDINIT
.Fa "struct nameidata *ndp" "u_long op" "u_long flags"
.Fa "enum uio_seg segflg" "const char *namep" "struct thread *td"
.Fc
.Ft void
.Fn NDFREE "struct nameidata *ndp" "const uint flags"
.Sh DESCRIPTION
@ -63,9 +66,9 @@ using either
.Xr vrele 9
or
.Xr vput 9 ,
depending on whether you specified the
depending on whether the
.Dv LOCKLEAF
flag or not.
flag was specified or not.
.Pp
The
.Fn NDINIT
@ -73,8 +76,7 @@ function is used to initialize
.Nm
components.
It takes the following arguments:
.Pp
.Bl -tag -width segflg
.Bl -tag -width ".Fa segflg"
.It Fa ndp
The
.Vt "struct nameidata"
@ -84,9 +86,7 @@ The operation which
.Fn namei
will perform.
The following operations are valid:
.Dv LOOKUP ,
.Dv CREATE ,
.Dv DELETE ,
.Dv LOOKUP , CREATE , DELETE ,
and
.Dv RENAME .
The latter three are just setup for those
@ -106,7 +106,7 @@ or in the kernel address space
.Pq Dv UIO_SYSSPACE .
.It Fa namep
Pointer to the component's pathname buffer
.Pq the file or directory name that will be looked up .
(the file or directory name that will be looked up).
.It Fa td
The thread context to use for
.Nm
@ -116,16 +116,19 @@ operations and locks.
The
.Fn namei
function takes the following set of
.Dq operation flags
.Dq "operation flags"
that influence its operation:
.Bl -tag -width WANTPARENT
.Bl -tag -width ".Dv WANTPARENT"
.It Dv LOCKLEAF
Lock vnode on return.
This is a full lock of the vnode; you'll have to use
This is a full lock of the vnode; the
.Xr VOP_UNLOCK 9
to release the lock (or use
should be used
to release the lock (or
.Xr vput 9
to release the lock and do a
which is equivalent to calling
.Xr VOP_UNLOCK 9
followed by
.Xr vrele 9 ,
all in one).
.It Dv LOCKPARENT
@ -138,7 +141,7 @@ in locked state, unless it is identical to
in which case
.Va ni_dvp
is not locked per se (but may be locked due to
.Dv LOCKLEAF ).
.Dv LOCKLEAF ) .
If a lock is enforced, it should be released using
.Xr vput 9
or
@ -155,10 +158,11 @@ The parent vnode must be released separately by using
Avoid
.Fn namei
creating this entry in the namecache if it is not
already present. Normally
already present.
Normally,
.Fn namei
will add entries to the name cache
if they're not already there.
if they are not already there.
.It Dv FOLLOW
With this flag,
.Fn namei
@ -179,7 +183,7 @@ are intentionally not followed.
.It Dv SAVENAME
Do not free the pathname buffer at the end of the
.Fn namei
invocation, instead free it later in
invocation; instead, free it later in
.Fn NDFREE
so that the caller may access the pathname buffer.
See below for details.
@ -192,10 +196,11 @@ See below for details.
The
.Vt nameidata
structure is composed of the following fields:
.Bl -tag -width ni_cnd.cn_pnbuf
.Bl -tag -width ".Va ni_cnd.cn_pnbuf"
.It Va ni_startdir
In the normal case, this is either the current directory or the root.
It is the current directory if the name passed in doesn't start with /
It is the current directory if the name passed in does not start with
.Ql /
and we have not gone through any symlinks with an absolute path, and
the root otherwise.
.Pp
@ -228,10 +233,9 @@ It is locked if
.Dv LOCKPARENT
is set.
Freeing this in
.Dv NDFREE
.Fn NDFREE
can be inhibited by
.Dv NDF_NO_DVP_RELE ,
.Dv NDF_NO_DVP_PUT ,
.Dv NDF_NO_DVP_RELE , NDF_NO_DVP_PUT ,
or
.Dv NDF_NO_DVP_UNLOCK
(with the obvious effects).
@ -249,11 +253,10 @@ is set, it is also locked.
Freeing this in
.Fn NDFREE
can be inhibited by
.Dv NDF_NO_VP_RELE ,
.Dv NDF_NO_VP_PUT ,
.Dv NDF_NO_VP_RELE , NDF_NO_VP_PUT ,
or
.Dv NDF_NO_VP_UNLOCK
.Pq with the obvious effects .
(with the obvious effects).
.It Va ni_cnd.cn_pnbuf
The pathname buffer contains the location of the file or directory
that will be used by the
@ -268,7 +271,7 @@ or
.Dv SAVENAME
flag is set, then the pathname buffer is available
after calling the
.Nm namei
.Fn namei
function.
.Pp
To only deallocate resources used by the pathname buffer,
@ -286,7 +289,9 @@ flag can be passed to the
function.
.El
.Sh FILES
.Pa src/sys/kern/vfs_lookup.c
.Bl -tag
.It Pa src/sys/kern/vfs_lookup.c
.El
.Sh SEE ALSO
.Xr uio 9 ,
.Xr uma 9 ,
@ -295,10 +300,11 @@ function.
.Xr vput 9 ,
.Xr vref 9
.Sh AUTHORS
.An -nosplit
This manual page was written by
.An Eivind Eklund Aq eivind@FreeBSD.ORG
.An Eivind Eklund Aq eivind@FreeBSD.org
and later significantly revised by
.An Hiten M. Pandya Aq hmp@FreeBSD.ORG .
.An Hiten M. Pandya Aq hmp@FreeBSD.org .
.Sh BUGS
The
.Dv LOCKPARENT

View File

@ -104,7 +104,7 @@ for the first time, callers should ensure that unused bits of the
structure are set to zero. On subsequent calls,
.Fn rtalloc
returns without performing a lookup if
.Va ro->ro_rt
.Fa ro->ro_rt
is non-null and the
.Dv RTF_UP
flag is set in the route's