]> git.ipfire.org Git - thirdparty/ipxe.git/commitdiff
[fc] Add Fibre Channel management commands
authorMichael Brown <mcb30@ipxe.org>
Wed, 15 Sep 2010 02:06:50 +0000 (03:06 +0100)
committerMichael Brown <mcb30@ipxe.org>
Wed, 15 Sep 2010 02:17:30 +0000 (03:17 +0100)
Signed-off-by: Michael Brown <mcb30@ipxe.org>
src/config/config_fc.c [new file with mode: 0644]
src/config/general.h
src/hci/commands/fcmgmt_cmd.c [new file with mode: 0644]
src/include/usr/fcmgmt.h [new file with mode: 0644]
src/usr/fcmgmt.c [new file with mode: 0644]

diff --git a/src/config/config_fc.c b/src/config/config_fc.c
new file mode 100644 (file)
index 0000000..26d9bf4
--- /dev/null
@@ -0,0 +1,24 @@
+/*
+ * 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, or (at
+ * your option) any later version.
+ */
+
+FILE_LICENCE ( GPL2_OR_LATER );
+
+#include <config/general.h>
+
+/** @file
+ *
+ * Fibre Channel configuration options
+ *
+ */
+
+/*
+ * Drag in Fibre Channel-specific commands
+ *
+ */
+#ifdef FCMGMT_CMD
+REQUIRE_OBJECT ( fcmgmt_cmd );
+#endif
index 623138f55e056a957fdb70a7e53599d80e560736..ee7f9034da3cff0d884d03d38cdeaa1c89da976d 100644 (file)
@@ -112,6 +112,7 @@ FILE_LICENCE ( GPL2_OR_LATER );
 #define        CONFIG_CMD              /* Option configuration console */
 #define        IFMGMT_CMD              /* Interface management commands */
 #define        IWMGMT_CMD              /* Wireless interface management commands */
+#define FCMGMT_CMD             /* Fibre Channel management commands */
 #define        ROUTE_CMD               /* Routing table management commands */
 #define IMAGE_CMD              /* Image management commands */
 #define DHCP_CMD               /* DHCP management commands */
diff --git a/src/hci/commands/fcmgmt_cmd.c b/src/hci/commands/fcmgmt_cmd.c
new file mode 100644 (file)
index 0000000..3a4e284
--- /dev/null
@@ -0,0 +1,189 @@
+/*
+ * Copyright (C) 2010 Michael Brown <mbrown@fensystems.co.uk>.
+ *
+ * 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 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., 675 Mass Ave, Cambridge, MA 02139, USA.
+ */
+
+FILE_LICENCE ( GPL2_OR_LATER );
+
+#include <stdio.h>
+#include <getopt.h>
+#include <strings.h>
+#include <ipxe/fc.h>
+#include <ipxe/fcels.h>
+#include <ipxe/command.h>
+#include <ipxe/tables.h>
+#include <usr/fcmgmt.h>
+
+/** @file
+ *
+ * Fibre Channel management commands
+ *
+ */
+
+static void fcstat_syntax ( char **argv ) {
+       printf ( "Usage:\n  %s\n", argv[0] );
+}
+
+static int fcstat_exec ( int argc, char **argv ) {
+       static struct option fcstat_opts[] = {
+               { "help", 0, NULL, 'h' },
+               { NULL, 0, NULL, 0 },
+       };
+       struct fc_port *port;
+       struct fc_peer *peer;
+       int c;
+
+       /* Parse options */
+       while ( ( c = getopt_long ( argc, argv, "h", fcstat_opts,
+                                   NULL ) ) >= 0 ) {
+               switch ( c ) {
+               case 'h':
+                       /* Display help text */
+               default:
+                       /* Unrecognised/invalid option */
+                       fcstat_syntax ( argv );
+                       return 1;
+               }
+       }
+
+       if ( optind != argc ) {
+               fcstat_syntax ( argv );
+               return 1;
+       }
+
+       list_for_each_entry ( port, &fc_ports, list )
+               fcportstat ( port );
+       list_for_each_entry ( peer, &fc_peers, list )
+               fcpeerstat ( peer );
+
+       return 0;
+}
+
+static void fcels_syntax ( char **argv ) {
+       printf ( "Usage:\n  %s [--port <port>] [--id <peer port id>]"
+                " <command>\n", argv[0] );
+}
+
+static struct fc_els_handler * fcels_find_handler ( const char *name ) {
+       struct fc_els_handler *handler;
+
+       for_each_table_entry ( handler, FC_ELS_HANDLERS ) {
+               if ( strcasecmp ( handler->name, name ) == 0 )
+                       return handler;
+       }
+       return NULL;
+}
+
+static int fcels_exec ( int argc, char **argv ) {
+       static struct option fcels_opts[] = {
+               { "help", 0, NULL, 'h' },
+               { "port", required_argument, NULL, 'p' },
+               { "id", required_argument, NULL, 'i' },
+               { NULL, 0, NULL, 0 },
+       };
+       const char *handler_text;
+       const char *port_text = NULL;
+       const char *id_text = NULL;
+       struct fc_els_handler *handler;
+       struct fc_port *port;
+       struct fc_port_id id_buf;
+       struct fc_port_id *id;
+       int c;
+
+       /* Parse options */
+       while ( ( c = getopt_long ( argc, argv, "hp:i:", fcels_opts,
+                                   NULL ) ) >= 0 ) {
+               switch ( c ) {
+               case 'p':
+                       port_text = optarg;
+                       break;
+               case 'i':
+                       id_text = optarg;
+                       break;
+               case 'h':
+                       /* Display help text */
+               default:
+                       /* Unrecognised/invalid option */
+                       fcels_syntax ( argv );
+                       return 1;
+               }
+       }
+
+       /* Identify ELS */
+       if ( optind != ( argc - 1 ) ) {
+               fcels_syntax ( argv );
+               return 1;
+       }
+       handler_text = argv[optind];
+       handler = fcels_find_handler ( handler_text );
+       if ( ! handler ) {
+               printf ( "%s: unrecognised ELS\n", handler_text );
+               return 1;
+       }
+
+       /* Identify port */
+       if ( port_text ) {
+               /* Use specified port */
+               port = fc_port_find ( port_text );
+               if ( ! port ) {
+                       printf ( "%s: no such port\n", port_text );
+                       return 1;
+               }
+       } else {
+               /* Use first port */
+               if ( list_empty ( &fc_ports ) ) {
+                       printf ( "No ports\n" );
+                       return 1;
+               }
+               list_for_each_entry ( port, &fc_ports, list )
+                       break;
+       }
+       assert ( port != NULL );
+
+       /* Identify port ID */
+       if ( id_text ) {
+               if ( fc_id_aton ( id_text, &id_buf ) != 0 ) {
+                       printf ( "%s: invalid port ID\n", id_text );
+                       return 1;
+               }
+               id = &id_buf;
+       } else {
+               if ( fc_link_ok ( &port->link ) &&
+                    ! ( port->flags & FC_PORT_HAS_FABRIC ) ) {
+                       id = &port->ptp_link_port_id;
+               } else {
+                       id = &fc_f_port_id;
+               }
+       }
+       assert ( id != NULL );
+
+       if ( fcels ( port, id, handler ) != 0 )
+               return 1;
+
+       return 0;
+}
+
+/** Fibre Channel management commands */
+struct command fcmgmt_commands[] __command = {
+       {
+               .name = "fcstat",
+               .exec = fcstat_exec,
+       },
+       {
+               .name = "fcels",
+               .exec = fcels_exec,
+       },
+};
diff --git a/src/include/usr/fcmgmt.h b/src/include/usr/fcmgmt.h
new file mode 100644 (file)
index 0000000..9441cef
--- /dev/null
@@ -0,0 +1,21 @@
+#ifndef _USR_FCMGMT_H
+#define _USR_FCMGMT_H
+
+/** @file
+ *
+ * Fibre Channel management
+ *
+ */
+
+FILE_LICENCE ( GPL2_OR_LATER );
+
+struct fc_port;
+struct fc_peer;
+struct fc_els_handler;
+
+extern void fcportstat ( struct fc_port *port );
+extern void fcpeerstat ( struct fc_peer *peer );
+extern int fcels ( struct fc_port *port, struct fc_port_id *peer_port_id,
+                  struct fc_els_handler *handler );
+
+#endif /* _USR_FCMGMT_H */
diff --git a/src/usr/fcmgmt.c b/src/usr/fcmgmt.c
new file mode 100644 (file)
index 0000000..5a4d811
--- /dev/null
@@ -0,0 +1,117 @@
+/*
+ * Copyright (C) 2010 Michael Brown <mbrown@fensystems.co.uk>.
+ *
+ * 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 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., 675 Mass Ave, Cambridge, MA 02139, USA.
+ */
+
+FILE_LICENCE ( GPL2_OR_LATER );
+
+#include <string.h>
+#include <stdio.h>
+#include <errno.h>
+#include <ipxe/fc.h>
+#include <ipxe/fcels.h>
+#include <ipxe/monojob.h>
+#include <usr/fcmgmt.h>
+
+/** @file
+ *
+ * Fibre Channel management
+ *
+ */
+
+/**
+ * Print status of Fibre Channel port
+ *
+ * @v port             Fibre Channel port
+ */
+void fcportstat ( struct fc_port *port ) {
+       printf ( "%s: %s", port->name, fc_ntoa ( &port->node_wwn ) );
+       printf ( " port %s id %s\n  [Link:", fc_ntoa ( &port->port_wwn ),
+                fc_id_ntoa ( &port->port_id ) );
+       if ( fc_link_ok ( &port->link ) ) {
+               printf ( " up, %s", fc_ntoa ( &port->link_node_wwn ) );
+               printf ( " port %s", fc_ntoa ( &port->link_port_wwn ) );
+               if ( ( port->flags & FC_PORT_HAS_FABRIC ) ) {
+                       printf ( " fabric" );
+               } else {
+                       printf ( " id %s",
+                                fc_id_ntoa ( &port->ptp_link_port_id ) );
+               }
+               printf ( "]\n" );
+       } else {
+               printf ( " down: %s]\n", strerror ( port->link.rc ) );
+       }
+}
+
+/**
+ * Print status of Fibre Channel peer
+ *
+ * @v peer             Fibre Channel peer
+ */
+void fcpeerstat ( struct fc_peer *peer ) {
+       struct fc_ulp *ulp;
+       uint8_t *param;
+       unsigned int i;
+
+       printf ( "%s:\n  [Link:", fc_ntoa ( &peer->node_wwn ) );
+       if ( fc_link_ok ( &peer->link ) ) {
+               printf ( " up, port %s id %s]\n", peer->port->name,
+                        fc_id_ntoa ( &peer->port_id ) );
+       } else {
+               printf ( " down: %s]\n", strerror ( peer->link.rc ) );
+       }
+
+       list_for_each_entry ( ulp, &peer->ulps, list ) {
+               printf ( "  [Type %02x usage %d link:",
+                        ulp->type, ulp->usage );
+               if ( fc_link_ok ( &ulp->link ) ) {
+                       printf ( " up, params" );
+                       param = ulp->param;
+                       for ( i = 0 ; i < ulp->param_len ; i++ ) {
+                               printf ( "%c%02x", ( ( i == 0 ) ? ' ' : ':' ),
+                                        param[i] );
+                       }
+               } else {
+                       printf ( " down: %s", strerror ( ulp->link.rc ) );
+               }
+               printf ( "]\n" );
+       }
+}
+
+/**
+ * Issue Fibre Channel ELS
+ *
+ * @v port             Fibre Channel port
+ * @v peer_port_id     Peer port ID
+ * @v handler          ELS handler
+ * @ret rc             Return status code
+ */
+int fcels ( struct fc_port *port, struct fc_port_id *peer_port_id,
+           struct fc_els_handler *handler ) {
+       int rc;
+
+       /* Initiate ELS */
+       printf ( "%s %s to %s...",
+                port->name, handler->name, fc_id_ntoa ( peer_port_id ) );
+       if ( ( rc = fc_els_request ( &monojob, port, peer_port_id,
+                                    handler ) ) != 0 ) {
+               printf ( "%s\n", strerror ( rc ) );
+               return rc;
+       }
+
+       /* Wait for ELS to complete */
+       return monojob_wait ( "" );
+}