NAME

kinit − Obtains and caches a ticket-granting ticket

SYNOPSIS

kinit [-c cachename] [-f] [-l lifetime] [-p] [-r lifetime] [-v] [principal]

OPTIONS

-c cachename
Specifies an alternative credentials cache, cachename, to be used in place of the default credentials cache.  The kinit command overwrites the contents of the alternative cache with the current credentials.  The name of the default credentials cache may vary between systems. However, if the KRB5CCNAME environment variable is set, its value is used to name the default cache. 

-fRequests the FORWARDABLE option.  This option allows a ticket-granting ticket with a different network address than the present ticket-granting ticket to be issued to the principal.  For forwardable tickets to be granted, the principal’s account in the registry must specify that the principal can be granted forwardable tickets. 

-l lifetimeSpecifies the lifetime of the ticket-granting ticket in hours.  If this option is not specified, the default ticket lifetime (set by each site using the rgy_edit command) is used. 

-pRequests the PROXIABLE option.  This option allows a ticket with a different network address than the present ticket to be issued to the principal.  For proxiable tickets to be granted, the principal’s account in the registry must specify that the principal can be granted proxiable tickets. 

-r lifetimeRequests the RENEWABLE option.  This option allows the tickets issued to the principal to be renewed.  For renewable tickets to be granted, the principal’s account in the registry must specify that the principal can be granted renewable tickets.  The lifetime of the ticket-granting ticket is specified in hours by lifetime. 

-vSpecifies verbose mode. 

ARGUMENTS

principalThe principal argument specifies the name of the principal for whom the ticket-granting ticket should be obtained.  If principal is omitted, the principal name from the existing cache is reused. 

DESCRIPTION

The kinit command can be used to refresh a DCE credentials cache.  When you invoke kinit, it prompts for your password. 

The ticket lifetime and renewable lifetime are specified by concatenating pairs of integers and unit specifiers, as required.  The number of units precedes the unit specifier.  The unit specifiers are as follows:

wWeeks

dDays

hHours

mMinutes

sSeconds

For example, to set the lifetime to 3 weeks, 5 days, and 10 hours, the entry would be as follows:

3w5d10h

FILES

/tmp/krb5cc_unix_id
If the KRB5CCNAME environment variable is not set, the name of the file is in the form shown, where unix_id is the decimal UNIX ID of the user.  If the KRB5CCNAME environment variable is set, its setting determines the name of the file. 

RELATED INFORMATION

Commands: kdestroy(8sec), klist(8sec).