getnetname Subroutine

Communications Technical Reference, Volume 1

getnetname Subroutine

Purpose

Installs the network name of the caller in the array specified by the name parameter.

Library

C Library (libc.a)

Syntax

#include <rpc/rpc.h>

getnetname (name)
char name [MAXNETNAMELEN];

Description

The getnetname subroutine installs the caller's unique, operating-system-independent network name in the fixed-length array specified by the name parameter.

Parameters

name

Specifies 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.

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 Version 4.3 Communications Programming Concepts.