isodetailor Subroutine

Purpose

Initializes variables for various logging facilities.

Library

ISODE Library (libisode.a)

Syntax

#include <isode/tailor.h>
  
void isodetailor (myname, wantuser)
char * myname;
int  wantuser;

Description

The ISODE library contains internal logging facilities. Some of the facilities need to have their variables initialized. The isodetailor subroutine sets default or user-defined values for the logging facility variables. The logging facility variables are listed in the usr/lpp/snmpd/smux/isodetailor file.

The isodetailor subroutine first reads the /etc/isodetailor file. If the wantuser parameter is set to 0, the isodetailor subroutine ignores the myname parameter and reads the /etc/isodetailor file. If the wantuser parameter is set to a value greater than 0, the isodetailor subroutine searches the current user's home directory ($HOME) and reads a file based on the myname parameter. If the myname parameter is specified, the isodetailor subroutine reads a file with the name in the form .myname_tailor. If the myname parameter is null, the isodetailor subroutine reads a file named .isode_tailor. The _tailor file contents must be in the following form:

#comment
<variable> : <value>  # comment
<variable> : <value>  # comment
<variable> : <value>  # comment

The comments are optional. The isodetailor subroutine reads the file and changes the values. The latest entry encountered is the final value. The subroutine reads /etc/isodetailor first and then the $HOME directory, if told to do so. A complete list of the variables is in the /usr/lpp/snmpd/smux/isodetailor sample file.

This subroutine is part of the SNMP Application Programming Interface in the TCP/IP facility.

Parameters

Item Description
myname Contains a character string describing the SNMP multiplexing (SMUX) peer.
wantuser Indicates that the isodetailor subroutine should check the $HOME directory for a isodetailor file if the value is greater than 0. If the value of the wantuser parameter is set to 0, the $HOME directory is not checked, and the myname parameter is ignored.

Files

Item Description
/etc/isodetailor Location of user's copy of the /usr/lpp/snmpd/smux/isodetailor file.
/usr/lpp/snmpd/smux/isodetailor Contains a complete list of all the logging parameters.