From 704898a9ea60c6c29be7e869bbe1a856d44dc4b9 Mon Sep 17 00:00:00 2001
From: gmcgarry <gmcgarry@NetBSD.org>
Date: Sun, 4 Aug 2002 01:03:12 +0000
Subject: [PATCH] Document pci_set_powerstate()/pci_get_powerstate().

---
 share/man/man9/Makefile |  4 +++-
 share/man/man9/pci.9    | 22 +++++++++++++++++++++-
 2 files changed, 24 insertions(+), 2 deletions(-)

diff --git a/share/man/man9/Makefile b/share/man/man9/Makefile
index 8af9ab12b498..d678cb88122d 100644
--- a/share/man/man9/Makefile
+++ b/share/man/man9/Makefile
@@ -1,4 +1,4 @@
-#       $NetBSD: Makefile,v 1.118 2002/08/02 00:41:53 thorpej Exp $
+#       $NetBSD: Makefile,v 1.119 2002/08/04 01:03:12 gmcgarry Exp $
 
 #	Makefile for section 9 (kernel function and variable) manual pages.
 
@@ -236,6 +236,8 @@ MLINKS+=pci.9 pci_conf_read.9 \
 	pci.9 pci_intr_evcnt.9 \
 	pci.9 pci_intr_establish.9 \
 	pci.9 pci_intr_disestablish.9 \
+	pci.9 pci_get_powerstate.9 \
+	pci.9 pci_set_powerstate.9 \
 	pci.9 pci_make_tag.9 \
 	pci.9 pci_decompose_tag.9 \
 	pci.9 pci_findvendor.9 \
diff --git a/share/man/man9/pci.9 b/share/man/man9/pci.9
index fa73642b6ccc..015f48ccc47f 100644
--- a/share/man/man9/pci.9
+++ b/share/man/man9/pci.9
@@ -1,4 +1,4 @@
-.\"     $NetBSD: pci.9,v 1.6 2002/02/13 08:18:47 ross Exp $
+.\"     $NetBSD: pci.9,v 1.7 2002/08/04 01:03:12 gmcgarry Exp $
 .\"
 .\" Copyright (c) 2001 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -52,6 +52,8 @@
 .Nm pci_intr_evcnt ,
 .Nm pci_intr_establish ,
 .Nm pci_intr_disestablish ,
+.Nm pci_get_powerstate ,
+.Nm pci_set_powerstate ,
 .Nm pci_make_tag ,
 .Nm pci_decompose_tag ,
 .Nm pci_findvendor ,
@@ -99,6 +101,11 @@
 "int level" "int (*handler)(void *)" "void *arg"
 .Ft void
 .Fn pci_intr_disestablish "pci_chipset_tag_t pc" "void *ih"
+.Ft int
+.Fn pci_set_powerstate "pci_chipset_tag_t pc" "pcitag_t tag" \
+"int newstate"
+.Ft int
+.Fn pci_get_powerstate "pci_chipset_tag_t pc" "pcitag_t tag"
 .Ft pcitag_t
 .Fn pci_make_tag "pci_chipset_tag_t pc" "int bus" "int device" \
 "int function"
@@ -345,6 +352,19 @@ See
 .It Fn pci_intr_disestablish "pc" "ih"
 See
 .Xr pci_intr 9 .
+.It Fn pci_set_powerstate "pc" "tag" "newstate"
+Set power state of the device to newstate.  Valid values for
+.Fa newstate
+are:
+.Pp
+.Bl -tag -width PCI_PWR_D0 -compact
+.It PCI_PWR_D0
+.It PCI_PWR_D1
+.It PCI_PWR_D2
+.It PCI_PWR_D3
+.El
+.It Fn pci_get_powerstate "pc" "tag"
+Get current power state of the device.
 .It Fn pci_make_tag "pc" "bus" "device" "function"
 Create a new PCI tag for the PCI device specified by the tuple
 .Ao