Expand *n't contractions.
This commit is contained in:
parent
13e88b41ba
commit
1541af42f1
@ -210,7 +210,7 @@ the clock goes back at 02:00 to 01:00, using
|
|||||||
.Fl v No +3H
|
.Fl v No +3H
|
||||||
will be necessary to reach October 29, 2:30.
|
will be necessary to reach October 29, 2:30.
|
||||||
.Pp
|
.Pp
|
||||||
When the date is adjusted to a specific value that doesn't actually exist
|
When the date is adjusted to a specific value that does not actually exist
|
||||||
(for example March 26, 1:30 BST 2000 in the Europe/London timezone),
|
(for example March 26, 1:30 BST 2000 in the Europe/London timezone),
|
||||||
the date will be silently adjusted forwards in units of one hour until it
|
the date will be silently adjusted forwards in units of one hour until it
|
||||||
reaches a valid time.
|
reaches a valid time.
|
||||||
|
@ -69,7 +69,7 @@ the link.
|
|||||||
Symbolic links may reference other symbolic links,
|
Symbolic links may reference other symbolic links,
|
||||||
in which case the links are dereferenced until an object that is
|
in which case the links are dereferenced until an object that is
|
||||||
not a symbolic link is found,
|
not a symbolic link is found,
|
||||||
a symbolic link which references a file which doesn't exist is found,
|
a symbolic link which references a file which does not exist is found,
|
||||||
or a loop is detected.
|
or a loop is detected.
|
||||||
(Loop detection is done by placing an upper limit on the number of
|
(Loop detection is done by placing an upper limit on the number of
|
||||||
links that may be followed, and an error results if this limit is
|
links that may be followed, and an error results if this limit is
|
||||||
|
@ -475,12 +475,12 @@ variable must be set to
|
|||||||
.Dq Li xterm-color .
|
.Dq Li xterm-color .
|
||||||
Other terminal types may require similar adjustments.
|
Other terminal types may require similar adjustments.
|
||||||
Colorization
|
Colorization
|
||||||
is silently disabled if the output isn't directed to a terminal
|
is silently disabled if the output is not directed to a terminal
|
||||||
unless the
|
unless the
|
||||||
.Ev CLICOLOR_FORCE
|
.Ev CLICOLOR_FORCE
|
||||||
variable is defined.
|
variable is defined.
|
||||||
.It Ev CLICOLOR_FORCE
|
.It Ev CLICOLOR_FORCE
|
||||||
Color sequences are normally disabled if the output isn't directed to
|
Color sequences are normally disabled if the output is not directed to
|
||||||
a terminal.
|
a terminal.
|
||||||
This can be overridden by setting this flag.
|
This can be overridden by setting this flag.
|
||||||
The
|
The
|
||||||
|
@ -120,7 +120,7 @@ Write old-style
|
|||||||
.Pq non- Ns Tn POSIX
|
.Pq non- Ns Tn POSIX
|
||||||
archives.
|
archives.
|
||||||
.It Fl o
|
.It Fl o
|
||||||
Don't write directory information that the older (V7) style
|
Do not write directory information that the older (V7) style
|
||||||
.Nm
|
.Nm
|
||||||
is unable to decode.
|
is unable to decode.
|
||||||
This implies the
|
This implies the
|
||||||
|
@ -129,7 +129,7 @@ described here
|
|||||||
has been reimplemented with Kerberos in
|
has been reimplemented with Kerberos in
|
||||||
.Bx 4.3 Reno .
|
.Bx 4.3 Reno .
|
||||||
.Sh BUGS
|
.Sh BUGS
|
||||||
Doesn't detect all cases where the target of a copy might
|
Does not detect all cases where the target of a copy might
|
||||||
be a file in cases where only a directory should be legal.
|
be a file in cases where only a directory should be legal.
|
||||||
.Pp
|
.Pp
|
||||||
Is confused by any output generated by commands in a
|
Is confused by any output generated by commands in a
|
||||||
|
@ -96,7 +96,7 @@ Pretend the local hostname is
|
|||||||
.Ar name .
|
.Ar name .
|
||||||
This is useful after the local hostname has been changed and rmtab entries
|
This is useful after the local hostname has been changed and rmtab entries
|
||||||
using the old name remain on a remote machine.
|
using the old name remain on a remote machine.
|
||||||
Unfortunately, most mountd's won't be able to successfully handle removal
|
Unfortunately, most mountd's will not be able to successfully handle removal
|
||||||
of such entries, so this option is useful in combination with
|
of such entries, so this option is useful in combination with
|
||||||
.Fl v
|
.Fl v
|
||||||
only.
|
only.
|
||||||
|
@ -86,7 +86,7 @@ which defaults to
|
|||||||
Lookups within that directory are handled by
|
Lookups within that directory are handled by
|
||||||
.Nm hlfsd ,
|
.Nm hlfsd ,
|
||||||
which uses the password map to determine how to resolve the lookup. The
|
which uses the password map to determine how to resolve the lookup. The
|
||||||
directory will be created if it doesn't already exist. The symbolic link will
|
directory will be created if it does not already exist. The symbolic link will
|
||||||
be to the accessing user's home directory, with
|
be to the accessing user's home directory, with
|
||||||
.Ar subdir
|
.Ar subdir
|
||||||
appended to it. If not specified,
|
appended to it. If not specified,
|
||||||
@ -113,7 +113,7 @@ the symbolic link returned by
|
|||||||
will point, if it cannot access the home directory of the user. This
|
will point, if it cannot access the home directory of the user. This
|
||||||
defaults to
|
defaults to
|
||||||
.Pa /var/hlfs .
|
.Pa /var/hlfs .
|
||||||
This directory will be created if it doesn't exist. It is expected
|
This directory will be created if it does not exist. It is expected
|
||||||
that either users will read these files, or the system administrators
|
that either users will read these files, or the system administrators
|
||||||
will run a script to resend this
|
will run a script to resend this
|
||||||
.Dq lost mail
|
.Dq lost mail
|
||||||
|
@ -71,7 +71,7 @@ Only available if compiled with -DDEBUG.
|
|||||||
Consider all fortune files to be of equal size (see discussion below
|
Consider all fortune files to be of equal size (see discussion below
|
||||||
on multiple files).
|
on multiple files).
|
||||||
.It Fl f
|
.It Fl f
|
||||||
Print out the list of files which would be searched, but don't
|
Print out the list of files which would be searched, but do not
|
||||||
print a fortune.
|
print a fortune.
|
||||||
.It Fl l
|
.It Fl l
|
||||||
Long dictums only.
|
Long dictums only.
|
||||||
|
@ -99,7 +99,7 @@ bit in the header
|
|||||||
.Ar str_flags
|
.Ar str_flags
|
||||||
field to be set.
|
field to be set.
|
||||||
.It Fl s
|
.It Fl s
|
||||||
Run silently; don't give a summary message when finished.
|
Run silently; do not give a summary message when finished.
|
||||||
.It Fl x
|
.It Fl x
|
||||||
Note that each alphabetic character in the groups of lines is rotated
|
Note that each alphabetic character in the groups of lines is rotated
|
||||||
13 positions in a simple caesar cypher.
|
13 positions in a simple caesar cypher.
|
||||||
|
@ -59,4 +59,4 @@ Display the number on a single line.
|
|||||||
.Sh BUGS
|
.Sh BUGS
|
||||||
Although
|
Although
|
||||||
.Nm
|
.Nm
|
||||||
understand fractions, it doesn't understand exponents.
|
understand fractions, it does not understand exponents.
|
||||||
|
@ -686,7 +686,7 @@ function gets the current value of the helpful text line.
|
|||||||
.Pp
|
.Pp
|
||||||
The
|
The
|
||||||
.Fn dialog_clear_norefresh
|
.Fn dialog_clear_norefresh
|
||||||
function clears the screen back to the dialog background color, but don't
|
function clears the screen back to the dialog background color, but do not
|
||||||
refresh the contents just yet.
|
refresh the contents just yet.
|
||||||
.Pp
|
.Pp
|
||||||
The
|
The
|
||||||
|
@ -93,7 +93,7 @@ that match
|
|||||||
.Ar name ,
|
.Ar name ,
|
||||||
not just the first.
|
not just the first.
|
||||||
.It Fl d
|
.It Fl d
|
||||||
Don't actually display the man pages, but do print gobs of debugging
|
Do not actually display the man pages, but do print gobs of debugging
|
||||||
information.
|
information.
|
||||||
.It Fl f
|
.It Fl f
|
||||||
Equivalent to
|
Equivalent to
|
||||||
@ -191,7 +191,7 @@ The output from
|
|||||||
may need to be passed through some filter or another before being
|
may need to be passed through some filter or another before being
|
||||||
printed.
|
printed.
|
||||||
.It Fl w
|
.It Fl w
|
||||||
Don't actually display the man pages, but do print the location(s) of
|
Do not actually display the man pages, but do print the location(s) of
|
||||||
the files that would be formatted or displayed.
|
the files that would be formatted or displayed.
|
||||||
.El
|
.El
|
||||||
.Sh ENVIRONMENT
|
.Sh ENVIRONMENT
|
||||||
|
@ -51,7 +51,7 @@ If it exists, it is added to the search path.
|
|||||||
.Nm Manpath
|
.Nm Manpath
|
||||||
is used by
|
is used by
|
||||||
.Xr man 1
|
.Xr man 1
|
||||||
to determine the search path, so users normally don't need to set the
|
to determine the search path, so users normally do not need to set the
|
||||||
.Ev MANPATH
|
.Ev MANPATH
|
||||||
environment variable directly.
|
environment variable directly.
|
||||||
.Pp
|
.Pp
|
||||||
|
@ -205,12 +205,12 @@ Create/list/extract old GNU-format incremental backup.
|
|||||||
Create/list/extract new GNU-format incremental backup.
|
Create/list/extract new GNU-format incremental backup.
|
||||||
.It Fl h
|
.It Fl h
|
||||||
.It Fl -dereference
|
.It Fl -dereference
|
||||||
Don't write symlinks as symlinks; write the data of the files they name.
|
Do not write symlinks as symlinks; write the data of the files they name.
|
||||||
.It Fl i
|
.It Fl i
|
||||||
.It Fl -ignore-zeros
|
.It Fl -ignore-zeros
|
||||||
Ignore blocks of zeroes in archive (usually means End-Of-File).
|
Ignore blocks of zeroes in archive (usually means End-Of-File).
|
||||||
.It Fl -ignore-failed-read
|
.It Fl -ignore-failed-read
|
||||||
Don't exit with non-zero status on unreadable files.
|
Do not exit with non-zero status on unreadable files.
|
||||||
.It Fl j
|
.It Fl j
|
||||||
.It Fl y
|
.It Fl y
|
||||||
.It Fl -bzip
|
.It Fl -bzip
|
||||||
@ -220,7 +220,7 @@ Filter the archive through
|
|||||||
.Xr bzip2 1 .
|
.Xr bzip2 1 .
|
||||||
.It Fl k
|
.It Fl k
|
||||||
.It Fl -keep-old-files
|
.It Fl -keep-old-files
|
||||||
Keep files which already exist on disk; don't overwrite them from the archive.
|
Keep files which already exist on disk; do not overwrite them from the archive.
|
||||||
.It Fl K Ar file
|
.It Fl K Ar file
|
||||||
.It Fl -starting-file Ar file
|
.It Fl -starting-file Ar file
|
||||||
Begin at
|
Begin at
|
||||||
@ -237,13 +237,13 @@ Change tapes after writing
|
|||||||
* 1024 bytes.
|
* 1024 bytes.
|
||||||
.It Fl m
|
.It Fl m
|
||||||
.It Fl -modification-time
|
.It Fl -modification-time
|
||||||
Don't extract file modified time.
|
Do not extract file modified time.
|
||||||
.It Fl M
|
.It Fl M
|
||||||
.It Fl -multi-volume
|
.It Fl -multi-volume
|
||||||
Create/list/extract multi-volume archive.
|
Create/list/extract multi-volume archive.
|
||||||
.It Fl n
|
.It Fl n
|
||||||
.It Fl -norecurse
|
.It Fl -norecurse
|
||||||
Don't recurse into subdirectories when creating.
|
Do not recurse into subdirectories when creating.
|
||||||
.It Fl -volno-file Ar file
|
.It Fl -volno-file Ar file
|
||||||
File name with volume number to start with.
|
File name with volume number to start with.
|
||||||
.It Fl N Ar date
|
.It Fl N Ar date
|
||||||
@ -270,7 +270,7 @@ Has the effect of
|
|||||||
.Fl p s .
|
.Fl p s .
|
||||||
.It Fl P
|
.It Fl P
|
||||||
.It Fl -absolute-paths
|
.It Fl -absolute-paths
|
||||||
Don't strip leading
|
Do not strip leading
|
||||||
.Ql /
|
.Ql /
|
||||||
from file names.
|
from file names.
|
||||||
.It Fl R
|
.It Fl R
|
||||||
@ -333,7 +333,7 @@ Attempt to verify the archive after writing it.
|
|||||||
.It Fl -exclude Ar pattern
|
.It Fl -exclude Ar pattern
|
||||||
Exclude files matching the
|
Exclude files matching the
|
||||||
.Ar pattern
|
.Ar pattern
|
||||||
(don't extract them, don't add them, don't list them).
|
(do not extract them, do not add them, do not list them).
|
||||||
.It Fl X Ar file
|
.It Fl X Ar file
|
||||||
.It Fl -exclude-from Ar file
|
.It Fl -exclude-from Ar file
|
||||||
Exclude files listed in
|
Exclude files listed in
|
||||||
@ -468,7 +468,7 @@ which will add the files contained in
|
|||||||
.Pa archive2.tar
|
.Pa archive2.tar
|
||||||
onto the end of
|
onto the end of
|
||||||
.Pa archive1.tar
|
.Pa archive1.tar
|
||||||
(note that this can't be done by simply typing
|
(note that this cannot be done by simply typing
|
||||||
.Dl "cat archive2.tar >> archive1.tar"
|
.Dl "cat archive2.tar >> archive1.tar"
|
||||||
because of the end-of-file block at the end of a
|
because of the end-of-file block at the end of a
|
||||||
.Nm
|
.Nm
|
||||||
|
@ -272,7 +272,7 @@ Complete the archive and invoke the close callback.
|
|||||||
.It Fn archive_read_finish
|
.It Fn archive_read_finish
|
||||||
Invokes
|
Invokes
|
||||||
.Fn archive_read_close
|
.Fn archive_read_close
|
||||||
if it wasn't invoked maually, then release all resources.
|
if it was not invoked maually, then release all resources.
|
||||||
.El
|
.El
|
||||||
.Pp
|
.Pp
|
||||||
Note that the library determines most of the relevant information about
|
Note that the library determines most of the relevant information about
|
||||||
|
@ -196,7 +196,7 @@ Complete the archive and invoke the close callback.
|
|||||||
.It Fn archive_write_finish
|
.It Fn archive_write_finish
|
||||||
Invokes
|
Invokes
|
||||||
.Fn archive_write_close
|
.Fn archive_write_close
|
||||||
if it wasn't invoked manually, then release all resources.
|
if it was not invoked manually, then release all resources.
|
||||||
.El
|
.El
|
||||||
More information about the
|
More information about the
|
||||||
.Va struct archive
|
.Va struct archive
|
||||||
|
@ -98,7 +98,7 @@ is not possible.)
|
|||||||
.\".Bl -tag -width indent
|
.\".Bl -tag -width indent
|
||||||
.\".It Dv DB_LOCK
|
.\".It Dv DB_LOCK
|
||||||
.\"Do the necessary locking in the database to support concurrent access.
|
.\"Do the necessary locking in the database to support concurrent access.
|
||||||
.\"If concurrent access isn't needed or the database is read-only this
|
.\"If concurrent access is not needed or the database is read-only this
|
||||||
.\"flag should not be set, as it tends to have an associated performance
|
.\"flag should not be set, as it tends to have an associated performance
|
||||||
.\"penalty.
|
.\"penalty.
|
||||||
.\".It Dv DB_SHMEM
|
.\".It Dv DB_SHMEM
|
||||||
@ -541,7 +541,7 @@ The typedef
|
|||||||
is a mnemonic for
|
is a mnemonic for
|
||||||
.Dq "data base thang" ,
|
.Dq "data base thang" ,
|
||||||
and was used
|
and was used
|
||||||
because noone could think of a reasonable name that wasn't already used.
|
because noone could think of a reasonable name that was not already used.
|
||||||
.Pp
|
.Pp
|
||||||
The file descriptor interface is a kluge and will be deleted in a
|
The file descriptor interface is a kluge and will be deleted in a
|
||||||
future version of the interface.
|
future version of the interface.
|
||||||
|
@ -196,7 +196,7 @@ function may fail and set
|
|||||||
for the following:
|
for the following:
|
||||||
.Bl -tag -width Er
|
.Bl -tag -width Er
|
||||||
.It Bq Er EINVAL
|
.It Bq Er EINVAL
|
||||||
The requested record doesn't exist.
|
The requested record does not exist.
|
||||||
.El
|
.El
|
||||||
.Pp
|
.Pp
|
||||||
The
|
The
|
||||||
|
@ -159,7 +159,7 @@ and
|
|||||||
search path is the path specified in the environment by
|
search path is the path specified in the environment by
|
||||||
.Dq Ev PATH
|
.Dq Ev PATH
|
||||||
variable.
|
variable.
|
||||||
If this variable isn't specified,
|
If this variable is not specified,
|
||||||
the default path is set according to the
|
the default path is set according to the
|
||||||
.Dv _PATH_DEFPATH
|
.Dv _PATH_DEFPATH
|
||||||
definition in
|
definition in
|
||||||
@ -196,7 +196,7 @@ or
|
|||||||
according to whether at least one file with suitable execute permissions
|
according to whether at least one file with suitable execute permissions
|
||||||
was found.
|
was found.
|
||||||
.Pp
|
.Pp
|
||||||
If the header of a file isn't recognized (the attempted
|
If the header of a file is not recognized (the attempted
|
||||||
.Fn execve
|
.Fn execve
|
||||||
returned
|
returned
|
||||||
.Er ENOEXEC ) ,
|
.Er ENOEXEC ) ,
|
||||||
|
@ -110,8 +110,8 @@ On success 0 is returned, 1 if the returned
|
|||||||
record contains an unresolved
|
record contains an unresolved
|
||||||
.Ic tc
|
.Ic tc
|
||||||
expansion,
|
expansion,
|
||||||
\-1 if the requested record couldn't be found,
|
\-1 if the requested record could not be found,
|
||||||
\-2 if a system error was encountered (couldn't open/read a file, etc.) also
|
\-2 if a system error was encountered (could not open/read a file, etc.) also
|
||||||
setting
|
setting
|
||||||
.Va errno ,
|
.Va errno ,
|
||||||
and \-3 if a potential reference loop is detected (see
|
and \-3 if a potential reference loop is detected (see
|
||||||
@ -178,7 +178,7 @@ in
|
|||||||
.Fa buf
|
.Fa buf
|
||||||
is returned on success,
|
is returned on success,
|
||||||
.Dv NULL
|
.Dv NULL
|
||||||
if the requested capability couldn't be
|
if the requested capability could not be
|
||||||
found.
|
found.
|
||||||
The end of the capability value is signaled by a `:' or
|
The end of the capability value is signaled by a `:' or
|
||||||
.Tn ASCII
|
.Tn ASCII
|
||||||
@ -195,7 +195,7 @@ The numeric value is returned in the
|
|||||||
.Ft long
|
.Ft long
|
||||||
pointed to by
|
pointed to by
|
||||||
.Fa num .
|
.Fa num .
|
||||||
0 is returned on success, \-1 if the requested numeric capability couldn't
|
0 is returned on success, \-1 if the requested numeric capability could not
|
||||||
be found.
|
be found.
|
||||||
.Pp
|
.Pp
|
||||||
The
|
The
|
||||||
@ -214,7 +214,7 @@ pointed to by
|
|||||||
.Fa str .
|
.Fa str .
|
||||||
The number of characters in the decoded string not including the trailing
|
The number of characters in the decoded string not including the trailing
|
||||||
.Dv NUL
|
.Dv NUL
|
||||||
is returned on success, \-1 if the requested string capability couldn't
|
is returned on success, \-1 if the requested string capability could not
|
||||||
be found, \-2 if a system error was encountered (storage allocation
|
be found, \-2 if a system error was encountered (storage allocation
|
||||||
failure).
|
failure).
|
||||||
.Pp
|
.Pp
|
||||||
@ -257,7 +257,7 @@ expansion is done (see
|
|||||||
.Ic tc=
|
.Ic tc=
|
||||||
comments below).
|
comments below).
|
||||||
Upon completion of the database 0 is returned, 1 is returned upon successful
|
Upon completion of the database 0 is returned, 1 is returned upon successful
|
||||||
return of record with possibly more remaining (we haven't reached the end of
|
return of record with possibly more remaining (we have not reached the end of
|
||||||
the database yet), 2 is returned if the record contains an unresolved
|
the database yet), 2 is returned if the record contains an unresolved
|
||||||
.Ic tc
|
.Ic tc
|
||||||
expansion, \-1 is returned if a system error occurred, and \-2
|
expansion, \-1 is returned if a system error occurred, and \-2
|
||||||
@ -559,7 +559,7 @@ No memory to allocate.
|
|||||||
.Xr cap_mkdb 1 ,
|
.Xr cap_mkdb 1 ,
|
||||||
.Xr malloc 3
|
.Xr malloc 3
|
||||||
.Sh BUGS
|
.Sh BUGS
|
||||||
Colons (`:') can't be used in names, types, or values.
|
Colons (`:') cannot be used in names, types, or values.
|
||||||
.Pp
|
.Pp
|
||||||
There are no checks for
|
There are no checks for
|
||||||
.Ic tc Ns = Ns Ic name
|
.Ic tc Ns = Ns Ic name
|
||||||
|
@ -147,7 +147,7 @@ is non-zero, file descriptors are left open, significantly speeding
|
|||||||
functions subsequent calls.
|
functions subsequent calls.
|
||||||
This functionality is unnecessary for
|
This functionality is unnecessary for
|
||||||
.Fn getgrent
|
.Fn getgrent
|
||||||
as it doesn't close its file descriptors by default.
|
as it does not close its file descriptors by default.
|
||||||
It should also
|
It should also
|
||||||
be noted that it is dangerous for long-running programs to use this
|
be noted that it is dangerous for long-running programs to use this
|
||||||
functionality as the group file may be updated.
|
functionality as the group file may be updated.
|
||||||
|
@ -151,7 +151,7 @@ is non-zero, file descriptors are left open, significantly speeding
|
|||||||
up subsequent accesses for all of the routines.
|
up subsequent accesses for all of the routines.
|
||||||
(This latter functionality is unnecessary for
|
(This latter functionality is unnecessary for
|
||||||
.Fn getpwent
|
.Fn getpwent
|
||||||
as it doesn't close its file descriptors by default.)
|
as it does not close its file descriptors by default.)
|
||||||
.Pp
|
.Pp
|
||||||
It is dangerous for long-running programs to keep the file descriptors
|
It is dangerous for long-running programs to keep the file descriptors
|
||||||
open as the database will become out of date if it is updated while the
|
open as the database will become out of date if it is updated while the
|
||||||
|
@ -94,7 +94,7 @@ as held in a character string) to network format (usually a
|
|||||||
.Ft struct in_addr
|
.Ft struct in_addr
|
||||||
or some other internal binary representation, in network byte order).
|
or some other internal binary representation, in network byte order).
|
||||||
It returns 1 if the address was valid for the specified address family, or
|
It returns 1 if the address was valid for the specified address family, or
|
||||||
0 if the address wasn't parseable in the specified address family, or -1
|
0 if the address was not parseable in the specified address family, or -1
|
||||||
if some system error occurred (in which case
|
if some system error occurred (in which case
|
||||||
.Va errno
|
.Va errno
|
||||||
will have been set).
|
will have been set).
|
||||||
|
@ -166,7 +166,7 @@ This is useful only in programs that regularly do many queries.
|
|||||||
.Tn UDP
|
.Tn UDP
|
||||||
should be the normal mode used.
|
should be the normal mode used.
|
||||||
.It Dv RES_IGNTC
|
.It Dv RES_IGNTC
|
||||||
Unused currently (ignore truncation errors, i.e., don't retry with
|
Unused currently (ignore truncation errors, i.e., do not retry with
|
||||||
.Tn TCP ) .
|
.Tn TCP ) .
|
||||||
.It Dv RES_RECURSE
|
.It Dv RES_RECURSE
|
||||||
Set the recursion-desired bit in queries.
|
Set the recursion-desired bit in queries.
|
||||||
|
@ -436,7 +436,7 @@ places the NUL-terminated message into the buffer pointed to by
|
|||||||
limiting the length (including the NUL) to at most
|
limiting the length (including the NUL) to at most
|
||||||
.Fa errbuf_size
|
.Fa errbuf_size
|
||||||
bytes.
|
bytes.
|
||||||
If the whole message won't fit,
|
If the whole message will not fit,
|
||||||
as much of it as will fit before the terminating NUL is supplied.
|
as much of it as will fit before the terminating NUL is supplied.
|
||||||
In any case,
|
In any case,
|
||||||
the returned value is the size of buffer needed to hold the whole
|
the returned value is the size of buffer needed to hold the whole
|
||||||
@ -641,7 +641,7 @@ operand invalid
|
|||||||
.It Dv REG_EMPTY
|
.It Dv REG_EMPTY
|
||||||
empty (sub)expression
|
empty (sub)expression
|
||||||
.It Dv REG_ASSERT
|
.It Dv REG_ASSERT
|
||||||
can't happen - you found a bug
|
cannot happen - you found a bug
|
||||||
.It Dv REG_INVARG
|
.It Dv REG_INVARG
|
||||||
invalid argument, e.g.\& negative-length string
|
invalid argument, e.g.\& negative-length string
|
||||||
.It Dv REG_ILLSEQ
|
.It Dv REG_ILLSEQ
|
||||||
@ -715,7 +715,7 @@ are legal REs because
|
|||||||
is
|
is
|
||||||
a special character only in the presence of a previous unmatched
|
a special character only in the presence of a previous unmatched
|
||||||
.Ql (\& .
|
.Ql (\& .
|
||||||
This can't be fixed until the spec is fixed.
|
This cannot be fixed until the spec is fixed.
|
||||||
.Pp
|
.Pp
|
||||||
The standard's definition of back references is vague.
|
The standard's definition of back references is vague.
|
||||||
For example, does
|
For example, does
|
||||||
|
@ -105,7 +105,7 @@ Set the timeout argument to 0 for batching calls.
|
|||||||
.It Dv CLGET_SVC_ADDR Ta "struct netbuf *" Ta "get servers address"
|
.It Dv CLGET_SVC_ADDR Ta "struct netbuf *" Ta "get servers address"
|
||||||
.It Dv CLGET_FD Ta "int *" Ta "get fd from handle"
|
.It Dv CLGET_FD Ta "int *" Ta "get fd from handle"
|
||||||
.It Dv CLSET_FD_CLOSE Ta "void" Ta "close fd on destroy"
|
.It Dv CLSET_FD_CLOSE Ta "void" Ta "close fd on destroy"
|
||||||
.It Dv CLSET_FD_NCLOSE Ta void Ta "don't close fd on destroy"
|
.It Dv CLSET_FD_NCLOSE Ta void Ta "do not close fd on destroy"
|
||||||
.It Dv CLGET_VERS Ta "u_int32_t *" Ta "get RPC program version"
|
.It Dv CLGET_VERS Ta "u_int32_t *" Ta "get RPC program version"
|
||||||
.It Dv CLSET_VERS Ta "u_int32_t *" Ta "set RPC program version"
|
.It Dv CLSET_VERS Ta "u_int32_t *" Ta "set RPC program version"
|
||||||
.It Dv CLGET_XID Ta "u_int32_t *" Ta "get XID of previous call"
|
.It Dv CLGET_XID Ta "u_int32_t *" Ta "get XID of previous call"
|
||||||
|
@ -78,7 +78,7 @@ The
|
|||||||
function is less well-behaved:
|
function is less well-behaved:
|
||||||
for a positive leap second hit the result is not unique,
|
for a positive leap second hit the result is not unique,
|
||||||
and for a negative leap second hit the corresponding
|
and for a negative leap second hit the corresponding
|
||||||
POSIX time_t doesn't exist so an adjacent value is returned.
|
POSIX time_t does not exist so an adjacent value is returned.
|
||||||
Both of these are good indicators of the inferiority of the
|
Both of these are good indicators of the inferiority of the
|
||||||
POSIX representation.
|
POSIX representation.
|
||||||
.Pp
|
.Pp
|
||||||
|
@ -44,7 +44,7 @@
|
|||||||
.In sys/file.h
|
.In sys/file.h
|
||||||
.Fd "#define LOCK_SH 0x01 /* shared file lock */"
|
.Fd "#define LOCK_SH 0x01 /* shared file lock */"
|
||||||
.Fd "#define LOCK_EX 0x02 /* exclusive file lock */"
|
.Fd "#define LOCK_EX 0x02 /* exclusive file lock */"
|
||||||
.Fd "#define LOCK_NB 0x04 /* don't block when locking */"
|
.Fd "#define LOCK_NB 0x04 /* do not block when locking */"
|
||||||
.Fd "#define LOCK_UN 0x08 /* unlock file */"
|
.Fd "#define LOCK_UN 0x08 /* unlock file */"
|
||||||
.Ft int
|
.Ft int
|
||||||
.Fn flock "int fd" "int operation"
|
.Fn flock "int fd" "int operation"
|
||||||
|
@ -302,7 +302,7 @@ The protocol family has not been configured into the
|
|||||||
system or no implementation for it exists.
|
system or no implementation for it exists.
|
||||||
.It Er 47 EAFNOSUPPORT Em "Address family not supported by protocol family" .
|
.It Er 47 EAFNOSUPPORT Em "Address family not supported by protocol family" .
|
||||||
An address incompatible with the requested protocol was used.
|
An address incompatible with the requested protocol was used.
|
||||||
For example, you shouldn't necessarily expect to be able to use
|
For example, you should not necessarily expect to be able to use
|
||||||
.Tn NS
|
.Tn NS
|
||||||
addresses with
|
addresses with
|
||||||
.Tn ARPA
|
.Tn ARPA
|
||||||
@ -426,7 +426,7 @@ on the remote host
|
|||||||
.It Er 76 EPROCUNAVAIL Em "Bad procedure for program" .
|
.It Er 76 EPROCUNAVAIL Em "Bad procedure for program" .
|
||||||
An
|
An
|
||||||
.Tn RPC
|
.Tn RPC
|
||||||
call was attempted for a procedure which doesn't exist
|
call was attempted for a procedure which does not exist
|
||||||
in the remote program.
|
in the remote program.
|
||||||
.It Er 77 ENOLCK Em "No locks available" .
|
.It Er 77 ENOLCK Em "No locks available" .
|
||||||
A system-imposed limit on the number of simultaneous file
|
A system-imposed limit on the number of simultaneous file
|
||||||
|
@ -63,7 +63,7 @@ is
|
|||||||
.Er ENOENT ,
|
.Er ENOENT ,
|
||||||
which is set when
|
which is set when
|
||||||
.Va fileid
|
.Va fileid
|
||||||
refers to a kld file that does not exist (isn't loaded).
|
refers to a kld file that does not exist (is not loaded).
|
||||||
.Sh SEE ALSO
|
.Sh SEE ALSO
|
||||||
.Xr kldfind 2 ,
|
.Xr kldfind 2 ,
|
||||||
.Xr kldfirstmod 2 ,
|
.Xr kldfirstmod 2 ,
|
||||||
|
@ -52,7 +52,7 @@ The file referred to by
|
|||||||
is unloaded unless:
|
is unloaded unless:
|
||||||
.Bl -tag -width Er
|
.Bl -tag -width Er
|
||||||
.It Bq Er EPERM
|
.It Bq Er EPERM
|
||||||
You don't have access to unlink the file from the kernel.
|
You do not have access to unlink the file from the kernel.
|
||||||
.It Bq Er ENOENT
|
.It Bq Er ENOENT
|
||||||
The file was not found.
|
The file was not found.
|
||||||
.It Bq Er EBUSY
|
.It Bq Er EBUSY
|
||||||
|
@ -77,7 +77,7 @@ is
|
|||||||
.Er ENOENT ,
|
.Er ENOENT ,
|
||||||
which is set when
|
which is set when
|
||||||
.Va modid
|
.Va modid
|
||||||
refers to a kernel module that does not exist (isn't loaded).
|
refers to a kernel module that does not exist (is not loaded).
|
||||||
.Sh SEE ALSO
|
.Sh SEE ALSO
|
||||||
.Xr kldfind 2 ,
|
.Xr kldfind 2 ,
|
||||||
.Xr kldfirstmod 2 ,
|
.Xr kldfirstmod 2 ,
|
||||||
|
@ -359,7 +359,7 @@ some process other than the one making the request.
|
|||||||
A request
|
A request
|
||||||
(other than
|
(other than
|
||||||
.Dv PT_ATTACH )
|
.Dv PT_ATTACH )
|
||||||
specified a process that wasn't stopped.
|
specified a process that was not stopped.
|
||||||
.El
|
.El
|
||||||
.It Bq Er EPERM
|
.It Bq Er EPERM
|
||||||
.Bl -bullet -compact
|
.Bl -bullet -compact
|
||||||
@ -367,7 +367,7 @@ specified a process that wasn't stopped.
|
|||||||
A request
|
A request
|
||||||
(other than
|
(other than
|
||||||
.Dv PT_ATTACH )
|
.Dv PT_ATTACH )
|
||||||
attempted to manipulate a process that wasn't being traced at all.
|
attempted to manipulate a process that was not being traced at all.
|
||||||
.It
|
.It
|
||||||
An attempt was made to use
|
An attempt was made to use
|
||||||
.Dv PT_ATTACH
|
.Dv PT_ATTACH
|
||||||
|
@ -107,7 +107,7 @@ The
|
|||||||
system call
|
system call
|
||||||
can be implemented as a call to
|
can be implemented as a call to
|
||||||
.Fn rfork "RFFDG | RFPROC"
|
.Fn rfork "RFFDG | RFPROC"
|
||||||
but isn't for backwards compatibility.
|
but is not for backwards compatibility.
|
||||||
.Sh RETURN VALUES
|
.Sh RETURN VALUES
|
||||||
Upon successful completion,
|
Upon successful completion,
|
||||||
.Fn rfork
|
.Fn rfork
|
||||||
|
@ -220,7 +220,7 @@ function appeared in
|
|||||||
.Sh BUGS
|
.Sh BUGS
|
||||||
Because
|
Because
|
||||||
.Fn sendmsg
|
.Fn sendmsg
|
||||||
doesn't necessarily block until the data has been transferred, it
|
does not necessarily block until the data has been transferred, it
|
||||||
is possible to transfer an open file descriptor across an
|
is possible to transfer an open file descriptor across an
|
||||||
.Dv AF_UNIX
|
.Dv AF_UNIX
|
||||||
domain socket
|
domain socket
|
||||||
|
@ -89,7 +89,7 @@ Be careful, also, to call
|
|||||||
.Xr _exit 2
|
.Xr _exit 2
|
||||||
rather than
|
rather than
|
||||||
.Xr exit 3
|
.Xr exit 3
|
||||||
if you can't
|
if you cannot
|
||||||
.Xr execve 2 ,
|
.Xr execve 2 ,
|
||||||
since
|
since
|
||||||
.Xr exit 3
|
.Xr exit 3
|
||||||
|
@ -191,8 +191,8 @@ Once the device name and unit number
|
|||||||
are determined, a lookup is performed to determine the passthrough device
|
are determined, a lookup is performed to determine the passthrough device
|
||||||
that corresponds to the given device.
|
that corresponds to the given device.
|
||||||
.Fn cam_open_device
|
.Fn cam_open_device
|
||||||
is rather simple to use, but it isn't really suitable for general use
|
is rather simple to use, but it is not really suitable for general use
|
||||||
because its behavior isn't necessarily deterministic.
|
because its behavior is not necessarily deterministic.
|
||||||
Programmers writing
|
Programmers writing
|
||||||
new applications should make the extra effort to use one of the other open
|
new applications should make the extra effort to use one of the other open
|
||||||
routines documented below.
|
routines documented below.
|
||||||
@ -419,10 +419,10 @@ The CAM library first appeared in
|
|||||||
.An Kenneth Merry Aq ken@FreeBSD.org
|
.An Kenneth Merry Aq ken@FreeBSD.org
|
||||||
.Sh BUGS
|
.Sh BUGS
|
||||||
.Fn cam_open_device
|
.Fn cam_open_device
|
||||||
doesn't check to see if the
|
does not check to see if the
|
||||||
.Fa path
|
.Fa path
|
||||||
passed in is a symlink to something.
|
passed in is a symlink to something.
|
||||||
It also doesn't check to see if the
|
It also does not check to see if the
|
||||||
.Fa path
|
.Fa path
|
||||||
passed in is an actual
|
passed in is an actual
|
||||||
.Xr pass 4
|
.Xr pass 4
|
||||||
|
@ -279,7 +279,7 @@ This flag tells the
|
|||||||
.Xr pass 4
|
.Xr pass 4
|
||||||
driver to enable error recovery.
|
driver to enable error recovery.
|
||||||
The default is to not perform error
|
The default is to not perform error
|
||||||
recovery, which means that the retry count won't be honored without this
|
recovery, which means that the retry count will not be honored without this
|
||||||
flag, among other things.
|
flag, among other things.
|
||||||
.It Dv CAM_DATA_PHYS
|
.It Dv CAM_DATA_PHYS
|
||||||
This indicates that the address contained in
|
This indicates that the address contained in
|
||||||
@ -301,7 +301,7 @@ The
|
|||||||
.Fa timeout
|
.Fa timeout
|
||||||
tells the kernel how long to wait for the given command to complete.
|
tells the kernel how long to wait for the given command to complete.
|
||||||
If
|
If
|
||||||
the timeout expires and the command hasn't completed, the CCB will be
|
the timeout expires and the command has not completed, the CCB will be
|
||||||
returned from the kernel with an appropriate error status.
|
returned from the kernel with an appropriate error status.
|
||||||
.Pp
|
.Pp
|
||||||
.Fa cmd_spec
|
.Fa cmd_spec
|
||||||
@ -559,10 +559,10 @@ CCB.
|
|||||||
I discovered this while implementing the arbitrary command execution
|
I discovered this while implementing the arbitrary command execution
|
||||||
code in
|
code in
|
||||||
.Xr camcontrol 8 ,
|
.Xr camcontrol 8 ,
|
||||||
but I haven't yet had time to implement such a function.
|
but I have not yet had time to implement such a function.
|
||||||
.Pp
|
.Pp
|
||||||
Some of the CCB flag descriptions really don't belong here.
|
Some of the CCB flag descriptions really do not belong here.
|
||||||
Rather they
|
Rather they
|
||||||
belong in a generic CCB man page.
|
belong in a generic CCB man page.
|
||||||
Since that man page hasn't yet been
|
Since that man page has not yet been
|
||||||
written, the shorter descriptions here will have to suffice.
|
written, the shorter descriptions here will have to suffice.
|
||||||
|
@ -324,7 +324,7 @@ returns the name strings associated with the specified
|
|||||||
.Ql subtype .
|
.Ql subtype .
|
||||||
If
|
If
|
||||||
.Fn slice_type_name
|
.Fn slice_type_name
|
||||||
returns "unknown" for slices it isn't familiar with.
|
returns "unknown" for slices it is not familiar with.
|
||||||
.Sh AUTHORS
|
.Sh AUTHORS
|
||||||
.An -nosplit
|
.An -nosplit
|
||||||
The
|
The
|
||||||
|
@ -189,7 +189,7 @@ The return value is
|
|||||||
-1 if the command is unknown,
|
-1 if the command is unknown,
|
||||||
0 if there was no error or
|
0 if there was no error or
|
||||||
.Dq prog
|
.Dq prog
|
||||||
didn't match, or
|
did not match, or
|
||||||
1 if the command returned an error.
|
1 if the command returned an error.
|
||||||
Refer to
|
Refer to
|
||||||
.Xr editrc 5
|
.Xr editrc 5
|
||||||
@ -449,7 +449,7 @@ Insert
|
|||||||
into the line at the cursor.
|
into the line at the cursor.
|
||||||
Returns -1 if
|
Returns -1 if
|
||||||
.Fa str
|
.Fa str
|
||||||
is empty or won't fit, and 0 otherwise.
|
is empty or will not fit, and 0 otherwise.
|
||||||
.It Fn el_deletestr
|
.It Fn el_deletestr
|
||||||
Delete
|
Delete
|
||||||
.Fa num
|
.Fa num
|
||||||
|
@ -254,7 +254,7 @@ No sanity checking is done.
|
|||||||
.Xc
|
.Xc
|
||||||
Control which tty modes that
|
Control which tty modes that
|
||||||
.Nm
|
.Nm
|
||||||
won't allow the user to change.
|
will not allow the user to change.
|
||||||
.Fl d ,
|
.Fl d ,
|
||||||
.Fl q
|
.Fl q
|
||||||
or
|
or
|
||||||
|
@ -381,7 +381,7 @@ To register the authentication callback, simply set
|
|||||||
.Va fetchAuthMethod
|
.Va fetchAuthMethod
|
||||||
to point at it.
|
to point at it.
|
||||||
The callback will be used whenever a site requires authentication and
|
The callback will be used whenever a site requires authentication and
|
||||||
the appropriate environment variables aren't set.
|
the appropriate environment variables are not set.
|
||||||
.Pp
|
.Pp
|
||||||
This interface is experimental and may be subject to change.
|
This interface is experimental and may be subject to change.
|
||||||
.Sh RETURN VALUES
|
.Sh RETURN VALUES
|
||||||
|
@ -50,7 +50,7 @@ hash-function, that is, you cannot find (except by exhaustive search)
|
|||||||
the input corresponding to a particular output.
|
the input corresponding to a particular output.
|
||||||
This net result is a
|
This net result is a
|
||||||
.Dq fingerprint
|
.Dq fingerprint
|
||||||
of the input-data, which doesn't disclose the actual input.
|
of the input-data, which does not disclose the actual input.
|
||||||
.Pp
|
.Pp
|
||||||
MD2 is the slowest, MD4 is the fastest and MD5 is somewhere in the middle.
|
MD2 is the slowest, MD4 is the fastest and MD5 is somewhere in the middle.
|
||||||
MD2 can only be used for Privacy-Enhanced Mail.
|
MD2 can only be used for Privacy-Enhanced Mail.
|
||||||
@ -196,7 +196,7 @@ Phk ristede runen.
|
|||||||
.Sh BUGS
|
.Sh BUGS
|
||||||
No method is known to exist which finds two files having the same hash value,
|
No method is known to exist which finds two files having the same hash value,
|
||||||
nor to find a file with a specific hash value.
|
nor to find a file with a specific hash value.
|
||||||
There is on the other hand no guarantee that such a method doesn't exist.
|
There is on the other hand no guarantee that such a method does not exist.
|
||||||
.Pp
|
.Pp
|
||||||
MD2 has only been licensed for use in Privacy Enhanced Mail.
|
MD2 has only been licensed for use in Privacy Enhanced Mail.
|
||||||
Use MD4 or MD5 if that isn't what you're doing.
|
Use MD4 or MD5 if that is not what you're doing.
|
||||||
|
@ -50,7 +50,7 @@ hash function; that is, it is computationally impractical to find
|
|||||||
the input corresponding to a particular output.
|
the input corresponding to a particular output.
|
||||||
This net result is a
|
This net result is a
|
||||||
.Dq fingerprint
|
.Dq fingerprint
|
||||||
of the input-data, which doesn't disclose the actual input.
|
of the input-data, which does not disclose the actual input.
|
||||||
.Pp
|
.Pp
|
||||||
The
|
The
|
||||||
.Fn RIPEMD160_Init ,
|
.Fn RIPEMD160_Init ,
|
||||||
@ -138,4 +138,4 @@ specification.
|
|||||||
.Sh BUGS
|
.Sh BUGS
|
||||||
No method is known to exist which finds two files having the same hash value,
|
No method is known to exist which finds two files having the same hash value,
|
||||||
nor to find a file with a specific hash value.
|
nor to find a file with a specific hash value.
|
||||||
There is on the other hand no guarantee that such a method doesn't exist.
|
There is on the other hand no guarantee that such a method does not exist.
|
||||||
|
@ -74,7 +74,7 @@ the input corresponding to a particular output.
|
|||||||
This net result is
|
This net result is
|
||||||
a
|
a
|
||||||
.Dq fingerprint
|
.Dq fingerprint
|
||||||
of the input-data, which doesn't disclose the actual input.
|
of the input-data, which does not disclose the actual input.
|
||||||
.Pp
|
.Pp
|
||||||
.Tn SHA
|
.Tn SHA
|
||||||
(or
|
(or
|
||||||
@ -169,7 +169,7 @@ standards.
|
|||||||
.Sh BUGS
|
.Sh BUGS
|
||||||
No method is known to exist which finds two files having the same hash value,
|
No method is known to exist which finds two files having the same hash value,
|
||||||
nor to find a file with a specific hash value.
|
nor to find a file with a specific hash value.
|
||||||
There is on the other hand no guarantee that such a method doesn't exist.
|
There is on the other hand no guarantee that such a method does not exist.
|
||||||
.Pp
|
.Pp
|
||||||
The
|
The
|
||||||
.Tn IA32
|
.Tn IA32
|
||||||
|
@ -88,7 +88,7 @@ specifies a NAS identifier to send instead of the hostname.
|
|||||||
specifies a user whose
|
specifies a user whose
|
||||||
.Xr passwd 5
|
.Xr passwd 5
|
||||||
entry will be used as a template to create the session environment
|
entry will be used as a template to create the session environment
|
||||||
if the supplied username doesn't exist in local password database.
|
if the supplied username does not exist in local password database.
|
||||||
The user
|
The user
|
||||||
will be authenticated with the supplied username and password, but his
|
will be authenticated with the supplied username and password, but his
|
||||||
credentials to the system will be presented as the ones for
|
credentials to the system will be presented as the ones for
|
||||||
|
@ -55,7 +55,7 @@ must point to a buffer of at least
|
|||||||
.Ar hsize
|
.Ar hsize
|
||||||
bytes, and will always be written to by this function.
|
bytes, and will always be written to by this function.
|
||||||
.Pp
|
.Pp
|
||||||
If the name resolution doesn't work both ways or if the host name is longer
|
If the name resolution does not work both ways or if the host name is longer
|
||||||
than
|
than
|
||||||
.Ar hsize
|
.Ar hsize
|
||||||
bytes,
|
bytes,
|
||||||
|
@ -84,7 +84,7 @@ must point to a buffer of at least
|
|||||||
.Ar hsize
|
.Ar hsize
|
||||||
bytes, and will always be written to by this function.
|
bytes, and will always be written to by this function.
|
||||||
.Pp
|
.Pp
|
||||||
If the name resolution doesn't work both ways or if the host name is longer
|
If the name resolution does not work both ways or if the host name is longer
|
||||||
than
|
than
|
||||||
.Ar hsize
|
.Ar hsize
|
||||||
bytes,
|
bytes,
|
||||||
|
@ -103,7 +103,7 @@ The lock file could not be read via
|
|||||||
.Xr read 2 .
|
.Xr read 2 .
|
||||||
.Pp
|
.Pp
|
||||||
.Dv UU_LOCK_CREAT_ERR :
|
.Dv UU_LOCK_CREAT_ERR :
|
||||||
Can't create temporary lock file via
|
Cannot create temporary lock file via
|
||||||
.Xr creat 2 .
|
.Xr creat 2 .
|
||||||
.Pp
|
.Pp
|
||||||
.Dv UU_LOCK_WRITE_ERR :
|
.Dv UU_LOCK_WRITE_ERR :
|
||||||
@ -111,7 +111,7 @@ The current process id could not be written to the lock file via a call to
|
|||||||
.Xr write 2 .
|
.Xr write 2 .
|
||||||
.Pp
|
.Pp
|
||||||
.Dv UU_LOCK_LINK_ERR :
|
.Dv UU_LOCK_LINK_ERR :
|
||||||
Can't link temporary lock file via
|
Cannot link temporary lock file via
|
||||||
.Xr link 2 .
|
.Xr link 2 .
|
||||||
.Pp
|
.Pp
|
||||||
.Dv UU_LOCK_TRY_ERR :
|
.Dv UU_LOCK_TRY_ERR :
|
||||||
|
@ -331,7 +331,7 @@ Rather than repeatedly specifying these tags, a full
|
|||||||
specification can be listed for one host entry and shared by others via the
|
specification can be listed for one host entry and shared by others via the
|
||||||
.Em tc
|
.Em tc
|
||||||
(table continuation) mechanism.
|
(table continuation) mechanism.
|
||||||
Often, the template entry is a dummy host which doesn't actually exist and
|
Often, the template entry is a dummy host which does not actually exist and
|
||||||
never sends bootp requests.
|
never sends bootp requests.
|
||||||
This feature is similar to the
|
This feature is similar to the
|
||||||
.Em tc
|
.Em tc
|
||||||
|
@ -106,7 +106,7 @@ Specify the location of the netid information
|
|||||||
file.
|
file.
|
||||||
The compiled-in default is
|
The compiled-in default is
|
||||||
.Pa /etc/netid .
|
.Pa /etc/netid .
|
||||||
Note that no error is generated if the netid database can't be
|
Note that no error is generated if the netid database cannot be
|
||||||
found.
|
found.
|
||||||
The netid database is not likely to be present on most systems
|
The netid database is not likely to be present on most systems
|
||||||
until
|
until
|
||||||
|
@ -219,7 +219,7 @@ for the local user's login class.
|
|||||||
.It Sy Can't make pipe.
|
.It Sy Can't make pipe.
|
||||||
The pipe needed for the
|
The pipe needed for the
|
||||||
.Em stderr ,
|
.Em stderr ,
|
||||||
wasn't created.
|
was not created.
|
||||||
.It Sy Can't fork; try again.
|
.It Sy Can't fork; try again.
|
||||||
A
|
A
|
||||||
.Xr fork 2
|
.Xr fork 2
|
||||||
|
@ -176,7 +176,7 @@ server is registered on the
|
|||||||
.Tn NIS
|
.Tn NIS
|
||||||
master server and attempt to use
|
master server and attempt to use
|
||||||
it if it is present.
|
it if it is present.
|
||||||
If it isn't it will fall back to the standard
|
If it is not it will fall back to the standard
|
||||||
transfer method, copying the map contents from
|
transfer method, copying the map contents from
|
||||||
.Xr ypserv 8
|
.Xr ypserv 8
|
||||||
and creating new maps instead.
|
and creating new maps instead.
|
||||||
|
@ -134,7 +134,7 @@ This form should be invoked from root's
|
|||||||
.Xr crontab 5
|
.Xr crontab 5
|
||||||
every half hour between midnight and 5am, when most modern time
|
every half hour between midnight and 5am, when most modern time
|
||||||
zone changes occur.
|
zone changes occur.
|
||||||
Warning: don't use the
|
Warning: do not use the
|
||||||
.Fl s
|
.Fl s
|
||||||
option in a
|
option in a
|
||||||
.Xr crontab 5
|
.Xr crontab 5
|
||||||
|
@ -51,7 +51,7 @@ makes the pack appear perfect, and such packs can then be copied with
|
|||||||
The technique used by this program is also less general than
|
The technique used by this program is also less general than
|
||||||
bad block forwarding, as
|
bad block forwarding, as
|
||||||
.Nm
|
.Nm
|
||||||
can't make amends for
|
cannot make amends for
|
||||||
bad blocks in the i-list of file systems or in swap areas.
|
bad blocks in the i-list of file systems or in swap areas.
|
||||||
.Pp
|
.Pp
|
||||||
On some disks,
|
On some disks,
|
||||||
|
@ -285,7 +285,7 @@ argument), the given bus (XPT_SCAN_BUS), or bus:target:lun
|
|||||||
The user
|
The user
|
||||||
may specify a scan of all busses, a single bus, or a lun.
|
may specify a scan of all busses, a single bus, or a lun.
|
||||||
Scanning all luns
|
Scanning all luns
|
||||||
on a target isn't supported.
|
on a target is not supported.
|
||||||
.It Ic reset
|
.It Ic reset
|
||||||
Tell the kernel to reset all busses in the system (with the
|
Tell the kernel to reset all busses in the system (with the
|
||||||
.Ar all
|
.Ar all
|
||||||
@ -313,14 +313,14 @@ required.
|
|||||||
Most drives support the physical sector format.
|
Most drives support the physical sector format.
|
||||||
Some drives
|
Some drives
|
||||||
support the logical block format.
|
support the logical block format.
|
||||||
Many drives, if they don't support the
|
Many drives, if they do not support the
|
||||||
requested format, return the data in an alternate format, along with sense
|
requested format, return the data in an alternate format, along with sense
|
||||||
information indicating that the requested data format isn't supported.
|
information indicating that the requested data format is not supported.
|
||||||
The
|
The
|
||||||
.Nm
|
.Nm
|
||||||
utility
|
utility
|
||||||
attempts to detect this, and print out whatever format the drive returns.
|
attempts to detect this, and print out whatever format the drive returns.
|
||||||
If the drive uses a non-standard sense code to report that it doesn't
|
If the drive uses a non-standard sense code to report that it does not
|
||||||
support the requested format,
|
support the requested format,
|
||||||
.Nm
|
.Nm
|
||||||
will probably see the error as a failure to complete the request.
|
will probably see the error as a failure to complete the request.
|
||||||
@ -492,7 +492,7 @@ switch for this
|
|||||||
.Nm
|
.Nm
|
||||||
subcommand is described below.
|
subcommand is described below.
|
||||||
.It Fl q
|
.It Fl q
|
||||||
Be quiet, and don't report the number of tags.
|
Be quiet, and do not report the number of tags.
|
||||||
This is generally used when
|
This is generally used when
|
||||||
setting the number of tags.
|
setting the number of tags.
|
||||||
.It Fl v
|
.It Fl v
|
||||||
@ -566,7 +566,7 @@ The meaning of the
|
|||||||
flag for the
|
flag for the
|
||||||
.Ic negotiate
|
.Ic negotiate
|
||||||
command is described below.
|
command is described below.
|
||||||
Also, some controller drivers don't support
|
Also, some controller drivers do not support
|
||||||
setting negotiation parameters, even if the underlying controller supports
|
setting negotiation parameters, even if the underlying controller supports
|
||||||
negotiation changes.
|
negotiation changes.
|
||||||
Some controllers, such as the Advansys wide
|
Some controllers, such as the Advansys wide
|
||||||
@ -584,9 +584,9 @@ Enable or disable disconnection.
|
|||||||
.It Fl O Ar offset
|
.It Fl O Ar offset
|
||||||
Set the command delay offset.
|
Set the command delay offset.
|
||||||
.It Fl q
|
.It Fl q
|
||||||
Be quiet, don't print anything.
|
Be quiet, do not print anything.
|
||||||
This is generally useful when you want to
|
This is generally useful when you want to
|
||||||
set a parameter, but don't want any status information.
|
set a parameter, but do not want any status information.
|
||||||
.It Fl R Ar syncrate
|
.It Fl R Ar syncrate
|
||||||
Change the synchronization rate for a device.
|
Change the synchronization rate for a device.
|
||||||
The sync rate is a floating
|
The sync rate is a floating
|
||||||
@ -655,7 +655,7 @@ Some hard
|
|||||||
disks will complete a format operation in a very short period of time
|
disks will complete a format operation in a very short period of time
|
||||||
(on the order of 5 minutes or less).
|
(on the order of 5 minutes or less).
|
||||||
This is often because the drive
|
This is often because the drive
|
||||||
doesn't really support the FORMAT UNIT command -- it just accepts the
|
does not really support the FORMAT UNIT command -- it just accepts the
|
||||||
command, waits a few minutes and then returns it.
|
command, waits a few minutes and then returns it.
|
||||||
.Pp
|
.Pp
|
||||||
The
|
The
|
||||||
@ -669,7 +669,7 @@ arguments can be useful for scripts.
|
|||||||
.Pp
|
.Pp
|
||||||
.Bl -tag -width 6n
|
.Bl -tag -width 6n
|
||||||
.It Fl q
|
.It Fl q
|
||||||
Be quiet, don't print any status messages.
|
Be quiet, do not print any status messages.
|
||||||
This option will not disable
|
This option will not disable
|
||||||
the questions, however.
|
the questions, however.
|
||||||
To disable questions, use the
|
To disable questions, use the
|
||||||
@ -697,7 +697,7 @@ will issue a non-immediate format command, and will be unable to print any
|
|||||||
information to let the user know what percentage of the disk has been
|
information to let the user know what percentage of the disk has been
|
||||||
formatted.
|
formatted.
|
||||||
.It Fl y
|
.It Fl y
|
||||||
Don't ask any questions.
|
Do not ask any questions.
|
||||||
By default,
|
By default,
|
||||||
.Nm
|
.Nm
|
||||||
will ask the user if he/she really wants to format the disk in question,
|
will ask the user if he/she really wants to format the disk in question,
|
||||||
@ -853,7 +853,7 @@ in
|
|||||||
.Sh AUTHORS
|
.Sh AUTHORS
|
||||||
.An Kenneth Merry Aq ken@FreeBSD.org
|
.An Kenneth Merry Aq ken@FreeBSD.org
|
||||||
.Sh BUGS
|
.Sh BUGS
|
||||||
The code that parses the generic command line arguments doesn't know that
|
The code that parses the generic command line arguments does not know that
|
||||||
some of the subcommands take multiple arguments.
|
some of the subcommands take multiple arguments.
|
||||||
So if, for instance, you
|
So if, for instance, you
|
||||||
tried something like this:
|
tried something like this:
|
||||||
|
@ -104,7 +104,7 @@ and
|
|||||||
.Xr m4 1 .
|
.Xr m4 1 .
|
||||||
If
|
If
|
||||||
.Ar preproc
|
.Ar preproc
|
||||||
doesn't start with a slash
|
does not start with a slash
|
||||||
.Pq Ql /
|
.Pq Ql /
|
||||||
as its first character, the usual
|
as its first character, the usual
|
||||||
.Ev PATH
|
.Ev PATH
|
||||||
@ -168,7 +168,7 @@ One rule is always present:
|
|||||||
65535 deny all from any to any
|
65535 deny all from any to any
|
||||||
.Ed
|
.Ed
|
||||||
.Pp
|
.Pp
|
||||||
This rule is the default policy, i.e., don't allow anything at all.
|
This rule is the default policy, i.e., do not allow anything at all.
|
||||||
Your job in setting up rules is to modify this policy to match your
|
Your job in setting up rules is to modify this policy to match your
|
||||||
needs.
|
needs.
|
||||||
.Pp
|
.Pp
|
||||||
@ -180,7 +180,7 @@ See also
|
|||||||
.Dq show
|
.Dq show
|
||||||
command.
|
command.
|
||||||
.It Fl f
|
.It Fl f
|
||||||
Don't ask for confirmation for commands that can cause problems if misused
|
Do not ask for confirmation for commands that can cause problems if misused
|
||||||
(ie; flush).
|
(ie; flush).
|
||||||
.Ar Note ,
|
.Ar Note ,
|
||||||
if there is no tty associated with the process, this is implied.
|
if there is no tty associated with the process, this is implied.
|
||||||
@ -497,7 +497,7 @@ Most connections need packets going in both directions.
|
|||||||
Remember to test very carefully.
|
Remember to test very carefully.
|
||||||
It is a good idea to be near the console when doing this.
|
It is a good idea to be near the console when doing this.
|
||||||
.It
|
.It
|
||||||
Don't forget the loopback interface.
|
Do not forget the loopback interface.
|
||||||
.El
|
.El
|
||||||
.Sh FINE POINTS
|
.Sh FINE POINTS
|
||||||
There is one kind of packet that the firewall will always discard,
|
There is one kind of packet that the firewall will always discard,
|
||||||
@ -576,7 +576,7 @@ When
|
|||||||
using it for the first time, work on the console of the computer, and
|
using it for the first time, work on the console of the computer, and
|
||||||
do
|
do
|
||||||
.Em NOT
|
.Em NOT
|
||||||
do anything you don't understand.
|
do anything you do not understand.
|
||||||
.Pp
|
.Pp
|
||||||
When manipulating/adding chain entries, service and protocol names are
|
When manipulating/adding chain entries, service and protocol names are
|
||||||
not accepted.
|
not accepted.
|
||||||
|
@ -230,7 +230,7 @@ While listing, if the
|
|||||||
.Fl d
|
.Fl d
|
||||||
option was specified, also show expired dynamic rules.
|
option was specified, also show expired dynamic rules.
|
||||||
.It Fl f
|
.It Fl f
|
||||||
Don't ask for confirmation for commands that can cause problems
|
Do not ask for confirmation for commands that can cause problems
|
||||||
if misused,
|
if misused,
|
||||||
.No i.e. Cm flush .
|
.No i.e. Cm flush .
|
||||||
If there is no tty associated with the process, this is implied.
|
If there is no tty associated with the process, this is implied.
|
||||||
@ -303,7 +303,7 @@ and
|
|||||||
.Xr m4 1 .
|
.Xr m4 1 .
|
||||||
If
|
If
|
||||||
.Ar preproc
|
.Ar preproc
|
||||||
doesn't start with a slash
|
does not start with a slash
|
||||||
.Pq Ql /
|
.Pq Ql /
|
||||||
as its first character, the usual
|
as its first character, the usual
|
||||||
.Ev PATH
|
.Ev PATH
|
||||||
@ -1771,7 +1771,7 @@ If you cannot be near the console,
|
|||||||
use an auto-recovery script such as the one in
|
use an auto-recovery script such as the one in
|
||||||
.Pa /usr/share/examples/ipfw/change_rules.sh .
|
.Pa /usr/share/examples/ipfw/change_rules.sh .
|
||||||
.It
|
.It
|
||||||
Don't forget the loopback interface.
|
Do not forget the loopback interface.
|
||||||
.El
|
.El
|
||||||
.Sh FINE POINTS
|
.Sh FINE POINTS
|
||||||
.Bl -bullet
|
.Bl -bullet
|
||||||
@ -1827,7 +1827,7 @@ A
|
|||||||
socket bound to the specified port will receive all packets
|
socket bound to the specified port will receive all packets
|
||||||
diverted to that port.
|
diverted to that port.
|
||||||
If no socket is bound to the destination port, or if the divert module is
|
If no socket is bound to the destination port, or if the divert module is
|
||||||
not loaded, or if the kernel wasn't compiled with divert socket support,
|
not loaded, or if the kernel was not compiled with divert socket support,
|
||||||
the packets are dropped.
|
the packets are dropped.
|
||||||
.Sh SYSCTL VARIABLES
|
.Sh SYSCTL VARIABLES
|
||||||
A set of
|
A set of
|
||||||
|
@ -153,7 +153,7 @@ in 2003.
|
|||||||
POSIX device node mapping is currently not supported.
|
POSIX device node mapping is currently not supported.
|
||||||
.Pp
|
.Pp
|
||||||
Version numbers are not stripped if Rockridge extensions are in use.
|
Version numbers are not stripped if Rockridge extensions are in use.
|
||||||
In this case, accessing files that don't have Rockridge names without
|
In this case, accessing files that do not have Rockridge names without
|
||||||
version numbers gets the one with the lowest version number and not
|
version numbers gets the one with the lowest version number and not
|
||||||
the one with the highest.
|
the one with the highest.
|
||||||
.Pp
|
.Pp
|
||||||
|
@ -70,7 +70,7 @@ to determine geometry, if required.
|
|||||||
The options are as follow:
|
The options are as follow:
|
||||||
.Bl -tag -width indent
|
.Bl -tag -width indent
|
||||||
.It Fl N
|
.It Fl N
|
||||||
Don't create a file system: just print out parameters.
|
Do not create a file system: just print out parameters.
|
||||||
.It Fl B Ar boot
|
.It Fl B Ar boot
|
||||||
Get bootstrap from file.
|
Get bootstrap from file.
|
||||||
.It Fl F Ar FAT-type
|
.It Fl F Ar FAT-type
|
||||||
|
@ -54,7 +54,7 @@ on the cisco.
|
|||||||
This is because the tunnel is a point-to-point interface
|
This is because the tunnel is a point-to-point interface
|
||||||
in the
|
in the
|
||||||
.Fx
|
.Fx
|
||||||
end, a concept cisco doesn't really implement.
|
end, a concept cisco does not really implement.
|
||||||
.Pp
|
.Pp
|
||||||
.Ar Protocol number
|
.Ar Protocol number
|
||||||
sets tunnel mode.
|
sets tunnel mode.
|
||||||
@ -89,4 +89,4 @@ wrote the man-page.
|
|||||||
.An Isao SEKI Aq iseki@gongon.com
|
.An Isao SEKI Aq iseki@gongon.com
|
||||||
added a new flag, IP protocol number.
|
added a new flag, IP protocol number.
|
||||||
.Sh BUGS
|
.Sh BUGS
|
||||||
We don't allow for setting our source address for multihomed machines.
|
We do not allow for setting our source address for multihomed machines.
|
||||||
|
@ -506,4 +506,4 @@ operation that may have been interrupted, the temporary files should
|
|||||||
be the same across different processes.
|
be the same across different processes.
|
||||||
In all other cases, the files are unique because it is possible to
|
In all other cases, the files are unique because it is possible to
|
||||||
have two different dumps started at the same time, and separate
|
have two different dumps started at the same time, and separate
|
||||||
operations shouldn't conflict with each other.
|
operations should not conflict with each other.
|
||||||
|
@ -383,7 +383,7 @@ on a directly-connected network.
|
|||||||
The next-hop gateway must be given.
|
The next-hop gateway must be given.
|
||||||
.It "not in table"
|
.It "not in table"
|
||||||
A delete operation was attempted for an entry which
|
A delete operation was attempted for an entry which
|
||||||
wasn't present in the tables.
|
was not present in the tables.
|
||||||
.It "routing table overflow"
|
.It "routing table overflow"
|
||||||
An add operation was attempted, but the system was
|
An add operation was attempted, but the system was
|
||||||
low on resources and was unable to allocate memory
|
low on resources and was unable to allocate memory
|
||||||
|
@ -141,7 +141,7 @@ For CHAP, this will be used to compute the response hash value, based
|
|||||||
on remote's challenge.
|
on remote's challenge.
|
||||||
For PAP, it will be transmitted as plain text
|
For PAP, it will be transmitted as plain text
|
||||||
together with the system name.
|
together with the system name.
|
||||||
Don't forget to quote the secrets from
|
Do not forget to quote the secrets from
|
||||||
the shell if they contain shell metacharacters (or white space).
|
the shell if they contain shell metacharacters (or white space).
|
||||||
.It Va myauthkey Ns Li = Ns Ar secret
|
.It Va myauthkey Ns Li = Ns Ar secret
|
||||||
Same as above.
|
Same as above.
|
||||||
@ -170,7 +170,7 @@ Only meaningful with CHAP.
|
|||||||
Do not re-challenge peer once the initial
|
Do not re-challenge peer once the initial
|
||||||
CHAP handshake was successful.
|
CHAP handshake was successful.
|
||||||
Used to work around broken peer
|
Used to work around broken peer
|
||||||
implementations that can't grok being re-challenged once the
|
implementations that cannot grok being re-challenged once the
|
||||||
connection is up.
|
connection is up.
|
||||||
.It Ar rechallenge
|
.It Ar rechallenge
|
||||||
With CHAP, send re-challenges at random intervals while the connection
|
With CHAP, send re-challenges at random intervals while the connection
|
||||||
|
@ -165,4 +165,4 @@ This utility should work on active file systems.
|
|||||||
.\" Take this out and a Unix Daemon will dog your steps from now until
|
.\" Take this out and a Unix Daemon will dog your steps from now until
|
||||||
.\" the time_t's wrap around.
|
.\" the time_t's wrap around.
|
||||||
.Pp
|
.Pp
|
||||||
You can tune a file system, but you can't tune a fish.
|
You can tune a file system, but you cannot tune a fish.
|
||||||
|
@ -299,7 +299,7 @@ Lock a mutex and block until it becomes available or until the timeout expires.
|
|||||||
.Ft int
|
.Ft int
|
||||||
.Fn pthread_mutex_trylock "pthread_mutex_t *mutex"
|
.Fn pthread_mutex_trylock "pthread_mutex_t *mutex"
|
||||||
.Xc
|
.Xc
|
||||||
Try to lock a mutex, but don't block if the mutex is locked by another thread,
|
Try to lock a mutex, but do not block if the mutex is locked by another thread,
|
||||||
including the current thread.
|
including the current thread.
|
||||||
.It Xo
|
.It Xo
|
||||||
.Ft int
|
.Ft int
|
||||||
|
@ -156,7 +156,7 @@ always be restored to its value on entry to the object.
|
|||||||
.Pp
|
.Pp
|
||||||
This follows from a modularity argument: if the client of an object (or the
|
This follows from a modularity argument: if the client of an object (or the
|
||||||
client of an object that uses that object) has disabled cancelability, it is
|
client of an object that uses that object) has disabled cancelability, it is
|
||||||
because the client doesn't want to have to worry about how to clean up if the
|
because the client does not want to have to worry about how to clean up if the
|
||||||
thread is canceled while executing some sequence of actions.
|
thread is canceled while executing some sequence of actions.
|
||||||
If an object
|
If an object
|
||||||
is called in such a state and it enables cancelability and a cancellation
|
is called in such a state and it enables cancelability and a cancellation
|
||||||
|
@ -80,7 +80,7 @@ A service is unavailable.
|
|||||||
This can occur if a support program or file
|
This can occur if a support program or file
|
||||||
does not exist.
|
does not exist.
|
||||||
This can also be used as a catchall message when
|
This can also be used as a catchall message when
|
||||||
something you wanted to do doesn't work, but you don't know why.
|
something you wanted to do does not work, but you do not know why.
|
||||||
.It Sy EX_SOFTWARE Pq 70
|
.It Sy EX_SOFTWARE Pq 70
|
||||||
An internal software error has been detected.
|
An internal software error has been detected.
|
||||||
This should be limited
|
This should be limited
|
||||||
|
@ -43,7 +43,7 @@ driver also supports a variant of adhoc mode out of spec for DS radio cards,
|
|||||||
which makes it possible to communicate with adhoc mode of
|
which makes it possible to communicate with adhoc mode of
|
||||||
.Xr wi 8
|
.Xr wi 8
|
||||||
driver.
|
driver.
|
||||||
The NWID doesn't affect in this mode.
|
The NWID does not affect in this mode.
|
||||||
.Pp
|
.Pp
|
||||||
For more information on configuring this device, see
|
For more information on configuring this device, see
|
||||||
.Xr ifconfig 8 .
|
.Xr ifconfig 8 .
|
||||||
|
@ -214,7 +214,7 @@ and
|
|||||||
.It Li bs_drop
|
.It Li bs_drop
|
||||||
the number of packets which were accepted by the filter but dropped by the
|
the number of packets which were accepted by the filter but dropped by the
|
||||||
kernel because of buffer overflows
|
kernel because of buffer overflows
|
||||||
(i.e., the application's reads aren't keeping up with the packet traffic).
|
(i.e., the application's reads are not keeping up with the packet traffic).
|
||||||
.El
|
.El
|
||||||
.It Dv BIOCIMMEDIATE
|
.It Dv BIOCIMMEDIATE
|
||||||
.Pq Li u_int
|
.Pq Li u_int
|
||||||
@ -349,7 +349,7 @@ header will be word aligned.
|
|||||||
Suitable precautions
|
Suitable precautions
|
||||||
must be taken when accessing the link layer protocol fields on alignment
|
must be taken when accessing the link layer protocol fields on alignment
|
||||||
restricted machines.
|
restricted machines.
|
||||||
(This isn't a problem on an Ethernet, since
|
(This is not a problem on an Ethernet, since
|
||||||
the type field is a short falling on an even offset,
|
the type field is a short falling on an even offset,
|
||||||
and the addresses are probably accessed in a bytewise fashion).
|
and the addresses are probably accessed in a bytewise fashion).
|
||||||
.Pp
|
.Pp
|
||||||
@ -586,7 +586,7 @@ BPF_RET+BPF_A accept A bytes
|
|||||||
BPF_RET+BPF_K accept k bytes
|
BPF_RET+BPF_K accept k bytes
|
||||||
.Ed
|
.Ed
|
||||||
.It Dv BPF_MISC
|
.It Dv BPF_MISC
|
||||||
The miscellaneous category was created for anything that doesn't
|
The miscellaneous category was created for anything that does not
|
||||||
fit into the above classes, and for any new instructions that might need to
|
fit into the above classes, and for any new instructions that might need to
|
||||||
be added.
|
be added.
|
||||||
Currently, these are the register transfer instructions
|
Currently, these are the register transfer instructions
|
||||||
|
@ -171,11 +171,11 @@ In particular, the initial states for non (POSIX) standard flags
|
|||||||
should be set to suit the devices attached and may need to be
|
should be set to suit the devices attached and may need to be
|
||||||
locked to prevent buggy programs from changing them.
|
locked to prevent buggy programs from changing them.
|
||||||
E.g., CRTSCTS should be locked on for devices that support
|
E.g., CRTSCTS should be locked on for devices that support
|
||||||
RTS/CTS handshaking at all times and off for devices that don't
|
RTS/CTS handshaking at all times and off for devices that do not
|
||||||
support it at all.
|
support it at all.
|
||||||
CLOCAL should be locked on for devices
|
CLOCAL should be locked on for devices
|
||||||
that don't support carrier.
|
that do not support carrier.
|
||||||
HUPCL may be locked off if you don't
|
HUPCL may be locked off if you do not
|
||||||
want to hang up for some reason.
|
want to hang up for some reason.
|
||||||
In general, very bad things happen
|
In general, very bad things happen
|
||||||
if something is locked to the wrong state, and things should not
|
if something is locked to the wrong state, and things should not
|
||||||
|
@ -236,9 +236,9 @@ The default is 6 bytes.
|
|||||||
The
|
The
|
||||||
.Nm
|
.Nm
|
||||||
driver issues a CAM Path Inquiry CCB at probe time to determine whether the
|
driver issues a CAM Path Inquiry CCB at probe time to determine whether the
|
||||||
protocol the device in question speaks (e.g.\& ATAPI) typically doesn't allow
|
protocol the device in question speaks (e.g.\& ATAPI) typically does not allow
|
||||||
6 byte commands.
|
6 byte commands.
|
||||||
If it doesn't, the
|
If it does not, the
|
||||||
.Nm
|
.Nm
|
||||||
driver will default to using at least 10 byte CDBs.
|
driver will default to using at least 10 byte CDBs.
|
||||||
If a 6 byte READ or WRITE fails with an ILLEGAL REQUEST error, the
|
If a 6 byte READ or WRITE fails with an ILLEGAL REQUEST error, the
|
||||||
|
@ -314,7 +314,7 @@ mode when shutting down, and some PCI BIOSes fail to bring the chip
|
|||||||
out of this state before configuring it.
|
out of this state before configuring it.
|
||||||
The controller loses all of
|
The controller loses all of
|
||||||
its PCI configuration in the D3 state, so if the BIOS does not set
|
its PCI configuration in the D3 state, so if the BIOS does not set
|
||||||
it back to full power mode in time, it won't be able to configure it
|
it back to full power mode in time, it will not be able to configure it
|
||||||
correctly.
|
correctly.
|
||||||
The driver tries to detect this condition and bring
|
The driver tries to detect this condition and bring
|
||||||
the adapter back to the D0 (full power) state, but this may not be
|
the adapter back to the D0 (full power) state, but this may not be
|
||||||
|
@ -99,7 +99,7 @@ a hexadecimal format at a prompt.
|
|||||||
Examine and write commands update `dot' to the address of the last line
|
Examine and write commands update `dot' to the address of the last line
|
||||||
examined or the last location modified, and set `next' to the address of
|
examined or the last location modified, and set `next' to the address of
|
||||||
the next location to be examined or changed.
|
the next location to be examined or changed.
|
||||||
Other commands don't change `dot', and set `next' to be the same as `dot'.
|
Other commands do not change `dot', and set `next' to be the same as `dot'.
|
||||||
.Pp
|
.Pp
|
||||||
The general command syntax is:
|
The general command syntax is:
|
||||||
.Cm command Ns Op Li \&/ Ns Ar modifier
|
.Cm command Ns Op Li \&/ Ns Ar modifier
|
||||||
@ -394,8 +394,8 @@ only if the machine dependent code supports it.
|
|||||||
Search memory for
|
Search memory for
|
||||||
.Ar value .
|
.Ar value .
|
||||||
This command might fail in interesting
|
This command might fail in interesting
|
||||||
ways if it doesn't find the searched-for value.
|
ways if it does not find the searched-for value.
|
||||||
This is because ddb doesn't always recover from touching bad memory.
|
This is because ddb does not always recover from touching bad memory.
|
||||||
The optional
|
The optional
|
||||||
.Ar count
|
.Ar count
|
||||||
argument limits the search.
|
argument limits the search.
|
||||||
|
@ -72,7 +72,7 @@ Meaning of
|
|||||||
.It 0x0001
|
.It 0x0001
|
||||||
use alternate pinout (exchange DCD and DSR lines)
|
use alternate pinout (exchange DCD and DSR lines)
|
||||||
.It 0x0002
|
.It 0x0002
|
||||||
don't use 8K window mode of PC/Xe
|
do not use 8K window mode of PC/Xe
|
||||||
.El
|
.El
|
||||||
.Pp
|
.Pp
|
||||||
Device numbering:
|
Device numbering:
|
||||||
@ -100,7 +100,7 @@ Input and output for each line may set to one of following baud rates;
|
|||||||
50, 75, 110, 134.5, 150, 300, 600, 1200, 1800, 2400, 4800, 9600,
|
50, 75, 110, 134.5, 150, 300, 600, 1200, 1800, 2400, 4800, 9600,
|
||||||
19200, 38400, 57600, or for newer versions of cards 115200.
|
19200, 38400, 57600, or for newer versions of cards 115200.
|
||||||
.Pp
|
.Pp
|
||||||
The driver doesn't use any interrupts, it is
|
The driver does not use any interrupts, it is
|
||||||
.Dq polling-based .
|
.Dq polling-based .
|
||||||
This means that
|
This means that
|
||||||
it uses clock interrupts instead of interrupts generated by DigiBoard cards and
|
it uses clock interrupts instead of interrupts generated by DigiBoard cards and
|
||||||
@ -126,7 +126,7 @@ to change the pinout of the interface or to use new PC/Xe cards
|
|||||||
which can work with an 8K memory window in compatibility mode
|
which can work with an 8K memory window in compatibility mode
|
||||||
(with a 64K memory window).
|
(with a 64K memory window).
|
||||||
Note
|
Note
|
||||||
that using 8K memory window doesn't mean shorter input/output buffers, it means
|
that using 8K memory window does not mean shorter input/output buffers, it means
|
||||||
only that all buffers will be mapped to the same memory address and switched as
|
only that all buffers will be mapped to the same memory address and switched as
|
||||||
needed.
|
needed.
|
||||||
.Pp
|
.Pp
|
||||||
@ -237,13 +237,13 @@ locked to prevent buggy programs from changing them.
|
|||||||
E.g.,
|
E.g.,
|
||||||
.Dv CRTSCTS
|
.Dv CRTSCTS
|
||||||
should be locked on for devices that support
|
should be locked on for devices that support
|
||||||
RTS/CTS handshaking at all times and off for devices that don't
|
RTS/CTS handshaking at all times and off for devices that do not
|
||||||
support it at all.
|
support it at all.
|
||||||
.Dv CLOCAL
|
.Dv CLOCAL
|
||||||
should be locked on for devices
|
should be locked on for devices
|
||||||
that don't support carrier.
|
that do not support carrier.
|
||||||
.Dv HUPCL
|
.Dv HUPCL
|
||||||
may be locked off if you don't
|
may be locked off if you do not
|
||||||
want to hang up for some reason.
|
want to hang up for some reason.
|
||||||
In general, very bad things happen
|
In general, very bad things happen
|
||||||
if something is locked to the wrong state, and things should not
|
if something is locked to the wrong state, and things should not
|
||||||
|
@ -176,7 +176,7 @@ could be cleaner, and it's too dependent on
|
|||||||
It's questionable whether incoming fragments should be reassembled
|
It's questionable whether incoming fragments should be reassembled
|
||||||
before being diverted.
|
before being diverted.
|
||||||
For example, if only some fragments of a
|
For example, if only some fragments of a
|
||||||
packet destined for another machine don't get routed through the
|
packet destined for another machine do not get routed through the
|
||||||
local machine, the packet is lost.
|
local machine, the packet is lost.
|
||||||
This should probably be
|
This should probably be
|
||||||
a settable socket option in any case.
|
a settable socket option in any case.
|
||||||
|
@ -87,7 +87,7 @@ lossage).
|
|||||||
Some
|
Some
|
||||||
.No ( non- Ns Fx
|
.No ( non- Ns Fx
|
||||||
:-)) machines have terrible Ethernet performance
|
:-)) machines have terrible Ethernet performance
|
||||||
and simply can't cope with 1100K+ data rates.
|
and simply cannot cope with 1100K+ data rates.
|
||||||
Use of this flag also provides
|
Use of this flag also provides
|
||||||
one more packet worth of receiver buffering, and on 8bit cards, this may help
|
one more packet worth of receiver buffering, and on 8bit cards, this may help
|
||||||
reduce receiver lossage.
|
reduce receiver lossage.
|
||||||
@ -262,7 +262,7 @@ This is most commonly
|
|||||||
caused by a BIOS extension ROM being configured in the same address space as the
|
caused by a BIOS extension ROM being configured in the same address space as the
|
||||||
Ethernet card's shared memory.
|
Ethernet card's shared memory.
|
||||||
Either find the offending card and change its BIOS
|
Either find the offending card and change its BIOS
|
||||||
ROM to be at an address that doesn't conflict, or change the
|
ROM to be at an address that does not conflict, or change the
|
||||||
.Cd iomem
|
.Cd iomem
|
||||||
option in the kernel config file so that the card's shared memory is mapped at a
|
option in the kernel config file so that the card's shared memory is mapped at a
|
||||||
non-conflicting address.
|
non-conflicting address.
|
||||||
@ -279,7 +279,7 @@ the card is defective.
|
|||||||
Indicates a logic problem in the driver.
|
Indicates a logic problem in the driver.
|
||||||
Should never happen.
|
Should never happen.
|
||||||
.It "ed%d: device timeout"
|
.It "ed%d: device timeout"
|
||||||
Indicates that an expected transmitter interrupt didn't occur.
|
Indicates that an expected transmitter interrupt did not occur.
|
||||||
Usually caused by an
|
Usually caused by an
|
||||||
interrupt conflict with another card on the ISA bus.
|
interrupt conflict with another card on the ISA bus.
|
||||||
This condition could also be caused if the kernel is configured for a
|
This condition could also be caused if the kernel is configured for a
|
||||||
|
@ -147,7 +147,7 @@ already has one, or when trying to send a datagram with the destination
|
|||||||
address specified and the socket is already connected;
|
address specified and the socket is already connected;
|
||||||
.It Bq Er ENOTCONN
|
.It Bq Er ENOTCONN
|
||||||
when trying to send a datagram, but
|
when trying to send a datagram, but
|
||||||
no destination address is specified, and the socket hasn't been
|
no destination address is specified, and the socket has not been
|
||||||
connected;
|
connected;
|
||||||
.It Bq Er ENOBUFS
|
.It Bq Er ENOBUFS
|
||||||
when the system runs out of memory for
|
when the system runs out of memory for
|
||||||
|
@ -60,4 +60,4 @@ This device requires IRQ 9 exclusively.
|
|||||||
To use this, you should enable
|
To use this, you should enable
|
||||||
ACPI function in BIOS configuration, or PnP mechanism assigns conflicted
|
ACPI function in BIOS configuration, or PnP mechanism assigns conflicted
|
||||||
IRQ for PnP ISA card.
|
IRQ for PnP ISA card.
|
||||||
And don't use IRQ 9 for Non-PnP ISA cards.
|
And do not use IRQ 9 for Non-PnP ISA cards.
|
||||||
|
@ -564,7 +564,7 @@ already has one, or when trying to send a datagram with the destination
|
|||||||
address specified and the socket is already connected;
|
address specified and the socket is already connected;
|
||||||
.It Bq Er ENOTCONN
|
.It Bq Er ENOTCONN
|
||||||
when trying to send a datagram, but
|
when trying to send a datagram, but
|
||||||
no destination address is specified, and the socket hasn't been
|
no destination address is specified, and the socket has not been
|
||||||
connected;
|
connected;
|
||||||
.It Bq Er ENOBUFS
|
.It Bq Er ENOBUFS
|
||||||
when the system runs out of memory for
|
when the system runs out of memory for
|
||||||
|
@ -611,7 +611,7 @@ already has one or when trying to send a datagram with the destination
|
|||||||
address specified and the socket is already connected.
|
address specified and the socket is already connected.
|
||||||
.It Bq Er ENOTCONN
|
.It Bq Er ENOTCONN
|
||||||
when trying to send a datagram, but
|
when trying to send a datagram, but
|
||||||
no destination address is specified, and the socket hasn't been
|
no destination address is specified, and the socket has not been
|
||||||
connected.
|
connected.
|
||||||
.It Bq Er ENOBUFS
|
.It Bq Er ENOBUFS
|
||||||
when the system runs out of memory for
|
when the system runs out of memory for
|
||||||
|
@ -185,13 +185,13 @@ driver was written by Matthew Jacob for NASA/Ames Research Center.
|
|||||||
.Sh BUGS
|
.Sh BUGS
|
||||||
The driver currently ignores some NVRAM settings.
|
The driver currently ignores some NVRAM settings.
|
||||||
.Pp
|
.Pp
|
||||||
The driver currently doesn't do error recovery for timed out commands
|
The driver currently does not do error recovery for timed out commands
|
||||||
very gracefully.
|
very gracefully.
|
||||||
.Pp
|
.Pp
|
||||||
Target mode support isn't completely debugged yet.
|
Target mode support is not completely debugged yet.
|
||||||
It works reasonably
|
It works reasonably
|
||||||
well for Fibre Channel, somewhat well for Qlogic 1040 cards, but
|
well for Fibre Channel, somewhat well for Qlogic 1040 cards, but
|
||||||
doesn't yet work for the other cards (due to last minute unannounced
|
does not yet work for the other cards (due to last minute unannounced
|
||||||
changes in firmware interfaces).
|
changes in firmware interfaces).
|
||||||
.Pp
|
.Pp
|
||||||
Sometimes, when booting, the driver gets stuck waiting for the
|
Sometimes, when booting, the driver gets stuck waiting for the
|
||||||
|
@ -128,7 +128,7 @@ Many, if not most, of the implementations of APM-bios in laptops
|
|||||||
today are buggy.
|
today are buggy.
|
||||||
You may be putting your LCD-display and batteries at
|
You may be putting your LCD-display and batteries at
|
||||||
a risk by using this interface.
|
a risk by using this interface.
|
||||||
(The reason this isn't a problem for
|
(The reason this is not a problem for
|
||||||
MS-Windows is that they use the real-mode interface.)
|
MS-Windows is that they use the real-mode interface.)
|
||||||
If you see any
|
If you see any
|
||||||
weird behavior from your system with this code in use, unplug the
|
weird behavior from your system with this code in use, unplug the
|
||||||
|
@ -104,7 +104,7 @@ The
|
|||||||
driver assumes the memory it allocates is within the lower 16Mb range.
|
driver assumes the memory it allocates is within the lower 16Mb range.
|
||||||
This is not a very valid assumption but there's nothing that can be done
|
This is not a very valid assumption but there's nothing that can be done
|
||||||
about it yet.
|
about it yet.
|
||||||
For shared memory NICs this isn't relevant.
|
For shared memory NICs this is not relevant.
|
||||||
.It "lnc%d: Device timeout -- Resetting"
|
.It "lnc%d: Device timeout -- Resetting"
|
||||||
The device has stopped responding to the network, or there is a problem with
|
The device has stopped responding to the network, or there is a problem with
|
||||||
the network connection (cable).
|
the network connection (cable).
|
||||||
|
@ -147,7 +147,7 @@ features of the interface board, although it has an interrupt handler
|
|||||||
for any IRQ requests that are generated.
|
for any IRQ requests that are generated.
|
||||||
Until the DMA features are
|
Until the DMA features are
|
||||||
supported, the only interrupts that the board generates are those that
|
supported, the only interrupts that the board generates are those that
|
||||||
aren't supported by the driver anyway.
|
are not supported by the driver anyway.
|
||||||
.Sh SEE ALSO
|
.Sh SEE ALSO
|
||||||
.In sys/cdio.h
|
.In sys/cdio.h
|
||||||
.Sh HISTORY
|
.Sh HISTORY
|
||||||
|
@ -126,7 +126,7 @@ minor = (`unit' << 1) | `non-blocking'
|
|||||||
.Ed
|
.Ed
|
||||||
.Pp
|
.Pp
|
||||||
where `unit' is the device number (usually 0) and the `non-blocking' bit
|
where `unit' is the device number (usually 0) and the `non-blocking' bit
|
||||||
is set to indicate ``don't block waiting for mouse input,
|
is set to indicate ``do not block waiting for mouse input,
|
||||||
return immediately''.
|
return immediately''.
|
||||||
The `non-blocking' bit should be set for \fIXFree86\fP,
|
The `non-blocking' bit should be set for \fIXFree86\fP,
|
||||||
therefore the minor device number usually used for \fIXFree86\fP is 1.
|
therefore the minor device number usually used for \fIXFree86\fP is 1.
|
||||||
@ -307,7 +307,7 @@ and
|
|||||||
are modifiable by the
|
are modifiable by the
|
||||||
.Dv MOUSE_SETMODE
|
.Dv MOUSE_SETMODE
|
||||||
command.
|
command.
|
||||||
Changing the other field doesn't cause error, but has no effect.
|
Changing the other field does not cause error, but has no effect.
|
||||||
.Pp
|
.Pp
|
||||||
.It Dv MOUSE_SETMODE Ar mousemode_t *mode
|
.It Dv MOUSE_SETMODE Ar mousemode_t *mode
|
||||||
The command changes the current operation parameters of the mouse driver
|
The command changes the current operation parameters of the mouse driver
|
||||||
|
@ -381,7 +381,7 @@ memory maps correctly - it works around
|
|||||||
and then throws it all away assuming the card is an
|
and then throws it all away assuming the card is an
|
||||||
.Xr ed 4
|
.Xr ed 4
|
||||||
driver...).
|
driver...).
|
||||||
Note that this could be dangerous (because it doesn't interact with
|
Note that this could be dangerous (because it does not interact with
|
||||||
.Xr pccardd 8 )
|
.Xr pccardd 8 )
|
||||||
if you use other memory mapped cards at the same time or have
|
if you use other memory mapped cards at the same time or have
|
||||||
SCSI cards with on-board BIOS.
|
SCSI cards with on-board BIOS.
|
||||||
|
@ -84,7 +84,7 @@ The
|
|||||||
specification in
|
specification in
|
||||||
.Pa /boot/device.hints
|
.Pa /boot/device.hints
|
||||||
is optional.
|
is optional.
|
||||||
If it isn't specified, the driver will
|
If it is not specified, the driver will
|
||||||
assume the following:
|
assume the following:
|
||||||
.Pp
|
.Pp
|
||||||
.Bl -hang -offset indent
|
.Bl -hang -offset indent
|
||||||
|
@ -14,7 +14,7 @@ ATM software comes with a
|
|||||||
which provides socket level access to AAL0 and AAL5 virtual circuits.
|
which provides socket level access to AAL0 and AAL5 virtual circuits.
|
||||||
To enable this protocol layer, add
|
To enable this protocol layer, add
|
||||||
.Dl options NATM
|
.Dl options NATM
|
||||||
to your kernel configuration file and re-make the kernel (don't forget
|
to your kernel configuration file and re-make the kernel (do not forget
|
||||||
to do
|
to do
|
||||||
.Dq make clean ) .
|
.Dq make clean ) .
|
||||||
.Sh NATM API
|
.Sh NATM API
|
||||||
|
@ -202,7 +202,7 @@ is disabled, over the (single) PPP link.
|
|||||||
Typically when the controlling entity receives an unexpected packet on the
|
Typically when the controlling entity receives an unexpected packet on the
|
||||||
.Dv bypass
|
.Dv bypass
|
||||||
hook it responds either by dropping the frame (if it's not ready for
|
hook it responds either by dropping the frame (if it's not ready for
|
||||||
the protocol) or with an LCP protocol reject (if it doesn't recognize
|
the protocol) or with an LCP protocol reject (if it does not recognize
|
||||||
or expect the protocol).
|
or expect the protocol).
|
||||||
.Sh MULTILINK OPERATION
|
.Sh MULTILINK OPERATION
|
||||||
To enable multi-link PPP, the corresponding configuration flag must be set
|
To enable multi-link PPP, the corresponding configuration flag must be set
|
||||||
|
@ -131,7 +131,7 @@ A device must match all specified fields in order to be returned.
|
|||||||
The match flags are enumerated in the
|
The match flags are enumerated in the
|
||||||
.Va pci_getconf_flags
|
.Va pci_getconf_flags
|
||||||
structure.
|
structure.
|
||||||
Hopefully the flag values are obvious enough that they don't need to
|
Hopefully the flag values are obvious enough that they do not need to
|
||||||
described in detail.
|
described in detail.
|
||||||
.El
|
.El
|
||||||
.It match_buf_len
|
.It match_buf_len
|
||||||
@ -315,11 +315,11 @@ Kenneth Merry, and first appeared in
|
|||||||
.Sh AUTHORS
|
.Sh AUTHORS
|
||||||
.An Kenneth Merry Aq ken@FreeBSD.org
|
.An Kenneth Merry Aq ken@FreeBSD.org
|
||||||
.Sh BUGS
|
.Sh BUGS
|
||||||
It isn't possible for users to specify an accurate offset into the device
|
It is not possible for users to specify an accurate offset into the device
|
||||||
list without calling the
|
list without calling the
|
||||||
.Dv PCIOCGETCONF
|
.Dv PCIOCGETCONF
|
||||||
at least once, since they have no way of knowing the current generation
|
at least once, since they have no way of knowing the current generation
|
||||||
number otherwise.
|
number otherwise.
|
||||||
This probably isn't a serious problem, though, since
|
This probably is not a serious problem, though, since
|
||||||
users can easily narrow their search by specifying a pattern or patterns
|
users can easily narrow their search by specifying a pattern or patterns
|
||||||
for the kernel to match against.
|
for the kernel to match against.
|
||||||
|
@ -248,7 +248,7 @@ characteristics of the standard.
|
|||||||
IEEE1284 interacts with the ppbus system as little as possible.
|
IEEE1284 interacts with the ppbus system as little as possible.
|
||||||
That means
|
That means
|
||||||
you still have to request the ppbus when you want to access it, the negotiate
|
you still have to request the ppbus when you want to access it, the negotiate
|
||||||
function doesn't do it for you.
|
function does not do it for you.
|
||||||
And of course, release it later.
|
And of course, release it later.
|
||||||
.Sh ARCHITECTURE
|
.Sh ARCHITECTURE
|
||||||
.Ss adapter, ppbus and device layers
|
.Ss adapter, ppbus and device layers
|
||||||
|
@ -87,7 +87,7 @@ The PS/2 style pointing device typically supports 10, 20, 40, 60, 80, 100
|
|||||||
and 200 reports per second.
|
and 200 reports per second.
|
||||||
60 or 100 appears to be the default value for many devices.
|
60 or 100 appears to be the default value for many devices.
|
||||||
Note that when there is no movement and no button has changed its state,
|
Note that when there is no movement and no button has changed its state,
|
||||||
the device won't send anything to the host system.
|
the device will not send anything to the host system.
|
||||||
The report rate can be changed via an ioctl call.
|
The report rate can be changed via an ioctl call.
|
||||||
.Ss Operation Levels
|
.Ss Operation Levels
|
||||||
The
|
The
|
||||||
@ -186,7 +186,7 @@ minor = (`unit' << 1) | `non-blocking'
|
|||||||
.Ed
|
.Ed
|
||||||
.Pp
|
.Pp
|
||||||
where `unit' is the device number (usually 0) and the `non-blocking' bit
|
where `unit' is the device number (usually 0) and the `non-blocking' bit
|
||||||
is set to indicate ``don't block waiting for mouse input,
|
is set to indicate ``do not block waiting for mouse input,
|
||||||
return immediately''.
|
return immediately''.
|
||||||
The `non-blocking' bit should be set for \fIXFree86\fP,
|
The `non-blocking' bit should be set for \fIXFree86\fP,
|
||||||
therefore the minor device number usually used for \fIXFree86\fP is 1.
|
therefore the minor device number usually used for \fIXFree86\fP is 1.
|
||||||
@ -293,14 +293,14 @@ driver will not try to identify the model of the pointing device and
|
|||||||
will not carry out model-specific initialization.
|
will not carry out model-specific initialization.
|
||||||
The device should always act like a standard PS/2 mouse without such
|
The device should always act like a standard PS/2 mouse without such
|
||||||
initialization.
|
initialization.
|
||||||
Extra features, such as wheels and additional buttons, won't be
|
Extra features, such as wheels and additional buttons, will not be
|
||||||
recognized by the
|
recognized by the
|
||||||
.Nm
|
.Nm
|
||||||
driver.
|
driver.
|
||||||
.It bit 10 NORESET
|
.It bit 10 NORESET
|
||||||
When this flag is set, the
|
When this flag is set, the
|
||||||
.Nm
|
.Nm
|
||||||
driver won't reset the pointing device when initializing the device.
|
driver will not reset the pointing device when initializing the device.
|
||||||
If the
|
If the
|
||||||
.Fx
|
.Fx
|
||||||
kernel
|
kernel
|
||||||
|
@ -209,7 +209,7 @@ mode when shutting down, and some PCI BIOSes fail to bring the chip
|
|||||||
out of this state before configuring it.
|
out of this state before configuring it.
|
||||||
The controller loses all of
|
The controller loses all of
|
||||||
its PCI configuration in the D3 state, so if the BIOS does not set
|
its PCI configuration in the D3 state, so if the BIOS does not set
|
||||||
it back to full power mode in time, it won't be able to configure it
|
it back to full power mode in time, it will not be able to configure it
|
||||||
correctly.
|
correctly.
|
||||||
The driver tries to detect this condition and bring
|
The driver tries to detect this condition and bring
|
||||||
the adapter back to the D0 (full power) state, but this may not be
|
the adapter back to the D0 (full power) state, but this may not be
|
||||||
|
@ -191,5 +191,5 @@ or in the
|
|||||||
tty layer.
|
tty layer.
|
||||||
.\" (Although my bet is that it's in the higher-level tty layer;
|
.\" (Although my bet is that it's in the higher-level tty layer;
|
||||||
.\" given the bugs I found while writing this driver, it's clear
|
.\" given the bugs I found while writing this driver, it's clear
|
||||||
.\" the BSD software flow control code hasn't been tested very much
|
.\" the BSD software flow control code has not been tested very much
|
||||||
.\" at all! -- TYT)
|
.\" at all! -- TYT)
|
||||||
|
@ -169,7 +169,7 @@ If a rewind is requested after a write, then the driver
|
|||||||
assumes that the last file on the tape has been written, and ensures
|
assumes that the last file on the tape has been written, and ensures
|
||||||
that there are two file marks written to the tape.
|
that there are two file marks written to the tape.
|
||||||
The exception to
|
The exception to
|
||||||
this is that there seems to be a standard (which we follow, but don't
|
this is that there seems to be a standard (which we follow, but do not
|
||||||
understand why) that certain types of tape do not actually write two
|
understand why) that certain types of tape do not actually write two
|
||||||
file marks to tape, but when read, report a `phantom' file mark when the
|
file marks to tape, but when read, report a `phantom' file mark when the
|
||||||
last file is read.
|
last file is read.
|
||||||
@ -235,7 +235,7 @@ Additionally, certain
|
|||||||
tapes (QIC tapes mostly) that were written under
|
tapes (QIC tapes mostly) that were written under
|
||||||
.Fx
|
.Fx
|
||||||
2.X
|
2.X
|
||||||
aren't automatically read correctly with this driver: you may need to
|
are not automatically read correctly with this driver: you may need to
|
||||||
explicitly set variable block mode or set to the blocksize that works best
|
explicitly set variable block mode or set to the blocksize that works best
|
||||||
for your device in order to read tapes written under
|
for your device in order to read tapes written under
|
||||||
.Fx
|
.Fx
|
||||||
|
@ -75,7 +75,7 @@ subsystem:
|
|||||||
.Bl -tag -width SCSI_NO_SENSE_STRINGS
|
.Bl -tag -width SCSI_NO_SENSE_STRINGS
|
||||||
.It Dv CAMDEBUG
|
.It Dv CAMDEBUG
|
||||||
This option enables the CAM debugging printf code.
|
This option enables the CAM debugging printf code.
|
||||||
This won't actually
|
This will not actually
|
||||||
cause any debugging information to be printed out when included by itself.
|
cause any debugging information to be printed out when included by itself.
|
||||||
Enabling printouts requires additional configuration.
|
Enabling printouts requires additional configuration.
|
||||||
See below for details.
|
See below for details.
|
||||||
@ -105,7 +105,7 @@ In most cases, though,
|
|||||||
this should be enabled, since it speeds the interpretation of
|
this should be enabled, since it speeds the interpretation of
|
||||||
.Tn SCSI
|
.Tn SCSI
|
||||||
error messages.
|
error messages.
|
||||||
Don't let the "kernel bloat" zealots get to you -- leave
|
Do not let the "kernel bloat" zealots get to you -- leave
|
||||||
the sense descriptions in your kernel!
|
the sense descriptions in your kernel!
|
||||||
.It Dv SCSI_NO_OP_STRINGS
|
.It Dv SCSI_NO_OP_STRINGS
|
||||||
This disables text descriptions of each
|
This disables text descriptions of each
|
||||||
@ -113,7 +113,7 @@ This disables text descriptions of each
|
|||||||
opcode.
|
opcode.
|
||||||
This option, like the sense string option above, is primarily
|
This option, like the sense string option above, is primarily
|
||||||
useful for environments like a boot floppy where kernel size is critical.
|
useful for environments like a boot floppy where kernel size is critical.
|
||||||
Enabling this option for normal use isn't recommended, since it slows
|
Enabling this option for normal use is not recommended, since it slows
|
||||||
debugging of
|
debugging of
|
||||||
.Tn SCSI
|
.Tn SCSI
|
||||||
problems.
|
problems.
|
||||||
@ -137,7 +137,7 @@ Newer disks
|
|||||||
may need as little as 100ms, while old, slow devices may need much longer.
|
may need as little as 100ms, while old, slow devices may need much longer.
|
||||||
If the
|
If the
|
||||||
.Dv SCSI_DELAY
|
.Dv SCSI_DELAY
|
||||||
isn't specified, it defaults to 2 seconds.
|
is not specified, it defaults to 2 seconds.
|
||||||
The minimum allowable value for
|
The minimum allowable value for
|
||||||
.Dv SCSI_DELAY
|
.Dv SCSI_DELAY
|
||||||
is "100", or 100ms.
|
is "100", or 100ms.
|
||||||
@ -268,10 +268,10 @@ Some of these flags, most notably
|
|||||||
and
|
and
|
||||||
.Dv CAM_DEBUG_SUBTRACE
|
.Dv CAM_DEBUG_SUBTRACE
|
||||||
will produce kernel printfs in EXTREME numbers,
|
will produce kernel printfs in EXTREME numbers,
|
||||||
and because of that, they aren't especially useful.
|
and because of that, they are not especially useful.
|
||||||
There aren't many things logged at the
|
There are not many things logged at the
|
||||||
.Dv CAM_DEBUG_INFO
|
.Dv CAM_DEBUG_INFO
|
||||||
level, so it isn't especially useful.
|
level, so it is not especially useful.
|
||||||
The most useful debugging flag is the
|
The most useful debugging flag is the
|
||||||
.Dv CAM_DEBUG_CDB
|
.Dv CAM_DEBUG_CDB
|
||||||
flag.
|
flag.
|
||||||
|
@ -229,7 +229,7 @@ port.
|
|||||||
The driver supports controller based PCI modems.
|
The driver supports controller based PCI modems.
|
||||||
The 3Com FaxModem PCI and the Advantec 56k Voice Messaging PCI
|
The 3Com FaxModem PCI and the Advantec 56k Voice Messaging PCI
|
||||||
FaxModem are the only cards supported.
|
FaxModem are the only cards supported.
|
||||||
WinModems, softmodems, hfc modems and any other modems that aren't
|
WinModems, softmodems, hfc modems and any other modems that are not
|
||||||
controller based are not supported.
|
controller based are not supported.
|
||||||
.Pp
|
.Pp
|
||||||
The
|
The
|
||||||
@ -330,10 +330,10 @@ In particular, the initial states for non (POSIX) standard flags
|
|||||||
should be set to suit the devices attached and may need to be
|
should be set to suit the devices attached and may need to be
|
||||||
locked to prevent buggy programs from changing them.
|
locked to prevent buggy programs from changing them.
|
||||||
E.g., CRTSCTS should be locked on for devices that support
|
E.g., CRTSCTS should be locked on for devices that support
|
||||||
RTS/CTS handshaking at all times and off for devices that don't
|
RTS/CTS handshaking at all times and off for devices that do not
|
||||||
support it at all.
|
support it at all.
|
||||||
CLOCAL should be locked on for devices that don't support carrier.
|
CLOCAL should be locked on for devices that do not support carrier.
|
||||||
HUPCL may be locked off if you don't
|
HUPCL may be locked off if you do not
|
||||||
want to hang up for some reason.
|
want to hang up for some reason.
|
||||||
In general, very bad things happen
|
In general, very bad things happen
|
||||||
if something is locked to the wrong state, and things should not
|
if something is locked to the wrong state, and things should not
|
||||||
|
@ -78,7 +78,7 @@ signals an
|
|||||||
event (rise of
|
event (rise of
|
||||||
.Dq carrier ) .
|
.Dq carrier ) .
|
||||||
This can be used by lower layers to support
|
This can be used by lower layers to support
|
||||||
a dialin connection where the physical layer isn't available
|
a dialin connection where the physical layer is not available
|
||||||
immediately at startup, but only after some external event arrives.
|
immediately at startup, but only after some external event arrives.
|
||||||
Receipt of a
|
Receipt of a
|
||||||
.Em Down
|
.Em Down
|
||||||
@ -134,7 +134,7 @@ wrong assumptions.
|
|||||||
In a similar spirit the remote address can be set to the magical
|
In a similar spirit the remote address can be set to the magical
|
||||||
value
|
value
|
||||||
.Li 0.0.0. Ns Em *
|
.Li 0.0.0. Ns Em *
|
||||||
which means that we don't care what address the remote
|
which means that we do not care what address the remote
|
||||||
side will use, as long as it is not 0.0.0.0.
|
side will use, as long as it is not 0.0.0.0.
|
||||||
This is useful if your ISP has several dial-in
|
This is useful if your ISP has several dial-in
|
||||||
servers.
|
servers.
|
||||||
@ -227,7 +227,7 @@ for authentication and link quality reporting.
|
|||||||
.Pp
|
.Pp
|
||||||
Negotiation loop avoidance is not fully implemented.
|
Negotiation loop avoidance is not fully implemented.
|
||||||
If the negotiation
|
If the negotiation
|
||||||
doesn't converge, this can cause an endless loop.
|
does not converge, this can cause an endless loop.
|
||||||
.Pp
|
.Pp
|
||||||
The various parameters that should be adjustable per RFC 1661 are
|
The various parameters that should be adjustable per RFC 1661 are
|
||||||
currently hard-coded into the kernel, and should be made accessible
|
currently hard-coded into the kernel, and should be made accessible
|
||||||
|
@ -136,7 +136,7 @@ mode when shutting down, and some PCI BIOSes fail to bring the chip
|
|||||||
out of this state before configuring it.
|
out of this state before configuring it.
|
||||||
The controller loses all of
|
The controller loses all of
|
||||||
its PCI configuration in the D3 state, so if the BIOS does not set
|
its PCI configuration in the D3 state, so if the BIOS does not set
|
||||||
it back to full power mode in time, it won't be able to configure it
|
it back to full power mode in time, it will not be able to configure it
|
||||||
correctly.
|
correctly.
|
||||||
The driver tries to detect this condition and bring
|
The driver tries to detect this condition and bring
|
||||||
the adapter back to the D0 (full power) state, but this may not be
|
the adapter back to the D0 (full power) state, but this may not be
|
||||||
|
Some files were not shown because too many files have changed in this diff Show More
Loading…
Reference in New Issue
Block a user