coreinfo(1)                         CLIX                         coreinfo(1)



  NAME

    coreinfo - Extracts useful information from corefiles

  SYNOPSIS

    coreinfo [-acpsv] [corefile ...]

  FLAGS

    -a     Gives the address in the PC (program counter) register at the time
           of the core dump.

    -c     Gives the command line arguments used to run the program.  This is
           exactly the same output as shown by ps(1).

    -p     Gives the basename of the executed program.  This may or may not be
           the first field in the string given by the -c flag due to symbolic
           links.

    -s     Gives the signal number which caused the core dump.  In verbose
           mode, this also gives the usual symbolic name for the signal for
           those signals that ordinarily cause core dumps.

    -v     Enables verbose mode.

  DESCRIPTION

    The coreinfo command is a tool for determining the source and cause of any
    core files on a system (see core(4) ), and is especially useful in a
    development environment.

    The coreinfo program reads the user structures from the given corefiles
    and displays the selected fields to stdout.  If no command line flags are
    given, all four fields are displayed.  The fields are displayed in the
    following order:

    program-name "command line args" sig-number pc-address

    In verbose mode, each field is displayed on a separate line.  If no
    corefile arguments are specified, the program looks for a file named core
    in the current directory.

  EXAMPLES

    1.  To display the name of the program whose core is in the file
        /usr/foo/core, key in the following:

        coreinfo -p /usr/foo/core





  2/94 - Intergraph Corporation                                              1

  coreinfo(1)                         CLIX                         coreinfo(1)



    2.  To display the command line arguments and faulting signal number of a
        file named core in the current directory, key in the following:

        coreinfo -cs


  CAUTIONS

    Since corefiles have no magic number, the coreinfo program cannot
    distinguish a core image from a regular file, unless the file is not large
    enough to be a core image.  Therefore, garbage may be output if coreinfo
    is run on a non-corefile.

  WARNINGS

    The coreinfo command issues a warning if run on a CPU different than the
    one for which it was compiled (c100/c300 versus c400).

  EXIT VALUES

    The coreinfo command exits with a value of 0 if successful.  A usage error
    returns the value 2, and any other error returns a value of 1.

  RELATED INFORMATION

    Commands: adb(1), dbg(1), sdb(1)

    Functions: signal(2)

    Files: core(4)
























  2                                              Intergraph Corporation - 2/94