Main Page | Modules

Security Token Transport

Token routines using fread and fwrite. More...

Token Get File Descriptor

Token Send File Descriptor

Token Send File Descriptor Without Length

Token Send File Descriptor Flag EX

Token Get Nexus

Token Send Nexus

Token Send Nexus Without Length

Token Send Nexus EX


Detailed Description

Token routines using fread and fwrite.

Additional code has been added to detect tokens which are sent without a length field. These can currently be only SSL tokens. This does require some knowledge of the underlying GSSAPI, by the application, but is within the guidelines of the GSSAPI specifications.

The get routine will automaticly attempt this test, while a new send routine will check a flag. The old send routine will work as before, sending a 4-byte length.


Function Documentation

int globus_gss_assist_token_get_fd void *  arg,
void **  bufp,
size_t *  sizep
 

Use a open file discriptor to get a token.

This function provides parameter types that allow it to be passed to globus_gss_assist_init_sec_context and globus_gss_assist_accept_sec_context

Parameters:
arg the FILE * stream cast to a void pointer
bufp the resulting token
sizep the size (number of bytes) read into bufp
Returns:
0 on success > 0 is internal return < 0 is the -errno

int globus_gss_assist_token_send_fd void *  arg,
void *  buf,
size_t  size
 

Write a token to the open file descriptor.

WIll write it with a 4 byte length. This function provides parameter types that allow it to be passed to globus_gss_assist_init_sec_context and globus_gss_assist_accept_sec_context

Parameters:
arg the FILE * stream to send the token on
buf the token
size the size of the token in bytes
Returns:
0 on success >0 on error <0 on errno error

int globus_gss_assist_token_send_fd_without_length void *  arg,
void *  buf,
size_t  size
 

Write a token to the open file descripter.

Will write it without a length. so as to

int globus_gss_assist_token_send_fd_ex void *  exp,
void *  buf,
size_t  size
 

Write a token to the open file descripter.

will look at the flag to determine if the length field need to be written.

Parameters:
exp the globus_gss_assist_ex variable that holds the FILE * stream and flags to bet set
buf the token buffer to send
size size of the token buffer
Returns:
0 on success >0 on error <0 on errno error (-errno)

int globus_gss_assist_token_get_nexus void *  arg,
void **  bufp,
size_t *  sizep
 

Use a nexus socket to get the tokens

Additional code has been added to detect tokens which are sent without a length field.

These can currently be only SSL tokens. This does require some knowledge of the underlying GSSAPI, by the application, but is within the guidelines of the GSSAPI specifications.

The get routine will automaticly attempt this test, while a new send routine will check a flag. The old send routine will work as before, sending a 4-byte length.

Parameters:
arg the globus_io_handle_t to get the token from
bufp the buffer to read the token into
sizep the size of what gets read
Returns:
0 on success > 0 is internal return < 0 is the -errno returned from nexus

int globus_gss_assist_token_send_nexus void *  arg,
void *  buf,
size_t  size
 

Write a token to the nexus io handle.

This function provides parameter types that allow it to be passed to globus_gss_assist_init_sec_context and globus_gss_assist_accept_sec_context

Parameters:
arg nexus io handle to send the token on
buf the token as a buffer
size the size of the buffer
Returns:
0 on success >0 on error <0 on errno error (-errno)

int globus_gss_assist_token_send_nexus_without_length void *  arg,
void *  buf,
size_t  size
 

Send a token on a nexus IO handle.

Using this function the length is not sent.

See also:
globus_gss_assist_token_get_nexus() for further info.

int globus_gss_assist_token_send_nexus_ex void *  exp,
void *  buf,
size_t  size
 

Write a token to the open file descripter.

will look at the flag to determine if the length field need to be written.

Parameters:
exp The globus_gss_assist_ex that the wraps the nexus IO handle to send the token on
buf the buffer holding the token
size the size of the buffer
Returns:
0 on success >0 on error <0 on errno error (-errno)


about globus | globus toolkit | dev.globus

Comments? webmaster@globus.org