From: "Andrey Panin" <pazke@centrinvest.ru>
Date: Thu, 9 Jul 2009 12:54:34 +0400
To: Mark Allyn <mark.a.allyn@intel.com>
Cc: linux-kernel@vger.kernel.org, alan@linux.intel.com,
       charles.f.johnson@intel.com
Subject: Re: [PATCH] Restricted Access Region Register driver for Intel MID
	devices
Message-ID: <20090709085434.GA2252@centrinvest.ru>
Mail-Followup-To: Mark Allyn <mark.a.allyn@intel.com>,
	linux-kernel@vger.kernel.org, alan@linux.intel.com,
	charles.f.johnson@intel.com
References: <1247083212-17331-1-git-send-email-mark.a.allyn@intel.com>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <1247083212-17331-1-git-send-email-mark.a.allyn@intel.com>
User-Agent: Mutt/1.5.18 (2008-05-17)
Sender: linux-kernel-owner@vger.kernel.org
Content-Length: 21541
Lines: 771

On 189, 07 08, 2009 at 01:00:12PM -0700, Mark Allyn wrote:
> This is the device driver for the Restricted Access Region registers on the
> Intel MID device.
> 
> Restricted Access Regions are areas of memory that are not accessable to the
> i86 processor.
> 
> This driver is used by other device drivers to obtain the start and end 
> addresses of the Restricted Access Regions.
> 
> This driver is not used by any user space applications.
> 
> This patch is applied against 2.6.31
> 
> Signed off my Mark Allyn <mark.a.allyn@intel.com>
> ---
>  drivers/Kconfig                     |    2 +
>  drivers/Makefile                    |    1 +
>  drivers/rar_register/Kconfig        |   17 +
>  drivers/rar_register/Makefile       |    3 +
>  drivers/rar_register/rar_register.c |  547 +++++++++++++++++++++++++++++++++++
>  include/linux/rar/rar_register.h    |   67 +++++
>  6 files changed, 637 insertions(+), 0 deletions(-)
>  create mode 100644 drivers/rar_register/Kconfig
>  create mode 100644 drivers/rar_register/Makefile
>  create mode 100644 drivers/rar_register/rar_register.c
>  create mode 100644 include/linux/rar/rar_register.h
> 
> diff --git a/drivers/Kconfig b/drivers/Kconfig
> index 48bbdbe..293a7c6 100644
> --- a/drivers/Kconfig
> +++ b/drivers/Kconfig
> @@ -113,4 +113,6 @@ source "drivers/xen/Kconfig"
>  source "drivers/staging/Kconfig"
>  
>  source "drivers/platform/Kconfig"
> +
> +source "drivers/rar_register/Kconfig"
>  endmenu
> diff --git a/drivers/Makefile b/drivers/Makefile
> index 988d531..5da728a 100644
> --- a/drivers/Makefile
> +++ b/drivers/Makefile
> @@ -108,5 +108,6 @@ obj-$(CONFIG_SSB)		+= ssb/
>  obj-$(CONFIG_VIRTIO)		+= virtio/
>  obj-$(CONFIG_VLYNQ)		+= vlynq/
>  obj-$(CONFIG_STAGING)		+= staging/
> +obj-$(CONFIG_RAR_REGISTER)      += rar_register/
>  obj-y				+= platform/
>  obj-y				+= ieee802154/
> diff --git a/drivers/rar_register/Kconfig b/drivers/rar_register/Kconfig
> new file mode 100644
> index 0000000..b07620f
> --- /dev/null
> +++ b/drivers/rar_register/Kconfig
> @@ -0,0 +1,17 @@
> +#
> +# Serial device configuration
> +#
> +
> +menu "RAR Register Driver"
> +#
> +# The new 8250/16550 serial drivers
> +config RAR_REGISTER
> +	tristate "Restricted Access Region Register Driver"
> +	depends on MRST
> +	default y
> +	---help---
> +		This driver allows other kernel drivers access to the
> +		contents of the restricted access region control 
> +		registers. 
> +
> +endmenu
> diff --git a/drivers/rar_register/Makefile b/drivers/rar_register/Makefile
> new file mode 100644
> index 0000000..63ba70e
> --- /dev/null
> +++ b/drivers/rar_register/Makefile
> @@ -0,0 +1,3 @@
> +EXTRA_CFLAGS += -DLITTLE__ENDIAN 
> +obj-$(CONFIG_RAR_REGISTER) += rar_register.o
> +rar_register_driver-objs := rar_register.o
> diff --git a/drivers/rar_register/rar_register.c b/drivers/rar_register/rar_register.c
> new file mode 100644
> index 0000000..3e4933a
> --- /dev/null
> +++ b/drivers/rar_register/rar_register.c
> @@ -0,0 +1,547 @@
> +/*
> + *  rar_register.c - An Intel Restricted Access Region register driver
> + *
> + *  Copyright(c) 2009 Intel Corporation. All rights reserved.
> + *
> + *  This program is free software; you can redistribute it and/or
> + *  modify it under the terms of the GNU General Public License as
> + *  published by the Free Software Foundation; either version 2 of the
> + *  License, or (at your option) any later version.
> + *
> + *  This program is distributed in the hope that it will be useful,
> + *  but WITHOUT ANY WARRANTY; without even the implied warranty of
> + *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
> + *  General Public License for more details.
> + *
> + *  You should have received a copy of the GNU General Public License
> + *  along with this program; if not, write to the Free Software
> + *  Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
> + *  02111-1307, USA.
> + *
> + * -------------------------------------------------------------------
> + *
> + *  20090702 Ossama Othman <ossama.othman@intel.com>
> + *      Removed unnecessary include directives
> + *      Cleaned up spinlocks.
> + *      Cleaned up logging.
> + *      Improved invalid parameter checks.
> + *      Fixed and simplified RAR address retrieval and RAR locking
> + *      code.
> + *
> + *  20090626 Mark Allyn <mark.a.allyn@intel.com>
> + *      Initial publish
> + */
> +
> +#include <linux/rar/rar_register.h>
> +
> +#include <linux/module.h>
> +#include <linux/pci.h>
> +#include <linux/spinlock.h>
> +#include <linux/device.h>
> +
> +
> +/* PCI vendor id for controller */
> +#define VENDOR_ID 0x8086
> +
> +/* PCI device id for controller */
> +#define DEVICE_ID 0x4110
> +
> +
> +/* === Lincroft Message Bus Interface === */
> +/* Message Control Register */
> +#define LNC_MCR_OFFSET 0xD0
> +
> +/* Message Data Register */
> +#define LNC_MDR_OFFSET 0xD4
> +
> +/* Message Opcodes */
> +#define LNC_MESSAGE_READ_OPCODE  0xD0
> +#define LNC_MESSAGE_WRITE_OPCODE 0xE0
> +
> +/* Message Write Byte Enables */
> +#define LNC_MESSAGE_BYTE_WRITE_ENABLES 0xF
> +
> +/* B-unit Port */
> +#define LNC_BUNIT_PORT 0x3
> +
> +/* === Lincroft B-Unit Registers - Programmed by IA32 firmware === */
> +#define LNC_BRAR0L  0x10
> +#define LNC_BRAR0H  0x11
> +#define LNC_BRAR1L  0x12
> +#define LNC_BRAR1H  0x13
> +
> +/* Reserved for SeP */
> +#define LNC_BRAR2L  0x14
> +#define LNC_BRAR2H  0x15
> +
> +
> +
> +static DEFINE_SPINLOCK(rar_spinlock_lock);
> +unsigned long rar_flags;

Passing global variable to spin_lock_irqsave()/spin_unlock_irqrestore()
doesn't seem right. Remove this variable and use local flags variable
where apropriate.

> +
> +static DEFINE_SPINLOCK(lnc_reg_lock);
> +unsigned long lnc_reg_flags;

Same as above.

> +/* RAR Physical Address Range */
> +struct RAR_address_range {
> +	u32 low;
> +	u32 high;
> +};
> +
> +/* Structure containing low and high RAR register offsets. */
> +struct RAR_offsets {
> +	u32 low; /* Register offset for low RAR physical address. */
> +	u32 high; /* Register offset for high RAR physical address. */
> +};
> +
> +static struct RAR_offsets const rar_offsets[] = {
> +	{ LNC_BRAR0L, LNC_BRAR0H },
> +	{ LNC_BRAR1L, LNC_BRAR1H },
> +	{ LNC_BRAR2L, LNC_BRAR2H }
> +};
> +
> +static struct pci_dev *rar_dev;
> +static u32 registered;
> +
> +/* Moorestown supports three restricted access regions. */
> +#define MRST_NUM_RAR 3
> +
> +static struct RAR_address_range rar_addr[MRST_NUM_RAR];
> +
> +/* prototype for init */
> +static int __init rar_init_handler(void);
> +static void __exit rar_exit_handler(void);

These prototypes are not needed.

> +const struct pci_device_id rar_pci_id_tbl[] = {
> +	{ PCI_DEVICE(VENDOR_ID, DEVICE_ID) },

Use line below and remove VENDOR_ID & DEVICE_ID defines.
	{ PCI_DEVICE(PCI_VENDOR_ID_INTEL, 0x4110) },

> +	{ 0 }
> +};
> +
> +MODULE_DEVICE_TABLE(pci, rar_pci_id_tbl);
> +
> +/*
> + * Function that is activated on the succesful probe of the RAR
> + * device (Moorestown host controller).
> + */
> +int rar_probe(struct pci_dev *dev, const struct pci_device_id *id);

You can avoid prototypes by placing functions in sane way.

> +/* field for registering driver to PCI device */
> +static struct pci_driver rar_pci_driver = {
> +	.name = "rar_register",
> +	.id_table = rar_pci_id_tbl,
> +	.probe = rar_probe
> +};
> +
> +const struct pci_device_id *my_id_table = rar_pci_id_tbl;
> +int (*my_probe) (struct pci_dev *dev, const struct pci_device_id *id) =
> +	rar_probe;

What is this ?

> +/* This function is used to retrieved RAR info using the IPC message
> +   bus interface */
> +static int memrar_get_rar_addr(struct pci_dev *pdev,
> +			       int offset,
> +			       u32 *addr)
> +{
> +	/*
> +	 * ======== The Lincroft Message Bus Interface ========
> +	 * Lincroft registers may be obtained from the PCI
> +	 * (the Host Bridge) using the Lincroft Message Bus
> +	 * Interface.  That message bus interface is generally
> +	 * comprised of two registers: a control register (MCR, 0xDO)
> +	 * and a data register (MDR, 0xD4).
> +	 *
> +	 * The MCR (message control register) format is the following:
> +	 *   1.  [31:24]: Opcode
> +	 *   2.  [23:16]: Port
> +	 *   3.  [15:8]: Register Offset
> +	 *   4.  [7:4]: Byte Enables (use 0xF to set all of these bits
> +	 *              to 1)
> +	 *   5.  [3:0]: reserved
> +	 *
> +	 *  Read (0xD0) and write (0xE0) opcodes are written to the
> +	 *  control register when reading and writing to Lincroft
> +	 *  registers, respectively.
> +	 *
> +	 *  We're interested in registers found in the Lincroft
> +	 *  B-unit.  The B-unit port is 0x3.
> +	 *
> +	 *  The six B-unit RAR register offsets we use are listed
> +	 *  earlier in this file.
> +	 *
> +	 *  Lastly writing to the MCR register requires the "Byte
> +	 *  enables" bits to be set to 1.  This may be achieved by
> +	 *  writing 0xF at bit 4.
> +	 *
> +	 * The MDR (message data register) format is the following:
> +	 *   1. [31:0]: Read/Write Data
> +	 *
> +	 *  Data being read from this register is only available after
> +	 *  writing the appropriate control message to the MCR
> +	 *  register.
> +	 *
> +	 *  Data being written to this register must be written before
> +	 *  writing the appropriate control message to the MCR
> +	 *  register.
> +	 */
> +
> +	int result;
> +
> +	/* Construct control message */
> +	u32 const message =
> +		(LNC_MESSAGE_READ_OPCODE << 24)
> +		| (LNC_BUNIT_PORT << 16)
> +		| (offset << 8)
> +		| (LNC_MESSAGE_BYTE_WRITE_ENABLES << 4);
> +	
> +
> +	dev_dbg(&pdev->dev, "Offset for 'get' LNC MSG is %x\n", offset);
> +
> +	if (addr == 0) {
> +		WARN_ON(1);
> +		return -EINVAL;
> +	}
> +
> +	spin_lock_irqsave(&lnc_reg_lock, lnc_reg_flags);
> +
> +	/* Send the control message */
> +	result = pci_write_config_dword(pdev,
> +					LNC_MCR_OFFSET,
> +					message);

Please don't place each argument on its own line, you are just wasting screen space.

> +	dev_dbg(&pdev->dev,
> +		"Result from send ctl register is %x\n",
> +		result);
> +
> +	if (!result)
> +	{

Brace is misplaced.

> +		result = pci_read_config_dword(pdev,
> +					       LNC_MDR_OFFSET,
> +					       addr);
> +
> +		dev_dbg(&pdev->dev,
> +			"Result from read data register is %x\n",
> +			result);
> +
> +		dev_dbg(&pdev->dev,
> +			"Value read from data register is %x\n",
> +			*addr);
> +	}
> +
> +	spin_unlock_irqrestore(&lnc_reg_lock, lnc_reg_flags);
> +
> +	return result;
> +}
> +
> +static int memrar_set_rar_addr(struct pci_dev *pdev,
> +			       int offset,
> +			       u32 addr)
> +{
> +	/*
> +	 *  Data being written to this register must be written before
> +	 *  writing the appropriate control message to the MCR
> +	 *  register.
> +	 *
> +	 *  @note See memrar_get_rar_addr() for a description of the
> +	 *        message bus interface being used here.
> +	 */
> +
> +	int result = 0;
> +
> +	/* Construct control message */
> +	u32 const message =
> +	       (LNC_MESSAGE_WRITE_OPCODE << 24)
> +	       | (LNC_BUNIT_PORT << 16)
> +	       | (offset << 8)
> +	       | (LNC_MESSAGE_BYTE_WRITE_ENABLES << 4);
> +
> +	if (addr == 0) {
> +		WARN_ON(1);
> +		return -EINVAL;
> +	
> +	}
> +
> +	spin_lock_irqsave(&lnc_reg_lock, lnc_reg_flags);
> +
> +	dev_dbg(&pdev->dev,
> +		"Offset for 'set' LNC MSG is %x\n", offset);
> +
> +	/* Send the control message */
> +	result = pci_write_config_dword(pdev,
> +					LNC_MDR_OFFSET,
> +					addr);
> +
> +	dev_dbg(&pdev->dev,
> +		"Result from write data register is %x\n",
> +		result);
> +
> +	if (!result)
> +	{
> +		dev_dbg(&pdev->dev,
> +			"Value written to data register is %x\n",
> +			addr);
> +
> +		result = pci_write_config_dword(pdev,
> +						LNC_MCR_OFFSET,
> +						message);
> +
> +		dev_dbg(&pdev->dev,
> +			"Result from send ctl register is %x\n",
> +			result);
> +	
> +	}
> +
> +	spin_unlock_irqrestore(&lnc_reg_lock, lnc_reg_flags);
> +
> +	return result;
> +}
> +
> +/*
> + * Initialize RAR parameters, such as physical addresses, etc.
> + */
> +static int memrar_init_rar_params(struct pci_dev *pdev)
> +{
> +	size_t const num_offsets = ARRAY_SIZE(rar_offsets);
> +	struct RAR_offsets const *end = rar_offsets + num_offsets;
> +	struct RAR_offsets const *i;
> +	struct pci_dev *my_pdev;
> +	unsigned int n = 0;
> +	int result = 0;
> +
> +	/* Retrieve RAR start and end physical addresses. */
> +
> +	/*
> +	 * Access the RAR registers through the Lincroft Message Bus
> +	 * Interface on PCI device: 00:00.0 Host bridge.
> +	 */
> +
> +	/* struct pci_dev *pdev = pci_get_bus_and_slot(0, PCI_DEVFN(0,0)); */
> +
> +	my_pdev = pci_dev_get(pdev);
> +
> +	if (my_pdev == NULL) {
> +		WARN_ON(1);
> +		return -ENODEV;
> +	}
> +
> +	for (i = rar_offsets; i != end; ++i, ++n) {
> +		if (memrar_get_rar_addr(my_pdev,
> +					i->low,
> +					&(rar_addr[n].low)) != 0
> +		    || memrar_get_rar_addr(my_pdev,
> +					   i->high,
> +					   &(rar_addr[n].high)) != 0) {
> +			result = -1;
> +			break;
> +		}
> +
> +		/*
> +		 * Only the upper 22 bits of the RAR addresses are
> +		 * stored in their corresponding RAR registers so we
> +		 * must set the lower 10 bits accordingly.
> +		 *
> +		 * The low address has its lower 10 bits cleared, and
> +		 * the high address has all its lower 10 bits set,
> +		 * e.g.:
> +		 *
> +		 *   low = 0x2ffffc00
> +		 *  high = 0x3fffffff
> +		 *
> +		 * This is not arbitrary, and is actually how RAR
> +		 * addressing/configuration works.
> +		 */
> +		rar_addr[n].low  &= 0xfffffc00u;  /* Clear bits 9:0 */
> +		rar_addr[n].high |= 0x3ffu;       /* Set   bits 9:0 */
> +	}
> +	
> +        /* Done accessing the device. */
> +	/* pci_dev_put(pdev); */

Why this line is commented out ?

> +	if (result == 0) {
> +		size_t z;
> +		for (z = 0; z != MRST_NUM_RAR; ++z)
> +		{
> +			/*
> +			 * "BRAR" refers to the RAR registers in the
> +			 * Lincroft B-unit.
> +			 */
> +			dev_info(&pdev->dev,
> +				 "BRAR[%u] physical address range = "
> +				 "[0x%08x, 0x%08x]\n",
> +				 z,
> +				 rar_addr[z].low,
> +				 rar_addr[z].high);
> +		}
> +	}
> +
> +	return result;
> +}
> +
> +/*
> + * This function registers the driver with the device subsystem (
> + * either PCI, USB, etc).
> +*/
> +static int __init rar_init_handler(void)
> +{
> +	return pci_register_driver(&rar_pci_driver);
> +}
> +
> +static void __exit rar_exit_handler(void)
> +{
> +	pci_unregister_driver(&rar_pci_driver);
> +}
> +
> +module_init(rar_init_handler);
> +module_exit(rar_exit_handler);
> +
> +MODULE_LICENSE("GPL");
> +MODULE_DESCRIPTION("Intel Restricted Access Region Register Driver");
> +
> +/*
> + * Function that is activaed on the succesful probe of the RAR device
> + * (Moorestown host controller).
> + */
> +int rar_probe(struct pci_dev *dev, const struct pci_device_id *id)

static

> +{
> +	int error;
> +	registered = 0;
> +
> +	dev_dbg(&dev->dev,
> +		"PCI probe starting\n");
> +
> +	/* enable the device */
> +	error = pci_enable_device(dev);
> +	if (error)
> +	{
> +		dev_err(&dev->dev,
> +			"Error enabling RAR register PCI device\n");
> +		goto end_function;
> +	}
> +
> +	/* Initialize the RAR parameters, which have to be retrieved */
> +	/* via the message bus service */
> +	error = memrar_init_rar_params(dev);
> +	if (error)
> +	{
> +		pci_disable_device(dev);
> +
> +		dev_err(&dev->dev,
> +			"Error retrieving RAR addresses\n");
> +
> +		goto end_function;
> +	}
> +
> +	rar_dev = dev;
> +	registered = 1;
> +
> +end_function:
> +
> +	return error;
> +}
> +
> +
> +/* The rar_get_address function is used by other device drivers
> + * to obtain RAR address information on a RAR. It takes three
> + * parameters:
> + *
> + * int rar_index
> + * The rar_index is an index to the rar for which you wish to retrieve
> + * the address information.
> + * Values can be 0,1, or 2.
> + *
> + * 
> + *
> + * The function returns a 0 upon success or a -1 if there is no RAR
> + * facility on this system.
> + */
> +int rar_get_address(int rar_index,
> +		    u32 *start_address,
> +		    u32 *end_address)
> +{
> +	int result = -ENODEV;
> +
> +	if (registered)
> +	{
> +		if (start_address == 0
> +		    || end_address == 0
> +		    || rar_index >= MRST_NUM_RAR
> +		    || rar_index < 0)
> +		{
> +			result = -EINVAL;
> +		}
> +		else
> +		{
> +			*start_address = rar_addr[rar_index].low;
> +			*end_address   = rar_addr[rar_index].high;
> +			result = 0;
> +		}
> +	}
> +
> +	return result;
> +}

This function is can be written in much shorter and readable way:

int rar_get_address(int rar_index, u32 *start_address, u32 *end_address)
{
	if (!registered)
		return -ENODEV;

	if (start_address == 0 || end_address == 0 ||
	    rar_index >= MRST_NUM_RAR || rar_index < 0)
		return = -EINVAL;

	*start_address = rar_addr[rar_index].low;
	*end_address   = rar_addr[rar_index].high;

	return 0;
}


> +EXPORT_SYMBOL(rar_get_address);
> +
> +/* The lock_rar function is ued by other device drivers to lock an RAR.
> + * once an RAR is locked, it stays locked until the next system reboot.
> + * The function takes one parameter:
> + *
> + * int rar_index
> + * The rar_index is an index to the rar that you want to lock.
> + * Values can be 0,1, or 2.
> + *
> + * The function returns a 0 upon success or a -1 if there is no RAR
> + * facility on this system.
> + */
> +int rar_lock(int rar_index)
> +{
> +	int result = -ENODEV;
> +
> +	if  (rar_index >= MRST_NUM_RAR || rar_index < 0)
> +	{
> +		result = -EINVAL;
> +		goto exit_rar_lock;

You are not doing any cleanups so the goto is useless, just return -EINVAL here.

> +	}
> +
> +	spin_lock_irqsave(&rar_spinlock_lock, rar_flags);
> +
> +	if (registered)
> +	{
> +		/*
> +		 * Clear bits 4:0 in low register to lock.
> +		 * Clear bits 8,4:0 in high register to lock.
> +		 *
> +		 * The rest of the lower 10 bits in both registers are
> +		 * unused so we might as well clear them all.
> +		 */
> +		u32 const low  = rar_addr[rar_index].low  & 0xfffffc00u;
> +		u32 const high = rar_addr[rar_index].high & 0xfffffc00u;
> +
> +		/*
> +		 * Now program the register using the Lincroft message
> +		 * bus interface.
> +		 */
> +		result = memrar_set_rar_addr(rar_dev,
> +					     rar_offsets[rar_index].low,
> +					     low);
> +
> +		if (result == 0)
> +			result =
> +				memrar_set_rar_addr(
> +					rar_dev,
> +					rar_offsets[rar_index].high,
> +					high);
> +	}
> +
> +	spin_unlock_irqrestore(&rar_spinlock_lock, rar_flags);
> +
> +exit_rar_lock:
> +
> +	return result;
> +}
> +EXPORT_SYMBOL(rar_lock);
> +
> +
> +/*
> +  Local Variables:
> +    c-file-style: "linux"
> +  End:
> +*/
> diff --git a/include/linux/rar/rar_register.h b/include/linux/rar/rar_register.h
> new file mode 100644
> index 0000000..ca6d2e9
> --- /dev/null
> +++ b/include/linux/rar/rar_register.h
> @@ -0,0 +1,67 @@
> +/*
> + *      Copyright (C) 2008, 2009 Intel Corporation. All rights reserved.
> + *
> + *      This program is free software; you can redistribute it and/or
> + *      modify it under the terms of version 2 of the GNU General
> + *      Public License as published by the Free Software Foundation.
> + *
> + *      This program is distributed in the hope that it will be
> + *      useful, but WITHOUT ANY WARRANTY; without even the implied
> + *      warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
> + *      PURPOSE.  See the GNU General Public License for more details.
> + *      You should have received a copy of the GNU General Public
> + *      License along with this program; if not, write to the Free
> + *      Software Foundation, Inc., 59 Temple Place - Suite 330,
> + *      Boston, MA  02111-1307, USA.
> + *      The full GNU General Public License is included in this
> + *      distribution in the file called COPYING.
> + */
> +
> +
> +#ifndef _RAR_REGISTER_H
> +#define _RAR_REGISTER_H
> +
> +# include <linux/types.h>
> +
> +
> +/* The get_rar_address function is used by other device drivers
> + * to obtain RAR address information on a RAR. It takes two
> + * parameter:
> + *
> + * int rar_index
> + * The rar_index is an index to the rar for which you wish to retrieve
> + * the address information.
> + * Values can be 0,1, or 2.
> + *
> + * struct RAR_address_struct is a pointer to a place to which the function
> + * can return the address structure for the RAR.
> + *
> + * The function returns a 0 upon success or a -1 if there is no RAR
> + * facility on this system.
> + */
> +int rar_get_address(int rar_index,
> +		    u32 *start_address, u32 *end_address);
> +
> +
> +/* The lock_rar function is ued by other device drivers to lock an RAR.
> + * once an RAR is locked, it stays locked until the next system reboot.
> + * The function takes one parameter:
> + *
> + * int rar_index
> + * The rar_index is an index to the rar that you want to lock.
> + * Values can be 0,1, or 2.
> + *
> + * The function returns a 0 upon success or a -1 if there is no RAR
> + * facility on this system.
> + */
> +int rar_lock(int rar_index);
> +
> +
> +#endif  /* _RAR_REGISTER_H */
> +
> +
> +/*
> +  Local Variables:
> +    c-file-style: "linux"
> +  End:
> +*/
> -- 
> 1.6.0.6
> 
> --
> To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
> the body of a message to majordomo@vger.kernel.org
> More majordomo info at  http://vger.kernel.org/majordomo-info.html
> Please read the FAQ at  http://www.tux.org/lkml/
> 
--
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@vger.kernel.org
More majordomo info at  http://vger.kernel.org/majordomo-info.html
Please read the FAQ at  http://www.tux.org/lkml/