src/WINNT/doc/install/Documentation/en_US/html/CmdRef/auarf178.htm

   1 <!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML 3//EN">
   2 <HTML><HEAD>
   3 <TITLE>Administration Reference</TITLE>
   4 <!-- Begin Header Records  ========================================== -->
   5 <!-- /tmp/idwt3190/auarf000.scr converted by idb2h R4.2 (359) ID      -->
   6 <!-- Workbench Version (AIX) on 5 Nov 1999 at 13:58:29                -->
   7 <META HTTP-EQUIV="updated" CONTENT="Fri, 05 Nov 1999 13:58:29">
   8 <META HTTP-EQUIV="review" CONTENT="Sun, 05 Nov 2000 13:58:29">
   9 <META HTTP-EQUIV="expires" CONTENT="Mon, 05 Nov 2001 13:58:29">
  10 </HEAD><BODY>
  11 <!-- (C) IBM Corporation 2000. All Rights Reserved    -->
  12 <BODY bgcolor="ffffff">
  13 <!-- End Header Records  ============================================ -->
  14 <A NAME="Top_Of_Page"></A>
  15 <H1>Administration Reference</H1>
  16 <HR><P ALIGN="center"> <A HREF="../index.htm"><IMG SRC="../books.gif" BORDER="0" ALT="[Return to Library]"></A> <A HREF="auarf002.htm#ToC"><IMG SRC="../toc.gif" BORDER="0" ALT="[Contents]"></A> <A HREF="auarf177.htm"><IMG SRC="../prev.gif" BORDER="0" ALT="[Previous Topic]"></A> <A HREF="#Bot_Of_Page"><IMG SRC="../bot.gif" BORDER="0" ALT="[Bottom of Topic]"></A> <A HREF="auarf179.htm"><IMG SRC="../next.gif" BORDER="0" ALT="[Next Topic]"></A> <A HREF="auarf284.htm#HDRINDEX"><IMG SRC="../index.gif" BORDER="0" ALT="[Index]"></A> <P>
  17 <P>
  18 <H2><A NAME="HDRFTPD" HREF="auarf002.htm#ToC_192">ftpd (AFS version)</A></H2>
  19 <A NAME="IDX5044"></A>
  20 <A NAME="IDX5045"></A>
  21 <A NAME="IDX5046"></A>
  22 <A NAME="IDX5047"></A>
  23 <A NAME="IDX5048"></A>
  24 <P><STRONG>Purpose</STRONG>
  25 <P>Initializes the Internet File Transfer Protocol server
  26 <P><STRONG>Synopsis</STRONG>
  27 <PRE><B>ftpd</B>  [<B>-d</B>]  [<B>-l</B>]  [<B>-t</B> &lt;<VAR>timeout</VAR>>]  [<B>-v</B>]  [<B>-T</B> &lt;<VAR>MaxTimeOut</VAR>>]  [<B>-u</B>]  [<B>-s</B>]
  28 </PRE>
  29 <P><STRONG>Description</STRONG>
  30 <P>The AFS-modified <B>ftpd</B> program functions like the standard UNIX
  31 <B>ftpd</B> program, but also authenticates the issuer of the
  32 <B>ftp</B> command (who is presumably working on a remote machine) with
  33 the Authentication Server in the local cell (the home cell of the machine
  34 where the <B>ftpd</B> process is running, as defined in the local
  35 <B>/usr/vice/etc/ThisCell</B> file). The authentication is based on
  36 the user name and password provided at the <TT>ftp></TT> prompts on the
  37 remote machine. The Cache Manager on the machine running the
  38 <B>ftpd</B> process stores the newly created token, identifying it by
  39 process authentication group (PAG) rather than by the user&#39;s UNIX
  40 UID.
  41 <P>The issuer of the <B>ftp</B> command can be working in a foreign cell,
  42 as long as the user name and password provided are valid in the cell where the
  43 <B>ftpd</B> process is running. If the user name under which the
  44 <B>ftp</B> command is issued does not exist in the Authentication Database
  45 for the cell where the <B>ftpd</B> process is running, or the issuer
  46 provides the wrong password, then the <B>ftpd</B> process logs the user
  47 into the local file system of the machine where the <B>ftpd</B> process is
  48 running. The success of this local login depends on the user name
  49 appearing in the local password file and on the user providing the correct
  50 local password. In the case of a local login, AFS server processes
  51 consider the issuer of the <B>ftp</B> command to be the user
  52 <B>anonymous</B>.
  53 <P>In the recommended configuration, the AFS version of the <B>ftpd</B>
  54 process is substituted for the standard version (only one of the versions can
  55 run at a time). The administrator then has two choices&#58;
  56 <UL>
  57 <P><LI>Name the binary for the AFS version something like
  58 <B>ftpd.afs</B>, leaving the standard version as the
  59 <B>ftpd</B> process. Change the <B>inetd.conf</B>
  60 configuration file to refer to the <B>ftpd.afs</B> file rather than
  61 to the standard version.
  62 <P><LI>Rename the binary for the AFS version to the standard name (such as
  63 <B>ftpd</B>) and rename the binary for the standard version to something
  64 like <B>ftpd.orig</B>. No change to the
  65 <B>inetd.conf</B> file is necessary, but it is not as obvious that
  66 the standard version of the <B>ftpd</B> process is no longer in
  67 use.
  68 </UL>
  69 <P><STRONG>Cautions</STRONG>
  70 <P>The AFS distribution does not include an AFS-modified version of this
  71 command for every system type. On system types that use an integrated
  72 authentication system, it is appropriate instead to control the
  73 <B>ftpd</B> daemon&#39;s handling of AFS authentication through the
  74 integrated system. For example, on system types that use the Pluggable
  75 Authentication Module (PAM), add an <B>ftpd</B> entry that references the
  76 AFS PAM module to the PAM configuration file. For instructions on
  77 incorporating AFS into a machine&#39;s integrated authentication system, see
  78 the <I>AFS Quick Beginnings</I>.
  79 <P>Some system types impose the following requirement. If the issuer of
  80 the <B>ftp</B> command on the remote machine is using a shell other than
  81 <B>/bin/csh</B>, then the <B>/etc/shells</B> file on the local disk of
  82 the machine being accessed (the machine running the <B>ftpd</B> process)
  83 must include an entry for the alternate shell.
  84 <P><STRONG>Options</STRONG>
  85 <DL>
  86 <P><DT><B>-d
  87 </B><DD>Directs debugging information to the system log daemon.
  88 <P><DT><B>-l
  89 </B><DD>Directs each FTP session to be logged to the system log daemon.
  90 <P><DT><B>-t
  91 </B><DD>Specifies a timeout period. By default, the FTP server will timeout
  92 an inactive session after 15 minutes.
  93 <P><DT><B>-v
  94 </B><DD>Same as <B>-d</B>.
  95 <P><DT><B>-T
  96 </B><DD>Specifies a timeout period in seconds. By default, the FTP server
  97 will timeout after 2 hours (7200 seconds).
  98 <P><DT><B>-s
  99 </B><DD>Turns on socket level debugging. Do not use this flag. It is
 100 valid only on an operating system level that AFS does not support.
 101 <P><DT><B>-u
 102 </B><DD>Specifies the default UNIX mode bit file mask to use.
 103 </DL>
 104 <P><STRONG>Privilege Required</STRONG>
 105 <P>See the UNIX manual page for the <B>ftpd</B> process.
 106 <P><STRONG>Related Information</STRONG>
 107 <P>UNIX manual page for <B>ftp</B>
 108 <P>UNIX manual page for <B>ftpd</B>
 109 <P><I>AFS Quick Beginnings</I>
 110 <P>
 111 <HR><P ALIGN="center"> <A HREF="../index.htm"><IMG SRC="../books.gif" BORDER="0" ALT="[Return to Library]"></A> <A HREF="auarf002.htm#ToC"><IMG SRC="../toc.gif" BORDER="0" ALT="[Contents]"></A> <A HREF="auarf177.htm"><IMG SRC="../prev.gif" BORDER="0" ALT="[Previous Topic]"></A> <A HREF="#Top_Of_Page"><IMG SRC="../top.gif" BORDER="0" ALT="[Top of Topic]"></A> <A HREF="auarf179.htm"><IMG SRC="../next.gif" BORDER="0" ALT="[Next Topic]"></A> <A HREF="auarf284.htm#HDRINDEX"><IMG SRC="../index.gif" BORDER="0" ALT="[Index]"></A> <P>
 112 <!-- Begin Footer Records  ========================================== -->
 113 <P><HR><B>
 114 <br>&#169; <A HREF="http://www.ibm.com/">IBM Corporation 2000.</A>  All Rights Reserved
 115 </B>
 116 <!-- End Footer Records  ============================================ -->
 117 <A NAME="Bot_Of_Page"></A>
 118 </BODY></HTML>