authnone_create()--Create Null Authentication

Syntax

 #include <rpc/rpc.h>

 AUTH *authnone_create();

  Default Public Authority: *USE

  Service Program Name: QZNFTRPC

  Threadsafe: No

The authnone_create() function creates and returns a default RPC authentication handle that passes null authentication information with each remote procedure call.

Parameters

None.

Authorities

No authorization is required.

Return Value

auth	Upon successful completion, this API returns a pointer to an RPC authentication handle.
NULL	authnone_create() was not successful. The errno variable is set to indicate the reason.

Error Conditions

[ENOMEM]	Storage allocation failed.
[EUNKNOWN]	Unknown System State.

Error Messages

Message ID	Error Message Text
CPIA1B0 I	An authentication problem was encountered by one of the TI-RPC APIs.
CPE3418 E	Possible APAR condition or hardware failure.
CPF3CF2 E	Error(s) occurred during running of &1 API.
CPF9872 E	Program or service program &1 in library &2 ended. Reason code &3.

Related Information

authsys_create()--Create Authentication with OS Permission

Example

The following example shows how authnone_create() is used.

Note: By using the code examples, you agree to the terms of the Code license and disclaimer information.

#include <stdio.h>
#include <rpc/rpc.h>
/* Define remote program number and version */
#define RMTPROGNUM (u_long)0x3fffffffL
#define RMTPROGVER (u_long)0x1

main()
{
  CLIENT *client;  /* client handle */

  ...

  /* Create a null authentication */
  client->cl_auth = authnone_create();
  if (client->cl_auth == (AUTH *)NULL){
    fprintf(stderr, "authnone_create failed!!\n");
    exit(1);
  }

  ...

}

API introduced: V4R2

[ Back to top | Remote Procedure Call (RPC) APIs | APIs by category ]