Imported Upstream version 4.6.0
[debian/atlc] / man / man1 / sysdata.1
1 .TH sysdata 1 "atlc-4.5.0 28th Sep 2003" "Dr. David Kirkby"
2 .ds n 5
3 .SH NAME
4 \fBsysdata\fR - find basic hardware system data
5 .SH SYNOPSIS
6 \fBsysdata\fR
7 .br
8 .SH DESCRIPTION
9 After the \fBatlc\fR package is built, a small benchmark is run as part of the testing procedure. This benchmark
10 tries to get some information about the hardware. The program \fBsysdata\fR displays the same hardware information
11 that the benchmark will display, but runs in a fraction of a second, whereas the benchmark can take from 19 s
12 (quad 1.4 GHz Itainium 2 machine) to 14,906 s (for a very old 33.3 MHz Cray Y-MP). There are no options or
13 arguments to \fBsysdata\fR
14 .PP
15 The information gathered on hardware and software both developed by the same company (i.e. Solaris on Suns, AIX
16 on IBM RS/6000, IRIX on SGI, ... etc etc) is generally more informative than the free systems (Linux, NetBSD,
17 OpenBSD, FreeBSD) where it is usually impossible to get much hardware information. 
18 .SH EXAMPLES
19 Here are some examples of the use of \fBsysdata\fR on a number of systems. The large number of examples is for
20 my own use as much as anything, so I can keep track of the development of sysdata and see easily where it needs
21 extending. Examples are presented for:
22 .br
23 .PP
24 1) Sun Ultra 80 running Solaris 9
25 .br
26 2) HP C3000 running HP-UX 11
27 .br
28 3) SGI Octane running IRIX 6.5.16
29 .br
30 4) IBM RS/6000 running AIX 5.2
31 .br
32 5) Dec Alpha 600a Personal Workstation running Tru64 5.1B
33 .br
34 6) Cray Y-MP running UNICOS 9
35 .br
36 7) Sun SPARCstation 20 running NetBSD 1.6
37 .br
38 8) Sun SPARCstation 20 running OpenBSD 3.2
39 .br
40 9) Sun SPARCstation 20 running Debian Linux
41 .br
42 10) Sun SPARCstation 20 running Solaris 2.5  
43 .br
44 11) Generic PC with 350 MHz Pentium II running Redhat Linux 7.2
45 .br
46 .PP
47 .br
48 Here's the output from \fBsysdata\fR on these 11 systems. 
49 .PP
50 .br
51 \fBe.g. 1 (Sun Ultra 80 running Solaris 9)\fR
52 .br
53 Hardware provider:    Sun_Microsystems
54 .br
55 Hardware platform:    SUNW,Ultra-80
56 .br
57 Machine:              sun4u
58 .br
59 Sysname:              SunOS
60 .br
61 Release:              5.9
62 .br
63 Version:              Generic_112233-06
64 .br
65 Nodename:             sparrow
66 .br
67 #CPUs supported:      4
68 .br
69 #CPUs online:         4
70 .br
71 CPU type:             sparcv9
72 .br
73 FPU type:             sparcv9
74 .br
75 Speed:                450 MHz
76 .br
77 RAM:                  4096 Mb
78 .br
79 L1 data cache         unknown kB
80 .br
81 L1 instruction cache: unknown kB
82 .br
83 L2 cache:             unknown kB
84 .PP
85 Here's an example on a HP 9000 series Visualize C3000 workstation, fitted with one 400 MHz PA-RISC 8500 CPU and 1.5 Gb of RAM
86 .PP
87 \fBe.g. 2 (HP 9000 series Visualize C3000)\fR
88 .br
89 Hardware provider:    HP      
90 .br
91 Hardware platform:    unknown
92 .br
93 Machine:              9000/785
94 .br
95 Sysname:              HP-UX
96 .br
97 Release:              B.11.00
98 .br
99 Version:              A
100 .br
101 Nodename:             robin
102 .br
103 #CPUs supported:      1
104 .br
105 #CPUs online:         1
106 .br
107 CPU type:             532
108 .br
109 FPU type:             1048577
110 .br
111 Speed:                400.0 MHz
112 .br
113 RAM:                  1536 Mb
114 .br
115 L1 data cache         unknown kb
116 .br
117 L1 instruction cache: unknown kb
118 .br
119 L2 cache:             unknown kb
120 .PP
121 .br
122 Here's another example this time on an SGI Octane R10000 with 2 x 195 MHz processors. Note the CPU and FPU types
123 reported at not the R10000 and R10010 that are reported by SGI's hinv. \fBsysdata\fR is not meant to replace other
124 more sophisticated ways of obtaining system information (such as hinv on IRIX), but its data is useful to record for benchmarking purposes. 
125 .br
126 .PP
127 \fBe.g. 3 (SGI Octane R1000) \fR
128 .br
129 Hardware provider:    SGI
130 .br
131 Hardware platform:    unknown
132 .br
133 Machine:              IP30
134 .br
135 Sysname:              IRIX64
136 .br
137 Release:              6.5
138 .br
139 Version:              04101931
140 .br
141 Nodename:             owl
142 .br
143 #CPUs supported:      unknown
144 .br
145 #CPUs online:         2 
146 .br
147 CPU type:             2343
148 .br
149 FPU type:             2304
150 .br
151 Speed:                195 MHz
152 .br
153 RAM:                  1024 Mb
154 .br
155 L1 data cache         32 kB
156 .br
157 L1 instruction cache: 32 kB
158 .br
159 L2 cache:             1024 kB
160 .br
161 .PP
162 Here's an example using an IBM RS/6000 F50 with 4 x 332 MHz CPUs and 1 GB of RAM.
163 .PP
164 .br
165 \fBe.g. 4 (IBM RS/6000 F50)\fR
166 .br
167 Hardware provider:    IBM
168 .br
169 Hardware platform:    unknown
170 .br
171 Machine:              000245984C00
172 .br
173 Sysname:              AIX
174 .br
175 Release:              2
176 .br
177 Version:              5
178 .br
179 Nodename:             starling
180 .br
181 #CPUs supported:      unknown
182 .br
183 #CPUs online:         4
184 .br
185 CPU type:             unknown
186 .br
187 FPU type:             unknown
188 .br
189 Speed:                unknown MHz
190 .br
191 RAM:                  1024 Mb
192 .br
193 L1 data cache         unknown kB
194 .br
195 L1 instruction cache: unknown kB
196 .br
197 L2 cache:             unknown kB
198 .PP
199 .br
200 And here's an example from a single 599 MHz processor Dec Alpha 600a Personal Workstation running Tru64 5.1B
201 .PP
202 .br
203 \fBe.g. 5 (Dec Alpha 600a Personal Workstation)\fR
204 .br
205 Hardware provider:    unknown
206 .br
207 Hardware platform:    Digital_Personal_WorkStation_600au
208 .br
209 Machine:              alpha
210 .br
211 Sysname:              OSF1
212 .br
213 Release:              V5.1
214 .br
215 Version:              2650
216 .br
217 Nodename:             dobermann.localhost.ntlworld.co
218 .br
219 #CPUs supported:      1
220 .br
221 #CPUs online:         1
222 .br
223 CPU type:             EV5.6_(21164A)
224 .br
225 FPU type:             unknown
226 .br
227 Speed:                599 MHz
228 .br
229 RAM:                  1024 Mb
230 .br
231 L1 data cache         unknown kb
232 .br
233 L1 instruction cache: unknown kb
234 .br
235 L2 cache:             unknown kb
236 .PP
237 .br
238 Here's some data collected on a very old Cray Y-MP, which was introduced in 1991.
239 .PP
240 .br
241 \fBe.g 6 (Cray Y-MP running UNICOS)\fR
242 .PP
243 .br
244 Hardware provider:    Cray
245 .br
246 Hardware platform:    Y-MP
247 .br
248 Machine:              CRAY_Y-MP
249 .br
250 Sysname:              sn5176
251 .br
252 Release:              9.0.2.2
253 .br
254 Version:              sin.0
255 .br
256 Nodename:             sn5176
257 .br
258 #CPUs supported:      unknown
259 .br
260 #CPUs online:         4
261 .br
262 CPU type:             unknown
263 .br
264 FPU type:             unknown
265 .br
266 Speed:                33.3 MHz
267 .br
268 RAM:                  unknown Mb
269 .br
270 L1 data cache         unknown kb
271 .br
272 L1 instruction cache: unknown kb
273 .br
274 L2 cache:             unknown kb
275
276 That is all the examples of commercial hardware running the operating systems made by the manufacturers of the
277 hardware. The following are free UNIX versions. In these cases the data gathered is never as complete. In
278 particular the amoumt of memory reported if often less than the real amount due to memory taken by the
279 operating system (kernel etc). The number of processors the system can support is never available. 
280 .PP
281 Here's the first such non-commercial UNIX from a single processor Sun SPARCstation 20 running NetBSD 1.6. 
282 .PP
283 .br
284 \fBe.g. 7 (Sun SPARCstation 20 running NetBSD 1.6)\fR
285 .br
286 Hardware provider:    unknown
287 .br
288 Hardware platform:    unknown
289 .br
290 Machine:              sparc
291 .br
292 Sysname:              NetBSD
293 .br
294 Release:              1.6
295 .br
296 Version:              NetBSD_1.6_(GENERIC)_#0:_Mon_Sep__9_08:2sparc
297 .br
298 Nodename:             blackbird
299 .br
300 #CPUs supported:      unknown
301 .br
302 #CPUs online:         1 
303 .br
304 CPU type:             rg:/autobuild/sparc/OBJ/autobuild/src/sys/arch/sparc/compile/GENERIC
305 .br
306 FPU type:             unknown
307 .br
308 Speed:                unknown MHz
309 .br
310 RAM:                  255 Mb
311 .br
312 L1 data cache         unknown kb
313 .br
314 L1 instruction cache: unknown kb
315 .br
316 L2 cache:             unknown kb
317 .br
318 .PP
319 Here's data from a Sun SPARCstation 20 running OpenBSD 3.2. The machine has 320 Mb of RAM, not 318 Mb as
320 indicated. The number of processors the system supports is reported as unknown, but should the system have been
321 running Solaris 9, as in the example 1 (sparrow), then this information would have
322 been determined, but it is not available under OpenBSD - or Solaris 2.5 for that matter.
323 .PP
324 .br
325 \fBe.g. 8 (Sun SPARCstation 20 running OpenBSD 3.2)\fR
326 .br
327 Hardware provider:    unknown
328 .br
329 Hardware platform:    unknown
330 .br
331 Machine:              sparc
332 .br
333 Sysname:              OpenBSD
334 .br
335 Release:              3.2
336 .br
337 Version:              GENERIC#36
338 .br
339 Nodename:             crow.crow.localdomain
340 .br
341 #CPUs supported:      unknown
342 .br
343 #CPUs online:         1 
344 .br
345 CPU type:             unknown
346 .br
347 FPU type:             unknown
348 .br
349 Speed:                unknown MHz
350 .br
351 RAM:                  319 Mb
352 .br
353 L1 data cache         unknown kb
354 .br
355 L1 instruction cache: unknown kb
356 .br
357 L2 cache:             unknown kb
358 .br
359 The next machine is a Sun SPARCstation 20 running Debian Linux. The version of Debian is unknown, but clearly
360 \fBsysdata\fR is unable to determine this.
361 .PP
362 .br
363 \fBe.g. 9 (Sun SPARCstation 20 running Debian Linux)\fR
364 .PP
365 .br
366 Hardware provider:    unknown
367 .br
368 Hardware platform:    unknown
369 .br
370 Machine:              sparc
371 .br
372 Sysname:              Linux
373 .br
374 Release:              2.2.20
375 .br
376 Version:              #1_Fri_Nov_16_15:48:02_EST_2001
377 .br
378 Nodename:             dove
379 .br
380 #CPUs supported:      unknown
381 .br
382 #CPUs online:         1
383 .br
384 CPU type:             unknown
385 .br
386 FPU type:             unknown
387 .br
388 Speed:                unknown MHz
389 .br
390 RAM:                  281 Mb
391 .br
392 L1 data cache         unknown kb
393 .br
394 L1 instruction cache: unknown kb
395 .br
396 L2 cache:             unknown kb
397
398 Here's data from a Sun SPARCstation 20 running Solaris 2.5 (SunOS 5.5). The machine probably does have 352 Mb of RAM as
399 reported. The number of processors the system supports is reported as unknown, but should the system have been
400 running Solaris 9, as in the example 1 (sparrow), then this information would have been determined, but it is not available under Solaris 2.5. 
401 .PP
402 .br
403 \fBe.g. 10 (Sun SPARCstation 20 Solaris 2.5)\fR
404 .br
405 Hardware provider:    Sun_Microsystems
406 .br
407 Hardware platform:    SUNW,SPARCstation-20
408 .br
409 Machine:              sun4m
410 .br
411 Sysname:              SunOS
412 .br
413 Release:              5.5
414 .br
415 Version:              Generic
416 .br
417 Nodename:             bluetit
418 .br
419 #CPUs supported:      unknown
420 .br
421 #CPUs online:         2
422 .br
423 CPU type:             sparc
424 .br
425 FPU type:             sparc
426 .br
427 Speed:                125 MHz
428 .br
429 RAM:                  352 Mb
430 .br
431 L1 data cache         unknown kb
432 .br
433 L1 instruction cache: unknown kb
434 .br
435 L2 cache:             unknown kb
436
437 .br
438 .PP
439 Here's a standard PC, fitted with one processor
440 .PP
441 .br
442 \fBe.g. 11 (350 MHz Pentium II PC running Redhat Linux)\fR 
443 .br
444 Hardware provider:    unknown
445 .br
446 Hardware platform:    unknown
447 .br
448 Machine:              i686
449 .br
450 Sysname:              Linux
451 .br
452 Release:              2.4.18-5
453 .br
454 Version:              #1_Mon_Jun_10_15:31:48_EDT_2002
455 .br
456 Nodename:             tiger
457 .br
458 #CPUs supported:      unknown
459 .br
460 #CPUs online:         1
461 .br
462 CPU type:             unknown
463 .br
464 FPU type:             unknown
465 .br
466 Speed:                unknown MHz
467 .br
468 RAM:                  123 Mb
469 .br
470 L1 data cache         unknown kb
471 .br
472 L1 instruction cache: unknown kb
473 .br
474 L2 cache:             unknown kb
475 .br
476
477 .SH FILES
478 sysdata does not read/write any files. 
479 .SH SEE ALSO
480 atlc(1)
481 .br
482 create_bmp_for_circ_in_circ(1)
483 .br
484 create_bmp_for_circ_in_rect(1)
485 .br
486 create_bmp_for_microstrip_coupler(1)
487 .br
488 create_bmp_for_rect_cen_in_rect(1)
489 .br
490 create_bmp_for_rect_cen_in_rect_coupler(1)
491 .br
492 create_bmp_for_rect_in_circ(1)
493 .br
494 create_bmp_for_rect_in_rect(1)
495 .br
496 create_bmp_for_stripline_coupler(1)
497 .br
498 create_bmp_for_symmetrical_stripline(1)
499 .br
500 design_coupler(1)
501 .br
502 find_optimal_dimensions_for_microstrip_coupler(1)
503 .br
504 hinv - SGI's IRIX only.
505 .br
506 readbin(1)
507 .P 
508 .br
509 http://atlc.sourceforge.net                - Home page 
510 .br
511 http://sourceforge.net/projects/atlc       - Download area
512 .br
513 atlc-X.Y.Z/docs/html-docs/index.html       - HTML docs
514 .br
515 atlc-X.Y.Z/docs/qex-december-1996/atlc.pdf - theory paper
516 .br
517 atlc-X.Y.Z/examples                        - examples
518 .br