"Fossies" - the Fresh Open Source Software Archive

Member "linux_logo-6.0/README" (9 May 2020, 18322 Bytes) of package /linux/misc/linux_logo-6.0.tar.gz:


As a special service "Fossies" has tried to format the requested text file into HTML format (style: standard) with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file. See also the latest Fossies "Diffs" side-by-side code changes report for "README": 5.11_vs_6.0.

    1                                                                  #####         
    2                                                                 #######        
    3                    @                                            ##O#O##        
    4   ######          @@#                                           #VVVVV#
    5     ##             #                                          ##  VVV  ##      
    6     ##         @@@   ### ####   ###    ###  ##### ######     #          ##     
    7     ##        @  @#   ###    ##  ##     ##    ###  ##       #            ##    
    8     ##       @   @#   ##     ##  ##     ##      ###         #            ###   
    9     ##          @@#   ##     ##  ##     ##      ###        QQ#           ##Q   
   10     ##       # @@#    ##     ##  ##     ##     ## ##     QQQQQQ#       #QQQQQQ 
   11     ##      ## @@# #  ##     ##  ###   ###    ##   ##    QQQQQQQ#     #QQQQQQQ 
   12   ############  ###  ####   ####   #### ### ##### ######   QQQQQ#######QQQQQ   
   13 
   14    Linux Version 5.5.0-1-amd64, Compiled #1 SMP Debian 5.5.13-2 (2020-03-30)
   15         Four 2.7GHz Intel i5 Processors, 3.8GB RAM, 12800 Bogomips Total
   16                                    orvavista
   17 /*--------------------------------------------------------------------------*\
   18     LINUX_LOGO 6.0 -- Shows a Logo With some System Info - 9 May 2020
   19     by Vince Weaver ( vince _at_ deater.net, http://www.deater.net/weave )
   20     SUPPORTS Linux (most architectures) and some non-Linux OSes
   21 \*--------------------------------------------------------------------------*/
   22 
   23 HISTORY: 
   24   
   25    Back in the summer of 1997 there was a recurring topic on the linux-kernel
   26    list about having a "boot-up" penguin on all architectures. There 
   27    were many arguments back and forth, but eventually the primary consensus 
   28    was that this would be better done in user-space.  [Eventually the fbcon 
   29    people snuck it in anyway].  In any case, those of us running on text
   30    consoles wanted a penguin too, and barring some attempts to use a vga-font 
   31    hack to get one displayed, the best way to get this was a user-space
   32    text-mode program.
   33    
   34    I used a ppm of the Linux penguin and a ppm2ansi converter from 
   35    Rasterman [www.rasterman.com], and then touched it up with a trial 
   36    version of THEDRAW under DosEmu.  Dredging up some talents left
   37    over from my Ansi-art BBS days I eventually hacked together a rough 
   38    likeness of Ewing's Linux Penguin.  I added some system info from 
   39    /proc, and linux_logo was born.
   40    
   41    The program itself has grown more "feature-full" as people around the
   42    world send in their patches.  The newer versions are primarily minor
   43    cosmetic fixes.  But I get a lot of positive feedback from this tiny
   44    little program I created one summer day........
   45 
   46 -----------------------------------------------------------------------
   47 CONFIG FILES
   48 -----------------------------------------------------------------------
   49 
   50   As of 3.9b5 linux_logo now reads ~/.linux_logo [that is, the
   51      hidden file .linux_logo in your home directory] and
   52      /etc/linux_logo.conf before parsing the command line options.
   53      
   54   The format of the config files is a bit of a hack.  Just put in the
   55   file the command line options you want passed to linux_logo.
   56     
   57   Thus if you put in ~/.linux_logo
   58   
   59 -a -c -F "Linux Logo on a #M Mhz Machine"
   60 
   61   Then when you run "linux_logo" it will automatically show an ASCII classic
   62   logo with the formatting command applied.
   63   
   64   This is a bit ugly, but is was simpler and [at the time] seemed more elegant
   65   than writing a separate dot file parser....
   66  
   67 ----------------------------------------------------------------------->
   68 POTENTIAL USES FOR linux_logo
   69 ----------------------------------------------------------------------->
   70 
   71    There are so many uses, I split them off into a separate "USAGE" file.
   72    
   73 
   74  ----------------------------------------------------------------------->
   75  QUICKLY INSTALLING linux_logo
   76  ----------------------------------------------------------------------->
   77  
   78     untar and uncompress the file
   79         tar -xzvf linux_logo-6.0.tar.gz
   80 	
   81     enter the directory
   82         cd linux_logo-6.0
   83 	
   84     run "configure"
   85         ./configure
   86 	
   87     compile the program
   88         make
   89 	
   90     install (you'll probably want to do this as root) with
   91         make install
   92 	
   93 
   94 -------------------------------------------------------------------------->
   95 ADVANCED LINUX_LOGO Installation
   96 -------------------------------------------------------------------------->
   97 
   98    Destination directory:
   99      
  100       By default linux_logo is installed under /usr/local/
  101       
  102       To change this, run configure with
  103          "./configure --prefix=/usr"
  104       Where you can replace /usr with any location you want.
  105 
  106    Picking logos:
  107 
  108       You can choose which logos are compiled into linux_logo.  
  109       Many contributed logos can be found in the ./logos directory.
  110     
  111       By editing the file logo_config, you can pick which logos are included.
  112     
  113       You can create a linux_logo binary with ALL of them
  114       by doing
  115     
  116          make logos-all
  117        
  118       Note: this will overwrite the current logo_config, so be careful.
  119        
  120       Then use "linux_logo -L list" to see them, or 
  121       "linux_logo -L random" to randomly go through them
  122     
  123    Compile time changes:
  124    
  125       Edit the "defaults.h" file to change a lot of linux_logo's default
  126       behaviors.
  127     
  128    Translations:
  129    
  130       Initial internationalization support has been added.  If you are running
  131       with the LANGUAGE environmental variable set, and there is a translation
  132       for your language, then you should get linux_logo in your own tongue.
  133       
  134       This can be turned off by changing the USE_I18N option at the top
  135       of the defaults.h file.
  136 
  137    Cross compiling:
  138 
  139       If you are using linux_logo on an embedded system you might
  140       want to cross compile.  I tried to make this as easy as possible.
  141    
  142       For example, to cross-compile for avr32 on x86 (assuming you
  143       have all of the avr32 cross-compile tools installed) I do this:
  144    
  145          env CROSS=avr32-linux- ./configure
  146          make CROSS=avr32-linux- LDFLAGS=-static ARCH=avr32
  147        
  148       And the result is a working avr32 version of linux_logo
  149 
  150    On non-Linux architectures:
  151     
  152       You'll have to use GNU make.  This is often called "gmake".
  153 
  154 
  155 
  156 --------------------------------------------------------------------------->
  157 COMMAND LINE OPTIONS
  158 --------------------------------------------------------------------------->
  159 
  160 Usage:   linux_logo [-a] [-b] [-c] [-d] [-D file] [-e file] [-f] [-F] [-g]
  161                     [-h] [-i] [-k] [-l] [-n] [-o num] [-p] [-s] [-t str] [-u] [-v]
  162                     [-w Num] [-x] [-y] [-F format] [-L num | list | random_xx]
  163          [-a]     -- Display an ascii-only Logo
  164          [-b]     -- Display a Banner Logo!
  165          [-c]     -- Display a "Classic" type logo
  166          [-d]     -- disable "prettying" of output
  167          [-D file]-- use custom logo from "file"
  168          [-e file]-- Use "file" instead of /proc/cpuinfo [for debugging
  169          [-f]     -- force the screen clear before drawing
  170          [-F format] Format output.  See README.
  171       B  [-g]     -- give system info only
  172          [-h]     -- this help screen
  173 	 [-i]     -- ignore the ~/.linux_logo and /etc/linux_logo.conf files
  174 	 [-k]	  -- keep sysinfo flushed-left (non-centered)
  175       B  [-l]     -- display logo only
  176       C  [-o Num] -- offset output Num spaces to the right
  177          [-p]     -- preserve cursor location
  178          [-s]     -- skip Bogomips [speeds up on non-Linux platforms]
  179          [-t str] -- display user-supplied string
  180       *  [-u]     -- show uptime
  181          [-v]     -- version information
  182          [-w Num] -- set width of screen to Num [default 80]
  183       *  [-y]     -- show load average
  184          [-L ...] -- multiple Logo options.
  185 
  186  B=Banner mode only, C=Classic Mode Only  *=Works Only in Linux
  187 
  188 
  189 
  190 More detailed explanations:
  191 
  192 [-a]     : This option makes linux_logo output no fancy colors.  This is
  193            useful if you are viewing linux_logo over a black and white 
  194 	   terminal, or a terminal that can't handle fancy escape sequences
  195 	   well [like default win95 telnet].
  196 	   
  197 [-b]     : This option makes linux_logo display the first compiled-in "banner" 
  198            style logo.
  199 	   
  200 [-c]     : This option makes linux_logo display the first compiled-in 
  201            "classic" style logo.  Many people prefer this version of the
  202 	   logo.  I made it myself using some complex manipulation of TheDraw 
  203 	   and the 'official' logo.xpm that comes with the linux_sources.
  204 	   
  205 [-d]     : This option turns off Megahertz rounding and cpuinfo "prettying".
  206            That is, it prints your /proc/cpuinfo's "model name" verbatim,
  207 	   instead of being clever and making it look nice.
  208 
  209 [-D file]: Use an alternate logo on disk.  Just make sure 'file' points
  210            to a valid '.logo' file.  Read README.CUSTOM_LOGOS for more
  211 	   info on how to make these.  Some can be found in the 
  212 	   ./logos directory of the linux_logo distribution.
  213 
  214 [-e file]: Specify an alternate cpuinfo file.  This is only really useful
  215            if you are debugging a /proc/cpuinfo file that is not from
  216 	   your own computer.  Theoretically you could also use this to
  217 	   make your old 386 appear to be a Pentium to users ;)
  218 
  219 [-f]     : This option simply clears the screen before drawing the logo.
  220 
  221 [-F format]: Use this to super-customize the output of the cpuinfo.  You 
  222            pass a string, for example "#V\n#U\n#L\n".  See the section
  223 	   below entitled "THE NEAT NEW FORMAT COMMAND" for further info.
  224 
  225 [-g]     : This option makes linux_logo display the system_info only.
  226            [Note.. this option only works in banner mode].  This is
  227 	   useful if you have your own, better, ansi logo and you don't
  228 	   want to mess with include files.  Just
  229 	   "cat My_Logo >> out; linux_logo -g >> out" to get your logo with
  230 	   my sysinfo.
  231 
  232 [-h]     : This simply displays the help screen, which is much less verbose
  233            than this write-up.
  234 
  235 [-i]     : linux_logo will look in ~/.linux_logo and /etc/linux_logo.conf
  236            for information on how to run linux_logo.  If the -i option
  237 	   is passed, linux_logo will ignore those files
  238 
  239 [-k]    :  keep sysinfo flushed-left (non-centered)
  240 
  241            In older versions of Linux_logo this modified how the logo
  242 	   looked, I apologize for re-using the command-line option,
  243 	   but there are only so many letters of the alphabet.
  244 
  245 [-l]     : This option displays the logo only [Only works in banner mode].
  246            This is useful if for whatever reason you don't want to see the
  247 	   system info.
  248 
  249 [-L num | NAME | list | random_xy]:  This option is used to manipulate compiled-in
  250            custom logos.  As of linux_logo 3.9 you can compile in an
  251 	   arbitrary amount of logos, although the default is to just have
  252 	   the original and banner logos.
  253 	   
  254 	   "-L list" will list all of the logos available
  255 	   "-L NAME" will display the logo with name NAME.
  256 	       the names available can be seen with the "-L list" command
  257 	   "-L num" will display logo number num, where the number is
  258 	       obtained using the "-L list" command
  259 	   "-L random_xy" will pick a logo at random, with criteria xy.
  260 	       When you replace x with the letter:
  261 	          b : pick a random banner mode logo
  262                   c : pick a random classic mode logo
  263                   e : pick a logo from either banner or classic
  264 	       When you replace y with the letter:
  265 	          a: pick a random ascii logo
  266 		  n: pick a non-ascii logo
  267 		  e: pick either type of logo
  268 	       So to summarize "-L random_ba" picks a random ascii banner,
  269 	                       "-L random_ce" picks a random classic logo
  270 			       "-L random_ee" picks any logo, etc, etc
  271 			       
  272 	   See README.CUSTOM_LOGOS for more info
  273 	   
  274 [-n]     : This option has been removed from linux_logo 3.9 and above.
  275            If you want to create a logo that looks different than the
  276 	   default, read README.CUSTOM_LOGOS.
  277 
  278 [-o Num] : This option will offset the logo towards the right of the screen
  279            Num spaces.
  280 
  281 [-p]     : This option preserves the position of the cursor on the screen
  282            while drawing the logo under it.
  283 	   
  284 [-rX]    : This option has been removed from linux_logo 3.9 and above.
  285            If you want to create a logo that looks different than the
  286 	   default, read README.CUSTOM_LOGOS.
  287 
  288 [-s]     : This option skips the bogomips test on non-linux ports.  On 
  289            platforms that don't have the bogomips value in a /proc file,
  290 	   linux_logo calculates the value itself using a GPL'd routine.
  291 	   This can take a while, especially on slower machines, so it can
  292 	   be disabled.
  293 	   
  294 [-t str] : This option displays user-supplied string (for example,
  295            Red Hat release or welcome...')  in first line of system info.
  296            See the "Things to do" section for ways to use this.
  297 	   
  298 [-u]     : This option displays the uptime along with the other system
  299            information.  While useless when putting logos in issue or motd
  300 	   files, this option comes in handy if you are using linux_logo
  301 	   to impress your friends.  Also, when used in conjunction with
  302 	   the -g option, you can use linux_logo in Server-Side includes
  303 	   in web pages.
  304 	   
  305 [-v]     : This option displays the version of linux_logo you are using.
  306 
  307 [-w Num] : Use this option to set the width of the screen.  It helps in trying
  308            to center the banner mode. Default is 80 columns.
  309 	   
  310 [-x]     : This option has been removed from linux_logo 3.9 and above.
  311            If you want to create a logo that is narrower than the
  312 	   default, read README.CUSTOM_LOGOS.
  313 	   
  314 [-y]     : Display the load average.  [Yes I have just about run out of
  315            letters to use as command line options ;)]
  316 
  317 --------------------------------------------------------------------------->
  318 TROUBLESHOOTING
  319 --------------------------------------------------------------------------->
  320 
  321 Know bugs: 
  322   
  323       Different architectures have odd /proc files.  If you send me
  324       a copy of relevant files (/proc/cpuinfo and /proc/version usually)
  325       I can see about adding support.
  326       
  327       On non-Linux platforms the BogoMips check can be quite slow.  To skip
  328          it use "linux_logo -s"
  329       
  330       To make easy updates to ansi files with difficult editors, 
  331          the combination ^[ is read as the ESC code (#27 decimal)
  332 	 so this combination cannot be used in a picture.
  333 	 
  334 ------------------------------------------------------------------------>
  335 THE NEAT FORMAT COMMAND
  336 ------------------------------------------------------------------------>
  337 These are instructions on how to use the Format command added in Linux Logo 3.0
  338 
  339 The command line argument is -F.  
  340 
  341 Special sequences start with "#" use "##" to make the "#" sign.  All other
  342 characters [except "\n", the carriage return] are printed as is.
  343 
  344 Special      Stands For                          Example
  345 ________________________________________________________________
  346   #B     Bogomips                            "374.37"
  347   #C     Compiled Date                       "#47 Fri Jan 8 10:37:09 EST 1999"
  348   #E     User Text [given with the -t]       "Given with -t option"
  349   #H     Hostname                            "deranged"
  350   #L     Load average                        "Load average 0.04, 0.01, 0.01"
  351   #M     Megahertz [where supported]         "188Mhz "
  352   #N     Number of CPU's                     "Two"
  353   #O     Operating System Name               "Linux"
  354   #P     Singular or Plural of "Processor"   "Processor"
  355   #R     Ram [in Megabytes]                  "64M"
  356   #S     Plural                              "s"
  357   #T     Type of CPU                         "K6"
  358   #U     Uptime                              "Uptime 10 hours 59 minutes"
  359   #V     Version of OS                       "2.2.0-pre5"
  360   #X     CPU Vendor                          "AMD "
  361   \n     carriage return
  362 
  363 
  364 Notes:
  365   + The letter after the # must be capitalized.
  366   + Options not available are silently ignored.
  367   + Megahertz only available on some platforms and newer kernels.
  368   + See "defaults.h" on how to have #N report in non-english numbers.
  369   + Plural [#S] gives nothing if there is 1 cpu, gives 's' otherwise.
  370   + Processor [#P] gives "Processor" [or i18n equiv] when 1 cpu,
  371     "Processors" if more than 1.
  372   + The "-y" and "-u" [display uptime and load average] command line options
  373     don't affect the output if a custom format is used.
  374       
  375       
  376 For example the default banner format is
  377 "#O Version #V, Compiled #C\n#N #M#X#T #P, #R RAM, #B Bogomips Total\n#H\n"
  378 
  379 which on my computer gives an output of:
  380        
  381       Linux Version 2.2.0-pre5, Compiled #47 Fri Jan 8 10:37:09 EST 1999
  382          One 188MHz AMD K6 Processor, 64M RAM, 374.37 Bogomips Total
  383 		                    deranged
  384 					
  385 Another example would be
  386   linux_logo -F "Redhat Linux 5.2\nKernel Version #V\n#U\n#L\n"
  387 which would give
  388                                 Redhat Linux 5.2
  389 			    Kernel Version 2.2.0-pre5
  390                             Uptime 11 hours 4 minutes
  391                           Load average 0.00, 0.00, 0.00
  392 			
  393 As you can see, the possibilities are endless.
  394 
  395 
  396 ------------------------------------------------------------------------>
  397 CREATING/USING CUSTOM LOGOS
  398 ------------------------------------------------------------------------>
  399   See the file README.CUSTOM_LOGOS for more than you ever wanted to know
  400   about making and using your own logo files.
  401      
  402 ------------------------------------------------------------------------->
  403 WHERE TO GET LINUX_LOGO:
  404 ------------------------------------------------------------------------->
  405   http://www.deater.net/weave/vmwprod/linux_logo
  406   http://sunsite.unc.edu/pub/Linux/logos/penguin/
  407   
  408 Check out other programs by me at http://www.deater.net/weave/vmwprod
  409 
  410 -------------------------------------------------------------------------->
  411 THANKS
  412 -------------------------------------------------------------------------->
  413 
  414    Many thanks to the people sending in patches and /proc/cpuinfo entries.
  415    Without you linux_logo wouldn't work on so many machines.
  416    
  417    Special thanks to Kristina (KRG) and my friends John Clemens and Marie
  418    Prosser.
  419    
  420 -----------------
  421 Vince
  422 vince _at_ deater.net