PreviousNext

kinit(8sec)

Obtains and caches 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.

-f
Requests 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 principals account in the registry must specify that the principal can be granted forwardable tickets.

-l lifetime
Specifies 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(8sec) command) is used.

-p
Requests 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 principals account in the registry must specify that the principal can be granted proxiable tickets.

-r lifetime
Requests the renewable option. This option allows the tickets issued to the principal to be renewed. For renewable tickets to be granted, the principals 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.

-v
Specifies that the command should run in verbose mode.

Arguments

principal
The 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:

{num {interval}}...

where:

num
A number that specifies the number of the interval; interval can be specified by the following:

w - weeks

d - days

h - hours

m - minutes

s - seconds

For example, to set the lifetime to 3 weeks, 5 days, and 10 hours, the entry would be the following:
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:

klist(8sec)

kdestroy(8sec)