.\" Automatically generated by Pod::Man 4.09 (Pod::Simple 3.35) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .if !\nF .nr F 0 .if \nF>0 \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} .\} .\" .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). .\" Fear. Run. Save yourself. No user-serviceable parts. . \" fudge factors for nroff and troff .if n \{\ . ds #H 0 . ds #V .8m . ds #F .3m . ds #[ \f1 . ds #] \fP .\} .if t \{\ . ds #H ((1u-(\\\\n(.fu%2u))*.13m) . ds #V .6m . ds #F 0 . ds #[ \& . ds #] \& .\} . \" simple accents for nroff and troff .if n \{\ . ds ' \& . ds ` \& . ds ^ \& . ds , \& . ds ~ ~ . ds / .\} .if t \{\ . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' .\} . \" troff and (daisy-wheel) nroff accents .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' .ds 8 \h'\*(#H'\(*b\h'-\*(#H' .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] .ds ae a\h'-(\w'a'u*4/10)'e .ds Ae A\h'-(\w'A'u*4/10)'E . \" corrections for vroff .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' . \" for low resolution devices (crt and lpr) .if \n(.H>23 .if \n(.V>19 \ \{\ . ds : e . ds 8 ss . ds o a . ds d- d\h'-1'\(ga . ds D- D\h'-1'\(hy . ds th \o'bp' . ds Th \o'LP' . ds ae ae . ds Ae AE .\} .rm #[ #] #H #V #F C .\" ======================================================================== .\" .IX Title "KAS_INTERACTIVE 8" .TH KAS_INTERACTIVE 8 "2017-12-15" "OpenAFS" "AFS Command Reference" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NAME" kas_interactive \- Enters interactive mode .SH "SYNOPSIS" .IX Header "SYNOPSIS" \&\fBkas interactive\fR [\fB\-admin_username\fR\ <\fIadmin\ principal\ to\ use\ for\ authentication\fR>] [\fB\-password_for_admin\fR\ <\fIadmin\ password\fR>] [\fB\-cell\fR\ <\fIcell\ name\fR>] [\fB\-servers\fR\ <\fIexplicit\ list\ of\ authentication\ servers\fR>+] [\fB\-noauth\fR] [\fB\-help\fR] .PP \&\fBkas i\fR [\fB\-a\fR\ <\fIadmin\ principal\ to\ use\ for\ authentication\fR>] [\fB\-p\fR\ <\fIadmin\ password\fR>] [\fB\-c\fR\ <\fIcell\ name\fR>] [\fB\-s\fR\ <\fIexplicit\ list\ of\ authentication\ servers\fR>+] [\fB\-n\fR] [\fB\-h\fR] .SH "DESCRIPTION" .IX Header "DESCRIPTION" The \fBkas interactive\fR command establishes an interactive session for the issuer of the command. By default, the command interpreter establishes an authenticated connection for the user logged into the local file system with all of the Authentication Servers listed in the local \&\fI/etc/openafs/CellServDB\fR file for the cell named in the local \&\fI/etc/openafs/ThisCell\fR file. To specify an alternate identity, cell name, or list of Authentication Servers, include the \fB\-admin_username\fR, \&\fB\-cell\fR, or \fB\-servers\fR arguments respectively. Interactive mode lasts for six hours unless the maximum ticket lifetime for the issuer or the Authentication Server's Ticket Granting Service is shorter. .PP There are two other ways to enter interactive mode, in addition to the \&\fBkas interactive\fR command: .IP "\(bu" 4 Type the kas command at the shell prompt without any operation code. If appropriate, include one or more of the \fB\-admin_username\fR, \&\fB\-password_for_admin\fR, \fB\-cell\fR, and \fB\-servers\fR arguments. .IP "\(bu" 4 Type the kas command followed by a user name and cell name, separated by an \f(CW\*(C`@\*(C'\fR sign (for example: \fBkas admin@abc.com\fR), to establish a connection under the specified identity with the Authentication Servers listed in the local \fI/etc/openafs/CellServDB\fR file for the indicated cell. If appropriate, provide the \fB\-servers\fR argument to specify an alternate list of Authentication Server machines that belong to the indicated cell. .PP There are several consequences of entering interactive mode: .IP "\(bu" 4 The \f(CW\*(C`ka>\*(C'\fR prompt replaces the system (shell) prompt. When typing commands at this prompt, provide only the operation code (omit the command suite name, \fBkas\fR). .IP "\(bu" 4 The command interpreter does not prompt for the issuer's password. .Sp The issuer's identity and password, the relevant cell, and the set of Authentication Server machines specified when entering interactive mode apply to all commands issued during the session. They cannot be changed without leaving the session, except by using the \fBkas noauthentication\fR command to replace the current authenticated connections with unauthenticated ones. The \fB\-admin_username\fR, \fB\-password_for_admin\fR, \&\fB\-cell\fR, and \fB\-servers\fR arguments are ignored if provided on a command issued during interactive mode. .PP To establish an unauthenticated connection to the Authentication Server, include the \fB\-noauth\fR flag or provide an incorrect password. Unless authorization checking is disabled on each Authentication Server machine involved, however, it is not possible to perform any privileged operations within such a session. .PP To end the current authenticated connection and establish an unauthenticated one, issue the \fBkas noauthentication\fR command. To leave interactive mode and return to the regular shell prompt, issue the \fBkas quit\fR command. .SH "OPTIONS" .IX Header "OPTIONS" .IP "\fB\-admin_username\fR <\fIadmin principal\fR>" 4 .IX Item "-admin_username " Specifies the user identity under which to authenticate with the Authentication Server for execution of the command. For more details, see \&\fIkas\fR\|(8). .IP "\fB\-password_for_admin\fR <\fIadmin password\fR>" 4 .IX Item "-password_for_admin " Specifies the password of the command's issuer. If it is omitted (as recommended), the \fBkas\fR command interpreter prompts for it and does not echo it visibly. For more details, see \fIkas\fR\|(8). .IP "\fB\-cell\fR <\fIcell name\fR>" 4 .IX Item "-cell " Names the cell in which to run the command. For more details, see \&\fIkas\fR\|(8). .IP "\fB\-servers\fR <\fIauthentication servers\fR>+" 4 .IX Item "-servers +" Names each machine running an Authentication Server with which to establish a connection. For more details, see \fIkas\fR\|(8). .IP "\fB\-noauth\fR" 4 .IX Item "-noauth" Assigns the unprivileged identity \f(CW\*(C`anonymous\*(C'\fR to the issuer. For more details, see \fIkas\fR\|(8). .IP "\fB\-help\fR" 4 .IX Item "-help" Prints the online help for this command. All other valid options are ignored. .SH "EXAMPLES" .IX Header "EXAMPLES" The following example shows a user entering interactive mode as the privileged user \f(CW\*(C`admin\*(C'\fR. .PP .Vb 3 \& % kas interactive admin \& Password for admin: I \& ka> .Ve .SH "PRIVILEGE REQUIRED" .IX Header "PRIVILEGE REQUIRED" None .SH "SEE ALSO" .IX Header "SEE ALSO" \&\fIkas\fR\|(8), \&\fIkas_noauthentication\fR\|(8), \&\fIkas_quit\fR\|(8) .SH "COPYRIGHT" .IX Header "COPYRIGHT" \&\s-1IBM\s0 Corporation 2000. All Rights Reserved. .PP This documentation is covered by the \s-1IBM\s0 Public License Version 1.0. It was converted from \s-1HTML\s0 to \s-1POD\s0 by software written by Chas Williams and Russ Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.