HPlogo HP-UX Reference > C

cmpt_get_ifcid(3)

HP-UX 11i Version 2: December 2007 Update
» 

Technical documentation

 » Table of Contents

 » Index

NAME

cmpt_get_ifcid() — get the compartment IDs associated with a network interface

SYNOPSIS

#include <sys/cmpt.h>

cmpt_t cmpt_get_ifcid(const char *ifname);

Parameters

ifname

Pointer to network interface name string.

DESCRIPTION

The cmpt_get_ifcid() function returns the compartment ID associated with a network interface.

Security Restrictions

In order for the cmpt_get_ifcid() function to be effective, the calling process must possess the RULESCONFIG privilege. See privileges(5) for more information about privileges.

RETURN VALUE

cmpt_get_ifcid() returns the following values:

n>0

Successful completion. The function returns a valid compartment ID.

-1

Function failed. errno may be set to indicate the error.

ERRORS

If any of the following conditions occur, cmpt_get_ifcid() fails and sets errno.

ENOSYS

Compartmentalization feature is not supported.

DEPENDENCIES

These functions are a part of the libsec library.