linux-kernel.vger.kernel.org archive mirror
 help / color / mirror / Atom feed
* [PATCH] MPT FUSION:  Delete unused header files.
@ 2007-03-10 21:57 Robert P. J. Day
  2007-03-11 19:55 ` Eric Moore
  0 siblings, 1 reply; 10+ messages in thread
From: Robert P. J. Day @ 2007-03-10 21:57 UTC (permalink / raw)
  To: Linux Kernel Mailing List; +Cc: Andrew Morton, eric.moore


  Delete apparently unused header files.

Signed-off-by: Robert P. J. Day <rpjday@mindspring.com>

---

 drivers/message/fusion/lsi/mpi_inb.h    |  221 ----------------------
 drivers/message/fusion/lsi/mpi_log_fc.h |   89 --------
 2 files changed, 310 deletions(-)

diff --git a/drivers/message/fusion/lsi/mpi_inb.h b/drivers/message/fusion/lsi/mpi_inb.h
deleted file mode 100644
index ff16730..0000000
--- a/drivers/message/fusion/lsi/mpi_inb.h
+++ /dev/null
@@ -1,221 +0,0 @@
-/*
- *  Copyright (c) 2003-2004 LSI Logic Corporation.
- *
- *
- *           Name:  mpi_inb.h
- *          Title:  MPI Inband structures and definitions
- *  Creation Date:  September 30, 2003
- *
- *    mpi_inb.h Version:  01.05.01
- *
- *  Version History
- *  ---------------
- *
- *  Date      Version   Description
- *  --------  --------  ------------------------------------------------------
- *  05-11-04  01.03.01  Original release.
- *  08-19-04  01.05.01  Original release for MPI v1.5.
- *  --------------------------------------------------------------------------
- */
-
-#ifndef MPI_INB_H
-#define MPI_INB_H
-
-/******************************************************************************
-*
-*        I n b a n d    M e s s a g e s
-*
-*******************************************************************************/
-
-
-/****************************************************************************/
-/* Inband Buffer Post Request                                               */
-/****************************************************************************/
-
-typedef struct _MSG_INBAND_BUFFER_POST_REQUEST
-{
-    U8                      Reserved1;          /* 00h */
-    U8                      BufferCount;        /* 01h */
-    U8                      ChainOffset;        /* 02h */
-    U8                      Function;           /* 03h */
-    U16                     Reserved2;          /* 04h */
-    U8                      Reserved3;          /* 06h */
-    U8                      MsgFlags;           /* 07h */
-    U32                     MsgContext;         /* 08h */
-    U32                     Reserved4;          /* 0Ch */
-    SGE_TRANS_SIMPLE_UNION  SGL;                /* 10h */
-} MSG_INBAND_BUFFER_POST_REQUEST, MPI_POINTER PTR_MSG_INBAND_BUFFER_POST_REQUEST,
-  MpiInbandBufferPostRequest_t , MPI_POINTER pMpiInbandBufferPostRequest_t;
-
-
-typedef struct _WWN_FC_FORMAT
-{
-    U64                     NodeName;           /* 00h */
-    U64                     PortName;           /* 08h */
-} WWN_FC_FORMAT, MPI_POINTER PTR_WWN_FC_FORMAT,
-  WwnFcFormat_t, MPI_POINTER pWwnFcFormat_t;
-
-typedef struct _WWN_SAS_FORMAT
-{
-    U64                     WorldWideID;        /* 00h */
-    U32                     Reserved1;          /* 08h */
-    U32                     Reserved2;          /* 0Ch */
-} WWN_SAS_FORMAT, MPI_POINTER PTR_WWN_SAS_FORMAT,
-  WwnSasFormat_t, MPI_POINTER pWwnSasFormat_t;
-
-typedef union _WWN_INBAND_FORMAT
-{
-    WWN_FC_FORMAT           Fc;
-    WWN_SAS_FORMAT          Sas;
-} WWN_INBAND_FORMAT, MPI_POINTER PTR_WWN_INBAND_FORMAT,
-  WwnInbandFormat, MPI_POINTER pWwnInbandFormat;
-
-
-/* Inband Buffer Post reply message */
-
-typedef struct _MSG_INBAND_BUFFER_POST_REPLY
-{
-    U16                     Reserved1;          /* 00h */
-    U8                      MsgLength;          /* 02h */
-    U8                      Function;           /* 03h */
-    U16                     Reserved2;          /* 04h */
-    U8                      Reserved3;          /* 06h */
-    U8                      MsgFlags;           /* 07h */
-    U32                     MsgContext;         /* 08h */
-    U16                     Reserved4;          /* 0Ch */
-    U16                     IOCStatus;          /* 0Eh */
-    U32                     IOCLogInfo;         /* 10h */
-    U32                     TransferLength;     /* 14h */
-    U32                     TransactionContext; /* 18h */
-    WWN_INBAND_FORMAT       Wwn;                /* 1Ch */
-    U32                     IOCIdentifier[4];   /* 2Ch */
-} MSG_INBAND_BUFFER_POST_REPLY, MPI_POINTER PTR_MSG_INBAND_BUFFER_POST_REPLY,
-  MpiInbandBufferPostReply_t, MPI_POINTER pMpiInbandBufferPostReply_t;
-
-
-/****************************************************************************/
-/* Inband Send Request                                                      */
-/****************************************************************************/
-
-typedef struct _MSG_INBAND_SEND_REQUEST
-{
-    U16                     Reserved1;          /* 00h */
-    U8                      ChainOffset;        /* 02h */
-    U8                      Function;           /* 03h */
-    U16                     Reserved2;          /* 04h */
-    U8                      Reserved3;          /* 06h */
-    U8                      MsgFlags;           /* 07h */
-    U32                     MsgContext;         /* 08h */
-    U32                     Reserved4;          /* 0Ch */
-    WWN_INBAND_FORMAT       Wwn;                /* 10h */
-    U32                     Reserved5;          /* 20h */
-    SGE_IO_UNION            SGL;                /* 24h */
-} MSG_INBAND_SEND_REQUEST, MPI_POINTER PTR_MSG_INBAND_SEND_REQUEST,
-  MpiInbandSendRequest_t , MPI_POINTER pMpiInbandSendRequest_t;
-
-
-/* Inband Send reply message */
-
-typedef struct _MSG_INBAND_SEND_REPLY
-{
-    U16                     Reserved1;          /* 00h */
-    U8                      MsgLength;          /* 02h */
-    U8                      Function;           /* 03h */
-    U16                     Reserved2;          /* 04h */
-    U8                      Reserved3;          /* 06h */
-    U8                      MsgFlags;           /* 07h */
-    U32                     MsgContext;         /* 08h */
-    U16                     Reserved4;          /* 0Ch */
-    U16                     IOCStatus;          /* 0Eh */
-    U32                     IOCLogInfo;         /* 10h */
-    U32                     ResponseLength;     /* 14h */
-} MSG_INBAND_SEND_REPLY, MPI_POINTER PTR_MSG_INBAND_SEND_REPLY,
-  MpiInbandSendReply_t, MPI_POINTER pMpiInbandSendReply_t;
-
-
-/****************************************************************************/
-/* Inband Response Request                                                  */
-/****************************************************************************/
-
-typedef struct _MSG_INBAND_RSP_REQUEST
-{
-    U16                     Reserved1;          /* 00h */
-    U8                      ChainOffset;        /* 02h */
-    U8                      Function;           /* 03h */
-    U16                     Reserved2;          /* 04h */
-    U8                      Reserved3;          /* 06h */
-    U8                      MsgFlags;           /* 07h */
-    U32                     MsgContext;         /* 08h */
-    U32                     Reserved4;          /* 0Ch */
-    WWN_INBAND_FORMAT       Wwn;                /* 10h */
-    U32                     IOCIdentifier[4];   /* 20h */
-    U32                     ResponseLength;     /* 30h */
-    SGE_IO_UNION            SGL;                /* 34h */
-} MSG_INBAND_RSP_REQUEST, MPI_POINTER PTR_MSG_INBAND_RSP_REQUEST,
-  MpiInbandRspRequest_t , MPI_POINTER pMpiInbandRspRequest_t;
-
-
-/* Inband Response reply message */
-
-typedef struct _MSG_INBAND_RSP_REPLY
-{
-    U16                     Reserved1;          /* 00h */
-    U8                      MsgLength;          /* 02h */
-    U8                      Function;           /* 03h */
-    U16                     Reserved2;          /* 04h */
-    U8                      Reserved3;          /* 06h */
-    U8                      MsgFlags;           /* 07h */
-    U32                     MsgContext;         /* 08h */
-    U16                     Reserved4;          /* 0Ch */
-    U16                     IOCStatus;          /* 0Eh */
-    U32                     IOCLogInfo;         /* 10h */
-} MSG_INBAND_RSP_REPLY, MPI_POINTER PTR_MSG_INBAND_RSP_REPLY,
-  MpiInbandRspReply_t, MPI_POINTER pMpiInbandRspReply_t;
-
-
-/****************************************************************************/
-/* Inband Abort Request                                                     */
-/****************************************************************************/
-
-typedef struct _MSG_INBAND_ABORT_REQUEST
-{
-    U8                      Reserved1;          /* 00h */
-    U8                      AbortType;          /* 01h */
-    U8                      ChainOffset;        /* 02h */
-    U8                      Function;           /* 03h */
-    U16                     Reserved2;          /* 04h */
-    U8                      Reserved3;          /* 06h */
-    U8                      MsgFlags;           /* 07h */
-    U32                     MsgContext;         /* 08h */
-    U32                     Reserved4;          /* 0Ch */
-    U32                     ContextToAbort;     /* 10h */
-} MSG_INBAND_ABORT_REQUEST, MPI_POINTER PTR_MSG_INBAND_ABORT_REQUEST,
-  MpiInbandAbortRequest_t , MPI_POINTER pMpiInbandAbortRequest_t;
-
-#define MPI_INBAND_ABORT_TYPE_ALL_BUFFERS       (0x00)
-#define MPI_INBAND_ABORT_TYPE_EXACT_BUFFER      (0x01)
-#define MPI_INBAND_ABORT_TYPE_SEND_REQUEST      (0x02)
-#define MPI_INBAND_ABORT_TYPE_RESPONSE_REQUEST  (0x03)
-
-
-/* Inband Abort reply message */
-
-typedef struct _MSG_INBAND_ABORT_REPLY
-{
-    U8                      Reserved1;          /* 00h */
-    U8                      AbortType;          /* 01h */
-    U8                      MsgLength;          /* 02h */
-    U8                      Function;           /* 03h */
-    U16                     Reserved2;          /* 04h */
-    U8                      Reserved3;          /* 06h */
-    U8                      MsgFlags;           /* 07h */
-    U32                     MsgContext;         /* 08h */
-    U16                     Reserved4;          /* 0Ch */
-    U16                     IOCStatus;          /* 0Eh */
-    U32                     IOCLogInfo;         /* 10h */
-} MSG_INBAND_ABORT_REPLY, MPI_POINTER PTR_MSG_INBAND_ABORT_REPLY,
-  MpiInbandAbortReply_t, MPI_POINTER pMpiInbandAbortReply_t;
-
-
-#endif
-
diff --git a/drivers/message/fusion/lsi/mpi_log_fc.h b/drivers/message/fusion/lsi/mpi_log_fc.h
deleted file mode 100644
index dc98d46..0000000
--- a/drivers/message/fusion/lsi/mpi_log_fc.h
+++ /dev/null
@@ -1,89 +0,0 @@
-/*
- *  Copyright (c) 2000-2001 LSI Logic Corporation. All rights reserved.
- *
- *  NAME:           fc_log.h
- *  SUMMARY:        MPI IocLogInfo definitions for the SYMFC9xx chips
- *  DESCRIPTION:    Contains the enumerated list of values that may be returned
- *                  in the IOCLogInfo field of a MPI Default Reply Message.
- *
- *  CREATION DATE:  6/02/2000
- *  ID:             $Id: fc_log.h,v 4.6 2001/07/26 14:41:33 sschremm Exp $
- */
-
-
-/*
- * MpiIocLogInfo_t enum
- *
- * These 32 bit values are used in the IOCLogInfo field of the MPI reply
- * messages.
- * The value is 0xabcccccc where
- *          a = The type of log info as per the MPI spec. Since these codes are
- *              all for Fibre Channel this value will always be 2.
- *          b = Specifies a subclass of the firmware where
- *                  0 = FCP Initiator
- *                  1 = FCP Target
- *                  2 = LAN
- *                  3 = MPI Message Layer
- *                  4 = FC Link
- *                  5 = Context Manager
- *                  6 = Invalid Field Offset
- *                  7 = State Change Info
- *                  all others are reserved for future use
- *          c = A specific value within the subclass.
- *
- * NOTE: Any new values should be added to the end of each subclass so that the
- *       codes remain consistent across firmware releases.
- */
-typedef enum _MpiIocLogInfoFc
-{
-    MPI_IOCLOGINFO_FC_INIT_BASE                     = 0x20000000,
-    MPI_IOCLOGINFO_FC_INIT_ERROR_OUT_OF_ORDER_FRAME = 0x20000001, /* received an out of order frame - unsupported */
-    MPI_IOCLOGINFO_FC_INIT_ERROR_BAD_START_OF_FRAME = 0x20000002, /* Bad Rx Frame, bad start of frame primative */
-    MPI_IOCLOGINFO_FC_INIT_ERROR_BAD_END_OF_FRAME   = 0x20000003, /* Bad Rx Frame, bad end of frame primative */
-    MPI_IOCLOGINFO_FC_INIT_ERROR_OVER_RUN           = 0x20000004, /* Bad Rx Frame, overrun */
-    MPI_IOCLOGINFO_FC_INIT_ERROR_RX_OTHER           = 0x20000005, /* Other errors caught by IOC which require retries */
-    MPI_IOCLOGINFO_FC_INIT_ERROR_SUBPROC_DEAD       = 0x20000006, /* Main processor could not initialize sub-processor */
-    MPI_IOCLOGINFO_FC_INIT_ERROR_RX_OVERRUN         = 0x20000007, /* Scatter Gather overrun  */
-    MPI_IOCLOGINFO_FC_INIT_ERROR_RX_BAD_STATUS      = 0x20000008, /* Receiver detected context mismatch via invalid header */
-    MPI_IOCLOGINFO_FC_INIT_ERROR_RX_UNEXPECTED_FRAME= 0x20000009, /* CtxMgr detected unsupported frame type  */
-    MPI_IOCLOGINFO_FC_INIT_ERROR_LINK_FAILURE       = 0x2000000A, /* Link failure occurred  */
-    MPI_IOCLOGINFO_FC_INIT_ERROR_TX_TIMEOUT         = 0x2000000B, /* Transmitter timeout error */
-
-    MPI_IOCLOGINFO_FC_TARGET_BASE                   = 0x21000000,
-    MPI_IOCLOGINFO_FC_TARGET_NO_PDISC               = 0x21000001, /* not sent because we are waiting for a PDISC from the initiator */
-    MPI_IOCLOGINFO_FC_TARGET_NO_LOGIN               = 0x21000002, /* not sent because we are not logged in to the remote node */
-    MPI_IOCLOGINFO_FC_TARGET_DOAR_KILLED_BY_LIP     = 0x21000003, /* Data Out, Auto Response, not sent due to a LIP */
-    MPI_IOCLOGINFO_FC_TARGET_DIAR_KILLED_BY_LIP     = 0x21000004, /* Data In, Auto Response, not sent due to a LIP */
-    MPI_IOCLOGINFO_FC_TARGET_DIAR_MISSING_DATA      = 0x21000005, /* Data In, Auto Response, missing data frames */
-    MPI_IOCLOGINFO_FC_TARGET_DONR_KILLED_BY_LIP     = 0x21000006, /* Data Out, No Response, not sent due to a LIP */
-    MPI_IOCLOGINFO_FC_TARGET_WRSP_KILLED_BY_LIP     = 0x21000007, /* Auto-response after a write not sent due to a LIP */
-    MPI_IOCLOGINFO_FC_TARGET_DINR_KILLED_BY_LIP     = 0x21000008, /* Data In, No Response, not completed due to a LIP */
-    MPI_IOCLOGINFO_FC_TARGET_DINR_MISSING_DATA      = 0x21000009, /* Data In, No Response, missing data frames */
-    MPI_IOCLOGINFO_FC_TARGET_MRSP_KILLED_BY_LIP     = 0x2100000a, /* Manual Response not sent due to a LIP */
-    MPI_IOCLOGINFO_FC_TARGET_NO_CLASS_3             = 0x2100000b, /* not sent because remote node does not support Class 3 */
-    MPI_IOCLOGINFO_FC_TARGET_LOGIN_NOT_VALID        = 0x2100000c, /* not sent because login to remote node not validated */
-    MPI_IOCLOGINFO_FC_TARGET_FROM_OUTBOUND          = 0x2100000e, /* cleared from the outbound queue after a logout */
-    MPI_IOCLOGINFO_FC_TARGET_WAITING_FOR_DATA_IN    = 0x2100000f, /* cleared waiting for data after a logout */
-
-    MPI_IOCLOGINFO_FC_LAN_BASE                      = 0x22000000,
-    MPI_IOCLOGINFO_FC_LAN_TRANS_SGL_MISSING         = 0x22000001, /* Transaction Context Sgl Missing */
-    MPI_IOCLOGINFO_FC_LAN_TRANS_WRONG_PLACE         = 0x22000002, /* Transaction Context found before an EOB */
-    MPI_IOCLOGINFO_FC_LAN_TRANS_RES_BITS_SET        = 0x22000003, /* Transaction Context value has reserved bits set */
-    MPI_IOCLOGINFO_FC_LAN_WRONG_SGL_FLAG            = 0x22000004, /* Invalid SGL Flags */
-
-    MPI_IOCLOGINFO_FC_MSG_BASE                      = 0x23000000,
-
-    MPI_IOCLOGINFO_FC_LINK_BASE                     = 0x24000000,
-    MPI_IOCLOGINFO_FC_LINK_LOOP_INIT_TIMEOUT        = 0x24000001, /* Loop initialization timed out */
-    MPI_IOCLOGINFO_FC_LINK_ALREADY_INITIALIZED      = 0x24000002, /* Another system controller already initialized the loop */
-    MPI_IOCLOGINFO_FC_LINK_LINK_NOT_ESTABLISHED     = 0x24000003, /* Not synchronized to signal or still negotiating (possible cable problem) */
-    MPI_IOCLOGINFO_FC_LINK_CRC_ERROR                = 0x24000004, /* CRC check detected error on received frame */
-
-    MPI_IOCLOGINFO_FC_CTX_BASE                      = 0x25000000,
-
-    MPI_IOCLOGINFO_FC_INVALID_FIELD_BYTE_OFFSET     = 0x26000000, /* The lower 24 bits give the byte offset of the field in the request message that is invalid */
-    MPI_IOCLOGINFO_FC_INVALID_FIELD_MAX_OFFSET      = 0x26ffffff,
-
-    MPI_IOCLOGINFO_FC_STATE_CHANGE                  = 0x27000000  /* The lower 24 bits give additional information concerning state change */
-
-} MpiIocLogInfoFc_t;
-- 
========================================================================
Robert P. J. Day
Linux Consulting, Training and Annoying Kernel Pedantry
Waterloo, Ontario, CANADA

http://fsdev.net/wiki/index.php?title=Main_Page
========================================================================

^ permalink raw reply related	[flat|nested] 10+ messages in thread

* Re: [PATCH] MPT FUSION:  Delete unused header files.
  2007-03-10 21:57 [PATCH] MPT FUSION: Delete unused header files Robert P. J. Day
@ 2007-03-11 19:55 ` Eric Moore
  2007-03-11 20:51   ` David Miller
                     ` (2 more replies)
  0 siblings, 3 replies; 10+ messages in thread
From: Eric Moore @ 2007-03-11 19:55 UTC (permalink / raw)
  To: Robert P. J. Day; +Cc: Linux Kernel Mailing List, Andrew Morton

On Sat, Mar 10, 2007 at 04:57:35PM -0500, Robert P. J. Day wrote:
> 
>   Delete apparently unused header files.
> 
> Signed-off-by: Robert P. J. Day <rpjday@mindspring.com>
> 
> ---
> 
>  drivers/message/fusion/lsi/mpi_inb.h    |  221 ----------------------
>  drivers/message/fusion/lsi/mpi_log_fc.h |   89 --------
>  2 files changed, 310 deletions(-)
> 

NACK.

Thanks, but no thanks.  Don't remove these header files.  These are the mpi
header files that define the interface between firmware and drivers.  This
set of headers are bundled with each flavor OS, and we are constantly
providing update files when changes occur.

With respect to mpi_log_fc.h - this defines the loginfo for fibre channel
protocal.  This is a easy lookup to for LSI Logic customers to better
understand the kind of errors returned from firmware, and help reduce number
of support generated request, as the end user can merely lookup the unqiue
id in the header file.    mpi_inb.h, is header for fibre channel protocal
definii
ng the inband-management interface, and maybe implemented some day.

Eric Moore
LSI Logic




^ permalink raw reply	[flat|nested] 10+ messages in thread

* Re: [PATCH] MPT FUSION: Delete unused header files.
  2007-03-11 19:55 ` Eric Moore
@ 2007-03-11 20:51   ` David Miller
  2007-03-11 21:11   ` Robert P. J. Day
  2007-03-11 22:32   ` Valdis.Kletnieks
  2 siblings, 0 replies; 10+ messages in thread
From: David Miller @ 2007-03-11 20:51 UTC (permalink / raw)
  To: eric.moore; +Cc: rpjday, linux-kernel, akpm

From: Eric Moore <eric.moore@lsi.com>
Date: Sun, 11 Mar 2007 13:55:54 -0600

> On Sat, Mar 10, 2007 at 04:57:35PM -0500, Robert P. J. Day wrote:
> > 
> >   Delete apparently unused header files.
> > 
> > Signed-off-by: Robert P. J. Day <rpjday@mindspring.com>
> > 
> > ---
> > 
> >  drivers/message/fusion/lsi/mpi_inb.h    |  221 ----------------------
> >  drivers/message/fusion/lsi/mpi_log_fc.h |   89 --------
> >  2 files changed, 310 deletions(-)
> > 
> 
> NACK.
> 
> Thanks, but no thanks.  Don't remove these header files.  These are the mpi
> header files that define the interface between firmware and drivers.  This
> set of headers are bundled with each flavor OS, and we are constantly
> providing update files when changes occur.
> 
> With respect to mpi_log_fc.h - this defines the loginfo for fibre channel
> protocal.  This is a easy lookup to for LSI Logic customers to better
> understand the kind of errors returned from firmware, and help reduce number
> of support generated request, as the end user can merely lookup the unqiue
> id in the header file.    mpi_inb.h, is header for fibre channel protocal
> definii
> ng the inband-management interface, and maybe implemented some day.

This is not the criteria for keeping source files in the tree,
they really have to be used to stay there.

If you want to document the error codes and other interfaces, publish
the programming manual for your hardware on a web site.

Sorry if you don't like this, but the linux kernel is about more than
your driver and your needs, it's about the needs of maintaining a huge
behemoth source tree in some sane manner and part of achieving that
goal is important tasks such as eliminating unused code and source
files.

^ permalink raw reply	[flat|nested] 10+ messages in thread

* Re: [PATCH] MPT FUSION:  Delete unused header files.
  2007-03-11 19:55 ` Eric Moore
  2007-03-11 20:51   ` David Miller
@ 2007-03-11 21:11   ` Robert P. J. Day
  2007-03-11 22:32   ` Valdis.Kletnieks
  2 siblings, 0 replies; 10+ messages in thread
From: Robert P. J. Day @ 2007-03-11 21:11 UTC (permalink / raw)
  To: Eric Moore; +Cc: Linux Kernel Mailing List, Andrew Morton

On Sun, 11 Mar 2007, Eric Moore wrote:

> On Sat, Mar 10, 2007 at 04:57:35PM -0500, Robert P. J. Day wrote:
> >
> >   Delete apparently unused header files.
> >
> > Signed-off-by: Robert P. J. Day <rpjday@mindspring.com>
> >
> > ---
> >
> >  drivers/message/fusion/lsi/mpi_inb.h    |  221 ----------------------
> >  drivers/message/fusion/lsi/mpi_log_fc.h |   89 --------
> >  2 files changed, 310 deletions(-)
> >
>
> NACK.
>
> Thanks, but no thanks.  Don't remove these header files.  These are
> the mpi header files that define the interface between firmware and
> drivers.  This set of headers are bundled with each flavor OS, and
> we are constantly providing update files when changes occur.

either way works for me, i was just identifying unused header files.

rday

p.s.  just to clarify, when i use the adjective "unused", i mean that
that header file is not used *anywhere* in the source tree -- not even
in an include that is currently commented out or conditionally
included.  i mean *nowhere* (as long as i didn't screw up my
programming, that is).

so whether people want to keep those header files in the tree is up to
them.

-- 
========================================================================
Robert P. J. Day
Linux Consulting, Training and Annoying Kernel Pedantry
Waterloo, Ontario, CANADA

http://fsdev.net/wiki/index.php?title=Main_Page
========================================================================

^ permalink raw reply	[flat|nested] 10+ messages in thread

* Re: [PATCH] MPT FUSION: Delete unused header files.
  2007-03-11 19:55 ` Eric Moore
  2007-03-11 20:51   ` David Miller
  2007-03-11 21:11   ` Robert P. J. Day
@ 2007-03-11 22:32   ` Valdis.Kletnieks
  2007-03-12 16:19     ` Moore, Eric
  2 siblings, 1 reply; 10+ messages in thread
From: Valdis.Kletnieks @ 2007-03-11 22:32 UTC (permalink / raw)
  To: Eric Moore; +Cc: Robert P. J. Day, Linux Kernel Mailing List, Andrew Morton

[-- Attachment #1: Type: text/plain, Size: 1155 bytes --]

On Sun, 11 Mar 2007 13:55:54 MDT, Eric Moore said:
>
> With respect to mpi_log_fc.h - this defines the loginfo for fibre channel
> protocal.  This is a easy lookup to for LSI Logic customers to better
> understand the kind of errors returned from firmware, and help reduce number
> of support generated request, as the end user can merely lookup the unqiue
> id in the header file.

Certainly appropriate content for something on your website, and vendors who
provide programs like dmidecode and parsemce are always welcome. I could
probably be convinced that such info should have at least a pointer somewhere
in Documentation/lsi_debug.txt or some such.  But quite frankly, if I'm reduced
to wading through *.h files to figure out what some recalcitrant hardware is
upset about, there's been a failure in documentation.  *ESPECIALLY* if I
go look at drivers/whatever/source.c and it doesn't even *reference* the *.h
file in question.

>                        mpi_inb.h, is header for fibre channel protocal
> ng the inband-management interface, and maybe implemented some day.

Feel free to include mpi_inb.h when you submit the interface for merging.

[-- Attachment #2: Type: application/pgp-signature, Size: 226 bytes --]

^ permalink raw reply	[flat|nested] 10+ messages in thread

* RE: [PATCH] MPT FUSION: Delete unused header files.
  2007-03-11 22:32   ` Valdis.Kletnieks
@ 2007-03-12 16:19     ` Moore, Eric
  2007-03-12 19:44       ` Roberto Nibali
  2007-03-12 21:00       ` David Miller
  0 siblings, 2 replies; 10+ messages in thread
From: Moore, Eric @ 2007-03-12 16:19 UTC (permalink / raw)
  To: Valdis.Kletnieks
  Cc: Robert P. J. Day, Linux Kernel Mailing List, Andrew Morton

Valdis.Kletnieks silly little rant: 

> Certainly appropriate content for something on your website, 
> and vendors who
> provide programs like dmidecode and parsemce are always 
> welcome. I could
> probably be convinced that such info should have at least a 
> pointer somewhere
> in Documentation/lsi_debug.txt or some such.  But quite 
> frankly, if I'm reduced
> to wading through *.h files to figure out what some 
> recalcitrant hardware is
> upset about, there's been a failure in documentation.  
> *ESPECIALLY* if I
> go look at drivers/whatever/source.c and it doesn't even 
> *reference* the *.h
> file in question.


Its apparent to me that you don't have our hardware, nor have you
actually waded thru this driver source code. 

If you did, you would of noticed that the header you want to delete, is
actually referenced in the *.c source code.   The file "mpi_log_fc.h",
is indeed mentioned in mptbase.c, in the function called
mpt_fc_log_info, in the documention section above the function.    This
header file is very helpful to those supporting our hardware, and those
using it
For SAS(mpi_log_sas.h), I have broken out each loginfo in the strings
you will find defined in originator_str, iop_code_str, pl_code_str, etc,
I probably do that with fibre.

If its that important to you to have the header files included, I will
provide a patch that does that.    

Eric Moore

^ permalink raw reply	[flat|nested] 10+ messages in thread

* Re: [PATCH] MPT FUSION: Delete unused header files.
  2007-03-12 16:19     ` Moore, Eric
@ 2007-03-12 19:44       ` Roberto Nibali
  2007-03-12 21:00       ` David Miller
  1 sibling, 0 replies; 10+ messages in thread
From: Roberto Nibali @ 2007-03-12 19:44 UTC (permalink / raw)
  To: Moore, Eric
  Cc: Valdis.Kletnieks, Robert P. J. Day, Linux Kernel Mailing List,
	Andrew Morton

>> Certainly appropriate content for something on your website, 
>> and vendors who
>> provide programs like dmidecode and parsemce are always 
>> welcome. I could
>> probably be convinced that such info should have at least a 
>> pointer somewhere
>> in Documentation/lsi_debug.txt or some such.  But quite 
>> frankly, if I'm reduced
>> to wading through *.h files to figure out what some 
>> recalcitrant hardware is
>> upset about, there's been a failure in documentation.  
>> *ESPECIALLY* if I
>> go look at drivers/whatever/source.c and it doesn't even 
>> *reference* the *.h
>> file in question.
> 
> 
> Its apparent to me that you don't have our hardware, nor have you
> actually waded thru this driver source code. 

Allow me to shortly chime in here:

I'm the author of the mpt-status user space tool (a simple alternative 
to your Java GUI tool), which queries LSI controllers and reports back 
the RAID status and the synchronization state; so I have waded through 
the driver source code quite a lot. My question:

> If you did, you would of noticed that the header you want to delete, is
> actually referenced in the *.c source code.   The file "mpi_log_fc.h",
> is indeed mentioned in mptbase.c, in the function called
> mpt_fc_log_info, in the documention section above the function.    This
> header file is very helpful to those supporting our hardware, and those
> using it
> For SAS(mpi_log_sas.h), I have broken out each loginfo in the strings
> you will find defined in originator_str, iop_code_str, pl_code_str, etc,
> I probably do that with fibre.
> 
> If its that important to you to have the header files included, I will
> provide a patch that does that.    

I would really like to see "sanitized" kernel headers, so is it possible 
to have your headers inside ../drivers/message/fusion{,/lsi} somehow 
inserted into the process of the headers_install target?

Best regards,
Roberto Nibali, ratz
-- 
echo 
'[q]sa[ln0=aln256%Pln256/snlbx]sb3135071790101768542287578439snlbxq' | dc

^ permalink raw reply	[flat|nested] 10+ messages in thread

* Re: [PATCH] MPT FUSION: Delete unused header files.
  2007-03-12 16:19     ` Moore, Eric
  2007-03-12 19:44       ` Roberto Nibali
@ 2007-03-12 21:00       ` David Miller
  2007-03-12 21:29         ` Moore, Eric
  1 sibling, 1 reply; 10+ messages in thread
From: David Miller @ 2007-03-12 21:00 UTC (permalink / raw)
  To: Eric.Moore; +Cc: Valdis.Kletnieks, rpjday, linux-kernel, akpm

From: "Moore, Eric" <Eric.Moore@lsi.com>
Date: Mon, 12 Mar 2007 10:19:18 -0600

> Valdis.Kletnieks silly little rant: 
> 
> > Certainly appropriate content for something on your website, 
> > and vendors who
> > provide programs like dmidecode and parsemce are always 
> > welcome. I could
> > probably be convinced that such info should have at least a 
> > pointer somewhere
> > in Documentation/lsi_debug.txt or some such.  But quite 
> > frankly, if I'm reduced
> > to wading through *.h files to figure out what some 
> > recalcitrant hardware is
> > upset about, there's been a failure in documentation.  
> > *ESPECIALLY* if I
> > go look at drivers/whatever/source.c and it doesn't even 
> > *reference* the *.h
> > file in question.
> 
> 
> Its apparent to me that you don't have our hardware, nor have you
> actually waded thru this driver source code. 
> 
> If you did, you would of noticed that the header you want to delete, is
> actually referenced in the *.c source code.   The file "mpi_log_fc.h",
> is indeed mentioned in mptbase.c, in the function called
> mpt_fc_log_info, in the documention section above the function.    This
> header file is very helpful to those supporting our hardware, and those
> using it
> For SAS(mpi_log_sas.h), I have broken out each loginfo in the strings
> you will find defined in originator_str, iop_code_str, pl_code_str, etc,
> I probably do that with fibre.
> 
> If its that important to you to have the header files included, I will
> provide a patch that does that.    

If you're going to include it just for the sake of including it, not
because the code in question actually uses types or function
declarations defined in there, don't bother, you're just using an
anti-social mechanism to keep this header file in the tree.

Please, let's kill this header file if it is unused.

^ permalink raw reply	[flat|nested] 10+ messages in thread

* RE: [PATCH] MPT FUSION: Delete unused header files.
  2007-03-12 21:00       ` David Miller
@ 2007-03-12 21:29         ` Moore, Eric
  2007-03-12 21:31           ` David Miller
  0 siblings, 1 reply; 10+ messages in thread
From: Moore, Eric @ 2007-03-12 21:29 UTC (permalink / raw)
  To: David Miller; +Cc: Valdis.Kletnieks, rpjday, linux-kernel, akpm


> If you're going to include it just for the sake of including it, not
> because the code in question actually uses types or function
> declarations defined in there, don't bother, you're just using an
> anti-social mechanism to keep this header file in the tree.
> 
> Please, let's kill this header file if it is unused.
>

Beside including the header I plan to use every define in that header
defined someplace in the source code.  

Now can I keep the header?


^ permalink raw reply	[flat|nested] 10+ messages in thread

* Re: [PATCH] MPT FUSION: Delete unused header files.
  2007-03-12 21:29         ` Moore, Eric
@ 2007-03-12 21:31           ` David Miller
  0 siblings, 0 replies; 10+ messages in thread
From: David Miller @ 2007-03-12 21:31 UTC (permalink / raw)
  To: Eric.Moore; +Cc: Valdis.Kletnieks, rpjday, linux-kernel, akpm

From: "Moore, Eric" <Eric.Moore@lsi.com>
Date: Mon, 12 Mar 2007 15:29:45 -0600

> Beside including the header I plan to use every define in that header
> defined someplace in the source code.  
> 
> Now can I keep the header?

For sure :-)

^ permalink raw reply	[flat|nested] 10+ messages in thread

end of thread, other threads:[~2007-03-12 21:31 UTC | newest]

Thread overview: 10+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2007-03-10 21:57 [PATCH] MPT FUSION: Delete unused header files Robert P. J. Day
2007-03-11 19:55 ` Eric Moore
2007-03-11 20:51   ` David Miller
2007-03-11 21:11   ` Robert P. J. Day
2007-03-11 22:32   ` Valdis.Kletnieks
2007-03-12 16:19     ` Moore, Eric
2007-03-12 19:44       ` Roberto Nibali
2007-03-12 21:00       ` David Miller
2007-03-12 21:29         ` Moore, Eric
2007-03-12 21:31           ` David Miller

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).