get_dev_desc
Purpose
Returns the device's descriptive text.
Syntax
char * get_dev_desc ( device_name )
char * device_name;
Description
The get_dev_desc subroutine gets the descriptive text associated with the device. This text is stored in the catalog field of the PdDv entry for the device. This is usually found in the /usr/lib/methods/devices.cat file for most devices. Other devices may use different catalogs.
Note: init_dgodm must
be called before starting this subroutine.
Parameters
| Parameter | Description |
|---|---|
| device_name | Character pointer to the name of the device. |
Return Value
Upon successful completion, a char pointer to a text string in memory is returned. Otherwise, a value of -1 is returned.