svcerr_auth(3)                      CLIX                      svcerr_auth(3)



  NAME

    svcerr_auth, svcerr_noprog, svcerr_weakauth, svcerr_decode,
    svcerr_progvers, svcerr_noproc, svcerr_systemerr - Library functions for
    remote procedure calls

  LIBRARY

    Berkeley Software Distribution Library (libbsd.a)

  SYNOPSIS

    #include <sys/rpc/auth.h>

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

    void svcerr_decode(
      SVCXPRT *xprt );

    void svcerr_noproc(
      SVCXPRT *xprt );

    void svcerr_noprog(
      SVCXPRT *xprt );

    void svcerr_progvers(
      SVCXPRT *xprt );

    void svcerr_systemerr(
      SVCXPRT *xprt );

    void svcerr_weakauth(
      SVCXPRT *xprt );

  PARAMETERS

    xprt   Specifies the address of the RPC transport handle.

    why    Specifies the reason an RPC was rejected.

  DESCRIPTION

    The svcerr_auth(), svcerr_noprog(), svcerr_weakauth(), svcerr_decode(),
    svcerr_progvers(), svcerr_noproc(), and svcerr_systemerr() functions allow
    C programs to make procedure calls on other machines across the network.
    First, the client calls a procedure to send a data packet to the server.
    Upon receipt of the packet, the server calls a dispatch routine to perform
    the requested service, and then sends back a reply.  Finally, the
    procedure call returns to the client.



  2/94 - Intergraph Corporation                                              1

  svcerr_auth(3)                      CLIX                      svcerr_auth(3)



    The svcerr_auth() function is called by a service dispatch routine that
    refuses to perform a remote procedure call due to an authentication error.

    The svcerr_decode() function is called by a service dispatch routine that
    cannot successfully decode its parameters.  (See also svc_getargs().)

    The svcerr() function is called by a service dispatch routine that does
    not implement the procedure number that the caller requests.

    The svcerr_noprog() function is called when the desired program is not
    registered with the RPC package.  Service implementors usually do not need
    this function.

    The svcerr_progvers() function is called when the desired version of a
    program is not registered with the RPC package.  Service implementors
    usually do not need this function.

    The svcerr_systemerr() function is called by a service dispatch routine
    when it detects a system error not covered by any particular protocol.
    For example, if a service can no longer allocate storage, it may call
    svcerr_systemerr().

    The svcerr_weakauth() function is called by a service dispatch routine
    that refuses to perform a remote procedure call due to insufficient (but
    correct) authentication parameters.  The function calls svcerr_auth(xprt,
    AUTH_TOOWEAK).

  RETURN VALUES

    This function returns void.

  RELATED INFORMATION

    Functions:  xdr_int(3), xdr_bytes(3), xdr_getpos(3), xdr_pointer(3),
    xdrrec_create(3), xdr_array(3), xdr_destroy(3), xdr_free(3),
    xdr_inline(3), xdrmem_create(3), xdr_opaque(3), xdr_union(3),
    xdr_vector(3), xdr_void(3)

    CLIX Programming Guide















  2                                              Intergraph Corporation - 2/94