logger_return_names
num_returned.i4.v = logger_return_names(list_id.i2.r,
device_names.i1a.r
[,disp_indices.i4a.r]
[,options.u4.v])
This routine returns a list of logged devices from a specific list
ID of a Lumberjack process.
list_id list number from 1 to LOGGER_NUM_LISTS
device_names array of returned device names
(up to LOGGER_DEVICES_PER_LIST entries)
(C_STYLE_LONG_DEVICE_NAME_LEN characters per entry)
[disp_indices] array of returned display indices
(up to LOGGER_DEVICES_PER_LIST entries)
(default is NULL)
[options] data return options
(LOGGER_OPT_NONE -> no options selected,
LOGGER_OPT_COLUMN_ORDER_INDEX -> return column order
display indices
(default is row order
display indices))
This function returns status values as follows:
LJ_INVARG invalid list ID passed
ACNET_xxx error in communicating with Lumberjack
otherwise number of returned device names
This function requires the following include files:
cnsparam_h, clib_h, acnet_errors_h
Related functions:
logger_get_device_c, logger_get_device_by_name_c,
logger_get_device_list_c, logger_return_data, logger_setnode,
logger_check_alive, logger_restart_lists, logger_shutdown,
logger_find_device_c
C/C++ usage:
char device_names[LOGGER_DEVICES_PER_LIST][C_STYLE_LONG_DEVICE_NAME_LEN];
short list_id = LIST_ID;
int num_returned;
int disp_indices[LOGGER_DEVICES_PER_LIST];
unsigned int options = LOGGER_OPT_NONE;
num_returned = logger_return_names(&list_id,(char *) device_names,
disp_indices,options);