Hcon_Library_Create()
Abstract
Creates an empty device library.
Syntax
Hcon_Library_Create (library_name, num_levels, level_names)
| Argument | Type | Description |
|---|---|---|
library_name |
char * |
name of device library |
num_levels |
int |
depth of DCR hierarchy |
level_names |
PrgT_List * |
level names in DCR hierarchy, from bottom to top (see Details) |
Return Type
HconT_Library *
the library created
Header
hcon.h
Details
Creates an empty device library and sets the depth of the device containment relationship (DCR) hierarchy.
The level_names argument is a list of char * containing the DCR hierarchy, which defines the amount of detail in the Hcon hardware model. Assume, for example, you need to know the number of routers for each site, the number of cards in each router, and the number of ports per card. You would specify:
num_levels = 4
level_names = ("port", "card", "router", "site")
This function does not modify the level_names memory or retain a pointer to it. The client must destroy the list when it is no longer needed.