No OneTemporary
Actions

Size

24 KB

Referenced Files

None

Subscribers

None

View Options

	diff --git a/client/options.c b/client/options.c
	index 39e6912b..7f9bc19e 100644
	--- a/client/options.c
	+++ b/client/options.c
	@@ -1,848 +1,848 @@
	/*
	Copyright Red Hat, Inc. 2006

	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.

	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; see the file COPYING. If not, write to the
	Free Software Foundation, Inc., 675 Mass Ave, Cambridge,
	MA 02139, USA.
	*/
	#include <stdio.h>
	#include <stdlib.h>
	#include <string.h>
	#include <unistd.h>
	#include <signal.h>
	#include <sys/types.h>
	#include <sys/stat.h>
	#include <sys/wait.h>
	#include <sys/un.h>
	#include <sys/socket.h>
	#include <sys/select.h>
	#include <sys/ioctl.h>
	#include <arpa/inet.h>
	#include <net/if.h>
	#include <netinet/in.h>
	#include <netdb.h>
	#include <sys/time.h>
	#include <fcntl.h>
	#include <errno.h>

	/* Local includes */
	#include "xvm.h"
	#include "simple_auth.h"
	#include "mcast.h"
	#include "options.h"



	/* Assignment functions */

	static inline void
	assign_debug(fence_virt_args_t args, struct arg_info arg, char *value)
	{
	if (!value) {
	/* GNU getopt sets optarg to NULL for options w/o a param
	We rely on this here... */
	args->debug++;
	return;
	}

	args->debug = atoi(value);
	if (args->debug < 0) {
	args->debug = 1;
	}
	}


	static inline void
	assign_foreground(fence_virt_args_t args, struct arg_info arg,
	char *value)
	{
	args->flags \|= F_FOREGROUND;
	}


	static inline void
	assign_family(fence_virt_args_t args, struct arg_info arg,
	char *value)
	{
	if (!strcasecmp(value, "ipv4")) {
	args->net.family = PF_INET;
	} else if (!strcasecmp(value, "ipv6")) {
	args->net.family = PF_INET6;
	} else if (!strcasecmp(value, "auto")) {
	args->net.family = 0;
	} else {
	printf("Unsupported family: '%s'\n", value);
	args->flags \|= F_ERR;
	}
	}


	static inline void
	assign_address(fence_virt_args_t args, struct arg_info arg, char *value)
	{
	if (args->net.addr)
	free(args->net.addr);
	args->net.addr = strdup(value);
	}


	static inline void
	assign_channel_address(fence_virt_args_t args, struct arg_info arg, char *value)
	{
	if (args->serial.address)
	free(args->serial.address);
	args->serial.address = strdup(value);
	}


	static inline void
	assign_port(fence_virt_args_t args, struct arg_info arg, char *value)
	{
	args->net.port = atoi(value);
	if (args->net.port <= 0 \|\| args->net.port >= 65500) {
	printf("Invalid port: '%s'\n", value);
	args->flags \|= F_ERR;
	}
	}


	static inline void
	assign_interface(fence_virt_args_t args, struct arg_info arg, char *value)
	{
	args->net.ifindex = if_nametoindex(value);
	}


	static inline void
	assign_retrans(fence_virt_args_t args, struct arg_info arg, char *value)
	{
	args->retr_time = atoi(value);
	if (args->retr_time <= 0) {
	printf("Invalid retransmit time: '%s'\n", value);
	args->flags \|= F_ERR;
	}
	}

	static inline void
	assign_hash(fence_virt_args_t args, struct arg_info arg, char *value)
	{
	if (!strcasecmp(value, "none")) {
	args->net.hash = HASH_NONE;
	} else if (!strcasecmp(value, "sha1")) {
	args->net.hash = HASH_SHA1;
	} else if (!strcasecmp(value, "sha256")) {
	args->net.hash = HASH_SHA256;
	} else if (!strcasecmp(value, "sha512")) {
	args->net.hash = HASH_SHA512;
	} else {
	printf("Unsupported hash: %s\n", value);
	args->flags \|= F_ERR;
	}
	}


	static inline void
	assign_auth(fence_virt_args_t args, struct arg_info arg, char *value)
	{
	if (!strcasecmp(value, "none")) {
	args->net.auth = AUTH_NONE;
	} else if (!strcasecmp(value, "sha1")) {
	args->net.auth = AUTH_SHA1;
	} else if (!strcasecmp(value, "sha256")) {
	args->net.auth = AUTH_SHA256;
	} else if (!strcasecmp(value, "sha512")) {
	args->net.auth = AUTH_SHA512;
	} else {
	printf("Unsupported auth type: %s\n", value);
	args->flags \|= F_ERR;
	}
	}

	static inline void
	assign_key(fence_virt_args_t args, struct arg_info arg, char *value)
	{
	struct stat st;

	if (args->net.key_file)
	free(args->net.key_file);
	args->net.key_file = strdup(value);

	if (stat(value, &st) == -1) {
	printf("Invalid key file: '%s' (%s)\n", value,
	strerror(errno));
	args->flags \|= F_ERR;
	}
	}


	static inline void
	assign_op(fence_virt_args_t args, struct arg_info arg, char *value)
	{
	if (!strcasecmp(value, "null")) {
	args->op = FENCE_NULL;
	} else if (!strcasecmp(value, "on")) {
	args->op = FENCE_ON;
	} else if (!strcasecmp(value, "off")) {
	args->op = FENCE_OFF;
	} else if (!strcasecmp(value, "reboot")) {
	args->op = FENCE_REBOOT;
	} else if (!strcasecmp(value, "status")) {
	args->op = FENCE_STATUS;
	} else if (!strcasecmp(value, "devstatus")) {
	args->op = FENCE_DEVSTATUS;
	} else if (!strcasecmp(value, "hostlist")) {
	args->op = FENCE_HOSTLIST;
	} else if (!strcasecmp(value, "metadata")) {
	args->op = FENCE_METADATA;
	} else {
	printf("Unsupported operation: %s\n", value);
	args->flags \|= F_ERR;
	}
	}


	static inline void
	assign_device(fence_virt_args_t args, struct arg_info arg, char *value)
	{
	args->serial.device = strdup(value);
	}


	static inline void
	assign_params(fence_virt_args_t args, struct arg_info arg, char *value)
	{
	args->serial.speed = strdup(value);
	}


	static inline void
	assign_domain(fence_virt_args_t args, struct arg_info arg, char *value)
	{
	if (args->domain) {
	printf("Domain/UUID may not be specified more than once\n");
	args->flags \|= F_ERR;
	return;
	}

	args->domain = strdup(value);

	if (strlen(value) <= 0) {
	printf("Invalid domain name\n");
	args->flags \|= F_ERR;
	}

	if (strlen(value) >= MAX_DOMAINNAME_LENGTH) {
	errno = ENAMETOOLONG;
	printf("Invalid domain name: '%s' (%s)\n",
	value, strerror(errno));
	args->flags \|= F_ERR;
	}
	}


	static inline void
	assign_uuid_lookup(fence_virt_args_t args, struct arg_info arg, char *value)
	{
	if (!value) {
	/* GNU getopt sets optarg to NULL for options w/o a param
	We rely on this here... */
	args->flags \|= F_USE_UUID;
	return;
	}

	args->flags \|= ( !!atoi(value) ? F_USE_UUID : 0);
	}


	static inline void
	assign_timeout(fence_virt_args_t args, struct arg_info arg, char *value)
	{
	args->timeout = atoi(value);
	if (args->timeout <= 0) {
	printf("Invalid timeout: '%s'\n", value);
	args->flags \|= F_ERR;
	}
	}


	static inline void
	assign_help(fence_virt_args_t args, struct arg_info arg, char *value)
	{
	args->flags \|= F_HELP;
	}


	static inline void
	assign_version(fence_virt_args_t args, struct arg_info arg, char *value)
	{
	args->flags \|= F_VERSION;
	}


	static inline void
	assign_uri(fence_virt_args_t args, struct arg_info arg, char *value)
	{
	#if 0
	if (args->uri)
	free(args->uri);

	/* XXX NO validation yet */
	args->uri = strdup(value);
	#endif
	}


	static void
	print_desc_xml(const char *desc)
	{
	const char *d;

	for (d = desc; *d; d++) {
	switch (*d) {
	case '<':
	printf("<");
	break;
	case '>':
	printf(">");
	break;
	default:
	printf("%c", *d);
	}
	}
	}


	/** ALL valid command line and stdin arguments for this fencing agent */
	static struct arg_info _arg_info[] = {
	{ '\xff', NULL, "agent",
	0, "string", NULL,
	"Not user serviceable",
	NULL },

	{ '\xff', NULL, "self",
	0, "string", NULL,
	"Not user serviceable",
	NULL },

	{ '\xff', NULL, "nodename",
	0, "string", NULL,
	"Not user serviceable",
	NULL },

	{ 'd', "-d", "debug",
	0, "boolean", NULL,
	"Specify (stdin) or increment (command line) debug level",
	assign_debug },

	{ 'i', "-i <family>", "ip_family",
	0, "string", "auto",
	"IP Family ([auto], ipv4, ipv6)",
	assign_family },

	{ 'a', "-a <address>", "multicast_address",
	0, "string", NULL,
	"Multicast address (default=" IPV4_MCAST_DEFAULT " / " IPV6_MCAST_DEFAULT ")",
	assign_address },

	{ 'A', "-A <address>", "channel_address",
	0, "string", "10.0.2.179",
	"VM Channel IP address (default=" DEFAULT_CHANNEL_IP ")",
	assign_channel_address },

	{ 'p', "-p <port>", "port",
	0, "string", "1229",
	"Multicast or VMChannel IP port (default=1229)",
	assign_port },

	{ 'I', "-I <interface>", "interface",
	0, "string", NULL,
	"Network interface name to listen on",
	assign_interface },

	{ 'r', "-r <retrans>", "retrans",
	0, "string", "20",
	"Multicast retransmit time (in 1/10sec; default=20)",
	assign_retrans },

	{ 'c', "-c <hash>", "hash",
	0, "string", "sha256",
	"Packet hash strength (none, sha1, [sha256], sha512)",
	assign_hash },

	{ 'C', "-C <auth>", "auth",
	0, "string", "sha256",
	"Authentication (none, sha1, [sha256], sha512)",
	assign_auth },

	{ 'k', "-k <file>", "key_file",
	0, "string", DEFAULT_KEY_FILE,
	"Shared key file (default=" DEFAULT_KEY_FILE ")",
	assign_key },

	{ 'D', "-D <device>", "serial_device",
	0, "string", NULL,
	"Serial device (default=" DEFAULT_SERIAL_DEVICE ")",
	assign_device },

	{ 'P', "-P <param>", "serial_params",
	0, "string", DEFAULT_SERIAL_SPEED,
	"Serial Parameters (default=" DEFAULT_SERIAL_SPEED ")",
	assign_params },

	{ '\xff', NULL, "option",
	/* Deprecated */
	0, "string", "reboot",
	- "Fencing option (null, off, on, [reboot], status, hostlist, devstatus)",
	+ "Fencing option (null, off, on, [reboot], status, hostlist, devstatus, metadata)",
	assign_op },

	{ 'o', "-o <operation>", "action",
	0, "string", "reboot",
	- "Fencing action (null, off, on, [reboot], status, hostlist, devstatus)",
	+ "Fencing action (null, off, on, [reboot], status, hostlist, devstatus, metadata)",
	assign_op },

	{ 'H', "-H <domain>", "domain",
	0, "string", NULL,
	"Virtual Machine (domain name) to fence",
	assign_domain },

	{ 'u', "-u", "use_uuid",
	0, "string", "0",
	"Treat <domain> as UUID instead of domain name. This is provided for compatibility with older fence_xvmd installations.",
	assign_uuid_lookup },

	{ 't', "-t <timeout>", "timeout",
	0, "string", "30",
	"Fencing timeout (in seconds; default=30)",
	assign_timeout },

	{ 'h', "-h", NULL,
	0, "boolean", "0",
	"Help",
	assign_help },

	{ '?', "-?", NULL,
	0, "boolean", "0",
	"Help (alternate)",
	assign_help },

	{ 'U', "-U", "uri",
	0, "boolean", "qemu:///system",
	"URI for Hypervisor (default: auto detect)",
	assign_uri },

	{ 'V', "-V", NULL,
	0, "boolean", "0",
	"Display version and exit",
	assign_version },

	/* Terminator */
	{ 0, NULL, NULL, 0, NULL, NULL, NULL, NULL }
	};


	struct arg_info *
	find_arg_by_char(char arg)
	{
	int x = 0;

	for (x = 0; _arg_info[x].opt != 0; x++) {
	if (_arg_info[x].opt == arg)
	return &_arg_info[x];
	}

	return NULL;
	}


	struct arg_info *
	find_arg_by_string(char *arg)
	{
	int x = 0;

	for (x = 0; _arg_info[x].opt != 0; x++) {
	if (!_arg_info[x].stdin_opt)
	continue;
	if (!strcasecmp(_arg_info[x].stdin_opt, arg))
	return &_arg_info[x];
	}

	return NULL;
	}


	/* ============================================================= */

	/**
	Initialize an args structure.

	@param args Pointer to args structure to initialize.
	*/
	void
	args_init(fence_virt_args_t *args)
	{
	args->domain = NULL;
	//args->uri = NULL;
	args->op = FENCE_REBOOT;
	args->net.key_file = strdup(DEFAULT_KEY_FILE);
	args->net.hash = DEFAULT_HASH;
	args->net.auth = DEFAULT_AUTH;
	args->net.addr = NULL;
	args->net.port = DEFAULT_MCAST_PORT;
	args->net.ifindex = 0;
	args->net.family = PF_INET;
	args->serial.device = NULL;
	args->serial.speed = strdup(DEFAULT_SERIAL_SPEED);
	args->serial.address = strdup(DEFAULT_CHANNEL_IP);
	args->timeout = 30;
	args->retr_time = 20;
	args->flags = 0;
	args->debug = 0;
	}


	#define _pr_int(piece) printf(" %s = %d\n", #piece, piece)
	#define _pr_str(piece) printf(" %s = %s\n", #piece, piece)


	/**
	Prints out the contents of an args structure for debugging.

	@param args Pointer to args structure to print out.
	*/
	void
	args_print(fence_virt_args_t *args)
	{
	printf("-- args @ %p --\n", args);
	_pr_str(args->domain);
	_pr_int(args->op);

	_pr_str(args->net.key_file);
	_pr_int(args->net.hash);
	_pr_str(args->net.addr);
	_pr_int(args->net.auth);
	_pr_int(args->net.port);
	_pr_int(args->net.ifindex);
	_pr_int(args->net.family);
	_pr_int(args->timeout);
	_pr_int(args->retr_time);
	_pr_int(args->flags);
	_pr_int(args->debug);
	printf("-- end args --\n");
	}


	/**
	Print out arguments and help information based on what is allowed in
	the getopt string optstr.

	@param progname Program name.
	@param optstr Getopt(3) style options string
	@param print_stdin 0 = print command line options + description,
	1 = print fence-style stdin args + description
	*/
	static char *
	find_rev(const char start, char curr, char c)
	{

	while (curr > start) {
	if (*curr == c)
	return curr;
	--curr;
	}

	return NULL;
	}


	static void
	output_help_text(int arg_width, int help_width, const char arg, const char desc)
	{
	char out_buf[4096];
	char p, start;
	const char *arg_print = arg;
	int len;

	memset(out_buf, 0, sizeof(out_buf));
	strncpy(out_buf, desc, sizeof(out_buf));
	start = out_buf;

	do {
	p = NULL;
	len = strlen(start);
	if (len > help_width) {
	p = start + help_width;
	p = find_rev(start, p, ' ');
	if (p) {
	*p = 0;
	p++;
	}
	}
	printf(" %.s %.s\n",
	-arg_width, arg_width,
	arg_print,
	-help_width, help_width,
	start);
	if (!p)
	return;
	if (arg == arg_print)
	arg_print = " ";
	start = p;
	} while(1);
	}


	void
	args_usage(char progname, const char optstr, int print_stdin)
	{
	int x;
	struct arg_info *arg;

	if (!print_stdin) {
	if (progname) {
	printf("usage: %s [args]\n", progname);
	} else {
	printf("usage: fence_virt [args]\n");
	}
	}

	for (x = 0; x < strlen(optstr); x++) {
	arg = find_arg_by_char(optstr[x]);
	if (!arg)
	continue;

	if (print_stdin) {
	if (arg && arg->stdin_opt)
	output_help_text(20, 55, arg->stdin_opt, arg->desc);
	} else {
	output_help_text(20, 55, arg->opt_desc, arg->desc);
	}
	}

	printf("\n");
	}


	void
	args_metadata(char progname, const char optstr)
	{
	int x;
	struct arg_info *arg;

	printf("<?xml version=\"1.0\" ?>\n");
	printf("<resource-agent name=\"%s\" shortdesc=\"Fence agent for virtual machines\">\n", basename(progname));
	printf("<longdesc>%s is an I/O Fencing agent which can be used with"
	"virtual machines.</longdesc>\n", basename(progname));
	printf("<parameters>\n");

	for (x = 0; x < strlen(optstr); x++) {
	arg = find_arg_by_char(optstr[x]);
	if (!arg)
	continue;
	if (!arg->stdin_opt)
	continue;

	printf("\t<parameter name=\"%s\">\n",arg->stdin_opt);
	printf("\t\t<getopt mixed=\"-%c\" />\n",arg->opt);
	if (arg->default_value) {
	printf("\t\t<content type=\"%s\" default=\"%s\" />\n", arg->content_type, arg->default_value);
	} else {
	printf("\t\t<content type=\"%s\" />\n", arg->content_type);
	}
	printf("\t\t<shortdesc lang=\"en\">");
	print_desc_xml(arg->desc);
	printf("</shortdesc>\n");
	printf("\t</parameter>\n");
	}

	printf("</parameters>\n");
	printf("<actions>\n");
	printf("\t<action name=\"null\" />\n");
	printf("\t<action name=\"on\" />\n");
	printf("\t<action name=\"off\" />\n");
	printf("\t<action name=\"reboot\" />\n");
	printf("\t<action name=\"metadata\" />\n");
	printf("\t<action name=\"status\" />\n");
	printf("\t<action name=\"devstatus\" />\n");
	printf("\t<action name=\"hostlist\" />\n");
	printf("</actions>\n");
	printf("</resource-agent>\n");
	}


	/**
	Remove leading and trailing whitespace from a line of text.

	@param line Line to clean up
	@param linelen Max size of line
	@return 0 on success, -1 on failure
	*/
	int
	cleanup(char *line, size_t linelen)
	{
	char *p;
	int x;

	/* Remove leading whitespace. */
	p = line;
	for (x = 0; x <= linelen; x++) {
	switch (line[x]) {
	case '\t':
	case ' ':
	break;
	case '\n':
	case '\r':
	return -1;
	default:
	goto eol;
	}
	}
	eol:
	/* Move the remainder down by as many whitespace chars as we
	chewed up */
	if (x)
	memmove(p, &line[x], linelen-x);

	/* Remove trailing whitespace. */
	for (x=0; x <= linelen; x++) {
	switch(line[x]) {
	case '\t':
	case ' ':
	case '\r':
	case '\n':
	line[x] = 0;
	case 0:
	/* End of line */
	return 0;
	}
	}

	return -1;
	}


	/**
	Parse args from stdin and assign to the specified args structure.

	@param optstr Command line option string in getopt(3) format
	@param args Args structure to fill in.
	*/
	void
	args_get_stdin(const char optstr, fence_virt_args_t args)
	{
	char in[256];
	int line = 0;
	char name, val;
	struct arg_info *arg;

	while (fgets(in, sizeof(in), stdin)) {
	++line;

	if (in[0] == '#')
	continue;

	if (cleanup(in, sizeof(in)) == -1)
	continue;

	name = in;
	if ((val = strchr(in, '='))) {
	*val = 0;
	++val;
	}

	arg = find_arg_by_string(name);
	if (!arg \|\| (arg->opt != '\xff' &&
	!strchr(optstr, arg->opt))) {
	fprintf(stderr,
	"parse warning: "
	"illegal variable '%s' on line %d\n", name,
	line);
	continue;
	}

	if (arg->assign)
	arg->assign(args, arg, val);
	}
	}


	/**
	Parse args from stdin and assign to the specified args structure.

	@param optstr Command line option string in getopt(3) format
	@param args Args structure to fill in.
	*/
	void
	args_get_getopt(int argc, char *argv, const char optstr, fence_virt_args_t *args)
	{
	int opt;
	struct arg_info *arg;

	while ((opt = getopt(argc, argv, optstr)) != EOF) {

	arg = find_arg_by_char(opt);

	if (!arg) {
	args->flags \|= F_ERR;
	continue;
	}

	if (arg->assign)
	arg->assign(args, arg, optarg);
	}
	}


	void
	args_finalize(fence_virt_args_t *args)
	{
	char *addr = NULL;

	if (!args->net.addr) {
	switch(args->net.family) {
	case 0:
	case PF_INET:
	addr = IPV4_MCAST_DEFAULT;
	break;
	case PF_INET6:
	addr = IPV6_MCAST_DEFAULT;
	break;
	default:
	args->flags \|= F_ERR;
	break;
	}
	}

	if (!args->net.addr)
	args->net.addr = addr;

	if (!args->net.addr) {
	printf("No multicast address available\n");
	args->flags \|= F_ERR;
	}

	if (!args->net.addr)
	return;
	if (args->net.family)
	return;

	/* Set family */
	if (strchr(args->net.addr, ':'))
	args->net.family = PF_INET6;
	if (strchr(args->net.addr, '.'))
	args->net.family = PF_INET;
	if (!args->net.family) {
	printf("Could not determine address family\n");
	args->flags \|= F_ERR;
	}
	}
	diff --git a/man/fence_virt.8 b/man/fence_virt.8
	index 862aa9a0..25331513 100644
	--- a/man/fence_virt.8
	+++ b/man/fence_virt.8
	@@ -1,251 +1,255 @@
	.TH FENCE_AGENT 8 2009-12-04 "fence_virt (Fence Agent)"
	.SH NAME
	fence_virt - Fencing agent for virtual machines using VM Channel

	fence_xvm - Fencing agent for virtual machines using multicast
	.SH DESCRIPTION
	.P
	fence_virt and fence_xvm are an I/O Fencing agents which can be used with virtual machines. Fence_xvm is backward compatible with fence_xvmd.

	Fence_virt and fence_xvm talk to fence_virtd, which supports multiple backend plugins, including:
	- libvirt for single-node operation
	- Cluster Checkpoints when using Linux-cluster release 3.0.0 or later
	- libvirt-qpid for multi-node, non-cluster operation

	For compatibility, fence_xvm may talk to fence_xvmd from linux-cluster
	release 2 or later.

	.P
	fence_virt and fence_xvm accept options on the command line as well
	as from stdin. The fencing daemon sends parameters through stdin
	when it execs the agent. The agent may be run by itself with command
	line options, which is useful for testing or turning on or off virtual
	machines from scripts.

	.SH GENERAL PARAMETERS

	.TP
	.B -d
	.
	Increment (command line) debug level

	.TP
	.B -H
	.
	Virtual machine (domain name) to fence

	.TP
	.B -o
	.
	-Fencing action (null, off, on, reboot, status, devstatus, or hostlist) (Default Value: reboot)
	+Fencing action (null, off, on, reboot, status, devstatus, hostlist, or metadata) (Default Value: reboot). See the FENCING ACTIONS section.

	.TP
	.B -t
	.
	Fencing timeout (in seconds) (Default Value: 30)

	.SH MULTICAST PARAMETERS
	These parameters are used only when using fence_virt in multicast mode
	(e.g. by running fence_xvm).

	.TP
	.B -i
	.
	IP Family (auto, ipv4, ipv6) (Default Value: auto)

	.TP
	.B -a
	.
	Multicast address (Default Values: 225.0.0.12 / ff02::3:1)

	.TP
	.B -p
	.
	IP port (Default Value: 1229)

	.TP
	.B -T
	.
	Multicast time-to-live (in hops) (Default Value: 2)

	.TP
	.B -r
	.
	Multicast retransmit time (in 1/10sec) (Default Value: 20)

	.TP
	.B -C
	.
	Authentication (none, sha1, sha256, sha512) (Default Value: sha256)

	.TP
	.B -c
	.
	Packet hash strength (none, sha1, sha256, sha512) (Default Value: sha256)

	.TP
	.B -k
	.
	Shared key file (Default Value: /etc/cluster/fence_xvm.key)

	.TP
	.B -u
	.
	Treat 'domain' as UUID instead of domain name.

	.SH SERIAL/VMCHANNEL PARAMETERS
	These parameters are used only when using fence_virt in multicast mode
	(e.g. by running fence_xvm).

	.TP
	.B -D
	.
	Serial device (fence_virt mode). On the host, the serial device must
	be mapped in each domain's configuration file. See fence_virt.conf(5)
	for more information. Specifying a serial device causes fence_virt
	to use serial mode (as opposed to VMChannel mode).

	.TP
	.B -P
	.
	Serial parameters. (Default Value: 115200,8N1)

	.TP
	.B -A
	VMChannel IP address (Default Value: 10.0.2.179)

	.TP
	.B -p
	.
	VMChannel IP port (Default Value: 1229)

	.SH GENERAL STDIN PARAMETERS
	These parameters are passed to fence_virt via standard input if
	no command line options are present. They are presented to
	fence_virt in the form:

	name=value

	.TP
	.B debug
	.
	Specify debugging level

	.TP
	.B domain
	.
	Virtual machine (domain name) to fence

	.TP
	.B action
	.
	-Fencing action to perform (See FENCING ACTIONS section)
	+Fencing action (null, off, on, reboot, status, devstatus, hostlist, or metadata) (Default Value: reboot). See the FENCING ACTIONS section.

	.TP
	.B timeout
	.
	Fencing timeout (in seconds) (Default Value: 30)

	.SH MULTICAST STDIN PARAMETERS
	.TP
	.B ip_family
	.
	IP Family ([auto], ipv4, ipv6) (Default Value: auto)

	.TP
	.B multicast_address
	.
	Multicast address (Defaults: 225.0.0.12 / ff02::3:1)

	.TP
	.B port
	.
	IP port (Default Value: 1229)

	.TP
	.B multicast_ttl
	.
	Multicast time-to-live (in hops) (Default Value: 2)

	.TP
	.B retrans
	.
	Multicast retransmit time (in 1/10sec) (Default Value: 20)

	.TP
	.B auth
	.
	Authentication (none, sha1, sha256, sha512) (Default Value: sha256)

	.TP
	.B hash
	.
	Packet hash strength (none, sha1, sha256, sha512) (Default Value: sha256)

	.TP
	.B key_file
	.
	Shared key file (Default Value: /etc/cluster/fence_xvm.key)

	.TP
	.B use_uuid
	.
	Treat 'domain' as UUID instead of domain name

	.SH SERIAL/VMCHANNEL STDIN PARAMETERS
	.TP
	.B serial_device
	.
	Serial device. On the host, the serial device must be mapped in
	each domain's configuration file. See fence_virt.conf(5)
	for more information. If specified, causes fence_virt to operate
	in serial mode (not specifying causes fence_virt to operate in
	VM Channel mode).

	.TP
	.B serial_params
	.
	Serial parameters. Default=115200,8N1.

	.TP
	.B channel_ip
	.
	Channel IP. Default=10.0.2.179

	.TP
	.B port
	.
	Channel port. Default=1229


	.SH FENCING ACTIONS

	.TP
	\fBoff \fP
	Destroy or turn off virtual machine.

	.TP
	\fBreboot \fP
	Reboot virtual machine; i.e. restart the virtual machine on the same
	host where it is currently running.

	.TP
	\fBon \fP
	Turn on a virtual machine. Note: Turning on a virtual machine only works
	with some fence_virt backends.

	.TP
	\fBstatus \fP
	Check whether a virtual machine is running or not.

	.TP
	\fBdevstatus \fP
	Check the health of fence_virtd.

	.TP
	\fBhostlist \fP
	List virtual machines which may be fenced by fence_virtd (not supported
	on all backends).

	+.TP
	+\fBmetadata \fP
	+Print XML metadata to standard output.
	+
	.SH SEE ALSO
	fence_virtd(8), fence(8), fence_virtd.conf(5)

File Metadata

Mime Type: text/x-diff
Expires: Wed, Feb 26, 6:28 AM (23 h, 57 m)
Storage Engine: blob
Storage Format: Raw Data
Storage Handle: 1465199
Default Alt Text: (24 KB)

No OneTemporaryActions

View Options

File Metadata

Event Timeline

No OneTemporary
Actions