LM_SETUP(3)

NAME
lm_setup - controls optional behaviors of FLXElm client

NOTE:
lm_setup has been superceded by lm_set_attr. You are encourage to use lm_set_attr instead of lm_setup.

SYNOPSIS
#include <lm_client.h>

void lm_setup(setup_struct)
SETUP_DATA *setup_struct;

typedef struct _lm_setup_data {
	short decrypt_flag;
/*			- Controls whether encryption/decryption
 *			  happens on lm_start
 */
	int timer_type;
/*			- Type of timer to use for checking and reconnection.
 *			  (if used; see check_interval and retry_interval),
 *			  choices are:
 *			    ITIMER_REAL or ITIMER_VIRTUAL  (see <sys/time.h>)
 */
	int check_interval;
/*			- Timer interval for connection checking (sec)
 *				(- implies no timer, ie. user-initiated
 *				   checking by calling lm_timer() periodically)
 */
	int retry_count;
/*			- How many retrys are attempted to reconnect, 0
 *			  implies user-supplied reconnection.
 */
	int retry_interval;
/*			- Retry interval (seconds) for automatic reconnect
 *				(- implies no timer for reconnect, ie. user
 *				   must perform reconnection by calling
 *				   lm_timer() periodically).
 */
	int (*reconnect)();
/*			- Pointer to (user-supplied) routine to be called when
 *			  reconnection starts.  If retry_count is 0, this
 *			  routine must perform reconnection (lm_timer()
 *			  will not do it).  If retry_interval is < 0,
 *			  the user must call lm_timer() periodically
 *			  to effect the reconnection.  This routine will
 *			  be passed the feature name, the retry pass number,
 *			  the total retry_count, and the retry interval:
 *		reconnect(feature, pass, retry_count, interval);
 */
	int (*reconnect_done)();
/*			- Pointer to (user-supplied) routine to be called when
 *			  reconnection completes.  This routine will be
 *			  passed the feature name, number of retrys,
 *			  the retry count, and the retry interval:
 *		reconnect_done(feature, tries, retry_count, interval);
 */
	int (*exitcall)();
/*			- Pointer to (user-supplied) exit handler
*/
	char *(*crypt)();
/*			- Pointer to (user-supplied) encryption routine
*/
	short crypt_case_sensitive;
/*			- If set, the encryption code in the license file
 *			  is CaSe SeNsItIvE. (Default: case insensitive).
 */
	int conn_timeout;
/*			- Timeout for connections to servers
*/
	char config_file[MAXPATHLEN+1];
/*			- The location of the license file
 *			  (to override /usr/local/flexlm/licenses/license.dat)
 */
	short disable_env;
/*			- Disable the use of LM_LICENSE_FILE to override the
 *				license file location.
 */
	short normal_hostid;
/*			- Set to a non-zero value to use only the default
 *			  ("normal") system host ID checking.  When
 *			  set to 0, extended host ID checking is performed.
 */
	char user_override[MAX_USER_NAME+1];
/*			- Use this string to override the default user name.
*/
	char host_override[MAX_SERVER_NAME+1];
/*			- Use this string to override the default host name.
*/
	int (*periodic_call)();
/*			- Pointer to (user-supplied) function to be called
 *				every "periodic_count" times through lm_timer.
 */
	int periodic_count;
/*			- Number of calls to lm_timer before a call is made
 *				to periodic_call()
 */
	short no_demo;
/*			- Do not allow demo software ("DEMO" in vendor string)
*/
	short no_traffic_encrypt;
/*			- Do not encrypt traffic between client and daemon
*/
	short use_start_date;
/*			- Enforce the start date in the license file
*/
	int max_timediff;
/*			- Maximum time difference between client/server
 *			  (minutes)
 */
	char display_override[MAX_DISPLAY_NAME+1];
/*			- Use this string to override the default display name.
 */
	int ef_1, ef_2, ef_3;
/*			- event flags for timers (VMS only)
 */
} SETUP_DATA;

DESCRIPTION
lm_setup() allows the client program to customize various options to FLEXlm.

setup_struct is a pointer to a structure containing the new data values for the items being changed. In general, if a field in the structure is left as 0 or NULL, that option will not be changed.

You can change a single field at a time with the function lm_set_attr.

SEE ALSO
lm_set_attr(3).