NAME

       lphdisk - prepare a hibernation partition for NoteBIOS suspend-to-disk

SYNOPSIS

       lphdisk  [  -h,  --help  ]  [  -p,  --probeonly ] [ -q, --quiet ] [ -d,
       --debug ] [ -n, --nowrite ] [ -f, --force ] [ device ]

DESCRIPTION

       lphdisk prepares  a  hard  disk  for  use  with  APM  "Suspend-to-disk"
       features,  as implemented on laptop computers running Phoenix NoteBIOS.
       Currently, the utility only formats an already created partition set to
       type  A0  with  a  disk  partitioning utility such as fdisk(8).  device
       should be a full-disk device  (such  as  /dev/hda  or  /dev/sda  )  and
       defaults to /dev/hda .

       Since  most laptops only have one IDE hard disk, and all known NoteBIOS
       configurations will only look to the first bootable hard drive  anyway,
       the default value for device is correct for most cases.

       In  order  to  properly prepare a hard disk for suspend-to-disk on your
       laptop, you will need to make  sure  there  is  enough  space  free  to
       accommodate   an  additional  hibernation  partition.  The  hibernation
       partition must be a primary partition (1-4), and the required size will
       be  determined  by the amount of physical and video RAM in your laptop.
       To determine the size you need to make  the  partition,  the  following
       calculation is a good rule of thumb:

              physical RAM + video memory + 2MB

       Alternately, you can run lphdisk --probeonly to have lphdisk attempt to
       determine  your  memory  requirements  and  calculate   a   reccomended
       partition size for you.

       Having  created  a  primary  partition  of the proper size using a disk
       partitioning utility, you should set it to type A0 hex  (identified  by
       fdisk   as   "IBM   ThinkPad  Hibernation",  though  "Phoenix  NoteBIOS
       Hibernation" would be a more correct label).

       lphdisk will then locate, verify, and format this partition for use. At
       this  point  you will need to reboot the system so that BIOS can locate
       and use the new hibernation partition.

       Once the system has been rebooted, you should be able  to  perform  the
       suspend-to-disk  function of your BIOS using the normal procedure ( Fn-
       F12 on many laptops, though some differ.  The apm --suspend command may
       or  may  not also do this, depending on the BIOS).  You will know it is
       working properly if you see a Phoenix NoteBIOS screen appear indicating
       the  progress  of  saving memory to disk before the machine powers off,
       and a similar screen indicating resume progress when it is  started  up
       again  (if  you  do not see this screen, it is likely that the BIOS has
       entered suspend-to-RAM mode instead, and is not successfully using  the
       hibernate partition).

OPTIONS

       -h, --help
              show terse usage information and available options.

       -p, --probeonly
              Probe  for  and  calculate  the  required partition size for the
              current system, but do not attempt to format anything.

       -q, --quiet
              tells lphdisk to be quiet: the normal output messages  will  not
              be displayed.

       -d, --debug
              turns on (copious) debugging output.

       -n, --nowrite
              tells  lphdisk to do everything it would normally do, but not to
              actually write data to the disk.  Useful for testing.

       -f, --force
              force lphdisk to  proceed,  regardless  of  potential  problems.
              This option is dangerous and could cause disk corruption!

TODO

       Currently  lphdisk only formats an already properly created hibernation
       partition. It is the goal of this utility to be able to detect physical
       and video memory as well as create the partition before formatting it.

BUGS

       No  known  bugs,  but that doesn't mean they're not in there.  However,
       functionality is not yet complete.

AUTHORS

       Patrick D. Ashmore <pda@procyon.com>
       Alex Stewart <alex@foogod.com>

SEE ALSO

       fdisk(8), cfdisk(8), sfdisk(8), apm(1) apmd(8)