dynagen-debian.patch

   1 --- dynagen-0.10.1.orig/debian/dynagen.1
   2 +++ dynagen-0.10.1/debian/dynagen.1
   3 @@ -0,0 +1,293 @@
   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.
   9 +.\"
  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)
  20 +.SH NAME
  21 +dynagen \- command line interface to dynamips Cisco 7200 Emulator
  22 +.SH SYNOPSIS
  23 +.B dynagen
  24 +.RI [ options ]
  25 +\fIconfiguration file\fP
  26 +.br
  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,
  29 +.\" respectively.
  30 +.SH DESCRIPTION
  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.
  39 +.br
  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.
  44 +.PP
  45 +Before running \fBdynagen\fP you need to start \fIdynamips\fP:
  46 +.PP
  47 +.UE
  48 +nice dynamips \-H 7200 &
  49 +.UR
  50 +.PP
  51 +.SH OPTIONS
  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.
  54 +.TP
  55 +.B \-n, \-\-nosend
  56 +Do not send any command to dynamips.
  57 +.TP
  58 +.B \-d, \-\-debug
  59 +Show debugging information.
  60 +.TP
  61 +.B \-h, \-\-help
  62 +Show summary of options.
  63 +.TP
  64 +.B \-\-version
  65 +Show version.
  66 +.SH CONFIGURATION FILE OPTIONS
  67 +Empty lines or lines starting with a hash ('#') are ignored.
  68 +.br
  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.
  73 +
  74 +.br
  75 +.B Server Section:
  76 +[<ip-address|hostname>]
  77 +.br
  78 +.B Device Section:
  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
  82 +.br
  83 +.TP
  84 +.B Global Configuration variable
  85 +.B autostart <true/false> (Default: True)
  86 +.br
  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
  89 +(start /all).
  90 +.TP
  91 +.B Server Configuration variables
  92 +.B port <1-65535> (Default: 7200)
  93 +.br
  94 +Hypervision port to connect to.
  95 +.br
  96 +.B workingdir <path> (Default: None)
  97 +.br
  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
 100 +\fIdynamips\fP.
 101 +.br
 102 +.B console <1-65535> (Default: 2000)
 103 +.br
 104 +Base console port. New instances that do not specify a console port will
 105 +default to this + the instance number.
 106 +.br
 107 +.B udp <1-65535> (Default: 10000)
 108 +.br
 109 +Set the base UDP port for NIOs.
 110 +.br
 111 +.TP
 112 +.B Device Configuration variables
 113 +.TP
 114 +.B [[7200]]
 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.
 118 +
 119 +.B image <path/file> (Default: None)
 120 +.br
 121 +Full path to 7200 IOS image file. This is the fully qualified path relative to the system running dynamips.
 122 +.br
 123 +.B ram <integer> (Default: None)
 124 +Amount of Virtual RAM to allocate to each router instance.
 125 +.br
 126 +.B rom <integer> (Default: None)
 127 +.br
 128 +Size of ROM.
 129 +.br
 130 +.B nvram <integer> (Default: None)
 131 +.br
 132 +Size of NVRAM.
 133 +.br
 134 +.B disk0 <integer> (Default: None)
 135 +.br
 136 +Set size of PCMCIA ATA disk0
 137 +.br
 138 +.B disk1 <integer> (Default: None)
 139 +.br
 140 +Set size of PCMCIA ATA disk1
 141 +.br
 142 +.B cnfg <path/file> (Default: None)
 143 +.br
 144 +Configuration file to import. This is the fully qualified path relative to the
 145 +system running dynamips.
 146 +.br
 147 +.B confreg <hex> (Default: 0x2102) 0x210X where X=0,1,2
 148 +.br
 149 +Set the configuration register
 150 +.br
 151 +.B idlepc <string> (Default: None)
 152 +.br
 153 +Set the Idle PC value.
 154 +Include a description here.
 155 +.br
 156 +.B exec_area <string> (Default: None)
 157 +.br
 158 +Set the exec area size.
 159 +.br
 160 +.B clock <integer> (Default: None)
 161 +.br
 162 +Clock divisor (should no longer been needed as of dynamips 0.2.5 RC1)
 163 +.br
 164 +.B npe <npe-100|150|175|200|225|300|400> (Default: None)
 165 +.br
 166 +NPE type.
 167 +.br
 168 +.B midplane <std|vxr> (Default: None)
 169 +.br
 170 +Midplane, either "std" or "vxr"
 171 +.br
 172 +.B mmap <binary> (Default: True)
 173 +.br
 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.
 176 +.TP
 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.
 180 +.br
 181 +.B model 7200 (Default: 7200)
 182 +.br
 183 +.B console <1-65535> (Default: None)
 184 +.br
 185 +Console port. Defaults to the server's base console port (specified in the server section) + instance number.
 186 +.br
 187 +.B aux <1-65535> (Default: None)
 188 +.br
 189 +Aux port.
 190 +.br
 191 +.B slotX <0-X> <PA-C7200-IO-FE|PA-FE-TX|PA-4T|PA-4E|PA-POS-OC3> (Default: None)
 192 +.br
 193 +Manual PA specification. This is optional, and if not done \fBdynagen\fP will
 194 +make sane decisions based on the interface specifications.
 195 +.RI
 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
 201 +
 202 +.br
 203 +.B <local interface> = <remote interface>
 204 +.br
 205 +Interface specification. Can take the following forms:
 206 +.RI
 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)
 211 +    s3/2 = F2 1
 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
 214 +
 215 +    [[ROUTER R2]]
 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
 218 +    s4/0 = F1 2
 219 +    s4/1 = F2 2
 220 +    s4/2 = F1 3
 221 +    a5/0 = A1 2
 222 +
 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
 230 +.br
 231 +.TP
 232 +.B [[ETHSW <name>]]
 233 +Define an Ethernet Switch
 234 +.br
 235 +.RI
 236 +    [[ETHSW S1]]
 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
 244 +.br
 245 +.TP
 246 +.B [[FRSW <name>]]
 247 +Each FRSW section defines a frame relay switch. All keywords are optional
 248 +.br
 249 +.RI
 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
 252 +
 253 +    [[FRSW F2]]
 254 +    1:102 = 2:201
 255 +
 256 +.br
 257 +.TP
 258 +.B [[ATMSW <name>]]
 259 +Define an ATM Switch
 260 +.br
 261 +.RI
 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
 264 +
 265 +.SH EXAMPLES
 266 +.br
 267 +See /usr/share/doc/dynagen/examples directory
 268 +.SH BUGS
 269 +.br
 270 +Take a look at the Bug tracking system.
 271 +.SH REPORTING BUGS
 272 +.br
 273 +Please send bug reports to http://www.ipflow.utc.fr/bts/
 274 +.SH SEE ALSO
 275 +.br
 276 +.UR
 277 +http://www.ipflow.utc.fr/index.php/
 278 +.UE
 279 +.br
 280 +.UR
 281 +http://www.ipflow.utc.fr/blog/
 282 +.UE
 283 +.br
 284 +.UR
 285 +http://dyna-gen.sourceforge.net/
 286 +.UE
 287 +.br
 288 +.UR
 289 +http://hacki.at/7200emu/index.php
 290 +.UE
 291 +.br
 292 +.SH AUTHOR
 293 +\fBdynagen\fP was written by Greg Anuzelli (dynagen@gmail.com)
 294 +.br
 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
 300 @@ -0,0 +1,20 @@
 301 +#!@PYTHON@
 302 +
 303 +"""Setup script for the dynagen module distribution."""
 304 +# run this like python setup --root=/usr/local
 305 +
 306 +from distutils.core import setup, Extension
 307 +
 308 +setup( # Distribution meta-data
 309 +    name = "dynagen",
 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",
 315 +
 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' ]
 320 +)
 321 +
 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
 324 @@ -43,7 +43,7 @@
 325  VERSION = '0.11.0'
 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
 332      C1700,