projects / OpenSPARC-T2-SAM / blame
| Commit | Line | Data |
|---|---|---|
| 920dae64 AT |
1 | <html> |
| 2 | ||
| 3 | <head> | |
| 4 | <title>sysconf UI command design: for Flexible Device Configuration</title> | |
| 5 | </head> | |
| 6 | ||
| 7 | <body bgcolor="#FFFFFF" LANG="en-US"> | |
| 8 | ||
| 9 | <h1> SAM sysconf UI command for flexible device configuration</h1> | |
| 10 | ||
| 11 | <h2>Introduction</h2> | |
| 12 | ||
| 13 | This document describes sysconf UI command syntax and introduces the example | |
| 14 | use of the command for creating a device hierarchy that similate a hardware | |
| 15 | system. | |
| 16 | ||
| 17 | <h2>References</h2> | |
| 18 | ||
| 19 | <ol> | |
| 20 | <li> SAM: SPARC Architecture Model<br> | |
| 21 | </li> | |
| 22 | ||
| 23 | <li> Module Model Interface (MMI)<br> | |
| 24 | </li> | |
| 25 | ||
| 26 | <li>SAM Flexible Configuration<br> | |
| 27 | </li> | |
| 28 | ||
| 29 | </ol> | |
| 30 | ||
| 31 | <h2>sysconf UI command</h2> | |
| 32 | <h4>Syntax</h4> | |
| 33 | <ul><tt><b>sysconf [ -p mod_path ] module_name [ instance_name [ args ... ] [ -d# ] ]</b></tt></ul> | |
| 34 | ||
| 35 | <ul><tt>cfg</tt> is an alias for <tt>sysconf</tt>.</ul> | |
| 36 | ||
| 37 | <ul>where:</ul> | |
| 38 | ||
| 39 | <ul> | |
| 40 | <table> | |
| 41 | <tr><td><i>mod_path</i></td> <td> pathname for .so files</td></tr> | |
| 42 | <tr><td><i>module_name</i></td> <td> a module name defined by MMI</td></tr> | |
| 43 | <tr><td><i>instance_name</i></td> <td> a unique instance name</td></tr> | |
| 44 | <tr><td><i>args</i></td> <td> optional arguments, usually <b>name=value</b> pairs.</td></tr> | |
| 45 | <tr><td><i>-d#</i></td> <td> set debug level to control the amount of debug output</td></tr> | |
| 46 | </table> | |
| 47 | </ul> | |
| 48 | ||
| 49 | The .so filename is contructed as follows: <i>mod_path</i>/<i>module_name</i>.so. | |
| 50 | The default value for <i>mod_path</i> is ".". | |
| 51 | The <i>-p</i> switch sets a new module path, and remains in effect until the next <i>-p</i> switch. | |
| 52 | ||
| 53 | ||
| 54 | <h4>Examples</h4> | |
| 55 | ||
| 56 | <pre> | |
| 57 | <tt> <blockquote> | |
| 58 | Example device hierarchy: | |
| 59 | ||
| 60 | ssm ->cpu0 | |
| 61 | ->cpu1 | |
| 62 | ->schizo30->pcia->fc0 | |
| 63 | ->isa | |
| 64 | ->pcib->bootbus_ctrl | |
| 65 | ->schizo31->pcia->ge0 | |
| 66 | ->ge1 | |
| 67 | ->pcib | |
| 68 | ||
| 69 | ||
| 70 | Example sysconf commands for above device hierarchy: | |
| 71 | ||
| 72 | sysconf -p ../blaze-conf/modules/64opt | |
| 73 | sysconf schizo schizo30 aid=30 pciA=pci30A pciB=pci30B | |
| 74 | sysconf pci_bus pci30A bridge=schizo30 | |
| 75 | sysconf fc fc0 bus=pci30A dev=0 fun=0 | |
| 76 | sysconf isa isa0 bus=pci30A dev=7 fun=0 | |
| 77 | sysconf pci_bus pci30B bridge=schizo30 | |
| 78 | sysconf bootbus bootbus_ctrl bus=pci30B dev=4 fun=0 | |
| 79 | sysconf schizo schizo31 aid=31 pciA=pci31A pciB=pci31B | |
| 80 | sysconf pci_bus pci31A bridge=schizo31 | |
| 81 | sysconf ge ge0 bus=pci31A dev=0 fun=0 | |
| 82 | sysconf ge ge1 bus=pci31A dev=1 fun=0 | |
| 83 | sysconf pci_bus pci31B bridge=schizo31 | |
| 84 | </blockquote> </tt> | |
| 85 | </pre> | |
| 86 | ||
| 87 | <hr> | |
| 88 | ||
| 89 | ||
| 90 | </body> | |
| 91 | </html> |