Markup and punctuation nits.
This commit is contained in:
parent
d41aa7462a
commit
362cd31336
Notes:
svn2git
2020-12-20 02:59:44 +00:00
svn path=/head/; revision=130131
@ -30,10 +30,10 @@
|
|||||||
.\" THIS SOFTWARE, EVEN IF WHISTLE COMMUNICATIONS IS ADVISED OF THE POSSIBILITY
|
.\" THIS SOFTWARE, EVEN IF WHISTLE COMMUNICATIONS IS ADVISED OF THE POSSIBILITY
|
||||||
.\" OF SUCH DAMAGE.
|
.\" OF SUCH DAMAGE.
|
||||||
.\"
|
.\"
|
||||||
.\" $FreeBSD$
|
.\" $FreeBSD$
|
||||||
.\" $Whistle: nghook.8,v 1.4 1999/01/20 03:19:45 archie Exp $
|
.\" $Whistle: nghook.8,v 1.4 1999/01/20 03:19:45 archie Exp $
|
||||||
.\"
|
.\"
|
||||||
.Dd January 19, 1999
|
.Dd October 24, 2003
|
||||||
.Dt NGHOOK 8
|
.Dt NGHOOK 8
|
||||||
.Os
|
.Os
|
||||||
.Sh NAME
|
.Sh NAME
|
||||||
@ -43,11 +43,10 @@
|
|||||||
node
|
node
|
||||||
.Sh SYNOPSIS
|
.Sh SYNOPSIS
|
||||||
.Nm
|
.Nm
|
||||||
.Op Fl Sadlns
|
.Op Fl adlnSs
|
||||||
.Op Fl m Ar msg
|
.Op Fl m Ar msg
|
||||||
.Ar path
|
.Ar path
|
||||||
.Op Ar hookname
|
.Op Ar hookname
|
||||||
.Pp
|
|
||||||
.Nm
|
.Nm
|
||||||
.Fl e
|
.Fl e
|
||||||
.Op Fl n
|
.Op Fl n
|
||||||
@ -55,7 +54,7 @@ node
|
|||||||
.Ar path
|
.Ar path
|
||||||
.Ar hookname
|
.Ar hookname
|
||||||
.Ar program
|
.Ar program
|
||||||
.Op Ar args...
|
.Op Ar args ...
|
||||||
.Sh DESCRIPTION
|
.Sh DESCRIPTION
|
||||||
The
|
The
|
||||||
.Nm
|
.Nm
|
||||||
@ -68,14 +67,14 @@ of the node found at
|
|||||||
If
|
If
|
||||||
.Ar hookname
|
.Ar hookname
|
||||||
is omitted,
|
is omitted,
|
||||||
.Dq debug
|
.Dq Li debug
|
||||||
is assumed.
|
is assumed.
|
||||||
.Pp
|
.Pp
|
||||||
If the
|
If the
|
||||||
.Fl e
|
.Fl e
|
||||||
option is given the third argument is interpreted as the path to a program
|
option is given, the third argument is interpreted as the path to a program,
|
||||||
and this program is executed with the remaining arguments as its arguments.
|
and this program is executed with the remaining arguments as its arguments.
|
||||||
Before executing the program netgraph messages (specified by the
|
Before executing, the program Netgraph messages (specified by the
|
||||||
.Fl m
|
.Fl m
|
||||||
option) are sent to the node.
|
option) are sent to the node.
|
||||||
The program is executed with its standard input (unless closed by
|
The program is executed with its standard input (unless closed by
|
||||||
@ -84,11 +83,12 @@ and output connected to the hook.
|
|||||||
.Pp
|
.Pp
|
||||||
If the
|
If the
|
||||||
.Fl e
|
.Fl e
|
||||||
option is not given all data written to standard input is sent
|
option is not given, all data written to standard input is sent
|
||||||
to the node and all data received from the node is relayed
|
to the node, and all data received from the node is relayed
|
||||||
to standard output. Messages specified with
|
to standard output.
|
||||||
|
Messages specified with
|
||||||
.Fl m
|
.Fl m
|
||||||
are send to the node before the loop is entered.
|
are sent to the node before the loop is entered.
|
||||||
The
|
The
|
||||||
.Nm
|
.Nm
|
||||||
utility exits when
|
utility exits when
|
||||||
@ -96,10 +96,7 @@ utility exits when
|
|||||||
is detected on standard input in this case.
|
is detected on standard input in this case.
|
||||||
.Pp
|
.Pp
|
||||||
The options are as follows:
|
The options are as follows:
|
||||||
.Pp
|
|
||||||
.Bl -tag -width indent
|
.Bl -tag -width indent
|
||||||
.It Fl S
|
|
||||||
Use file descriptor 0 for output instead of the default 1.
|
|
||||||
.It Fl a
|
.It Fl a
|
||||||
Output each packet read in human-readable decoded
|
Output each packet read in human-readable decoded
|
||||||
.Tn ASCII
|
.Tn ASCII
|
||||||
@ -117,19 +114,21 @@ Before executing the program (in
|
|||||||
mode) send the given ASCII control message to the node.
|
mode) send the given ASCII control message to the node.
|
||||||
This option may be given more than once.
|
This option may be given more than once.
|
||||||
.It Fl n
|
.It Fl n
|
||||||
Don't attempt to read any data from standard input.
|
Do not attempt to read any data from standard input.
|
||||||
The
|
The
|
||||||
.Nm
|
.Nm
|
||||||
utility will continue reading from the node until stopped by a signal.
|
utility will continue reading from the node until stopped by a signal.
|
||||||
|
.It Fl S
|
||||||
|
Use file descriptor 0 for output instead of the default 1.
|
||||||
.It Fl s
|
.It Fl s
|
||||||
Use file descriptor 1 for input instead of the default 0.
|
Use file descriptor 1 for input instead of the default 0.
|
||||||
.El
|
.El
|
||||||
.Sh BUGS
|
.Sh BUGS
|
||||||
Although all input is read in unbuffered mode,
|
Although all input is read in unbuffered mode,
|
||||||
there's no way to control the packetization of the input.
|
there is no way to control the packetization of the input.
|
||||||
.Pp
|
.Pp
|
||||||
If the node sends a reponse to a message (specified by
|
If the node sends a response to a message (specified by
|
||||||
.Fl m Ns No ),
|
.Fl m ) ,
|
||||||
this response is lost.
|
this response is lost.
|
||||||
.Sh SEE ALSO
|
.Sh SEE ALSO
|
||||||
.Xr netgraph 3 ,
|
.Xr netgraph 3 ,
|
||||||
@ -137,7 +136,7 @@ this response is lost.
|
|||||||
.Xr ngctl 8
|
.Xr ngctl 8
|
||||||
.Sh HISTORY
|
.Sh HISTORY
|
||||||
The
|
The
|
||||||
.Em netgraph
|
.Nm netgraph
|
||||||
system was designed and first implemented at Whistle Communications, Inc.\&
|
system was designed and first implemented at Whistle Communications, Inc.\&
|
||||||
in a version of
|
in a version of
|
||||||
.Fx 2.2
|
.Fx 2.2
|
||||||
|
@ -13,11 +13,9 @@
|
|||||||
.\"
|
.\"
|
||||||
.\" Jordan K. Hubbard
|
.\" Jordan K. Hubbard
|
||||||
.\"
|
.\"
|
||||||
.\"
|
|
||||||
.\" @(#)pkg_add.1
|
|
||||||
.\" $FreeBSD$
|
.\" $FreeBSD$
|
||||||
.\"
|
.\"
|
||||||
.Dd November 25, 1994
|
.Dd March 1, 2004
|
||||||
.Dt PKG_ADD 1
|
.Dt PKG_ADD 1
|
||||||
.Os
|
.Os
|
||||||
.Sh NAME
|
.Sh NAME
|
||||||
@ -72,7 +70,9 @@ The following command line arguments are supported:
|
|||||||
.Bl -tag -width indent
|
.Bl -tag -width indent
|
||||||
.It Ar pkg-name Op Ar pkg-name ...
|
.It Ar pkg-name Op Ar pkg-name ...
|
||||||
The named packages are installed.
|
The named packages are installed.
|
||||||
A package name of - will cause
|
A package name of
|
||||||
|
.Fl
|
||||||
|
will cause
|
||||||
.Nm
|
.Nm
|
||||||
to read from stdin.
|
to read from stdin.
|
||||||
If the packages are not found in the current
|
If the packages are not found in the current
|
||||||
@ -190,7 +190,7 @@ from stdin.
|
|||||||
The complete packing list is also read from stdin,
|
The complete packing list is also read from stdin,
|
||||||
and the contents then acted on as normal.
|
and the contents then acted on as normal.
|
||||||
.It Fl C Ar chrootdir
|
.It Fl C Ar chrootdir
|
||||||
Before doing any operations
|
Before doing any operations,
|
||||||
.Xr chroot 2
|
.Xr chroot 2
|
||||||
to the
|
to the
|
||||||
.Ar chrootdir
|
.Ar chrootdir
|
||||||
@ -201,19 +201,19 @@ Note that
|
|||||||
.Ar chrootdir
|
.Ar chrootdir
|
||||||
needs to be a fairly complete file system, including everything normally
|
needs to be a fairly complete file system, including everything normally
|
||||||
needed by
|
needed by
|
||||||
.Xr pkg_add 8
|
.Nm
|
||||||
to run.
|
to run.
|
||||||
This flag was added to help support operations done by
|
This flag was added to help support operations done by
|
||||||
.Xr sysinstall 8
|
.Xr sysinstall 8
|
||||||
and is not expected to be useful for much else.
|
and is not expected to be useful for much else.
|
||||||
Be careful that
|
Be careful that
|
||||||
.Ar chrootdir
|
.Ar chrootdir
|
||||||
is properly configured and can not be modified by normal users,
|
is properly configured and cannot be modified by normal users,
|
||||||
versions of commands like
|
versions of commands like
|
||||||
.Xr fetch 1
|
.Xr fetch 1
|
||||||
may be run inside
|
may be run inside
|
||||||
.Ar chrootdir
|
.Ar chrootdir
|
||||||
as a side-effect.
|
as a side effect.
|
||||||
.El
|
.El
|
||||||
.Pp
|
.Pp
|
||||||
One or more
|
One or more
|
||||||
|
Loading…
Reference in New Issue
Block a user