SYNOPSIS

       kinit  [-5] [-4] [-V] [-l lifetime] [-s start_time] [-r renewable_life]
              [-p | -P] [-f | -F] [-a] [-A] [-v] [-R] [-k [-t keytab_file]]
              [-c cache_name] [-S service_name] [principal]


DESCRIPTION

       kinit  obtains and caches an initial ticket-granting ticket for princi-
       pal.Thetypicaldefaultbehavioristoacquireonly Kerberos 5 tickets.   How-
       ever,  if  kinit  was  built  with both Kerberos 4 support and with the
       default behavior of acquiring both types of tickets,  it  will  try  to
       acquire  both  Kerberos 5 and Kerberos 4 by default.  Any documentation
       particular to Kerberos 4 does not apply if Kerberos 4 support  was  not
       built into kinit.


OPTIONS

       -5     get  Kerberos  5  tickets.   This overrides whatever the default
              built-in behavior may be.  This option may be used with -4

       -4     get Kerberos 4 tickets.  This  overrides  whatever  the  default
              built-in  behavior  may  be.   This  option is only available if
              kinit was built with Kerberos 4 compatibility.  This option  may
              be used with -5

       -V     display verbose output.

       -l lifetime
              requests  a  ticket  with  the lifetime lifetime.  The value for
              lifetime must be followed immediately by one  of  the  following
              delimiters:

                 s  seconds
                 m  minutes
                 h  hours
                 d  days

              as  in "kinit -l 90m".  You cannot mix units; a value of `3h30m'
              will result in an error.

              If the -l option is not specified, the default  ticket  lifetime
              (configured by each site) is used.  Specifying a ticket lifetime
              longer than the maximum  ticket  lifetime  (configured  by  each
              site) results in a ticket with the maximum lifetime.

       -s start_time
              requests  a  postdated  ticket,  valid  starting  at start_time.
              Postdated tickets are issued with the invalid flag set, and need
              to  be  fed back to the kdc before use.  (Not applicable to Ker-
              beros 4.)

       -r renewable_life
              requests renewable tickets, with  a  total  lifetime  of  renew-
              able_life.  The duration is in the same format as the -l option,

       -A     request address-less tickets.  (Not applicable to Kerberos 4.)

       -v     requests  that the ticket granting ticket in the cache (with the
              invalid flag set) be passed to the kdc for validation.   If  the
              ticket is within its requested time range, the cache is replaced
              with the validated ticket.  (Not applicable to Kerberos 4.)

       -R     requests renewal of the ticket-granting ticket.   Note  that  an
              expired  ticket  cannot  be renewed, even if the ticket is still
              within its renewable life.  When using this option with Kerberos
              4,  the kdc must support Kerberos 5 to Kerberos 4 ticket conver-
              sion.

       -k [-t keytab_file]
              requests a host ticket, obtained from a key in the local  host's
              keytab  file.   The  name and location of the keytab file may be
              specified with the -t keytab_file option; otherwise the  default
              name  and  location  will  be used.  When using this option with
              Kerberos 4, the kdc must support Kerberos 5 to Kerberos 4 ticket
              conversion.

       -c cache_name
              use cache_name as the Kerberos 5 credentials (ticket) cache name
              and location; if this option is not used, the default cache name
              and location are used.

              The  default credentials cache may vary between systems.  If the
              KRB5CCNAME environment variable is set, its  value  is  used  to
              name  the  default  ticket  cache.  Any existing contents of the
              cache are destroyed by kinit.  (Note: The default name for  Ker-
              beros  4  comes  from  the KRBTKFILE environment variable.  This
              option does not apply to Kerberos 4.)

       -S service_name
              specify an alternate service name to use  when  getting  initial
              tickets.   (Applicable to Kerberos 5 or if using both Kerberos 5
              and Kerberos 4 with a kdc that supports Kerberos 5 to Kerberos 4
              ticket conversion.)


ENVIRONMENT

       Kinit uses the following environment variables:

       KRB5CCNAME      Location  of the Kerberos 5 credentials (ticket) cache.

       KRBTKFILE      Filename of the Kerberos 4 credentials (ticket) cache.


FILES

       /tmp/krb5cc_[uid]  default location of  Kerberos  5  credentials  cache
                          ([uid] is the decimal UID of the user).

       /tmp/tkt[uid]  default  location of Kerberos 4 credentials cache ([uid]

Man(1) output converted with man2html