Return-Path: Received: from localhost (bix [127.0.0.1]) by localhost.localdomain (8.12.10/8.12.10) with ESMTP id iBPLKhRG005193 for ; Sat, 25 Dec 2004 13:20:43 -0800 Received: from bix [127.0.0.1] by localhost with POP3 (fetchmail-6.2.0) for akpm@localhost (single-drop); Sat, 25 Dec 2004 13:20:43 -0800 (PST) Received: by mangalore (mbox akpm) (with Cubic Circle's cucipop (v1.31 1998/05/13) Sun Dec 26 08:21:12 2004) X-From_: pavel@ucw.cz Sun Dec 26 08:20:38 2004 Received: from mailin1.pacific.net.au (mailin1.pacific.net.au [61.8.0.80]) by mangalore.zipworld.com.au (8.12.3/8.12.3/Debian-7.1) with ESMTP id iBPLKbAE027649 for ; Sun, 26 Dec 2004 08:20:37 +1100 Received: from amd.ucw.cz (gprs212-19.eurotel.cz [160.218.212.19]) by mailin1.pacific.net.au (8.12.3/8.12.3/Debian-7.1) with ESMTP id iBPLKVYo016940 for ; Sun, 26 Dec 2004 08:20:34 +1100 Received: by amd.ucw.cz (Postfix, from userid 8) id 7F3252C703; Sat, 25 Dec 2004 22:20:21 +0100 (CET) Date: Sat, 25 Dec 2004 22:20:21 +0100 From: Pavel Machek To: Andrew Morton , kernel list Subject: pm: remove outdated docs Message-ID: <20041225212021.GA20134@elf.ucw.cz> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline X-Warning: Reading this can be dangerous to your mental health. User-Agent: Mutt/1.5.6+20040722i X-Spam-Status: No, hits=-4.9 required=1.0 tests=BAYES_00 autolearn=ham version=2.60 X-Spam-Level: X-Spam-Checker-Version: SpamAssassin 2.60 (1.212-2003-09-23-exp) on bix Hi! pm_access / pm_dev_idle was removed from recent kernels. This should stop confusion... Please apply, Pavel Signed-off-by: Pavel Machek --- linux-cvs/Documentation/pm.txt 2004-10-28 17:21:21.000000000 +0200 +++ linux/Documentation/pm.txt 2004-10-26 12:44:23.000000000 +0200 @@ -91,54 +91,6 @@ void pm_unregister_all(pm_callback cback); /* - * Device idle/use detection - * - * In general, drivers for all devices should call "pm_access" - * before accessing the hardware (ie. before reading or modifying - * a hardware register). Request or packet-driven drivers should - * additionally call "pm_dev_idle" when a device is not being used. - * - * Examples: - * 1) A keyboard driver would call pm_access whenever a key is pressed - * 2) A network driver would call pm_access before submitting - * a packet for transmit or receive and pm_dev_idle when its - * transfer and receive queues are empty. - * 3) A VGA driver would call pm_access before it accesses any - * of the video controller registers - * - * Ultimately, the PM policy manager uses the access and idle - * information to decide when to suspend individual devices - * or when to suspend the entire system - */ - -/* - * Description: Update device access time and wake up device, if necessary - * - * Parameters: - * dev - PM device previously returned from pm_register - * - * Details: If called from an interrupt handler pm_access updates - * access time but should never need to wake up the device - * (if device is generating interrupts, it should be awake - * already) This is important as we can not wake up - * devices from an interrupt handler. - */ -void pm_access(struct pm_dev *dev); - -/* - * Description: Identify device as currently being idle - * - * Parameters: - * dev - PM device previously returned from pm_register - * - * Details: A call to pm_dev_idle might signal to the policy manager - * to put a device to sleep. If a new device request arrives - * between the call to pm_dev_idle and the pm_callback - * callback, the driver should fail the pm_callback request. - */ -void pm_dev_idle(struct pm_dev *dev); - -/* * Power management request callback * * Parameters: -- People were complaining that M$ turns users into beta-testers... ...jr ghea gurz vagb qrirybcref, naq gurl frrz gb yvxr vg gung jnl!