svcerr_auth Subroutine

Communications Technical Reference, Volume 1

svcerr_auth Subroutine

Purpose

Indicates that the service dispatch routine cannot complete a remote procedure call due to an authentication error.

Library

RPC Library (libcrpc.a)

Syntax

#include <rpc/rpc.h>

void svcerr_auth (xprt, why)
SVCXPRT *xprt;
enum auth_stat why;

Description

The svcerr_auth subroutine is called by a service dispatch subroutine that refuses to perform a remote procedure call (RPC) because of an authentication error. This subroutine sets the status of the RPC reply message to AUTH_ERROR.

Parameters

xprt	Points to the RPC service transport handle.
why	Specifies the authentication error.

Implementation Specifics

This subroutine is part of Base Operating System (BOS) Runtime.

Related Information

List of RPC Programming References.

Remote Procedure Call (RPC) Overview for Programming in AIX Version 4.3 Communications Programming Concepts.