[SCSI] SCSI and FC Transport: add netlink support for posting of transport events
This patch formally adds support for the posting of FC events via netlink.
It is a followup to the original RFC at:
http://marc.theaimsgroup.com/?l=linux-scsi&m=114530667923464&w=2
and the initial posting at:
http://marc.theaimsgroup.com/?l=linux-scsi&m=115507374832500&w=2
The patch has been updated to optimize the send path, per the discussions
in the initial posting.
Per discussions at the Storage Summit and at OLS, we are to use netlink for
async events from transports. Also per discussions, to avoid a netlink
protocol per transport, I've create a single NETLINK_SCSITRANSPORT protocol,
which can then be used by all transports.
This patch:
- Creates new files scsi_netlink.c and scsi_netlink.h, which contains the
single and shared definitions for the SCSI Transport. It is tied into the
base SCSI subsystem intialization.
Contains a single interface routine, scsi_send_transport_event(), for a
transport to send an event (via multicast to a protocol specific group).
- Creates a new scsi_netlink_fc.h file, which contains the FC netlink event
messages
- Adds 3 new routines to the fc transport:
fc_get_event_number() - to get a FC event #
fc_host_post_event() - to send a simple FC event (32 bits of data)
fc_host_post_vendor_event() - to send a Vendor unique event, with
arbitrary amounts of data.
Note: the separation of event number allows for a LLD to send a standard
event, followed by vendor-specific data for the event.
Note: This patch assumes 2 prior fc transport patches have been installed:
http://marc.theaimsgroup.com/?l=linux-scsi&m=115555807316329&w=2
http://marc.theaimsgroup.com/?l=linux-scsi&m=115581614930261&w=2
Sorry - next time I'll do something like making these individual
patches of the same posting when I know they'll be posted closely
together.
Signed-off-by: James Smart <James.Smart@emulex.com>
Tidy up configuration not to make SCSI always select NET
Signed-off-by: James Bottomley <James.Bottomley@SteelEye.com>
2006-08-18 14:30:09 -07:00
|
|
|
/*
|
|
|
|
* FC Transport Netlink Interface
|
|
|
|
*
|
|
|
|
* Copyright (C) 2006 James Smart, Emulex Corporation
|
|
|
|
*
|
|
|
|
* 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
|
|
|
|
*
|
|
|
|
*/
|
|
|
|
#ifndef SCSI_NETLINK_FC_H
|
|
|
|
#define SCSI_NETLINK_FC_H
|
|
|
|
|
|
|
|
#include <scsi/scsi_netlink.h>
|
|
|
|
|
|
|
|
/*
|
|
|
|
* This file intended to be included by both kernel and user space
|
|
|
|
*/
|
|
|
|
|
|
|
|
/*
|
|
|
|
* FC Transport Message Types
|
|
|
|
*/
|
|
|
|
/* kernel -> user */
|
|
|
|
#define FC_NL_ASYNC_EVENT 0x0100
|
|
|
|
/* user -> kernel */
|
|
|
|
/* none */
|
|
|
|
|
|
|
|
|
|
|
|
/*
|
|
|
|
* Message Structures :
|
|
|
|
*/
|
|
|
|
|
|
|
|
/* macro to round up message lengths to 8byte boundary */
|
|
|
|
#define FC_NL_MSGALIGN(len) (((len) + 7) & ~7)
|
|
|
|
|
|
|
|
|
|
|
|
/*
|
|
|
|
* FC Transport Broadcast Event Message :
|
|
|
|
* FC_NL_ASYNC_EVENT
|
|
|
|
*
|
|
|
|
* Note: if Vendor Unique message, &event_data will be start of
|
|
|
|
* vendor unique payload, and the length of the payload is
|
|
|
|
* per event_datalen
|
|
|
|
*
|
|
|
|
* Note: When specifying vendor_id, be sure to read the Vendor Type and ID
|
|
|
|
* formatting requirements specified in scsi_netlink.h
|
|
|
|
*/
|
|
|
|
struct fc_nl_event {
|
|
|
|
struct scsi_nl_hdr snlh; /* must be 1st element ! */
|
|
|
|
uint64_t seconds;
|
2006-08-22 06:55:23 -07:00
|
|
|
uint64_t vendor_id;
|
[SCSI] SCSI and FC Transport: add netlink support for posting of transport events
This patch formally adds support for the posting of FC events via netlink.
It is a followup to the original RFC at:
http://marc.theaimsgroup.com/?l=linux-scsi&m=114530667923464&w=2
and the initial posting at:
http://marc.theaimsgroup.com/?l=linux-scsi&m=115507374832500&w=2
The patch has been updated to optimize the send path, per the discussions
in the initial posting.
Per discussions at the Storage Summit and at OLS, we are to use netlink for
async events from transports. Also per discussions, to avoid a netlink
protocol per transport, I've create a single NETLINK_SCSITRANSPORT protocol,
which can then be used by all transports.
This patch:
- Creates new files scsi_netlink.c and scsi_netlink.h, which contains the
single and shared definitions for the SCSI Transport. It is tied into the
base SCSI subsystem intialization.
Contains a single interface routine, scsi_send_transport_event(), for a
transport to send an event (via multicast to a protocol specific group).
- Creates a new scsi_netlink_fc.h file, which contains the FC netlink event
messages
- Adds 3 new routines to the fc transport:
fc_get_event_number() - to get a FC event #
fc_host_post_event() - to send a simple FC event (32 bits of data)
fc_host_post_vendor_event() - to send a Vendor unique event, with
arbitrary amounts of data.
Note: the separation of event number allows for a LLD to send a standard
event, followed by vendor-specific data for the event.
Note: This patch assumes 2 prior fc transport patches have been installed:
http://marc.theaimsgroup.com/?l=linux-scsi&m=115555807316329&w=2
http://marc.theaimsgroup.com/?l=linux-scsi&m=115581614930261&w=2
Sorry - next time I'll do something like making these individual
patches of the same posting when I know they'll be posted closely
together.
Signed-off-by: James Smart <James.Smart@emulex.com>
Tidy up configuration not to make SCSI always select NET
Signed-off-by: James Bottomley <James.Bottomley@SteelEye.com>
2006-08-18 14:30:09 -07:00
|
|
|
uint16_t host_no;
|
|
|
|
uint16_t event_datalen;
|
|
|
|
uint32_t event_num;
|
|
|
|
uint32_t event_code;
|
|
|
|
uint32_t event_data;
|
|
|
|
} __attribute__((aligned(sizeof(uint64_t))));
|
|
|
|
|
|
|
|
|
|
|
|
#endif /* SCSI_NETLINK_FC_H */
|
|
|
|
|