mdoc fixes from ru@freebsd.org
git-svn-id: svn://svn.h5l.se/heimdal/trunk/heimdal@9470 ec53bebd-3082-4978-b11e-865c3cabbd6b
This commit is contained in:
@@ -916,7 +916,7 @@ if verbose is on, when a file transfer completes, statistics
|
|||||||
regarding the efficiency of the transfer are reported.
|
regarding the efficiency of the transfer are reported.
|
||||||
By default,
|
By default,
|
||||||
verbose is on.
|
verbose is on.
|
||||||
.It Ic ? Op Ar command
|
.It Ic \&? Op Ar command
|
||||||
A synonym for help.
|
A synonym for help.
|
||||||
.El
|
.El
|
||||||
.Pp
|
.Pp
|
||||||
|
@@ -81,7 +81,7 @@ but only OTP is allowed.
|
|||||||
.It Ar ftp
|
.It Ar ftp
|
||||||
Allow anonymous login.
|
Allow anonymous login.
|
||||||
.El
|
.El
|
||||||
|
.Pp
|
||||||
The following combination modes exists for backwards compatibility:
|
The following combination modes exists for backwards compatibility:
|
||||||
.Bl -tag -width plain
|
.Bl -tag -width plain
|
||||||
.It Ar none
|
.It Ar none
|
||||||
@@ -319,7 +319,7 @@ that the
|
|||||||
.Dq ftp
|
.Dq ftp
|
||||||
subtree be constructed with care, consider following these guidelines
|
subtree be constructed with care, consider following these guidelines
|
||||||
for anonymous ftp.
|
for anonymous ftp.
|
||||||
|
.Pp
|
||||||
In general all files should be owned by
|
In general all files should be owned by
|
||||||
.Dq root ,
|
.Dq root ,
|
||||||
and have non-write permissions (644 or 755 depending on the kind of
|
and have non-write permissions (644 or 755 depending on the kind of
|
||||||
@@ -377,7 +377,7 @@ and
|
|||||||
.Xr group 5
|
.Xr group 5
|
||||||
files here, ls will be able to produce owner names rather than
|
files here, ls will be able to produce owner names rather than
|
||||||
numbers. Remember to remove any passwords from these files.
|
numbers. Remember to remove any passwords from these files.
|
||||||
|
.Pp
|
||||||
The file
|
The file
|
||||||
.Pa motd ,
|
.Pa motd ,
|
||||||
if present, will be printed after a successful login.
|
if present, will be printed after a successful login.
|
||||||
@@ -388,7 +388,7 @@ here.
|
|||||||
.It Pa ~ftp/pub
|
.It Pa ~ftp/pub
|
||||||
Traditional place to put whatever you want to make public.
|
Traditional place to put whatever you want to make public.
|
||||||
.El
|
.El
|
||||||
|
.Pp
|
||||||
If you want guests to be able to upload files, create a
|
If you want guests to be able to upload files, create a
|
||||||
.Pa ~ftp/incoming
|
.Pa ~ftp/incoming
|
||||||
directory owned by
|
directory owned by
|
||||||
|
@@ -20,7 +20,7 @@ matches any user. Users that has an explicit
|
|||||||
.Dq allow ,
|
.Dq allow ,
|
||||||
or that does not match any line, are allowed access. Anyone else is
|
or that does not match any line, are allowed access. Anyone else is
|
||||||
denied access.
|
denied access.
|
||||||
|
.Pp
|
||||||
Note that this is compatible with the old format, where this file
|
Note that this is compatible with the old format, where this file
|
||||||
contained a list of users that should be denied access.
|
contained a list of users that should be denied access.
|
||||||
.Sh EXAMPLES
|
.Sh EXAMPLES
|
||||||
|
@@ -41,7 +41,6 @@ Port. Listen on the port
|
|||||||
Only usable with
|
Only usable with
|
||||||
.Fl i .
|
.Fl i .
|
||||||
.El
|
.El
|
||||||
|
|
||||||
.Sh EXAMPLES
|
.Sh EXAMPLES
|
||||||
Put the following in
|
Put the following in
|
||||||
.Pa /etc/inetd.conf :
|
.Pa /etc/inetd.conf :
|
||||||
|
@@ -10,7 +10,7 @@ start a telnet and forward X-connections.
|
|||||||
.Sh SYNOPSIS
|
.Sh SYNOPSIS
|
||||||
.Nm rxtelnet
|
.Nm rxtelnet
|
||||||
.Op Fl l Ar username
|
.Op Fl l Ar username
|
||||||
.Op Fl k
|
.Op Fl k
|
||||||
.Op Fl t Ar telnet_args
|
.Op Fl t Ar telnet_args
|
||||||
.Op Fl x Ar xterm_args
|
.Op Fl x Ar xterm_args
|
||||||
.Op Fl w Ar term_emulator
|
.Op Fl w Ar term_emulator
|
||||||
|
@@ -39,6 +39,7 @@ that says ``hex:'' or ``word:'' is included.
|
|||||||
To choose a different
|
To choose a different
|
||||||
.Ar algorithm
|
.Ar algorithm
|
||||||
from the default md5. Pick any of: md4, md5, and sha.
|
from the default md5. Pick any of: md4, md5, and sha.
|
||||||
|
.El
|
||||||
.It Fl h
|
.It Fl h
|
||||||
Print the passwords in hex.
|
Print the passwords in hex.
|
||||||
.It Fl n
|
.It Fl n
|
||||||
|
@@ -40,7 +40,7 @@ can have any of the following formats:
|
|||||||
.It Ql hostname
|
.It Ql hostname
|
||||||
.It Ql po:username
|
.It Ql po:username
|
||||||
.El
|
.El
|
||||||
|
.Pp
|
||||||
If no username is specified,
|
If no username is specified,
|
||||||
.Nm
|
.Nm
|
||||||
assumes that it's the same as on the local machine;
|
assumes that it's the same as on the local machine;
|
||||||
@@ -48,7 +48,7 @@ assumes that it's the same as on the local machine;
|
|||||||
defaults to the value of the
|
defaults to the value of the
|
||||||
.Ev MAILHOST
|
.Ev MAILHOST
|
||||||
environment variable.
|
environment variable.
|
||||||
|
.Pp
|
||||||
Supported options:
|
Supported options:
|
||||||
.Bl -tag -width Ds
|
.Bl -tag -width Ds
|
||||||
.It Xo
|
.It Xo
|
||||||
@@ -93,11 +93,10 @@ use this port instead of the default
|
|||||||
or
|
or
|
||||||
.Ql 1109 .
|
.Ql 1109 .
|
||||||
.El
|
.El
|
||||||
|
.Pp
|
||||||
The default is to first try Kerberos 5 authentication and then, if
|
The default is to first try Kerberos 5 authentication and then, if
|
||||||
that fails, Kerberos 4.
|
that fails, Kerberos 4.
|
||||||
.Sh ENVIRONMENT
|
.Sh ENVIRONMENT
|
||||||
|
|
||||||
.Bl -tag -width Ds
|
.Bl -tag -width Ds
|
||||||
.It Ev MAILHOST
|
.It Ev MAILHOST
|
||||||
points to the post office, if no other hostname is specified.
|
points to the post office, if no other hostname is specified.
|
||||||
@@ -107,7 +106,7 @@ points to the post office, if no other hostname is specified.
|
|||||||
.Bd -literal -offset indent
|
.Bd -literal -offset indent
|
||||||
$ push cornfield:roosta ~/.gnus-crash-box
|
$ push cornfield:roosta ~/.gnus-crash-box
|
||||||
.Ed
|
.Ed
|
||||||
|
.Pp
|
||||||
tries to fetch mail for the user
|
tries to fetch mail for the user
|
||||||
.Ar roosta
|
.Ar roosta
|
||||||
from the post office at
|
from the post office at
|
||||||
@@ -118,7 +117,7 @@ and stores the mail in
|
|||||||
.Bd -literal -offset indent
|
.Bd -literal -offset indent
|
||||||
$ push --from -5 havregryn
|
$ push --from -5 havregryn
|
||||||
.Ed
|
.Ed
|
||||||
|
.Pp
|
||||||
tries to fetch
|
tries to fetch
|
||||||
.Nm From:
|
.Nm From:
|
||||||
lines for current user at post office
|
lines for current user at post office
|
||||||
|
@@ -1251,10 +1251,12 @@ has ever been enabled, then
|
|||||||
is sent as
|
is sent as
|
||||||
.Ic abort ,
|
.Ic abort ,
|
||||||
and
|
and
|
||||||
.Ic eof and
|
.Ic eof
|
||||||
.B suspend
|
and
|
||||||
|
.Ic suspend
|
||||||
are sent as
|
are sent as
|
||||||
.Ic eof and
|
.Ic eof
|
||||||
|
and
|
||||||
.Ic susp ,
|
.Ic susp ,
|
||||||
see
|
see
|
||||||
.Ic send
|
.Ic send
|
||||||
|
@@ -298,7 +298,9 @@ DO TIMING-MARK
|
|||||||
.Ed
|
.Ed
|
||||||
.Pp
|
.Pp
|
||||||
The pseudo-terminal allocated to the client is configured
|
The pseudo-terminal allocated to the client is configured
|
||||||
to operate in \*(lqcooked\*(rq mode, and with
|
to operate in
|
||||||
|
.Dq cooked
|
||||||
|
mode, and with
|
||||||
.Dv XTABS and
|
.Dv XTABS and
|
||||||
.Dv CRMOD
|
.Dv CRMOD
|
||||||
enabled (see
|
enabled (see
|
||||||
|
@@ -11,8 +11,8 @@
|
|||||||
.Nm k_afs_cell_of_file ,
|
.Nm k_afs_cell_of_file ,
|
||||||
.Nm krb_afslog ,
|
.Nm krb_afslog ,
|
||||||
.Nm krb_afslog_uid
|
.Nm krb_afslog_uid
|
||||||
\" .Nm krb5_afslog ,
|
.\" .Nm krb5_afslog ,
|
||||||
\" .Nm krb5_afslog_uid
|
.\" .Nm krb5_afslog_uid
|
||||||
.Nd AFS library
|
.Nd AFS library
|
||||||
.Sh SYNOPSIS
|
.Sh SYNOPSIS
|
||||||
.Fd #include <kafs.h>
|
.Fd #include <kafs.h>
|
||||||
@@ -30,10 +30,10 @@
|
|||||||
.Fn krb_afslog "char *cell" "char *realm"
|
.Fn krb_afslog "char *cell" "char *realm"
|
||||||
.Ft int
|
.Ft int
|
||||||
.Fn krb_afslog_uid "char *cell" "char *realm" "uid_t uid"
|
.Fn krb_afslog_uid "char *cell" "char *realm" "uid_t uid"
|
||||||
\" .Ft krb5_error_code
|
.\" .Ft krb5_error_code
|
||||||
\" .Fn krb5_afslog_uid "krb5_context context" "krb5_ccache id" "const char *cell" "krb5_const_realm realm" "uid_t uid"
|
.\" .Fn krb5_afslog_uid "krb5_context context" "krb5_ccache id" "const char *cell" "krb5_const_realm realm" "uid_t uid"
|
||||||
\" .Ft krb5_error_code
|
.\" .Ft krb5_error_code
|
||||||
\" .Fn krb5_afslog "krb5_context context" "krb5_ccache id" "const char *cell" "krb5_const_realm realm"
|
.\" .Fn krb5_afslog "krb5_context context" "krb5_ccache id" "const char *cell" "krb5_const_realm realm"
|
||||||
.Sh DESCRIPTION
|
.Sh DESCRIPTION
|
||||||
.Fn k_hasafs
|
.Fn k_hasafs
|
||||||
initializes some library internal structures, and tests for the
|
initializes some library internal structures, and tests for the
|
||||||
@@ -41,7 +41,7 @@ presense of AFS in the kernel, none of the other functions should be
|
|||||||
called before
|
called before
|
||||||
.Fn k_hasafs
|
.Fn k_hasafs
|
||||||
is called, or if it fails.
|
is called, or if it fails.
|
||||||
|
.Pp
|
||||||
.Fn krb_afslog ,
|
.Fn krb_afslog ,
|
||||||
and
|
and
|
||||||
.Fn krb_afslog_uid
|
.Fn krb_afslog_uid
|
||||||
@@ -66,22 +66,22 @@ field in the token,
|
|||||||
.Fn krb_afslog_uid
|
.Fn krb_afslog_uid
|
||||||
will use
|
will use
|
||||||
.Fa uid .
|
.Fa uid .
|
||||||
|
.Pp
|
||||||
\" .Fn krb5_afslog ,
|
.\" .Fn krb5_afslog ,
|
||||||
\" and
|
.\" and
|
||||||
\" .Fn krb5_afslog_uid
|
.\" .Fn krb5_afslog_uid
|
||||||
\" are the Kerberos 5 equivalents of
|
.\" are the Kerberos 5 equivalents of
|
||||||
\" .Fn krb_afslog ,
|
.\" .Fn krb_afslog ,
|
||||||
\" and
|
.\" and
|
||||||
\" .Fn krb_afslog_uid .
|
.\" .Fn krb_afslog_uid .
|
||||||
\" The extra arguments are the ubiquitous context, and the cache id where
|
.\" The extra arguments are the ubiquitous context, and the cache id where
|
||||||
\" to store any obtained tickets. Since AFS servers normally can't handle
|
.\" to store any obtained tickets. Since AFS servers normally can't handle
|
||||||
\" Kerberos 5 tickets directly, these functions will first obtain version
|
.\" Kerberos 5 tickets directly, these functions will first obtain version
|
||||||
\" 5 tickets for the requested cells, and then convert them to version 4
|
.\" 5 tickets for the requested cells, and then convert them to version 4
|
||||||
\" tickets, that can be stashed in the kernel. To convert tickets the
|
.\" tickets, that can be stashed in the kernel. To convert tickets the
|
||||||
\" .Fn krb524_convert_creds_kdc
|
.\" .Fn krb524_convert_creds_kdc
|
||||||
\" function will be used.
|
.\" function will be used.
|
||||||
|
.\" .Pp
|
||||||
.Fn k_afs_cell_of_file
|
.Fn k_afs_cell_of_file
|
||||||
will in
|
will in
|
||||||
.Fa cell
|
.Fa cell
|
||||||
@@ -89,23 +89,22 @@ return the cell of a specified file, no more than
|
|||||||
.Fa len
|
.Fa len
|
||||||
characters is put in
|
characters is put in
|
||||||
.Fa cell .
|
.Fa cell .
|
||||||
|
.Pp
|
||||||
.Fn k_pioctl
|
.Fn k_pioctl
|
||||||
does a
|
does a
|
||||||
.Fn pioctl
|
.Fn pioctl
|
||||||
syscall with the specified arguments. This function is equivalent to
|
syscall with the specified arguments. This function is equivalent to
|
||||||
.Fn lpioctl .
|
.Fn lpioctl .
|
||||||
|
.Pp
|
||||||
.Fn k_setpag
|
.Fn k_setpag
|
||||||
initializes a new PAG.
|
initializes a new PAG.
|
||||||
|
.Pp
|
||||||
.Fn k_unlog
|
.Fn k_unlog
|
||||||
removes destroys all tokens in the current PAG.
|
removes destroys all tokens in the current PAG.
|
||||||
|
|
||||||
.Sh ENVIRONMENT
|
.Sh ENVIRONMENT
|
||||||
The following environment variable affect the mode of operation of
|
The following environment variable affect the mode of operation of
|
||||||
.Nm kafs :
|
.Nm kafs :
|
||||||
.Bl -tag
|
.Bl -tag -width AFS_SYSCALL
|
||||||
.It Ev AFS_SYSCALL
|
.It Ev AFS_SYSCALL
|
||||||
Normally,
|
Normally,
|
||||||
.Nm kafs
|
.Nm kafs
|
||||||
|
@@ -9,13 +9,10 @@
|
|||||||
.Nd collect command line options
|
.Nd collect command line options
|
||||||
.Sh SYNOPSIS
|
.Sh SYNOPSIS
|
||||||
.Fd #include <getarg.h>
|
.Fd #include <getarg.h>
|
||||||
|
|
||||||
.Ft int
|
.Ft int
|
||||||
.Fn getarg "struct getargs *args" "size_t num_args" "int argc" "char **argv" "int *optind"
|
.Fn getarg "struct getargs *args" "size_t num_args" "int argc" "char **argv" "int *optind"
|
||||||
|
|
||||||
.Ft void
|
.Ft void
|
||||||
.Fn arg_printusage "struct getargs *args" "size_t num_args" "const char *progname" "const char *extra_string"
|
.Fn arg_printusage "struct getargs *args" "size_t num_args" "const char *progname" "const char *extra_string"
|
||||||
|
|
||||||
.Sh DESCRIPTION
|
.Sh DESCRIPTION
|
||||||
.Fn getarg
|
.Fn getarg
|
||||||
collects any command line options given to a program in an easily used way.
|
collects any command line options given to a program in an easily used way.
|
||||||
@@ -45,7 +42,8 @@ take the same
|
|||||||
and
|
and
|
||||||
.Fa num_args
|
.Fa num_args
|
||||||
as getarg;
|
as getarg;
|
||||||
.Fa progname is the name of the program (to be used in the help text), and
|
.Fa progname
|
||||||
|
is the name of the program (to be used in the help text), and
|
||||||
.Fa extra_string
|
.Fa extra_string
|
||||||
is a string to print after the actual options to indicate more
|
is a string to print after the actual options to indicate more
|
||||||
arguments. The usefulness of this function is realised only be people
|
arguments. The usefulness of this function is realised only be people
|
||||||
@@ -55,7 +53,6 @@ the code does.
|
|||||||
The
|
The
|
||||||
.Fa getargs
|
.Fa getargs
|
||||||
struct has the following elements.
|
struct has the following elements.
|
||||||
|
|
||||||
.Bd -literal
|
.Bd -literal
|
||||||
struct getargs{
|
struct getargs{
|
||||||
const char *long_name;
|
const char *long_name;
|
||||||
@@ -176,7 +173,7 @@ and
|
|||||||
.Fa *optarg ,
|
.Fa *optarg ,
|
||||||
but to do this correct you (more or less) have to know about the inner
|
but to do this correct you (more or less) have to know about the inner
|
||||||
workings of getarg.
|
workings of getarg.
|
||||||
|
.Pp
|
||||||
You can skip parts of arguments by increasing
|
You can skip parts of arguments by increasing
|
||||||
.Fa *optarg
|
.Fa *optarg
|
||||||
(you could
|
(you could
|
||||||
@@ -233,8 +230,6 @@ and if you're really confused you can do it multiple times
|
|||||||
.Pf ( Fl -no-no-help= Ns Ar false ,
|
.Pf ( Fl -no-no-help= Ns Ar false ,
|
||||||
or even
|
or even
|
||||||
.Fl -no-no-help= Ns Ar maybe ) .
|
.Fl -no-no-help= Ns Ar maybe ) .
|
||||||
|
|
||||||
.Pp
|
|
||||||
.Sh EXAMPLE
|
.Sh EXAMPLE
|
||||||
.Bd -literal
|
.Bd -literal
|
||||||
#include <stdio.h>
|
#include <stdio.h>
|
||||||
@@ -276,11 +271,11 @@ main(int argc, char **argv)
|
|||||||
exit (0);
|
exit (0);
|
||||||
}
|
}
|
||||||
if (destination == NULL) {
|
if (destination == NULL) {
|
||||||
fprintf(stderr, "%s: must specify destination\n", progname);
|
fprintf(stderr, "%s: must specify destination\en", progname);
|
||||||
exit(1);
|
exit(1);
|
||||||
}
|
}
|
||||||
if (strcmp(source, destination) == 0) {
|
if (strcmp(source, destination) == 0) {
|
||||||
fprintf(stderr, "%s: destination must be different from source\n");
|
fprintf(stderr, "%s: destination must be different from source\en");
|
||||||
exit(1);
|
exit(1);
|
||||||
}
|
}
|
||||||
/* include more stuff here ... */
|
/* include more stuff here ... */
|
||||||
@@ -298,7 +293,6 @@ Usage: ship++ [--source=city] [-s city] [--destination=city] [-d city]
|
|||||||
-w tons, --weight=tons weight of shippment
|
-w tons, --weight=tons weight of shippment
|
||||||
-c, --no-catalog include product catalog
|
-c, --no-catalog include product catalog
|
||||||
.Ed
|
.Ed
|
||||||
|
|
||||||
.Sh BUGS
|
.Sh BUGS
|
||||||
It should be more flexible, so it would be possible to use other more
|
It should be more flexible, so it would be possible to use other more
|
||||||
complicated option syntaxes, such as what
|
complicated option syntaxes, such as what
|
||||||
|
Reference in New Issue
Block a user