rtalloc_gr Kernel Service

Purpose

Allocates a route.

#include <sys/types.h>
#include <sys/errno.h>
#include <net/route.h>

void rtalloc_gr ( ro, gidlist) register struct route *ro; struct gidstruct *gidlist;

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

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.

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

The rtalloc_gr service has no return values.

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

rtalloc_gr (ro, gidlist);