Man Linux: Main Page and Category List

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