Structure/union and variable definition files

The structure/union definition (stundef) and variable definition (varidef) files contain information that greatly enhances the ease of debugging using SCODB:

stundef file (/etc/conf/pack.d/scodb/defs/stud.def)
contains information about structures and unions

varidef file (/etc/conf/pack.d/scodb/defs/vari.def)
contains type information about system variables and functions

For kernel-level SCODB, these files are created automatically by scripts that are called by the idbuild(ADM) command. These files can be created manually if you are running user-level scodb(ADM) without linking the scodb driver into the kernel. The sequence is:

  1. Run the mkdef utility in the /etc/conf/pack.d/scodb/bin directory to create idef files from the space.c files for every driver that is listed in the /etc/conf/pack.d/scodb/defs/mkdef.list file.

    The idef files are stored in the /etc/conf/pack.d/scodb/defs directory. Each idef file has a descriptive name (such as the name of the driver for which it was built), suffixed with .idef. For example, the idef file for the mine driver would be named mine.idef. The special driver name conf is used to denote the structures and variables that are defined in the conf.c, fsconf.c, and vector.c files (built by the link kit during the kernel build).

    If the /etc/conf/pack.d/scodb/defs/extra file exists, the extra.idef file is rebuilt.

    Use the mkidef program in the /etc/conf/pack.d/scodb/bin/ directory to build individual idef files:

       mkidef idef_file [CFLAGS] input_files...

  2. Run the ldsy script (which calls the ldsv program) in the /etc/conf/pack.d/scodb/bin/ directory to create and load the stundef and varidef files from one or more idef files.

    idef files contain intermediate-definition information. Often two different idef files have much information in common (such as struct user); ldsv eliminates duplicate data.

  3. Set the STUNTB and VARTB parameters to the appropriate size; see ``Modifying tunable parameters''. These values are set automatically when the scodb driver is linked into the kernel.

© 2003 Caldera International, Inc. All rights reserved.
SCO OpenServer Release 5.0.7 -- 11 February 2003