yp_order Subroutine

Communications Technical Reference, Volume 1

yp_order Subroutine

Purpose

Returns the order number for an Network Information Services (NIS) map that identifies when the map was built.

Library

C Library (libc.a)

Syntax

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

yp_order (indomain, inmap, outorder)
char *indomain;
char *inmap;
int *outorder;

Description

The yp_order subroutine returns the order number for a NIS map that identifies when the map was built. The number determines whether the local NIS map is more current than the master NIS database.

Parameters

indomain	Points to the name of the domain used as input to the subroutine.
inmap	Points to the name of the map used as input to the subroutine.
outorder	Points to the returned order number, which is a 10-digit ASCII integer that represents the operating system time, in seconds, when the map was built.

Return Values

Upon successful completion, this routine returns a value of 0. If unsuccessful, it returns one of the error codes described in the rpcsvc/yp_prot.h file.

Implementation Specifics

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

Related Information

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.