Main Page Community portal Recent changes Random page Help

Article Discussion Edit History

How to report LINUX issues

How To

When logging an issues using the www.softimage.com\support forms you can greatly help us speed up the investigation by including detailed information on your machine setup, specifically:

• Operating System with version including updates
• Kernel version
• Desktop and window manager and versions
• Compiler
• Graphics Video Card with driver version
• Audio Card
• Python version
• X Server version
• OpenGL version

In some cases we will also need your desktop preferences to identify conflict with copy/paste or keyboard shortcuts.

Please attach the output from the following script to your issue submission:

#!/bin/sh
##
# (C) Softimage 2007
# Author: Hans Larsen
##
# Little script that output to STDOUT a list of system details for better bug id.
# The output is scriptable (and can be searched) using ^! regexp.
# It uses two variables XSI_SYSDETAILS_TEMPFILE and XSI_SYSDETAILS_MD (which are
# unset at the end).
# The simple way to send the output is to pipe it and send the zipped file, not
# copy-paste (because output is likely to be huge and get huger in time :)

# Checking if .xsi has been run correctly prior to this script.
[ -z `setenv | grep ^SI_HOME` ] && echo \$XSI_HOME is not set. Please source .xsi_\* && exit 1
[ ! -r "$XSI_HOME" ]             && echo \$XSI_HOME \($XSI_HOME\) is not set correctly or user doesn\'t have read access.  Please source .xsi_\* && exit 1

# Create $XSI_SYSDETAILS_TEMPFILE to mktemp if it exists, otherwise something almost as secure...
[ ! -z `which mktemp` ] && setenv XSI_SYSDETAILS_TEMPFILE `mktemp`
[   -z `which mktemp` ] && setenv XSI_SYSDETAILS_TEMPFILE /tmp/xsitmp.systemdetails.$$ && touch $XSI_SYSDETAILS_TEMPFILE

# Output to stdout

# Content.  Please do not modify the code AFTER the content if you don't know what you're doing.
# It is done as this to simplify scripting around this file (using the '!' as a delimiter).

# If you have something to add, create your own value and push it in here.
# The commands are pretty straight-forward, but if you need to put comments, feel free to use the technique
# so that the <<EOF is not interrupted and the comments don't affect the output.
# The sed is often used when output is multi-line to align data.
cat > $XSI_SYSDETAILS_TEMPFILE <<EOF
!id!host
    `hostname`						`# For identification`
!id!date
    `date`						`# Date of the generated file`
!id!kernel
    `cat /proc/version`					`# Better version than uname`
!id!distro
    `cat /etc/issue.net | sed "s/\t/    /m"`		`# Will give the name of the distribution`
!software!gcc						`# Different software versions`
    `gcc --version | head -1`
!software!ld
    `ld  --version | head -1`
!software!ldd
    `ldd --version | head -1`
!software!python
    `python -V |& cat`
!software!x11
`X -version |& sed "s/^/    /m"`
!xsi!binary 
    $XSI_HOME/Application/bin/$XSI_CPU_OPT/XSI
!xsi!ldd
`ldd $XSI_HOME/Application/bin/$XSI_CPU_OPT/XSI | sed "s/\t/    /m"`
!system!/lib
`ls /lib | sed "s/^/    /m" | column -c 100`
!system!/usr/lib
`ls /usr/lib | sed "s/^/    /m" | column -c 100`
!system!mount
`mount | sed "s/^/    /m"`
!hardware!eth						`# Just the interfaces, no info about IP, etc`
    `/sbin/ifconfig | colrm 8 | column`
!hardware!cpu
`cat /proc/cpuinfo | sed "s/^/    /m"`
!hardware!mem
`cat /proc/meminfo | sed "s/^/    /m"`
!hardware!glxinfo
`glxinfo | sed "s/^/    /m"`
EOF

# Calculate MD5 
[ ! -z `which md5sum` ] && setenv XSI_SYSDETAILS_MD `md5sum $XSI_SYSDETAILS_TEMPFILE | sed s/\ .\*\$//`
# else put nothing.
[   -z `which md5sum` ] && setenv XSI_SYSDETAILS_MD nothing

####################
# HEADER - Copyright and MD5 notice
cat <<EOF
--------------------------------------------------------------------------------
 (c) SoftImage
--------------------------------------------------------------------------------
!
!prot
    xsi$XSI_SYSDETAILS_MD
EOF
# CONTENT
cat < $XSI_SYSDETAILS_TEMPFILE

####################
# FOOTER
cat <<EOF
!env
`setenv | sed "s/^/    /m" | sort`
!
EOF

rm -f $XSI_SYSDETAILS_TEMPFILE
unset XSI_SYSDETAILS_TEMPFILE
unset XSI_SYSDETAILS_MD

NOTE: comments and suggestions on how this script can be improved are most welcome. Please send suggestions to mailto:support@softimage.com.