yp_get_default_domain Subroutine

Communications Technical Reference, Volume 1

yp_get_default_domain Subroutine

Purpose

Gets the default domain of the node.

Library

C Library (libc.a)

Syntax

#include <rpcsvc/ypclnt.h>
#include <rpcsvc/yp_prot.h>

yp_get_default_domain (outdomain)
char **outdomain;

Description

Network Information Services (NIS) lookup calls require both a map name and a domain name. Client processes can get the default domain of the node by calling the yp_get_default_domain routine and using the value returned in the outdomain parameter as the input domain (indomain) parameter for NIS remote procedure calls.

Parameters

outdomain

Specifies the address of the uninitialized string pointer where the default domain is returned. Memory is allocated by the NIS client using the malloc subroutine and should not be freed by the application.

Return Values

Upon successful completion, this routine returns a value of 0. If unsuccessful, it returns an error as described in the rpcsvc/ypclnt.h file.

Implementation Specifics

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

Related Information

The malloc subroutine.

Network Information Service (NIS) Overview for System Management in AIX Version 4.3 System Management Guide: Communications and Networks.

List of NIS Programming References and Remote Procedure Call (RPC) Overview for Programming in AIX Version 4.3 Communications Programming Concepts.