NAME
fence_ifmib - I/O Fencing agent for IF-MIB capable SNMP devices
SYNOPSIS
fence_ifmib [OPTION]...
DESCRIPTION
fence_ifmib is an I/O Fencing agent which can be used with any SNMP IF-
MIB capable device. Agent internally uses snmpget, snmpset and snmpwalk
command.
It was written with managed ethernet switches in mind, in order to
fence iSCSI SAN connections. However, there are many devices that
support the IF-MIB interface. The agent uses IF-MIB::ifAdminStatus to
control the state of an interface.
fence_ifmib accepts options on the command line as well as from stdin.
Fenced sends parameters through stdin when it execs the agent.
fence_ifmib can be run by itself with command line options. This is
useful for testing.
OPTIONS
-a IPaddress
IP address or hostname of the SNMP device. Can be used any
syntax supported by snmpget.
-h Print out a help message describing available options, then
exit.
-c community
The read/write community string to be used in the request.
-n name
Name of port to fence (fc1/1) or ifIndex (43).
-p password
Password for login for SNMP v3 (authentication protocol pass
phrase).
-P password
Password for privacy for SNMP v3 (privacy protocol password).
-S script
Script to run to retrieve password for login for SNMP v3
(authentication protocol pass phrase).
-R script
Script to run to retrieve privacy for SNMP v3 (privacy protocol
password).
-l login
Login name for SNMP v3 (security name).
-d version
SNMP version (1,2c,3).
-b auth_protocol
SNMP authentication protocol (MD5|SHA).
-E sec_level
SNMP security level (noAuthNoPriv|authNoPriv|authPriv).
-B priv_protocol
SNMP privacy protocol (DES|AES).
-u udp_port
UDP/TCP port to use.
-o action
The action required. off (default), on, status, list or
monitor. Deprecated options (enable -> on and disable -> off)
can be used too.
-v Verbose. Record session to stdout, or debug file if specified
(see -D).
-D Specifies file, where will be written debug messages from
session.
-V Print out a version message, then exit.
STDIN PARAMETERS
agent = < param >
This option is used by fence_node(8) and is ignored by
fence_ifmib.
ipaddr = < param >
IP address or hostname of the SNMP device. Can be used any
syntax supported by snmpget.
community = < param >
The read/write community string to be used in the request.
port = < param >
Name of port to fence (fc1/1) or ifIndex (43).
passwd = < param >
Password for login for SNMP v3 (authentication protocol pass
phrase).
snmp_priv_passwd
Password for privacy for SNMP v3 (privacy protocol password).
passwd_script = < param >
Script to run to retrieve password for login for SNMP v3
(authentication protocol pass phrase).
snmp_priv_passwd_script = < param>
Password for privacy for SNMP v3 (privacy protocol password).
login = < param >
Login name for SNMP v3 (security name).
snmp_version = < param >
SNMP version (1,2c,3).
snmp_auth_prot = < param >
SNMP authentication protocol (MD5|SHA).
snmp_sec_level = < param >
SNMP security level (noAuthNoPriv|authNoPriv|authPriv).
snmp_priv_prot = < param >
SNMP privacy protocol (DES|AES).
udpport = < param >
UDP/TCP port to use.
action = < param >
The action required. off (default), on, status, list or
monitor. Deprecated options (enable -> on and disable -> off)
can be used too.
verbose = < param >
Verbose. Record session to stdout, or debug file if specified
(see debug).
debug = < param >
Specifies file, where will be written debug messages from
session.
SEE ALSO
fence(8), fence_node(8)
fence_ifmib(8)