kernel/power/disk.c

   1 /*
   2  * kernel/power/disk.c - Suspend-to-disk support.
   3  *
   4  * Copyright (c) 2003 Patrick Mochel
   5  * Copyright (c) 2003 Open Source Development Lab
   6  * Copyright (c) 2004 Pavel Machek <pavel@suse.cz>
   7  *
   8  * This file is released under the GPLv2.
   9  *
  10  */
  11
  12 #include <linux/suspend.h>
  13 #include <linux/syscalls.h>
  14 #include <linux/reboot.h>
  15 #include <linux/string.h>
  16 #include <linux/device.h>
  17 #include <linux/delay.h>
  18 #include <linux/fs.h>
  19 #include <linux/mount.h>
  20 #include <linux/pm.h>
  21 #include <linux/console.h>
  22 #include <linux/cpu.h>
  23 #include <linux/freezer.h>
  24
  25 #include "power.h"
  26
  27
  28 static int noresume = 0;
  29 char resume_file[256] = CONFIG_PM_STD_PARTITION;
  30 dev_t swsusp_resume_device;
  31 sector_t swsusp_resume_block;
  32
  33 enum {
  34         HIBERNATION_INVALID,
  35         HIBERNATION_PLATFORM,
  36         HIBERNATION_TEST,
  37         HIBERNATION_TESTPROC,
  38         HIBERNATION_SHUTDOWN,
  39         HIBERNATION_REBOOT,
  40         /* keep last */
  41         __HIBERNATION_AFTER_LAST
  42 };
  43 #define HIBERNATION_MAX (__HIBERNATION_AFTER_LAST-1)
  44 #define HIBERNATION_FIRST (HIBERNATION_INVALID + 1)
  45
  46 static int hibernation_mode = HIBERNATION_SHUTDOWN;
  47
  48 static struct hibernation_ops *hibernation_ops;
  49
  50 /**
  51  * hibernation_set_ops - set the global hibernate operations
  52  * @ops: the hibernation operations to use in subsequent hibernation transitions
  53  */
  54
  55 void hibernation_set_ops(struct hibernation_ops *ops)
  56 {
  57         if (ops && !(ops->prepare && ops->enter && ops->finish
  58             && ops->pre_restore && ops->restore_cleanup)) {
  59                 WARN_ON(1);
  60                 return;
  61         }
  62         mutex_lock(&pm_mutex);
  63         hibernation_ops = ops;
  64         if (ops)
  65                 hibernation_mode = HIBERNATION_PLATFORM;
  66         else if (hibernation_mode == HIBERNATION_PLATFORM)
  67                 hibernation_mode = HIBERNATION_SHUTDOWN;
  68
  69         mutex_unlock(&pm_mutex);
  70 }
  71
  72
  73 /**
  74  *      platform_prepare - prepare the machine for hibernation using the
  75  *      platform driver if so configured and return an error code if it fails
  76  */
  77
  78 static int platform_prepare(int platform_mode)
  79 {
  80         return (platform_mode && hibernation_ops) ?
  81                 hibernation_ops->prepare() : 0;
  82 }
  83
  84 /**
  85  *      platform_finish - switch the machine to the normal mode of operation
  86  *      using the platform driver (must be called after platform_prepare())
  87  */
  88
  89 static void platform_finish(int platform_mode)
  90 {
  91         if (platform_mode && hibernation_ops)
  92                 hibernation_ops->finish();
  93 }
  94
  95 /**
  96  *      platform_pre_restore - prepare the platform for the restoration from a
  97  *      hibernation image.  If the restore fails after this function has been
  98  *      called, platform_restore_cleanup() must be called.
  99  */
 100
 101 static int platform_pre_restore(int platform_mode)
 102 {
 103         return (platform_mode && hibernation_ops) ?
 104                 hibernation_ops->pre_restore() : 0;
 105 }
 106
 107 /**
 108  *      platform_restore_cleanup - switch the platform to the normal mode of
 109  *      operation after a failing restore.  If platform_pre_restore() has been
 110  *      called before the failing restore, this function must be called too,
 111  *      regardless of the result of platform_pre_restore().
 112  */
 113
 114 static void platform_restore_cleanup(int platform_mode)
 115 {
 116         if (platform_mode && hibernation_ops)
 117                 hibernation_ops->restore_cleanup();
 118 }
 119
 120 /**
 121  *      hibernation_snapshot - quiesce devices and create the hibernation
 122  *      snapshot image.
 123  *      @platform_mode - if set, use the platform driver, if available, to
 124  *                       prepare the platform frimware for the power transition.
 125  *
 126  *      Must be called with pm_mutex held
 127  */
 128
 129 int hibernation_snapshot(int platform_mode)
 130 {
 131         int error;
 132
 133         /* Free memory before shutting down devices. */
 134         error = swsusp_shrink_memory();
 135         if (error)
 136                 return error;
 137
 138         suspend_console();
 139         error = device_suspend(PMSG_FREEZE);
 140         if (error)
 141                 goto Resume_console;
 142
 143         error = platform_prepare(platform_mode);
 144         if (error)
 145                 goto Resume_devices;
 146
 147         error = disable_nonboot_cpus();
 148         if (!error) {
 149                 if (hibernation_mode != HIBERNATION_TEST) {
 150                         in_suspend = 1;
 151                         error = swsusp_suspend();
 152                         /* Control returns here after successful restore */
 153                 } else {
 154                         printk("swsusp debug: Waiting for 5 seconds.\n");
 155                         mdelay(5000);
 156                 }
 157         }
 158         enable_nonboot_cpus();
 159  Resume_devices:
 160         platform_finish(platform_mode);
 161         device_resume();
 162  Resume_console:
 163         resume_console();
 164         return error;
 165 }
 166
 167 /**
 168  *      hibernation_restore - quiesce devices and restore the hibernation
 169  *      snapshot image.  If successful, control returns in hibernation_snaphot()
 170  *      @platform_mode - if set, use the platform driver, if available, to
 171  *                       prepare the platform frimware for the transition.
 172  *
 173  *      Must be called with pm_mutex held
 174  */
 175
 176 int hibernation_restore(int platform_mode)
 177 {
 178         int error;
 179
 180         pm_prepare_console();
 181         suspend_console();
 182         error = device_suspend(PMSG_PRETHAW);
 183         if (error)
 184                 goto Finish;
 185
 186         error = platform_pre_restore(platform_mode);
 187         if (!error) {
 188                 error = disable_nonboot_cpus();
 189                 if (!error)
 190                         error = swsusp_resume();
 191                 enable_nonboot_cpus();
 192         }
 193         platform_restore_cleanup(platform_mode);
 194         device_resume();
 195  Finish:
 196         resume_console();
 197         pm_restore_console();
 198         return error;
 199 }
 200
 201 /**
 202  *      hibernation_platform_enter - enter the hibernation state using the
 203  *      platform driver (if available)
 204  */
 205
 206 int hibernation_platform_enter(void)
 207 {
 208         int error;
 209
 210         if (hibernation_ops) {
 211                 kernel_shutdown_prepare(SYSTEM_SUSPEND_DISK);
 212                 /*
 213                  * We have cancelled the power transition by running
 214                  * hibernation_ops->finish() before saving the image, so we
 215                  * should let the firmware know that we're going to enter the
 216                  * sleep state after all
 217                  */
 218                 error = hibernation_ops->prepare();
 219                 if (!error)
 220                         error = hibernation_ops->enter();
 221         } else {
 222                 error = -ENOSYS;
 223         }
 224         return error;
 225 }
 226
 227 /**
 228  *      power_down - Shut the machine down for hibernation.
 229  *
 230  *      Use the platform driver, if configured so; otherwise try
 231  *      to power off or reboot.
 232  */
 233
 234 static void power_down(void)
 235 {
 236         switch (hibernation_mode) {
 237         case HIBERNATION_TEST:
 238         case HIBERNATION_TESTPROC:
 239                 break;
 240         case HIBERNATION_SHUTDOWN:
 241                 kernel_power_off();
 242                 break;
 243         case HIBERNATION_REBOOT:
 244                 kernel_restart(NULL);
 245                 break;
 246         case HIBERNATION_PLATFORM:
 247                 hibernation_platform_enter();
 248         }
 249         kernel_halt();
 250         /*
 251          * Valid image is on the disk, if we continue we risk serious data
 252          * corruption after resume.
 253          */
 254         printk(KERN_CRIT "Please power me down manually\n");
 255         while(1);
 256 }
 257
 258 static void unprepare_processes(void)
 259 {
 260         thaw_processes();
 261         pm_restore_console();
 262 }
 263
 264 static int prepare_processes(void)
 265 {
 266         int error = 0;
 267
 268         pm_prepare_console();
 269         if (freeze_processes()) {
 270                 error = -EBUSY;
 271                 unprepare_processes();
 272         }
 273         return error;
 274 }
 275
 276 /**
 277  *      hibernate - The granpappy of the built-in hibernation management
 278  */
 279
 280 int hibernate(void)
 281 {
 282         int error;
 283
 284         mutex_lock(&pm_mutex);
 285         /* The snapshot device should not be opened while we're running */
 286         if (!atomic_add_unless(&snapshot_device_available, -1, 0)) {
 287                 error = -EBUSY;
 288                 goto Unlock;
 289         }
 290
 291         error = pm_notifier_call_chain(PM_HIBERNATION_PREPARE);
 292         if (error)
 293                 goto Exit;
 294
 295         /* Allocate memory management structures */
 296         error = create_basic_memory_bitmaps();
 297         if (error)
 298                 goto Exit;
 299
 300         error = prepare_processes();
 301         if (error)
 302                 goto Finish;
 303
 304         if (hibernation_mode == HIBERNATION_TESTPROC) {
 305                 printk("swsusp debug: Waiting for 5 seconds.\n");
 306                 mdelay(5000);
 307                 goto Thaw;
 308         }
 309         error = hibernation_snapshot(hibernation_mode == HIBERNATION_PLATFORM);
 310         if (in_suspend && !error) {
 311                 unsigned int flags = 0;
 312
 313                 if (hibernation_mode == HIBERNATION_PLATFORM)
 314                         flags |= SF_PLATFORM_MODE;
 315                 pr_debug("PM: writing image.\n");
 316                 error = swsusp_write(flags);
 317                 swsusp_free();
 318                 if (!error)
 319                         power_down();
 320         } else {
 321                 pr_debug("PM: Image restored successfully.\n");
 322                 swsusp_free();
 323         }
 324  Thaw:
 325         unprepare_processes();
 326  Finish:
 327         free_basic_memory_bitmaps();
 328  Exit:
 329         pm_notifier_call_chain(PM_POST_HIBERNATION);
 330         atomic_inc(&snapshot_device_available);
 331  Unlock:
 332         mutex_unlock(&pm_mutex);
 333         return error;
 334 }
 335
 336
 337 /**
 338  *      software_resume - Resume from a saved image.
 339  *
 340  *      Called as a late_initcall (so all devices are discovered and
 341  *      initialized), we call swsusp to see if we have a saved image or not.
 342  *      If so, we quiesce devices, the restore the saved image. We will
 343  *      return above (in hibernate() ) if everything goes well.
 344  *      Otherwise, we fail gracefully and return to the normally
 345  *      scheduled program.
 346  *
 347  */
 348
 349 static int software_resume(void)
 350 {
 351         int error;
 352         unsigned int flags;
 353
 354         mutex_lock(&pm_mutex);
 355         if (!swsusp_resume_device) {
 356                 if (!strlen(resume_file)) {
 357                         mutex_unlock(&pm_mutex);
 358                         return -ENOENT;
 359                 }
 360                 swsusp_resume_device = name_to_dev_t(resume_file);
 361                 pr_debug("swsusp: Resume From Partition %s\n", resume_file);
 362         } else {
 363                 pr_debug("swsusp: Resume From Partition %d:%d\n",
 364                          MAJOR(swsusp_resume_device), MINOR(swsusp_resume_device));
 365         }
 366
 367         if (noresume) {
 368                 /**
 369                  * FIXME: If noresume is specified, we need to find the partition
 370                  * and reset it back to normal swap space.
 371                  */
 372                 mutex_unlock(&pm_mutex);
 373                 return 0;
 374         }
 375
 376         pr_debug("PM: Checking swsusp image.\n");
 377         error = swsusp_check();
 378         if (error)
 379                 goto Unlock;
 380
 381         /* The snapshot device should not be opened while we're running */
 382         if (!atomic_add_unless(&snapshot_device_available, -1, 0)) {
 383                 error = -EBUSY;
 384                 goto Unlock;
 385         }
 386
 387         error = create_basic_memory_bitmaps();
 388         if (error)
 389                 goto Finish;
 390
 391         pr_debug("PM: Preparing processes for restore.\n");
 392         error = prepare_processes();
 393         if (error) {
 394                 swsusp_close();
 395                 goto Done;
 396         }
 397
 398         pr_debug("PM: Reading swsusp image.\n");
 399
 400         error = swsusp_read(&flags);
 401         if (!error)
 402                 hibernation_restore(flags & SF_PLATFORM_MODE);
 403
 404         printk(KERN_ERR "PM: Restore failed, recovering.\n");
 405         swsusp_free();
 406         unprepare_processes();
 407  Done:
 408         free_basic_memory_bitmaps();
 409  Finish:
 410         atomic_inc(&snapshot_device_available);
 411         /* For success case, the suspend path will release the lock */
 412  Unlock:
 413         mutex_unlock(&pm_mutex);
 414         pr_debug("PM: Resume from disk failed.\n");
 415         return error;
 416 }
 417
 418 late_initcall(software_resume);
 419
 420
 421 static const char * const hibernation_modes[] = {
 422         [HIBERNATION_PLATFORM]  = "platform",
 423         [HIBERNATION_SHUTDOWN]  = "shutdown",
 424         [HIBERNATION_REBOOT]    = "reboot",
 425         [HIBERNATION_TEST]      = "test",
 426         [HIBERNATION_TESTPROC]  = "testproc",
 427 };
 428
 429 /**
 430  *      disk - Control hibernation mode
 431  *
 432  *      Suspend-to-disk can be handled in several ways. We have a few options
 433  *      for putting the system to sleep - using the platform driver (e.g. ACPI
 434  *      or other hibernation_ops), powering off the system or rebooting the
 435  *      system (for testing) as well as the two test modes.
 436  *
 437  *      The system can support 'platform', and that is known a priori (and
 438  *      encoded by the presence of hibernation_ops). However, the user may
 439  *      choose 'shutdown' or 'reboot' as alternatives, as well as one fo the
 440  *      test modes, 'test' or 'testproc'.
 441  *
 442  *      show() will display what the mode is currently set to.
 443  *      store() will accept one of
 444  *
 445  *      'platform'
 446  *      'shutdown'
 447  *      'reboot'
 448  *      'test'
 449  *      'testproc'
 450  *
 451  *      It will only change to 'platform' if the system
 452  *      supports it (as determined by having hibernation_ops).
 453  */
 454
 455 static ssize_t disk_show(struct kset *kset, char *buf)
 456 {
 457         int i;
 458         char *start = buf;
 459
 460         for (i = HIBERNATION_FIRST; i <= HIBERNATION_MAX; i++) {
 461                 if (!hibernation_modes[i])
 462                         continue;
 463                 switch (i) {
 464                 case HIBERNATION_SHUTDOWN:
 465                 case HIBERNATION_REBOOT:
 466                 case HIBERNATION_TEST:
 467                 case HIBERNATION_TESTPROC:
 468                         break;
 469                 case HIBERNATION_PLATFORM:
 470                         if (hibernation_ops)
 471                                 break;
 472                         /* not a valid mode, continue with loop */
 473                         continue;
 474                 }
 475                 if (i == hibernation_mode)
 476                         buf += sprintf(buf, "[%s] ", hibernation_modes[i]);
 477                 else
 478                         buf += sprintf(buf, "%s ", hibernation_modes[i]);
 479         }
 480         buf += sprintf(buf, "\n");
 481         return buf-start;
 482 }
 483
 484
 485 static ssize_t disk_store(struct kset *kset, const char *buf, size_t n)
 486 {
 487         int error = 0;
 488         int i;
 489         int len;
 490         char *p;
 491         int mode = HIBERNATION_INVALID;
 492
 493         p = memchr(buf, '\n', n);
 494         len = p ? p - buf : n;
 495
 496         mutex_lock(&pm_mutex);
 497         for (i = HIBERNATION_FIRST; i <= HIBERNATION_MAX; i++) {
 498                 if (len == strlen(hibernation_modes[i])
 499                     && !strncmp(buf, hibernation_modes[i], len)) {
 500                         mode = i;
 501                         break;
 502                 }
 503         }
 504         if (mode != HIBERNATION_INVALID) {
 505                 switch (mode) {
 506                 case HIBERNATION_SHUTDOWN:
 507                 case HIBERNATION_REBOOT:
 508                 case HIBERNATION_TEST:
 509                 case HIBERNATION_TESTPROC:
 510                         hibernation_mode = mode;
 511                         break;
 512                 case HIBERNATION_PLATFORM:
 513                         if (hibernation_ops)
 514                                 hibernation_mode = mode;
 515                         else
 516                                 error = -EINVAL;
 517                 }
 518         } else
 519                 error = -EINVAL;
 520
 521         if (!error)
 522                 pr_debug("PM: suspend-to-disk mode set to '%s'\n",
 523                          hibernation_modes[mode]);
 524         mutex_unlock(&pm_mutex);
 525         return error ? error : n;
 526 }
 527
 528 power_attr(disk);
 529
 530 static ssize_t resume_show(struct kset *kset, char *buf)
 531 {
 532         return sprintf(buf,"%d:%d\n", MAJOR(swsusp_resume_device),
 533                        MINOR(swsusp_resume_device));
 534 }
 535
 536 static ssize_t resume_store(struct kset *kset, const char *buf, size_t n)
 537 {
 538         unsigned int maj, min;
 539         dev_t res;
 540         int ret = -EINVAL;
 541
 542         if (sscanf(buf, "%u:%u", &maj, &min) != 2)
 543                 goto out;
 544
 545         res = MKDEV(maj,min);
 546         if (maj != MAJOR(res) || min != MINOR(res))
 547                 goto out;
 548
 549         mutex_lock(&pm_mutex);
 550         swsusp_resume_device = res;
 551         mutex_unlock(&pm_mutex);
 552         printk("Attempting manual resume\n");
 553         noresume = 0;
 554         software_resume();
 555         ret = n;
 556  out:
 557         return ret;
 558 }
 559
 560 power_attr(resume);
 561
 562 static ssize_t image_size_show(struct kset *kset, char *buf)
 563 {
 564         return sprintf(buf, "%lu\n", image_size);
 565 }
 566
 567 static ssize_t image_size_store(struct kset *kset, const char *buf, size_t n)
 568 {
 569         unsigned long size;
 570
 571         if (sscanf(buf, "%lu", &size) == 1) {
 572                 image_size = size;
 573                 return n;
 574         }
 575
 576         return -EINVAL;
 577 }
 578
 579 power_attr(image_size);
 580
 581 static struct attribute * g[] = {
 582         &disk_attr.attr,
 583         &resume_attr.attr,
 584         &image_size_attr.attr,
 585         NULL,
 586 };
 587
 588
 589 static struct attribute_group attr_group = {
 590         .attrs = g,
 591 };
 592
 593
 594 static int __init pm_disk_init(void)
 595 {
 596         return sysfs_create_group(&power_subsys.kobj, &attr_group);
 597 }
 598
 599 core_initcall(pm_disk_init);
 600
 601
 602 static int __init resume_setup(char *str)
 603 {
 604         if (noresume)
 605                 return 1;
 606
 607         strncpy( resume_file, str, 255 );
 608         return 1;
 609 }
 610
 611 static int __init resume_offset_setup(char *str)
 612 {
 613         unsigned long long offset;
 614
 615         if (noresume)
 616                 return 1;
 617
 618         if (sscanf(str, "%llu", &offset) == 1)
 619                 swsusp_resume_block = offset;
 620
 621         return 1;
 622 }
 623
 624 static int __init noresume_setup(char *str)
 625 {
 626         noresume = 1;
 627         return 1;
 628 }
 629
 630 __setup("noresume", noresume_setup);
 631 __setup("resume_offset=", resume_offset_setup);
 632 __setup("resume=", resume_setup);