1 --- dynagen-0.10.1.orig/debian/dynagen.1
2 +++ dynagen-0.10.1/debian/dynagen.1
4 +.\" First parameter, NAME, should be all caps
5 +.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
6 +.\" other parameters are allowed: see man(7), man(1)
7 +.TH DYNAGEN 1 "Aug 29, 2006"
8 +.\" Please adjust this date whenever revising the manpage.
10 +.\" Some roff macros, for reference:
11 +.\" .nh disable hyphenation
12 +.\" .hy enable hyphenation
13 +.\" .ad l left justify
14 +.\" .ad b justify to both left and right margins
15 +.\" .nf disable filling
16 +.\" .fi enable filling
17 +.\" .br insert line break
18 +.\" .sp <n> insert n+1 empty lines
19 +.\" for manpage-specific macros, see man(7)
21 +dynagen \- command line interface to dynamips Cisco 7200 Emulator
25 +\fIconfiguration file\fP
27 +.\" TeX users may be more comfortable with the \fB<whatever>\fP and
28 +.\" \fI<whatever>\fP escape sequences to invode bold face and italics,
31 +\fBDynagen\fP is a text-based front end for \fIDynamips\fP, that uses the
32 +\fIhypervisor\fP mode for communication with \fIDynamips\fP. \fBDynagen\fP
33 +simplifies building and working with virtual networks. \fBDynagen\fP uses a
34 +simple and easy to understand configuration file for specifying virtual router
35 +hardware configurations. Configuration file has a simple syntax for
36 +interconnecting routers, bridges, frame-relay and ATM switches. No need to deal
37 +with NetIO's. \fBDynagen\fP provides a management CLI for listing devices,
38 +starting, stopping, reloading, suspending and resuming virtual routers.
40 +\fBDynagen\fP can work in a client server mode, with \fBdynagen\fP running on
41 +your Workstation communicating to \fIdynamips\fP servers running ona back-end
42 +server. \fBDynagen\fP can also control multiple \fIdynamips\fP servers
43 +simultaneously for distributing large virtual networks across several machines.
45 +Before running \fBdynagen\fP you need to start \fIdynamips\fP:
48 +nice dynamips \-H 7200 &
52 +This program follow the usual GNU command line syntax, with long
53 +options starting with two dashes (`-'). A summary of options is included below.
56 +Do not send any command to dynamips.
59 +Show debugging information.
62 +Show summary of options.
66 +.SH CONFIGURATION FILE OPTIONS
67 +Empty lines or lines starting with a hash ('#') are ignored.
69 +Configuration file, in other documentation also called \fInetwork\fP file,
70 +knows three sections: global section, server section which starts with [...]
71 +and device section which start with [[...]]. Server section and device section
72 +can have multiple occurrencies.
76 +[<ip-address|hostname>]
79 +[[7200|ROUTER|FRSW|ATMSW|ETHSW <name>]]
80 +The 7200 section specifies defaults for all 7200 routers on this Dynamips
81 +server. Everything in this section is optional, and defaults to whatever the default is in Dynamips
84 +.B Global Configuration variable
85 +.B autostart <true/false> (Default: True)
87 +By default, all routers are automatically started when a lab is launched. The
88 +autostart keyword overrides this behavior, and the lab must manually be started
91 +.B Server Configuration variables
92 +.B port <1-65535> (Default: 7200)
94 +Hypervision port to connect to.
96 +.B workingdir <path> (Default: None)
98 +Set the directory where \fIDynamips\fP will store all the device files for this
99 +network. This is the fully qualified path relative to the system running
102 +.B console <1-65535> (Default: 2000)
104 +Base console port. New instances that do not specify a console port will
105 +default to this + the instance number.
107 +.B udp <1-65535> (Default: 10000)
109 +Set the base UDP port for NIOs.
112 +.B Device Configuration variables
115 +The 7200 section specifies defaults for all 7200 routers on this Dynamips
116 +server. Everything in this section is optional, and defaults to whatever the
117 +default is in Dynamips.
119 +.B image <path/file> (Default: None)
121 +Full path to 7200 IOS image file. This is the fully qualified path relative to the system running dynamips.
123 +.B ram <integer> (Default: None)
124 +Amount of Virtual RAM to allocate to each router instance.
126 +.B rom <integer> (Default: None)
130 +.B nvram <integer> (Default: None)
134 +.B disk0 <integer> (Default: None)
136 +Set size of PCMCIA ATA disk0
138 +.B disk1 <integer> (Default: None)
140 +Set size of PCMCIA ATA disk1
142 +.B cnfg <path/file> (Default: None)
144 +Configuration file to import. This is the fully qualified path relative to the
145 +system running dynamips.
147 +.B confreg <hex> (Default: 0x2102) 0x210X where X=0,1,2
149 +Set the configuration register
151 +.B idlepc <string> (Default: None)
153 +Set the Idle PC value.
154 +Include a description here.
156 +.B exec_area <string> (Default: None)
158 +Set the exec area size.
160 +.B clock <integer> (Default: None)
162 +Clock divisor (should no longer been needed as of dynamips 0.2.5 RC1)
164 +.B npe <npe-100|150|175|200|225|300|400> (Default: None)
168 +.B midplane <std|vxr> (Default: None)
170 +Midplane, either "std" or "vxr"
172 +.B mmap <binary> (Default: True)
174 +Set to false to use real memory rather than a disk file for router vitural
175 +memory. Conserves RAM at the expense of performance.
177 +.B [[ROUTER <name>]]
178 +All options from the 7200 section are options here as well, including
179 +"autostart". <name> must be unique in network file.
181 +.B model 7200 (Default: 7200)
183 +.B console <1-65535> (Default: None)
185 +Console port. Defaults to the server's base console port (specified in the server section) + instance number.
187 +.B aux <1-65535> (Default: None)
191 +.B slotX <0-X> <PA-C7200-IO-FE|PA-FE-TX|PA-4T|PA-4E|PA-POS-OC3> (Default: None)
193 +Manual PA specification. This is optional, and if not done \fBdynagen\fP will
194 +make sane decisions based on the interface specifications.
196 + slot0 = PA-C7200-IO-FE # Ethernet in slot 0
197 + slot1 = PA-FE-TX # Ethernet in slot 1
198 + slot3 = PA-4T # PA-4T+ in slot 2
199 + slot6 = PA-4E # PA-4E in slot 6
200 + #slotx = PA-POS-OC3 # PA-POS-OC3 in slot x
203 +.B <local interface> = <remote interface>
205 +Interface specification. Can take the following forms:
207 + f1/0 = R2 f1/0 # Connect to f1/0 on device R2
208 + f2/0 = LAN 1 # Connect to bridged LAN 1
209 + s3/0 = R2 s3/0 # Connect to s3/0 on device R2
210 + s3/1 = F1 1 # Connect to port 1 on device "F1" (a frame relay switch)
212 + a4/0 = A1 1 # Connect to port 1 on device "A1" (an ATM switch)
213 + f5/0 = NIO_linux_eth:eth0 # manually specify an NIO
216 + # Interface f1/0 will automatically be created because the interface was referenced in R1's config
217 + f2/0 = LAN 1 # Connect to bridged LAN 1
223 + [[router R3]] # Case is not significant
224 + # Examples of other manually specified NIOs
225 + f1/0 = NIO_gen_eth:\\Device\\NPF_{B00A38DD-F10B-43B4-99F4-B4A078484487}
226 + f2/0 = NIO_udp:10000:172.0.0.1:10001
227 + f3/0 = NIO_tap:tap0
228 + f4/0 = NIO_unix:/tmp/local:/tmp/remote
229 + f5/0 = NIO_vde:foo:bar
233 +Define an Ethernet Switch
237 + 1 = access 1 # Port 1 is an access port in vlan 1
238 + 2 = access 20 # Port 2 is an access port in vlan 20
239 + 3 = dot1q 1 # Port 3 is a trunk port (dot1q encapsulation) with native vlan 1
240 + 4 = dot1q 1 NIO_gen_eth:eth0 # Port 4 is trunk port (naitive vlan 1) that
241 +is connected to the host eth0 via the gen_eth NIO
242 + #4 = dot1q 1 NIO_gen_eth:\\Device\\NPF_{B00A38DD-F10B-43B4-99F4-B4A078484487}
243 +# Same as above, Windows example
247 +Each FRSW section defines a frame relay switch. All keywords are optional
250 + 1:102 = 2:201 # Tell the FRSW to switch from port 1, DLCI 102 to port 2, DLCI 201.
251 + 1:103 = 3:301 # and from port 1, DLCI 103 to port 3, DLCI 301
259 +Define an ATM Switch
262 + 1:10 = 2:20 # Port 1, vpi 10 to port 2, vpi 20
263 + #1:10:200 = 2:20:100 # Port 1, vpi 10, vci 200 to port 2, vpi 20, vci 100
267 +See /usr/share/doc/dynagen/examples directory
270 +Take a look at the Bug tracking system.
273 +Please send bug reports to http://www.ipflow.utc.fr/bts/
277 +http://www.ipflow.utc.fr/index.php/
281 +http://www.ipflow.utc.fr/blog/
285 +http://dyna-gen.sourceforge.net/
289 +http://hacki.at/7200emu/index.php
293 +\fBdynagen\fP was written by Greg Anuzelli (dynagen@gmail.com)
295 +This manual page was written by Erik Wenzel <erik@debian.org>
296 +for the Debian GNU/Linux system (but may be used by others).
297 diff -urNad dynagen-0.8.3~/setup.py dynagen-0.8.3/setup.py
298 --- dynagen-0.8.3~/setup.py 1970-01-01 00:00:00.000000000 +0000
299 +++ dynagen-0.8.3/setup.py 2007-01-09 22:09:18.000000000 +0000
303 +"""Setup script for the dynagen module distribution."""
304 +# run this like python setup --root=/usr/local
306 +from distutils.core import setup, Extension
308 +setup( # Distribution meta-data
310 + version = "@VERSION@",
311 + description = "A frontend for dynamips",
312 + author = "Greg Anuzelli",
313 + author_email = "dynagen@gmail.com",
314 + url = "http://sourceforge.net/projects/dyna-gen",
316 + scripts = [ 'dynagen' ],
317 + data_files = [ ('/etc/dynagen', ['dynagen.ini']), ('/usr/share/man/man1', ['debian/dynagen.1']),
318 + ('/usr/share/dynagen/', ['configspec']) ],
319 + py_modules = [ 'confConsole', 'console', 'dynamips_lib', 'pemu_lib' ]
322 --- dynagen-0.11.0/dynagen_orig 2010-04-07 18:19:38.000000000 +0200
323 +++ dynagen-0.11.0/dynagen 2010-04-07 18:20:05.000000000 +0200
326 CONFIGSPECPATH = ['/usr/share/dynagen', '/usr/local/share']
327 CONFIGSPEC = 'configspec'
328 -INIPATH = ['/etc', '/usr/local/etc']
329 +INIPATH = ['/etc', '/usr/local/etc', '/etc/dynagen']
330 INIFILE = 'dynagen.ini'
331 MODELTUPLE = ( # A tuple of known model objects