sam-t2/docs/mmi/sysconf.html

<html>

<head>
<title>sysconf UI command design:  for Flexible Device Configuration</title>
</head>

<body bgcolor="#FFFFFF" LANG="en-US">

<h1> SAM sysconf UI command for flexible device configuration</h1>

<h2>Introduction</h2>

This document describes sysconf UI command syntax and introduces the example
use of the command for creating a device hierarchy that similate a hardware
system.

<h2>References</h2>

<ol>
<li> SAM: SPARC Architecture Model<br>
</li>

<li> Module Model Interface (MMI)<br>
</li>

<li>SAM Flexible Configuration<br>
</li>

</ol>

<h2>sysconf UI command</h2>
<h4>Syntax</h4>
<ul><tt><b>sysconf &nbsp; [ -p mod_path ] module_name &nbsp; [ instance_name &nbsp; [ args ... ] [ -d# ] ]</b></tt></ul>

<ul><tt>cfg</tt> is an alias for <tt>sysconf</tt>.</ul>

<ul>where:</ul>

<ul>
<table>
<tr><td><i>mod_path</i></td> <td>&nbsp;&nbsp;pathname for .so files</td></tr>
<tr><td><i>module_name</i></td>  <td>&nbsp;&nbsp;a module name defined by MMI</td></tr>
<tr><td><i>instance_name</i></td>     <td>&nbsp;&nbsp;a unique instance name</td></tr>
<tr><td><i>args</i></td> <td>&nbsp;&nbsp;optional arguments, usually <b>name=value</b> pairs.</td></tr>
<tr><td><i>-d#</i></td> <td>&nbsp;&nbsp;set debug level to control the amount of debug output</td></tr>
</table>
</ul>

The .so filename is contructed as follows: <i>mod_path</i>/<i>module_name</i>.so.
The default value for <i>mod_path</i> is ".".
The <i>-p</i> switch sets a new module path, and remains in effect until the next <i>-p</i> switch.


<h4>Examples</h4>

<pre>
<tt> <blockquote>
Example device hierarchy:

ssm   ->cpu0
      ->cpu1
      ->schizo30->pcia->fc0
                      ->isa
                ->pcib->bootbus_ctrl
      ->schizo31->pcia->ge0
                      ->ge1
                ->pcib


Example sysconf commands for above device hierarchy:

sysconf -p ../blaze-conf/modules/64opt
sysconf schizo    schizo30      aid=30 pciA=pci30A pciB=pci30B
sysconf pci_bus   pci30A        bridge=schizo30
sysconf fc        fc0           bus=pci30A dev=0 fun=0
sysconf isa       isa0          bus=pci30A dev=7 fun=0
sysconf pci_bus   pci30B        bridge=schizo30
sysconf bootbus   bootbus_ctrl  bus=pci30B dev=4 fun=0
sysconf schizo    schizo31      aid=31 pciA=pci31A pciB=pci31B
sysconf pci_bus   pci31A        bridge=schizo31
sysconf ge        ge0           bus=pci31A dev=0 fun=0
sysconf ge        ge1           bus=pci31A dev=1 fun=0
sysconf pci_bus   pci31B        bridge=schizo31
</blockquote> </tt>
</pre>

<hr>


</body>
</html>