Subject: port-i386/7382: wrong definition of suspend and standby modes in apm(4)
To: None <gnats-bugs@gnats.netbsd.org>
From: None <tacha@trap.fukui-med.ac.jp>
List: netbsd-bugs
Date: 04/14/1999 03:50:57
>Number:         7382
>Category:       port-i386
>Synopsis:       wrong definition of suspend and standby modes in apm(4)
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    port-i386-maintainer (NetBSD/i386 Portmaster)
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Wed Apr 14 03:50:01 1999
>Last-Modified:
>Originator:     Tatoku Ogaito
>Organization:
-----            : Tatoku Ogaito
   / _  _ _/ _   : Department of Physics, Fukui Medical University
  / (_|(_ /)(_|  : E-mail: tacha@tera.fukui-med.ac.jp
>Release:        1.4_ALPHA as of 19990412
>Environment:
	
System: NetBSD tera.fukui-med.ac.jp 1.4_ALPHA NetBSD 1.4_ALPHA (TERA) #144: Tue Apr 13 17:39:52 JST 1999 root@tick.trun.org:/usr/current/src/sys/arch/i386/compile/TERA i386


>Description:
The apm(4) man page says
...
     APM_IOC_STANDBY
             initiate an APM standby mode.  This is a deep sleep mode which
                             ^^^^^^^                  ^^^^
             powers down most devices.  The device must be open for writing
             for this command to succeed
     APM_IOC_SUSPEND
             initiate an APM suspend mode.  This is a light sleep mode from
                             ^^^^^^^                  ^^^^^
             which the system can quickly restore normal operation.  The de-
             vice must be open for writing for this command to succeed.
...
but I think they should be defined as oppositely. 

>How-To-Repeat:
	man 4 apm
>Fix:
--- /usr/src/share/man/man4/man4.i386/apm.4	Thu Sep  3 20:08:42 1998
+++ ./apm.4	Wed Apr 14 19:30:30 1999
@@ -96,12 +96,12 @@
 .Xr ioctl 2
 calls supported are:
 .Bl -tag -width indent -compact
-.It Dv APM_IOC_STANDBY
-initiate an APM standby mode.  This is a deep sleep mode which powers down
+.It Dv APM_IOC_SUSPEND
+initiate an APM suspend mode.  This is a deep sleep mode which powers down
 most devices.  The device must be open for writing for this command to succeed
 .
-.It Dv APM_IOC_SUSPEND
-initiate an APM suspend mode.  This is a light sleep mode from which the
+.It Dv APM_IOC_STANDBY
+initiate an APM standby mode.  This is a light sleep mode from which the
 system can quickly restore normal operation.  The device must be open
 for writing for this command to succeed.
 .It Dv APM_IOC_GETPOWER

>Audit-Trail:
>Unformatted: