.TH LINUX_LOGO 1 "28 October 2001" "Debian" "Debian GNU/Linux Manual"
.SH NAME
linux_logo \- Color ANSI penguin logo w/ system information.
.SH SYNOPSIS
.BR "linux_logo " [ "-h" " | " "-v" " ] [" "-a" " ] [ " "-b" " | " "-c" "] [" "-d" "] [" "-D file" "] [" "-e file" "] [" "-f" "] [" "-g" " | " "-l" "] [" "-k" "] [" "-i" "] [" "-n" "] [" "-p" "] [" "-s" "] [" "-u" "] [" "-x" "] [" "-y" "] [" "-o Num" "] [" "-t string" "] [" "-L num | list | random_xy" "] [" "-F format" "]"
.SH "DESCRIPTION"
.B linux_logo
.SM
is a program that generates a color
.SM ANSI
picture of a penguin which
includes some system information obtained from the /proc filesystem.
.SH OPTIONS
.TP
.B \-h
Show summary of options.
.TP
.B \-v
Show version of program.
.TP
.B \-ascii -a
Display the logo as monochrome ascii.
.TP
.B \-banner -b
Display the banner-style logo.
.TP
.B \-classic -c
Display the original penguin logo.
.TP
.B \-d
Disable "prettying" of output
.TP
.B \-D filename
Use logo from "filename"
.TP
.B \-e filename
Use cpuinfo from "filename" for debugging purposes
.TP
.B \-f
Force the screen clear before drawing the logo.
.TP
.B \-F STRING
Use custom output STRING for sysinfo.  See below for more info.
.TP
.B \-g
Display only the system information.
.TP
.B \-i
Ignore the ~/.linux_logo and /etc/linux_logo.conf config files
.TP
.B \-k
Keep sysinfo flushed-left (non-centered)
.TP
.B \-l
Display only the logo.
.TP
.B \-L ...
Custom logo options.  See README
.TP
.B \-o Num
Shift output Num spaces to the right
.TP
.B \-p
Preserve cursor location
.TP
.B \-s
Skip the BogoMips test [ speeds up display on non-Linux platforms ].
.TP
.B \-t string
Display an arbitrary string
.TP
.B \-u
Display the system uptime.
.TP
.B \-w val
Set screen width to val
.TP
.B \-y
Display the load average.

.SH PROCESSOR INFORMATION
.SS CPUINFO
The cpuinfo supplied in
.I /proc/cpuinfo
is not always usable by
.BR linux_logo.
In the relevant
.I sysinfo_x.c
file there is a place to add custom output formatting to "beautify" the
cpuinfo. For instance "K6 (166 - 266)" is parsed to "K6". Formats have
been added for the K6 and certain Cyrix microprocessors.
.PP
If the cpuinfo for your microprocessor generates ugly output, send the
output from your
.I /proc/cpuinfo
and a sample of how it should look to the author.
.PP
Unfortunately the 2.0.x kernels don't know about newer chips.
So to get
.B linux_logo
to recognize your Pentium II and newer chips you
must find some piece of information in
.I /proc/cpuinfo
that distinguishes them from a pentium pro, or upgrade to a 2.2.x or
2.3.x kernel.
.SS FORMAT
The format string special sequences start with # (use ## to print
#). All other characters, except for \\n,  are printed as is.

.TS
tab (@);
l l l.
Seq@Description@Output
_
##@@#
#B@Bogomips@374.37
#C@Compiled Date@#47 Fri Jan 8 10:37:09 EST 1999
#E@User Text@My Favorite Linux Distribution
@Displayed with \-t@
#H@Hostname@deranged
#L@Load average@Load average 0.04, 0.01, 0.01
#M@Megahertz@188Mhz
@where supported@
#N@Number of CPU's@Two
#O@OS Name@Linux
#P@Processor or Processors@Processor
#R@Ram@64M
@in Megabytes@
#S@Plural@s
#T@Type of CPU@K6
#U@Uptime@Uptime 10 hours 59 minutes
#V@Version of OS@2.2.0-pre5
#X@CPU Vendor@AMD
\\\\n@carriage return@
.TE
.PP
Notes:
.IP \(bu 4
The letter after the # must be capitalized.
.IP \(bu 4
Options not available are silently ignored.
.IP \(bu 4
Megahertz only available on some platforms and newer kernels.
.IP \(bu 4
See
.I
defaults.h
on how to have #N report in non-english numbers.
.IP \(bu 4
Plural [#S] gives nothing if there is 1 cpu, gives 's' otherwise.
.IP \(bu 4
The "\-y" and "\-u" [display uptime and load average] command line
options don't affect the output if a custom format is used.
.PP
The default banner format is:
.PP
"#O Version #V, Compiled #C\\n \\
.br
#N #M#X#T Processor#S, #R RAM, #B Bogomips Total\\n \\
.br
#H\\n"
.PP
The default banner format displays the following on the author's computer:
.TS
center;
c.
Linux Version 2.2.0-pre5, Compiled #47 Fri Jan 8 10:37:09 EST 1999
One 188MHz AMD K6 Processor, 64M RAM, 374.37 Bogomips Total
deranged
.TE
Another example would be:
.PP
linux_logo \-F "Redhat Linux 5.2\\nKernel Version #V\\n#U\\n#L\\n"
.PP
which would display:
.TS
center;
c.
Redhat Linux 5.2
Kernel Version 2.2.0-pre5
Uptime 11 hours 4 minutes
Load average 0.00, 0.00, 0.00
.TE

.SH DEBIAN
The Debian pre-packaged version of
.B linux_logo
includes the Debian logo in addition to the 'Classic' and 'Banner'
logos. The Debian logo is the default logo unless one of the other
logos is specified on the command line.
.SH "CONFIG FILES"
.B ~/.linux_logo
and
.B /etc/linux_logo.conf
can be filled with command line options and will be parsed before the actual command line
.SH "SEE ALSO"
.IR /usr/share/doc/linuxlogo/ ", http://www.deater.net/weave"
.SH AUTHOR
.TP
Vince Weaver
<vince@deater.net>.
.PP
This manual page was written by Steve Kostecke <steve@debian.org>,
for the Debian GNU/Linux system.