NAME

       longrun - Transmeta(TM) Crusoe(TM) LongRun(TM) utility

SYNOPSIS

       longrun  [-c  device]  [-m  device] [-hlpv] [-f flag] [-s low high] [-t
       num]

DESCRIPTION

       The longrun utility is used to control and query  LongRun  settings  on
       Transmeta Crusoe processors.

       -c device
              Set   the   CPUID   device.    The   default   CPUID  device  is
              /dev/cpu/0/cpuid.

       -m device
              Set the MSR device.  The default MSR device is /dev/cpu/0/msr.

       -h     Print help.

       -l     List LongRun information about available performance levels  for
              the CPU.

              The  following  values  are  reported on all Transmeta CPUs that
              implement LongRun.

                 %      An  available  performance  level,  expressed   as   a
                        percentage of range of available core CPU frequencies.
                        0 corresponds to the lowest  available  frequency  and
                        100 corresponds to the highest.

                 MHz    The core CPU frequency at that level.

                 Volts  The core CPU voltage at that level.

                 usage  The  power  usage  relative to the maximum performance
                        level.

       -p     Print current LongRun settings and status:  whether  LongRun  is
              enabled,  whether  LongRun  Thermal  Extensions  are active, the
              current LongRun performance window (expressed  as  a  percentile
              range),  the  current  LongRun performance level (expressed as a
              percentile), and the current LongRun flags.

       -v     Be more verbose.

       -f flag
              Set a LongRun mode flag.  Currently, the two supported flags are
              performance and economy.  This controls whether the processor is
              in "performance mode" or "economy mode".

       -s low high
              Set the current  LongRun  performance  window  as  a  percentile
              range.   The  low number cannot be greater than the high number.
              The minimum and maximum performance values accepted by  the  CPU
              are 0 and 100, respectively.

       -t num Set  current  LongRun  Thermal  Extensions  setting (0 to 8, 8 =
              off).  Take care with -t 0 and -t 1.

              Longrun Thermal  Extensions  (LTX)  is  an  alternative  way  to
              manipulate  the  power saving functionality of the processor, by
              controlling heat dissipation directly.   Settings  2  through  8
              represent   power   utilization   levels   from   25%  to  100%,
              respectively, in 12.5% increments.  NOTE: Settings 0 and  1  are
              listed  as  'reserved'  in  the  TM5600 literature.  Though they
              appear to represent 0% and  12.5%  respectively  on  the  TM5800
              chip, use these settings at your own risk.

              Interaction with the -s flag: Originally intended as a mechanism
              to  use  Transmeta  chips  on  fanless  machines  (referred   to
              apocryphally  as  "coolrun"), the -t flag limits the power range
              of the processor.  The performance range  of  the  processor  is
              limited first by the -t flag, and then subsequently the -s flag.
              In other words, setting both '-s 57 100'  and '-t 6' will result
              in the processor running in the 57 to 75% power range.

              Notes:  This  functionality  may  or  may  not  provide you with
              different performance per  watt  characteristings  than  the  -s
              flag.   It is provided for completeness, and left as an exercise
              to the reader to decide if it is appropriate  on  their  system.
              As mentioned above, use the -t 0 and -t 1 settings with caution.

ENVIRONMENT

       No environment variables are used.

FILES

       This  program requires that the Linux CPUID and MSR devices be compiled
       into the kernel (or loaded as kernel modules), that the CPUID character
       device  be readable, and that the MSR character device be both readable
       and writable.

SEE ALSO

       acpid(8), apmd(8), hdparm(8)

AUTHOR

       Daniel Quinlan <quinlan@transmeta.com>

                               February 14, 2001                    LONGRUN(1)