libvirt/src/conf/storage_adapter_conf.c

351 lines
11 KiB
C
Raw Normal View History

/*
* storage_adapter_conf.c: helpers to handle storage pool adapter manipulation
* (derived from storage_conf.c)
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License, or (at your option) any later version.
*
* This library 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
* Lesser General Public License for more details.
*
* You should have received a copy of the GNU Lesser General Public
* License along with this library. If not, see
* <http://www.gnu.org/licenses/>.
*/
#include <config.h>
#include "storage_conf.h"
#include "viralloc.h"
#include "virerror.h"
#include "virlog.h"
#include "virstring.h"
#include "virutil.h"
#include "virxml.h"
#define VIR_FROM_THIS VIR_FROM_STORAGE
VIR_LOG_INIT("conf.storage_adapter_conf");
VIR_ENUM_IMPL(virStorageAdapter,
VIR_STORAGE_ADAPTER_TYPE_LAST,
"default", "scsi_host", "fc_host")
static void
virStorageAdapterClearFCHost(virStorageAdapterFCHostPtr fchost)
{
VIR_FREE(fchost->wwnn);
VIR_FREE(fchost->wwpn);
VIR_FREE(fchost->parent);
VIR_FREE(fchost->parent_wwnn);
VIR_FREE(fchost->parent_wwpn);
VIR_FREE(fchost->parent_fabric_wwn);
}
void
virStorageAdapterClear(virStorageAdapterPtr adapter)
{
if (adapter->type == VIR_STORAGE_ADAPTER_TYPE_FC_HOST)
virStorageAdapterClearFCHost(&adapter->data.fchost);
if (adapter->type == VIR_STORAGE_ADAPTER_TYPE_SCSI_HOST)
VIR_FREE(adapter->data.scsi_host.name);
}
static int
virStorageAdapterParseXMLFCHost(xmlNodePtr node,
virStorageAdapterFCHostPtr fchost)
{
char *managed = NULL;
fchost->parent = virXMLPropString(node, "parent");
if ((managed = virXMLPropString(node, "managed"))) {
if ((fchost->managed = virTristateBoolTypeFromString(managed)) < 0) {
virReportError(VIR_ERR_CONFIG_UNSUPPORTED,
_("unknown fc_host managed setting '%s'"),
managed);
VIR_FREE(managed);
return -1;
}
}
fchost->parent_wwnn = virXMLPropString(node, "parent_wwnn");
fchost->parent_wwpn = virXMLPropString(node, "parent_wwpn");
fchost->parent_fabric_wwn = virXMLPropString(node, "parent_fabric_wwn");
fchost->wwpn = virXMLPropString(node, "wwpn");
fchost->wwnn = virXMLPropString(node, "wwnn");
VIR_FREE(managed);
return 0;
}
static int
virStorageAdapterParseXMLSCSIHost(xmlNodePtr node,
xmlXPathContextPtr ctxt,
virStorageAdapterSCSIHostPtr scsi_host)
{
scsi_host->name = virXMLPropString(node, "name");
if (virXPathNode("./parentaddr", ctxt)) {
xmlNodePtr addrnode = virXPathNode("./parentaddr/address", ctxt);
if (!addrnode) {
virReportError(VIR_ERR_XML_ERROR, "%s",
_("Missing scsi_host PCI address element"));
return -1;
}
scsi_host->has_parent = true;
if (virPCIDeviceAddressParseXML(addrnode, &scsi_host->parentaddr) < 0)
return -1;
if ((virXPathInt("string(./parentaddr/@unique_id)",
ctxt,
&scsi_host->unique_id) < 0) ||
(scsi_host->unique_id < 0)) {
virReportError(VIR_ERR_XML_ERROR, "%s",
_("Missing or invalid scsi adapter "
"'unique_id' value"));
return -1;
}
}
return 0;
}
/* Prior to adding 'type' attribute support all that was supported was a
* 'name' attribute which designated which 'scsi_hostN' name was to be used.
* This was proven to not be stable enough especially between reboots, so
* future patches added other attributes (type, wwnn, wwpn, parent, etc.)
* that would provide the capability to designate a more specific scsi_hostN
* by more than just name. The 'type' attribute was the key to determine
* whether a SCSI or FC host was to be used.
*
* This code will parse this "older" (or legacy) XML that only had the name
* attribute. If other newer attributes are found, then a failure will
* be generated so as to force usage of the 'type' attribute.
*/
static int
virStorageAdapterParseXMLLegacy(xmlNodePtr node,
xmlXPathContextPtr ctxt,
virStorageAdapterPtr adapter)
{
char *wwnn = virXMLPropString(node, "wwnn");
char *wwpn = virXMLPropString(node, "wwpn");
char *parent = virXMLPropString(node, "parent");
/* "type" was not specified in the XML, so we must verify that
* "wwnn", "wwpn", "parent", or "parentaddr" are also not in the
* XML. If any are found, then we cannot just use "name" alone".
*/
if (wwnn || wwpn || parent) {
VIR_FREE(wwnn);
VIR_FREE(wwpn);
VIR_FREE(parent);
virReportError(VIR_ERR_XML_ERROR, "%s",
_("Use of 'wwnn', 'wwpn', and 'parent' attributes "
"requires use of the adapter 'type'"));
return -1;
}
if (virXPathNode("./parentaddr", ctxt)) {
virReportError(VIR_ERR_XML_ERROR, "%s",
_("Use of 'parentaddr' element requires use "
"of the adapter 'type'"));
return -1;
}
/* To keep back-compat, 'type' is not required to specify
* for scsi_host adapter.
*/
if ((adapter->data.scsi_host.name = virXMLPropString(node, "name")))
adapter->type = VIR_STORAGE_ADAPTER_TYPE_SCSI_HOST;
return 0;
}
int
virStorageAdapterParseXML(virStorageAdapterPtr adapter,
xmlNodePtr node,
xmlXPathContextPtr ctxt)
{
int ret = -1;
xmlNodePtr relnode = ctxt->node;
char *adapter_type = NULL;
ctxt->node = node;
if ((adapter_type = virXMLPropString(node, "type"))) {
if ((adapter->type =
virStorageAdapterTypeFromString(adapter_type)) <= 0) {
virReportError(VIR_ERR_CONFIG_UNSUPPORTED,
_("Unknown pool adapter type '%s'"),
adapter_type);
goto cleanup;
}
if ((adapter->type == VIR_STORAGE_ADAPTER_TYPE_FC_HOST) &&
(virStorageAdapterParseXMLFCHost(node, &adapter->data.fchost)) < 0)
goto cleanup;
if ((adapter->type == VIR_STORAGE_ADAPTER_TYPE_SCSI_HOST) &&
(virStorageAdapterParseXMLSCSIHost(node, ctxt,
&adapter->data.scsi_host)) < 0)
goto cleanup;
} else {
if (virStorageAdapterParseXMLLegacy(node, ctxt, adapter) < 0)
goto cleanup;
}
ret = 0;
cleanup:
ctxt->node = relnode;
VIR_FREE(adapter_type);
return ret;
}
static int
virStorageAdapterValidateFCHost(virStorageAdapterFCHostPtr fchost)
{
if (!fchost->wwnn || !fchost->wwpn) {
virReportError(VIR_ERR_XML_ERROR, "%s",
_("'wwnn' and 'wwpn' must be specified for adapter "
"type 'fchost'"));
return -1;
}
if (!virValidateWWN(fchost->wwnn) || !virValidateWWN(fchost->wwpn))
return -1;
if ((fchost->parent_wwnn && !fchost->parent_wwpn)) {
virReportError(VIR_ERR_XML_ERROR,
_("when providing parent_wwnn='%s', the "
"parent_wwpn must also be provided"),
fchost->parent_wwnn);
return -1;
}
if (!fchost->parent_wwnn && fchost->parent_wwpn) {
virReportError(VIR_ERR_XML_ERROR,
_("when providing parent_wwpn='%s', the "
"parent_wwnn must also be provided"),
fchost->parent_wwpn);
return -1;
}
if (fchost->parent_wwnn && !virValidateWWN(fchost->parent_wwnn))
return -1;
if (fchost->parent_wwpn && !virValidateWWN(fchost->parent_wwpn))
return -1;
if (fchost->parent_fabric_wwn && !virValidateWWN(fchost->parent_fabric_wwn))
return -1;
return 0;
}
static int
virStorageAdapterValidateSCSIHost(virStorageAdapterSCSIHostPtr scsi_host)
{
if (!scsi_host->name && !scsi_host->has_parent) {
virReportError(VIR_ERR_XML_ERROR, "%s",
_("Either 'name' or 'parent' must be specified "
"for the 'scsi_host' adapter"));
return -1;
}
if (scsi_host->name && scsi_host->has_parent) {
virReportError(VIR_ERR_XML_ERROR, "%s",
_("Both 'name' and 'parent' cannot be specified "
"for the 'scsi_host' adapter"));
return -1;
}
return 0;
}
int
virStorageAdapterValidate(virStorageAdapterPtr adapter)
{
if (!adapter->type) {
virReportError(VIR_ERR_XML_ERROR, "%s",
_("missing storage pool source adapter"));
return -1;
}
if (adapter->type == VIR_STORAGE_ADAPTER_TYPE_FC_HOST)
return virStorageAdapterValidateFCHost(&adapter->data.fchost);
if (adapter->type == VIR_STORAGE_ADAPTER_TYPE_SCSI_HOST)
return virStorageAdapterValidateSCSIHost(&adapter->data.scsi_host);
return 0;
}
static void
virStorageAdapterFormatFCHost(virBufferPtr buf,
virStorageAdapterFCHostPtr fchost)
{
virBufferEscapeString(buf, " parent='%s'", fchost->parent);
virBufferEscapeString(buf, " parent_wwnn='%s'", fchost->parent_wwnn);
virBufferEscapeString(buf, " parent_wwpn='%s'", fchost->parent_wwpn);
virBufferEscapeString(buf, " parent_fabric_wwn='%s'",
fchost->parent_fabric_wwn);
if (fchost->managed != VIR_TRISTATE_BOOL_ABSENT)
virBufferAsprintf(buf, " managed='%s'",
virTristateBoolTypeToString(fchost->managed));
virBufferAsprintf(buf, " wwnn='%s' wwpn='%s'/>\n",
fchost->wwnn, fchost->wwpn);
}
static void
virStorageAdapterFormatSCSIHost(virBufferPtr buf,
virStorageAdapterSCSIHostPtr scsi_host)
{
if (scsi_host->name) {
virBufferAsprintf(buf, " name='%s'/>\n", scsi_host->name);
} else {
virBufferAddLit(buf, ">\n");
virBufferAdjustIndent(buf, 2);
virBufferAsprintf(buf, "<parentaddr unique_id='%d'>\n",
scsi_host->unique_id);
virBufferAdjustIndent(buf, 2);
ignore_value(virPCIDeviceAddressFormat(buf, scsi_host->parentaddr,
false));
virBufferAdjustIndent(buf, -2);
virBufferAddLit(buf, "</parentaddr>\n");
virBufferAdjustIndent(buf, -2);
virBufferAddLit(buf, "</adapter>\n");
}
}
void
virStorageAdapterFormat(virBufferPtr buf,
virStorageAdapterPtr adapter)
{
virBufferAsprintf(buf, "<adapter type='%s'",
virStorageAdapterTypeToString(adapter->type));
if (adapter->type == VIR_STORAGE_ADAPTER_TYPE_FC_HOST)
virStorageAdapterFormatFCHost(buf, &adapter->data.fchost);
if (adapter->type == VIR_STORAGE_ADAPTER_TYPE_SCSI_HOST)
virStorageAdapterFormatSCSIHost(buf, &adapter->data.scsi_host);
}