git-svn-id: svn://svn.h5l.se/heimdal/trunk/heimdal@9470 ec53bebd-3082-4978-b11e-865c3cabbd6b
This commit is contained in:
Assar Westerlund
2001-01-11 16:16:30 +00:00
parent d94120b558
commit 130cb6b3fc
11 changed files with 53 additions and 57 deletions

View File

@@ -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

View File

@@ -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

View File

@@ -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

View File

@@ -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 :

View File

@@ -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

View File

@@ -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

View File

@@ -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

View File

@@ -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

View File

@@ -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

View File

@@ -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

View File

@@ -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