Technical Reference: Communications, Volume 1

netname2user Subroutine

Purpose

Converts from an operating-system-independent network name to a domain-specific user number (UID).

Library

C Library (libc.a)

Syntax

#include <rpc/rpc.h>

netname2user (name, uidp, gidp, gidlenp, gidlist) char * name; int * uidp; int * gidp; int * gidlenp; int * gidlist;

Description

The netname2user subroutine converts from an operating-system-independent network name to a domain-specific UID. This subroutine is the inverse of the user2netname subroutine.

Parameters

name	Points to the network name (or netname) of the server process owner. The name parameter can be either the host name derived from the host2netname subroutine or the user name derived from the user2netname subroutine.
uidp	Points to the user ID.
gidp	Points to the group ID.
gidlenp	Points to the size of the group ID.
gidlist	Points to the group list.

Return Values

Upon successful completion, this subroutine returns a value of 1. If unsuccessful, it returns a value of 0.

Implementation Specifics

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

Related Information

The host2netname subroutine, user2netname subroutine.

List of RPC Programming References.

Remote Procedure Call (RPC) Overview for Programming in AIX 5L Version 5.1 Communications Programming Concepts.