Linux Certif

Toute la documentation sur la certification Linux LPI

globus_gsi_gss_assist_tokens

NAME

Security Token Transport - Token routines using fread and fwrite.

Token Get File Descriptor

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

Token Send File Descriptor

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

Token Send File Descriptor Without Length

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

Token Send File Descriptor Flag EX

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

Token Get Nexus

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

Token Send Nexus

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

Token Send Nexus Without Length

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

Token Send Nexus EX

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

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)

Author

Generated automatically by Doxygen for globus gss assist from the source code.