Annotation of cf/README, revision 1.1.1.1

1.1       root        1: Help for Cisco 7200 simulator (dynamips-0.2.3)
                      2: ==============================================
                      3: Authors: Fabien Devaux, Christophe Fillot, MtvE
                      4: 
                      5: Emulated hardware
                      6: *****************
                      7: 
                      8: By default, a NPE-200 is emulated. You can choose the NPE type with the
                      9: "-t" option. It is possible to select "npe-100", "npe-150", "npe-175", 
                     10: "npe-200", "npe-225", "npe-300" and "npe-400". The "npe-g1" is not working.
                     11: 
                     12: Please note that you must use the C7200-IO-FE PA driver as IO card if you
                     13: want a FastEthernet interface in slot 0. For other slots, you must use
                     14: the PA-FE-TX driver.
                     15: 
                     16: The Serial driver (PA-4T+) is not working at all (the interfaces are only 
                     17: "seen" by IOS).
                     18: 
                     19: 
                     20: Command Line Options overview
                     21: *****************************
                     22: 
                     23: -r <ram_size>   : Set the virtual RAM size (default is 256 Mb)
                     24: -o <rom_size>   : Set the virtual ROM size (default is 4 Mb)
                     25: -n <nvram_size> : Set the NVRAM size (default is 128 Kb)
                     26: -l <log_file>   : Set logging file (default is pred_log0.txt)
                     27: -C <cfg_file>   : Import an IOS configuration file into NVRAM
                     28: -R <rom_file>   : Load an alternate ROM (default is embedded)
                     29: -s <sym_file>   : Load symbol file
                     30: -c <conf_reg>   : Set the configuration register (default is 0x2102)
                     31: -m <mac_addr>   : Set the MAC address of the chassis (IOS chooses default)
                     32: -k <clock_div>  : Set the clock divisor (default is 2)
                     33: -T <port>       : Console is on TCP <port> (default is on the terminal)
                     34: -A <port>       : AUX is on TCP <port> (default is no AUX port)
                     35: -i              : Instruction block trace, very slow
                     36: -j              : Disable the JIT compiler, very slow
                     37: -t <npe_type>   : Select NPE type
                     38: -M <midplane>   : Select Midplane ("std" or "vxr")
                     39: -p <pa_desc>    : Define a Port Adapter
                     40: -a <cfg_file>   : Virtual ATM switch configuration file
                     41: -b <cfg_file>   : Virtual bridge configuration file
                     42: 
                     43: 
                     44: Command Line Options details
                     45: ****************************
                     46: 
                     47: <clock_div> :
                     48: 
                     49:    Specify the clock divider (integer) based on the host clock.
                     50:    Alter the value to match the CISCO clock with the real time.
                     51:    The command "show clock" at the IOS' CLI will help you set this value.
                     52: 
                     53: <pa_desc> :
                     54: 
                     55:    Format: slot:pa_driver:netio_type[:netio_parameters]
                     56: 
                     57:    slot       : the number of the physical slot (starts from 0)
                     58: 
                     59:    pa_driver  : the name of a port adapter driver in:
                     60:         - C7200-IO-FE  (FastEthernet, slot 0 only)
                     61:         - PA-FE-TX     (FastEthernet, slots 1 to 6) 
                     62:         - PA-4T+       (Serial, NOT WORKING)
                     63:         - PA-A1        (ATM)
                     64: 
                     65:    netio_type : host interface for communication
                     66: 
                     67:         unix:<local_sock>:<remote_sock>
                     68:            Use unix sockets for local communication.
                     69:            <local_sock> is created and represents the local NIC.
                     70:            <remote_sock> is the file used by the other interface.
                     71:            (ex. "/tmp/local:/tmp/remote")
                     72: 
                     73:         tap:<tap_name>
                     74:            Use a virtual ethernet device for communication.
                     75:            <tap_name> is the name of the tap device (ex. "tap0")
                     76: 
                     77:         linux_eth:<dev_name>
                     78:            Use a real ethernet device for communication (Linux specific).
                     79:            <dev_name> is the name of the Ethernet device (ex. "eth0")
                     80: 
                     81:         udp:<local_port>:<remote_host>:<remote_port>
                     82:            Use an UDP socket for connection between remote instances.
                     83:            <local_port> is the port we listen to.
                     84:            <remote_host> is the host listening the port you want to connect to.
                     85:            <remote_port> is the port you want to connect to.
                     86:           (ex. "1000:somehost:2000" and "2000:otherhost:1000" on the other 
                     87:            side)
                     88: 
                     89:         tcp_cli:<host>:<port>
                     90:            Client side of a tcp connection.
                     91:            <host> is the ip address of the server.
                     92:            <port> is the port to connect to.
                     93: 
                     94:         tcp_ser:<port>
                     95:            Server side of a tcp connection.
                     96:            <port> is the port to listen to.
                     97: 
                     98:         null
                     99:            Dummy netio (used for testing/debugging), no parameters needed.
                    100: 
                    101: 
                    102: Escape commands
                    103: ***************
                    104: 
                    105: You can press ^] at any time, followed by one of the following letters:
                    106: 
                    107: d : Show the device list
                    108: r : Dump MIPS CPU registers
                    109: t : Dump MIPS TLB entries
                    110: m : Dump the latest memory accesses
                    111: s : Suspend CPU emulation
                    112: u : Resume CPU emulation
                    113: q : Quit the emulator
                    114: b : Dump the instruction block tree
                    115: c : Write IOS configuration to disk (ios_cfg.txt)
                    116: j : Non-JIT mode statistics
                    117: x : Experimentations (can crash the box!)
                    118: ^]: Send ^]
                    119: 
                    120: If you press an unrecognized key, help will be shown. 
                    121: 
                    122: 
                    123: Virtual Bridge
                    124: **************
                    125: 
                    126: The virtual bridge is used to emulate a shared network between emulator
                    127: instances.
                    128: 
                    129: Any emulator instance can ast as a virtual bridge.
                    130: 
                    131: The configuration file (specified by the "-b" option) contains a list of
                    132: NetIO descriptors, which the following syntax: netio_type[:netio_parameters]
                    133: 
                    134: Example:
                    135: 
                    136: # Connection to instance "I0"
                    137: udp:10000:127.0.0.1:10001
                    138: 
                    139: # Connection to instance "I1"
                    140: udp:10002:127.0.0.1:10003
                    141: 
                    142: # Connection to instance "I2"
                    143: udp:10004:127.0.0.1:10005
                    144: 
                    145: The "I0" would be launched with the following parameters:
                    146: 
                    147:    dynamips ios.bin -p 1:PA-FE-TX:udp:10001:127.0.0.1:10000
                    148: 
                    149: 
                    150: Virtual ATM switch
                    151: ******************
                    152: 
                    153: The virtual ATM switch fabric is used to emulate an ATM backbone between 
                    154: emulator instances. The use of this virtual switch is not mandatory, you 
                    155: can directly connect emulator instances for point-to-point ATM connections.
                    156: Please note that only basic VP/VC switching is supported, there is no
                    157: support for ILMI/QSAAL/... or other specific ATM protocols.
                    158: 
                    159: Any emulator instance can act as a virtual ATM switch.
                    160: 
                    161: Example of configuration file (specified by the "-a" option):
                    162: 
                    163: # Virtual Interface List
                    164: IF:A0:udp:10001:127.0.0.1:10000
                    165: IF:A1:udp:10002:127.0.0.1:10003
                    166: IF:A2:udp:10004:127.0.0.1:10005
                    167: 
                    168: # VP connection between I0 and I1
                    169: VP:A0:10:A1:20
                    170: VP:A1:20:A0:10
                    171: 
                    172: # VP connection between I0 and I2
                    173: VP:A0:11:A2:30
                    174: VP:A2:30:A0:11
                    175: 
                    176: # VC connection between I1 and I2
                    177: VC:A1:5:2:A2:7:3
                    178: VC:A2:7:3:A1:5:2
                    179: 
                    180: In this example, we have 3 virtual interfaces, A0, A1 and A2. The syntax
                    181: for interface definition is similar to Port Adapters:
                    182: 
                    183:    IF:interface_name:netio_type[:netio_parameters]
                    184: 
                    185: You can do VP switching or VC switching:
                    186: 
                    187: 1) VP switching
                    188: 
                    189: syntax: VP:input_if:input_vpi:output_if:output_vpi
                    190: 
                    191: 2) VC switching
                    192: 
                    193: syntax: VC:input_if:input_vpi:input_vci:output_if:output_vpi:output_vci
                    194: 
                    195: 
                    196: Testing the Virtual ATM switch with one dynamips instance
                    197: *********************************************************
                    198: (Contribution of Mtv Europe)
                    199: 
                    200: Virtual ATM switch configuration file ("atm.cfg"):
                    201: 
                    202: IF:A0:udp:10003:127.0.0.1:10001
                    203: IF:A1:udp:10004:127.0.0.1:10002                                                
                    204: # a0/vpi=1/vci=100 connects to a1/vpi=2/vci=200
                    205: VC:A0:1:100:A1:2:200                                                           
                    206: VC:A1:2:200:A0:1:100
                    207: 
                    208: Invoking dynamips:
                    209: 
                    210: ./dynamips -p 1:PA-A1:udp:10001:127.0.0.1:10003 -p 2:PA-A1:udp:10002:127.0.0.1:10004 -a atm.cfg IOS.BIN
                    211: 
                    212: (note input ports of IOS interfaces are output ports of ATM switch 
                    213: interfaces, and vice versa).
                    214: 
                    215: IOS configuration:
                    216: 
                    217: ip cef
                    218: ip vrf test
                    219:  rd 1:1
                    220:  route-target both 1:1
                    221: int a1/0
                    222:  no shut
                    223: int a1/0.2 p
                    224:  ip addr 1.1.1.1 255.255.255.0
                    225:  pvc 1/100
                    226: interface a2/0
                    227:  no shut
                    228: interface a2/0.2 p
                    229:  ip vrf forwarding test
                    230:  ip addr 1.1.1.2 255.255.255.0
                    231:  pvc 2/200
                    232: !
                    233: 
                    234: # ping 1.1.1.2
                    235: !!!!!
                    236: 
                    237: == EOF ==

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.