[ Previous | Next | Contents | Home | Search ]
AIX Version 4.3 Kernel and Subsystems Technical Reference, Volume 1

rtalloc_gr Kernel Service

Purpose

Allocates a route.

Syntax

#include <sys/types.h>
#include <sys/errno.h>
#include <net/route.h>
void rtalloc_gr (ro, gidlist)
register struct route *ro;
struct gidstruct *gidlist;

Parameter

ro Specifies the route.
gidlist Points to the group list.

Description

The rtalloc_gr kernel service allocates a route, which consists of a destination address and a reference to a routing entry.

A route can be allocated only if its group id restrictions specify that it can be used by a user with the gidlist that is passed in.

Execution Environment

The rtalloc_gr kernel service can be called from either the process or interrupt environment.

Return Values

The rtalloc_gr service has no return values.

Example

To allocate a route, invoke the rtalloc_gr kernel service as follows:

rtalloc_gr (ro, gidlist);

Implementation Specifics

The rtalloc_gr kernel service is part of Base Operating System (BOS) Runtime.

Related Information

Network Kernel Services in AIX Kernel Extensions and Device Support Programming Concepts.

The rtalloc kernel service.


[ Previous | Next | Contents | Home | Search ]