Main Page   Modules  

Security Token Transport

Token routines using fread and fwrite. More...

Functions


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 Utility Functions and Utility Functions

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 Utility Functions and Utility Functions

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 Utility Functions and Utility Functions

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