HP-UX Reference (11i v3 07/02) - 3 Library Functions N-Z (vol 7)

ManualsBrandsHP ManualsSoftwareHP-UX Reference Manuals

331

332

333

334

335

336

337

338

339

340

rpc_gss_set_defaults(3N) rpc_gss_set_defaults(3N)

NAME

rpc_gss_set_defaults - change service, QOP for a session

SYNOPSIS

#include <rpc/rpcsec_gss.h>

bool_t rpc_gss_set_defaults(

AUTH *

auth,

rpc_gss_service_t

service,

char *

qop);

DESCRIPTION

rpc_gss_set_defaults()

allows an application to change the service (privacy, integrity, authentica-

tion, or none) and Quality of Protection (QOP) for a transfer session. New values apply to the rest of the

session only unless they are changed again.

PARAMETERS

Information on

RPCSEC_GSS data types for parameters may be found on the rpcsec_gss (3N) manpage.

auth An RPC authentication handle returned by

rpc_gss_seccreate().

service An

enum of type rpc_gss_service_t

, representing one of the following types of security

service: authentication, privacy, integrity, or none.

qop A string representing Quality of Protection. Valid strings may be found in the ﬁle

/etc/gss/qop or by using rpc_gss_get_mech_info()

MULTITHREAD USAGE

Thread Safe: Yes

Cancel Safe: Yes

Fork Safe: No

Async-cancel Safe: No

Async-signal Safe: No

These functions can be called safely in a multithreaded environment. They may be cancellation points in

that they call functions that are cancel points.

In a multithreaded environment, these functions are not safe to be called by a child process after

fork()

and before exec(). These functions should not be called by a multithreaded application that supports

asynchronous cancellation or asynchronous signals.

RETURN VALUES

rpc_gss_set_svc_name()

returns TRUE if it is successful; otherwise, use

rpc_gss_get_error()

to get the error associated with the failure.

FILES

/etc/gss/qop File containing valid QOP values