~ubuntu-branches/ubuntu/trusty/linuxlogo/trusty

.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 infomation.

.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

100

.B linux_logo

101

to recognize your Pentium II and newer chips you

102

must find some piece of information in

103

.I /proc/cpuinfo

104

that distinguishes them from a pentium pro, or upgrade to a 2.2.x or

105

2.3.x kernel.

106

.SS FORMAT

107

The format string special sequences start with # (use ## to print

108

#). All other characters, except for \\n, are printed as is.

109

110

.TS

111

tab (@);

112

l l l.

113

Seq@Description@Output

114

115

##@@#

116

#B@Bogomips@374.37

117

#C@Compiled Date@#47 Fri Jan 8 10:37:09 EST 1999

118

#E@User Text@My Favorite Linux Distribution

119

@Displayed with \-t@

120

#H@Hostname@deranged

121

#L@Load average@Load average 0.04, 0.01, 0.01

122

#M@Megahertz@188Mhz

123

@where supported@

124

#N@Number of CPU's@Two

125

#O@OS Name@Linux

126

#P@Processor or Processors@Processor

127

#R@Ram@64M

128

@in Megabytes@

129

#S@Plural@s

130

#T@Type of CPU@K6

131

#U@Uptime@Uptime 10 hours 59 minutes

132

#V@Version of OS@2.2.0-pre5

133

#X@CPU Vendor@AMD

134

\\\\n@carriage return@

135

.TE

136

.PP

137

Notes:

138

.IP \(bu 4

139

The letter after the # must be capitalized.

140

.IP \(bu 4

141

Options not available are silently ignored.

142

.IP \(bu 4

143

Megahertz only available on some platforms and newer kernels.

144

.IP \(bu 4

145

See

146

147

defaults.h

148

on how to have #N report in non-english numbers.

149

.IP \(bu 4

150

Plural [#S] gives nothing if there is 1 cpu, gives 's' otherwise.

151

.IP \(bu 4

152

The "\-y" and "\-u" [display uptime and load average] command line

153

options don't affect the output if a custom format is used.

154

.PP

155

The default banner format is:

156

.PP

157

"#O Version #V, Compiled #C\\n \\

158

.br

159

#N #M#X#T Processor#S, #R RAM, #B Bogomips Total\\n \\

160

.br

161

#H\\n"

162

.PP

163

The default banner format displays the following on the author's computer:

164

.TS

165

center;

166

167

Linux Version 2.2.0-pre5, Compiled #47 Fri Jan 8 10:37:09 EST 1999

168

One 188MHz AMD K6 Processor, 64M RAM, 374.37 Bogomips Total

169

deranged

170

.TE

171

Another example would be:

172

.PP

173

linux_logo \-F "Redhat Linux 5.2\\nKernel Version #V\\n#U\\n#L\\n"

174

.PP

175

which would display:

176

.TS

177

center;

178

179

Redhat Linux 5.2

180

Kernel Version 2.2.0-pre5

181

Uptime 11 hours 4 minutes

182

Load average 0.00, 0.00, 0.00

183

.TE

184

185

.SH DEBIAN

186

The Debian pre-packaged version of

187

.B linux_logo

188

includes the Debian logo in addition to the 'Classic' and 'Banner'

189

logos. The Debian logo is the default logo unless one of the other

190

logos is specified on the command line.

191

.SH "CONFIG FILES"

192

.B ~/.linux_logo

193

and

194

.B /etc/linux_logo.conf

195

can be filled with command line options and will be parsed before the actual command line

196

.SH "SEE ALSO"

197

.IR /usr/share/doc/linuxlogo/ ", http://www.deater.net/weave"

198

.SH AUTHOR

199

.TP

200

Vince Weaver

201

<vince@deater.net>.

202

.PP

203

This manual page was written by Steve Kostecke <steve@debian.org>,

204

for the Debian GNU/Linux system.

Older »