mirror of
https://github.com/freebsd/freebsd-src.git
synced 2024-12-04 16:49:40 +00:00
Mdoc Janitor:
* Fix hard sentence breaks.
This commit is contained in:
parent
3a858f3798
commit
559eb8d2e3
Notes:
svn2git
2020-12-20 02:59:44 +00:00
svn path=/head/; revision=121385
@ -43,25 +43,27 @@ and WORM drives
|
||||
.Tn ( SCSI
|
||||
type 4)
|
||||
that support CDROM type commands.
|
||||
Some drives don't behave as the driver expects. See the section
|
||||
QUIRKS for info on possible flags.
|
||||
Some drives don't behave as the driver expects.
|
||||
See the section QUIRKS for info on possible flags.
|
||||
.Sh QUIRKS
|
||||
Each
|
||||
.Tn CD-ROM
|
||||
device can have different interpretations of the
|
||||
.Tn SCSI
|
||||
spec. This can lead to drives requiring special handling in the driver. The
|
||||
following is a list of quirks that the driver recognize.
|
||||
spec.
|
||||
This can lead to drives requiring special handling in the driver.
|
||||
The following is a list of quirks that the driver recognize.
|
||||
.Bl -tag -width CD_Q_BCD_TRACKS
|
||||
.It Dv CD_Q_NO_TOUCH
|
||||
This flag tell the driver not to probe the drive at attach time to see if
|
||||
there is a disk in the drive and find out what size it is. This flag is
|
||||
currently unimplemented in the CAM
|
||||
there is a disk in the drive and find out what size it is.
|
||||
This flag is currently unimplemented in the CAM
|
||||
.Nm
|
||||
driver.
|
||||
.It Dv CD_Q_BCD_TRACKS
|
||||
This flag is for broken drives that return the track numbers in packed BCD
|
||||
instead of straight decimal. If the drive seems to skip tracks
|
||||
instead of straight decimal.
|
||||
If the drive seems to skip tracks
|
||||
(tracks 10-15 are skipped)
|
||||
then you have a drive that is in need of this flag.
|
||||
.It Dv CD_Q_NO_CHANGER
|
||||
@ -71,22 +73,27 @@ part of a changer.
|
||||
.It Dv CD_Q_CHANGER
|
||||
This flag tells the driver that the given device is a multi-lun changer.
|
||||
In general, the driver will figure this out automatically when it sees a
|
||||
LUN greater than 0. Setting this flag only has the effect of telling the
|
||||
LUN greater than 0.
|
||||
Setting this flag only has the effect of telling the
|
||||
driver to run the initial read capacity command for LUN 0 of the changer
|
||||
through the changer scheduling code.
|
||||
.It Dv CD_Q_10_BYTE_ONLY
|
||||
This flag tells the driver that the given device only accepts 10 byte MODE
|
||||
SENSE/MODE SELECT commands. In general these types of quirks should not be
|
||||
SENSE/MODE SELECT commands.
|
||||
In general these types of quirks should not be
|
||||
added to the
|
||||
.Xr cd 4
|
||||
driver. The reason is that the driver does several things to attempt to
|
||||
determine whether the drive in question needs 10 byte commands. First, it
|
||||
driver.
|
||||
The reason is that the driver does several things to attempt to
|
||||
determine whether the drive in question needs 10 byte commands.
|
||||
First, it
|
||||
issues a CAM Path Inquiry command to determine whether the protocol that
|
||||
the drive speaks typically only allows 10 byte commands. (ATAPI and USB
|
||||
are two prominent examples of protocols where you generally only want to
|
||||
send 10 byte commands.) Then, if it gets an ILLEGAL REQUEST error back
|
||||
from a 6 byte MODE SENSE or MODE SELECT command, it attempts to send the 10
|
||||
byte version of the command instead. The only reason you would need a
|
||||
byte version of the command instead.
|
||||
The only reason you would need a
|
||||
quirk is if your drive uses a protocol (e.g.
|
||||
.Tn SCSI )
|
||||
that typically doesn't have a problem with 6 byte commands.
|
||||
|
@ -72,7 +72,8 @@ specific new attributes may be defined.
|
||||
.Pp
|
||||
Extended attributes are named using a null-terminated character string.
|
||||
Depending on underlying file system semantics, this name may or may not be
|
||||
case-sensitive. Appropriate vnode extended attribute calls are:
|
||||
case-sensitive.
|
||||
Appropriate vnode extended attribute calls are:
|
||||
.Xr VOP_GETEXTATTR 9 ,
|
||||
.Xr VOP_LISTEXTATTR 9 ,
|
||||
and
|
||||
|
@ -85,8 +85,8 @@ variable.
|
||||
The
|
||||
.Fn inittodr
|
||||
function prints diagnostic messages if it has trouble figuring
|
||||
out the system time. Conditions that can cause diagnostic
|
||||
messages to be printed include:
|
||||
out the system time.
|
||||
Conditions that can cause diagnostic messages to be printed include:
|
||||
.Bl -bullet
|
||||
.It
|
||||
The battery-backed clock's time appears nonsensical.
|
||||
@ -109,8 +109,8 @@ has to convert from
|
||||
a time expressed in terms of year, month, day, hours, minutes,
|
||||
and seconds to
|
||||
.Va time ,
|
||||
expressed in seconds. Many of the implementations could share code,
|
||||
but do not.
|
||||
expressed in seconds.
|
||||
Many of the implementations could share code, but do not.
|
||||
.Pp
|
||||
Each system's heuristics for picking the correct time are slightly
|
||||
different.
|
||||
@ -119,5 +119,5 @@ The
|
||||
.Fx
|
||||
implementation should do a better job of validating the time provided in
|
||||
.Fa base
|
||||
when the battery-backed clock is unusable. Currently it unconditionally
|
||||
sets the system clock to this value.
|
||||
when the battery-backed clock is unusable.
|
||||
Currently it unconditionally sets the system clock to this value.
|
||||
|
@ -105,7 +105,8 @@ All the bits generated by
|
||||
.Fn arc4rand
|
||||
and
|
||||
.Fn read_random
|
||||
are usable. For example,
|
||||
are usable.
|
||||
For example,
|
||||
.Sq Li random()&01
|
||||
will produce a random binary value.
|
||||
.Pp
|
||||
|
@ -58,4 +58,5 @@ On many systems,
|
||||
has to convert from
|
||||
.Va time
|
||||
to a time expressed in terms of year, month, day, hours, minutes,
|
||||
and seconds. Many of the implementations could share code, but do not.
|
||||
and seconds.
|
||||
Many of the implementations could share code, but do not.
|
||||
|
@ -58,7 +58,8 @@ external event, it is put on sleep by
|
||||
The parameter
|
||||
.Fa ident
|
||||
is an arbitrary address that uniquely identifies the event on which
|
||||
the process is being asleep. All processes sleeping on a single
|
||||
the process is being asleep.
|
||||
All processes sleeping on a single
|
||||
.Fa ident
|
||||
are woken up later by
|
||||
.Fn wakeup ,
|
||||
@ -77,7 +78,8 @@ The
|
||||
function is used to make the first process in the queue that is
|
||||
sleeping on the parameter
|
||||
.Fa ident
|
||||
runnable. This can prevent the system from becoming saturated
|
||||
runnable.
|
||||
This can prevent the system from becoming saturated
|
||||
when a large number of processes are sleeping on the same address,
|
||||
but only one of them can actually do any useful work when made
|
||||
runnable.
|
||||
@ -98,7 +100,8 @@ If
|
||||
includes the
|
||||
.Dv PCATCH
|
||||
flag, signals are checked before and after sleeping, else signals are
|
||||
not checked. Returns 0 if awakened,
|
||||
not checked.
|
||||
Returns 0 if awakened,
|
||||
.Er EWOULDBLOCK
|
||||
if the timeout expires.
|
||||
If
|
||||
|
@ -82,7 +82,8 @@ function family sets the interrupt priority
|
||||
.Dq level
|
||||
of the CPU.
|
||||
This prevents interrupt handlers of the blocked priority level from
|
||||
being run. This is used in the
|
||||
being run.
|
||||
This is used in the
|
||||
.Dq synchronous
|
||||
part of a driver (the part that runs on behalf of the user process) to
|
||||
examine or modify data areas that might be examined or modified by
|
||||
@ -97,7 +98,8 @@ device foo0 at isa? port 0x0815 irq 12 tty
|
||||
.Pp
|
||||
assigns interrupt 12 to the
|
||||
.Dq tty
|
||||
priority group. The system automatically arranges for interrupts in
|
||||
priority group.
|
||||
The system automatically arranges for interrupts in
|
||||
the
|
||||
.Em xxx
|
||||
group to be called at a priority >=
|
||||
@ -106,7 +108,8 @@ group to be called at a priority >=
|
||||
.Pp
|
||||
The function
|
||||
.Fn splx
|
||||
sets the interrupt priority to an absolute value. The intent is that
|
||||
sets the interrupt priority to an absolute value.
|
||||
The intent is that
|
||||
the value returned by the other functions should be saved in a local
|
||||
variable, and later passed to
|
||||
.Fn splx
|
||||
@ -186,7 +189,8 @@ foointr(...)
|
||||
.Ed
|
||||
Note that the interrupt handler should
|
||||
.Em never
|
||||
reduce the priority level. It is automatically called as it had
|
||||
reduce the priority level.
|
||||
It is automatically called as it had
|
||||
raised the interrupt priority to its own level, i.e. further interrupts
|
||||
of the same group are being blocked.
|
||||
.Sh HISTORY
|
||||
@ -194,8 +198,8 @@ The interrupt priority levels appeared in a very early version of
|
||||
.Ux .
|
||||
They have been traditionally known by number instead of by
|
||||
names, and were inclusive up to higher priority levels (i.e., priority
|
||||
5 has been blocking everything up to level 5). This is no longer the
|
||||
case in
|
||||
5 has been blocking everything up to level 5).
|
||||
This is no longer the case in
|
||||
.Fx .
|
||||
The traditional name
|
||||
.Ql level
|
||||
@ -204,7 +208,8 @@ for them is still reflected in the letter
|
||||
of the respective functions and variables, although they are not
|
||||
really levels anymore, but rather different (partially inclusive)
|
||||
sets of functions to be blocked during some periods of the life of
|
||||
the system. The historical number scheme can be considered as a
|
||||
the system.
|
||||
The historical number scheme can be considered as a
|
||||
simple linearly ordered set of interrupt priority groups.
|
||||
.Sh AUTHORS
|
||||
This man page was written by
|
||||
|
@ -74,9 +74,10 @@ be done by setting the
|
||||
.Dv PRISON_ROOT
|
||||
bit in the flags argument to the
|
||||
.Nm suser_cred
|
||||
function. It is important to review carefully in each case that
|
||||
this does not weaken the prison. Generally only where the action
|
||||
is protected by the
|
||||
function.
|
||||
It is important to review carefully in each case that
|
||||
this does not weaken the prison.
|
||||
Generally only where the action is protected by the
|
||||
.Xr chroot 2
|
||||
implicit in
|
||||
.Xr jail 2
|
||||
|
@ -65,7 +65,8 @@ system call and by periodic clock interrupts.
|
||||
.Pp
|
||||
The
|
||||
.Va boottime
|
||||
variable holds the system boot time. It is set from
|
||||
variable holds the system boot time.
|
||||
It is set from
|
||||
.Va time
|
||||
at system boot, and is updated when the system time is adjusted
|
||||
with
|
||||
@ -87,7 +88,8 @@ function, rather than being copied from
|
||||
.Pp
|
||||
The
|
||||
.Va mono_time
|
||||
variable is a monotonically increasing system clock. It is set
|
||||
variable is a monotonically increasing system clock.
|
||||
It is set
|
||||
from
|
||||
.Va time
|
||||
at boot, and is updated by the periodic timer interrupt. (It is
|
||||
@ -109,8 +111,8 @@ The
|
||||
.Xr gettime 9
|
||||
function can be used to read the
|
||||
.Va time
|
||||
variable in an atomic manner. There is no equivalent
|
||||
function for accessing
|
||||
variable in an atomic manner.
|
||||
There is no equivalent function for accessing
|
||||
.Va mono_time .
|
||||
The
|
||||
.Va boottime
|
||||
|
Loading…
Reference in New Issue
Block a user