76 lines
		
	
	
		
			1.5 KiB
		
	
	
	
		
			Groff
		
	
	
	
	
	
			
		
		
	
	
			76 lines
		
	
	
		
			1.5 KiB
		
	
	
	
		
			Groff
		
	
	
	
	
	
.\"
 | 
						|
.\"
 | 
						|
.Dd May 12, 2014
 | 
						|
.Os
 | 
						|
.Dt GSS-TOKEN 1
 | 
						|
.Sh NAME
 | 
						|
.Nm gss-token
 | 
						|
.Nd generate and consume base64 GSS tokens
 | 
						|
.Sh SYNOPSIS
 | 
						|
.Nm
 | 
						|
.Op Fl DNn
 | 
						|
.Op Fl c count
 | 
						|
.Ar service@host
 | 
						|
.Nm
 | 
						|
.Fl r
 | 
						|
.Op Fl MNln
 | 
						|
.Op Fl C Ar ccache
 | 
						|
.Op Fl c count
 | 
						|
.Op Ar service@host
 | 
						|
.Sh DESCRIPTION
 | 
						|
.Nm
 | 
						|
generates and consumes base64 encoded GSS tokens.
 | 
						|
It is mostly useful for testing.
 | 
						|
.Pp
 | 
						|
.Nm
 | 
						|
supports the following options:
 | 
						|
.Bl -tag -width indentxxxx
 | 
						|
.It Fl C Ar ccache
 | 
						|
write an accepted delegated credential into
 | 
						|
.Ar ccache .
 | 
						|
This only makes sense if
 | 
						|
.Fl r
 | 
						|
is specified.
 | 
						|
.It Fl D
 | 
						|
delegate credentials.
 | 
						|
This only makes sense as a client, that is when
 | 
						|
.Fl r
 | 
						|
is not specified.
 | 
						|
.It Fl M
 | 
						|
copy the default ccache to a MEMORY: ccache before each
 | 
						|
separate write operation.
 | 
						|
The default ccache will not pick up any obtained service
 | 
						|
tickets.
 | 
						|
If specified with
 | 
						|
.Fl c ,
 | 
						|
the cache will revert to its original state before each
 | 
						|
new token is written.
 | 
						|
This can be used to load test the KDC.
 | 
						|
.It Fl N
 | 
						|
prepend
 | 
						|
.Dq Negotiate\ 
 | 
						|
to generated tokens and expect it on consumed tokens.
 | 
						|
.It Fl c Ar count
 | 
						|
repeat the operation
 | 
						|
.Ar count
 | 
						|
times.
 | 
						|
This is good for very basic benchmarking.
 | 
						|
.It Fl l
 | 
						|
loop infinitely in read mode.
 | 
						|
This is to support a multiple round trip GSS mechanism.
 | 
						|
.It Fl n
 | 
						|
do not output the generated token.
 | 
						|
.It Fl r
 | 
						|
read a token rather than generate a token.
 | 
						|
.El
 | 
						|
.Pp
 | 
						|
.Nm
 | 
						|
takes one argument, a
 | 
						|
.Ar host@service
 | 
						|
specifier.
 | 
						|
The argument is required when generating a token but is optional if
 | 
						|
consuming (reading) a token.
 | 
						|
.Sh SEE ALSO
 | 
						|
.Xr gssapi 3 ,
 | 
						|
.Xr kerberos 8 .
 |