src/usr/fcmgmt.c

/*
 * 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., 51 Franklin Street, Fifth Floor, Boston, MA
 * 02110-1301, USA.
 *
 * You can also choose to distribute this program under the terms of
 * the Unmodified Binary Distribution Licence (as given in the file
 * COPYING.UBDL), provided that you have satisfied its requirements.
 */

FILE_LICENCE ( GPL2_OR_LATER_OR_UBDL );

#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 id %s", port->name, fc_ntoa ( &port->port_wwn ),
		 fc_id_ntoa ( &port->port_id ) );
	printf ( " node %s\n  [Link:", fc_ntoa ( &port->node_wwn ) );
	if ( fc_link_ok ( &port->link ) ) {
		printf ( " up, %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 ( " node %s]\n", fc_ntoa ( &port->link_node_wwn ) );
	} 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->port_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 link:", ulp->type );
		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 ( "", 0 );
}