| lists.openwall.net | lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC | |
|
Open Source and information security mailing list archives
| ||
|
Date: Wed, 20 May 2015 10:37:19 -0700
From: Alexander Duyck <alexander.h.duyck@...hat.com>
To: "Izumi, Taku" <izumi.taku@...fujitsu.com>,
"platform-driver-x86@...r.kernel.org"
<platform-driver-x86@...r.kernel.org>
CC: "Hart, Darren" <darren.hart@...el.com>,
"rkhan@...hat.com" <rkhan@...hat.com>,
"netdev@...r.kernel.org" <netdev@...r.kernel.org>,
"linux-acpi@...r.kernel.org" <linux-acpi@...r.kernel.org>
Subject: Re: [PATCH 4/7] fjes: Define hardware registers and related data
structures
On 05/20/2015 01:19 AM, Izumi, Taku wrote:
>
> This patch adds registers and related data structures
> definition.
>
> Signed-off-by: Taku Izumi <izumi.taku@...fujitsu.com>
So this patch and the next 2 should probably be rearranged so that you
are adding functionality a piece at a time instead of just placing large
chunks in at once.
So normally you don't want to just add defines like this. Instead it
would be better to add the defines as you need them. So this patch
should really be broken up into several pieces and joined in as you add
functionality for various pieces.
> ---
> drivers/platform/x86/fjes/fjes.h | 2 +
> drivers/platform/x86/fjes/fjes_hw.h | 31 ++++++++
> drivers/platform/x86/fjes/fjes_regs.h | 139 ++++++++++++++++++++++++++++++++++
> 3 files changed, 172 insertions(+)
> create mode 100644 drivers/platform/x86/fjes/fjes_hw.h
> create mode 100644 drivers/platform/x86/fjes/fjes_regs.h
>
> diff --git a/drivers/platform/x86/fjes/fjes.h b/drivers/platform/x86/fjes/fjes.h
> index 5586305..efe7cc4 100644
> --- a/drivers/platform/x86/fjes/fjes.h
> +++ b/drivers/platform/x86/fjes/fjes.h
> @@ -25,6 +25,8 @@
>
> #include <linux/acpi.h>
>
> +#include "fjes_hw.h"
> +
> #define FJES_ACPI_SYMBOL "Extended Socket"
>
> extern char fjes_driver_name[];
> diff --git a/drivers/platform/x86/fjes/fjes_hw.h b/drivers/platform/x86/fjes/fjes_hw.h
> new file mode 100644
> index 0000000..c5cc4c5
> --- /dev/null
> +++ b/drivers/platform/x86/fjes/fjes_hw.h
> @@ -0,0 +1,31 @@
> +/*
> + * FUJITSU Extended Socket Network Device driver
> + * Copyright (c) 2015 FUJITSU LIMITED
> + *
> + * This program is free software; you can redistribute it and/or modify it
> + * under the terms and conditions of the GNU General Public License,
> + * version 2, as published by the Free Software Foundation.
> + *
> + * This program is distributed in the hope 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, see <http://www.gnu.org/licenses/>.
> + *
> + * The full GNU General Public License is included in this distribution in
> + * the file called "COPYING".
> + *
> + */
> +
> +#ifndef FJES_HW_H_
> +#define FJES_HW_H_
> +
> +#include <linux/netdevice.h>
> +#include <linux/if_vlan.h>
> +
> +#include "fjes_regs.h"
> +
> +
> +#endif /* FJES_HW_H_ */
> diff --git a/drivers/platform/x86/fjes/fjes_regs.h b/drivers/platform/x86/fjes/fjes_regs.h
> new file mode 100644
> index 0000000..8546cb5
> --- /dev/null
> +++ b/drivers/platform/x86/fjes/fjes_regs.h
> @@ -0,0 +1,139 @@
> +/*
> + * FUJITSU Extended Socket Network Device driver
> + * Copyright (c) 2015 FUJITSU LIMITED
> + *
> + * This program is free software; you can redistribute it and/or modify it
> + * under the terms and conditions of the GNU General Public License,
> + * version 2, as published by the Free Software Foundation.
> + *
> + * This program is distributed in the hope 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, see <http://www.gnu.org/licenses/>.
> + *
> + * The full GNU General Public License is included in this distribution in
> + * the file called "COPYING".
> + *
> + */
> +
> +#ifndef FJES_REGS_H_
> +#define FJES_REGS_H_
> +
> +#include <linux/bitops.h>
> +
> +#define XSCT_DEVICE_REGISTER_SIZE 0x1000
> +
> +/*
> + * register offset
> + */
> +
> +/* Information registers */
> +#define XSCT_OWNER_EPID 0x0000 /* Owner EPID */
> +#define XSCT_MAX_EP 0x0004 /* Maximum EP */
> +
> +/* Device Control registers */
> +#define XSCT_DCTL 0x0010 /* Device Control */
> +
> +/* Command Control registers */
> +#define XSCT_CR 0x0020 /* Command request */
> +#define XSCT_CS 0x0024 /* Command status */
> +#define XSCT_SHSTSAL 0x0028 /* Share status address Low */
> +#define XSCT_SHSTSAH 0x002C /* Share status address High */
> +
> +#define XSCT_REQBL 0x0034 /* Request Buffer length */
> +#define XSCT_REQBAL 0x0038 /* Request Buffer Address Low */
> +#define XSCT_REQBAH 0x003C /* Request Buffer Address High */
> +
> +#define XSCT_RESPBL 0x0044 /* Response Buffer Length */
> +#define XSCT_RESPBAL 0x0048 /* Response Buffer Address Low */
> +#define XSCT_RESPBAH 0x004C /* Response Buffer Address High */
> +
> +/* Interrupt Control registers */
> +#define XSCT_IS 0x0080 /* Interrupt status */
> +#define XSCT_IMS 0x0084 /* Interrupt mas set */
> +#define XSCT_IMC 0x0088 /* Interrupt mask clear */
> +#define XSCT_IG 0x008C /* Interrupt generator */
> +#define XSCT_ICTL 0x0090 /* Interrupt control */
> +
> +
> +/*
> + * register structure
> + */
> +
> +/* Information registers */
> +union REG_OWNER_EPID {
> + struct {
> + __le32 epid:16;
> + __le32:16;
> + } Bits;
> + __le32 Reg;
> +};
> +
> +union REG_MAX_EP {
> + struct {
> + __le32 maxep:16;
> + __le32:16;
> + } Bits;
> + __le32 Reg;
> +};
> +
> +/* Device Control registers */
> +union REG_DCTL {
> + struct {
> + __le32 reset:1;
> + __le32 rsv0:15;
> + __le32 rsv1:16;
> + } Bits;
> + __le32 Reg;
> +};
> +
> +
> +/* Command Control registers */
> +union REG_CR {
> + struct {
> + __le32 req_code:16;
> + __le32 err_info:14;
> + __le32 error:1;
> + __le32 req_start:1;
> + } Bits;
> + __le32 Reg;
> +};
> +
> +union REG_CS {
> + struct {
> + __le32 req_code:16;
> + __le32 rsv0:14;
> + __le32 busy:1;
> + __le32 complete:1;
> + } Bits;
> + __le32 Reg;
> +};
> +
It might be better to just define some masks and shifts instead of
creating all these bitfield unions. It would probably make things a lot
less complicated since you wouldn't have to define a special union for
each register.
It is usually easier to define a write that way rather than having to
create a union and populate the bits before you can write it. I've
found that there are a number of GCC versions that don't exactly do the
smartest things when it comes to bitfields.
> +/* Interrupt Control registers */
> +union REG_ICTL {
> + struct {
> + __le32 automak:1;
> + __le32 rsv0:31;
> + } Bits;
> + __le32 Reg;
> +};
> +
Should automak be automask? Just wondering if that is a typo. Also if
this is a mostly reserved 0 register you could probably save yourself
some trouble and just use the reg as-is without the need for the union.
So for example you would just define a value such as:
#define FJES_ICTL_AUTOMASK 0x00000001
Then all you do is write that value when you want to enable it, or write
0 to disable it.
> +enum REG_ICTL_MASK {
> + REG_ICTL_MASK_INFO_UPDATE = 1 << 20,
> + REG_ICTL_MASK_DEV_STOP_REQ = 1 << 19,
> + REG_ICTL_MASK_TXRX_STOP_REQ = 1 << 18,
> + REG_ICTL_MASK_TXRX_STOP_DONE = 1 << 17,
> + REG_ICTL_MASK_RX_DATA = 1 << 16,
> + REG_ICTL_MASK_ALL = GENMASK(20, 16),
> +};
> +
You could probably reverse the order of this for readability. It is
better to go from 16 to 20 rather than 20 to 16.
> +enum REG_IS_MASK {
> + REG_IS_MASK_IS_ASSERT = 1 << 31,
> + REG_IS_MASK_EPID = GENMASK(15, 0),
> +};
> +
> +
> +#endif /* FJES_REGS_H_ */
>
I would update the 2 lines so that indentation for the = matched. It
looks like the GENMASK is tabbed over one additional tab.
--
To unsubscribe from this list: send the line "unsubscribe netdev" in
the body of a message to majordomo@...r.kernel.org
More majordomo info at http://vger.kernel.org/majordomo-info.html
Powered by blists - more mailing lists