lrcfg(8)

#include "lrcfg.h"

NAME
lrcfg - manipulating lr (link redundancy) driver

SYNOPSIS
lrcfg add physical_if logical_if
lrcfg del physical_if
lrcfg showsys
lrcfg showgrp logical_if
lrcfg showport logical_if
lrcfg showdist logical_if
lrcfg showbfu logical_if
lrcfg setgrp logical_if var val
lrcfg ver
lrcfg list
lrcfg -h | --help
lrcfg [-c config_file]

DESCRIPTION
lrcfg is used to set up, maintain the lr (virtual ethernet driver) in the Linux kernel. These operation can be divided into following categories: adding, deleting physical interface and printing version, port and group information.

COMMANDS

add This command adds a physical interface to pool and making it belong to a port group immediately.

del This command deletes a physical interface from group. It is safe to delete the physical interface while logical_if (lr interface) is up.

ver This command shows version information of lrcfg and lr driver. It is recommended to make lrcfg's major and minor version match lr driver's one at least.

showsys
    This command shows lr global system information.

showgrp
    This command shows given lr group related information. It takes another argument which is logical interface name. i.e. lrX.

showport
    This command shows lr ports which belong to given lr group. It takes another argument which is logical interface name. i.e. lrX.

showdist
    This command shows lr distributing information of given lr group. It takes another argument which is logical interface name. i.e. lrX.

showbfu
    This command shows lr broadcast filtering information of given lr group. It takes another argument which is logical interface name. i.e. lrX.

setgrp logical_if var val
    This command set val to administrative variable var for logical_if.

    perio specifies periodic time in second for specified group (logical_if).

    age specifies aging time time of non-LRCP node's distributing information entry and BFI entries in second for specified group (logical_if).

    tchg enables or disables topology change notification. yes enables topology change notification to other LRCP nodes and accepts it from other LRCP nodes. no disables topology change notification to other LRCP nodes and ignores it from other LRCP nodes.

    pii enables or disables Phase II compatibility mode. yes enables Phase II comaptibility. no disables Phase II compatibility.

list
    This command shows physical interfaces registered.

-h | --help
    Shows help.

-c config_file
    If no arguments specified, lrcfg uses DEFAULT_CONFIG_FILE by default for configuration. This option changes path of configuration file.

PARAMETERS

physical_if
    Specify the physical interface name of ethernet device (ethX).

logical_if
    Specify the logical interface name of lr device (lrX).

CONFIGURATION FILE
Configuration file can be used for storing confiuration command sets which are recalled by lrcfg later. Configuration file consists of comment or space lines and command lines. If beginning character of a line is '#' or ';' the line is ignored as comment line. Command line format is same as shell prompt command line format. E.g. "setgrp lr0 tchg yes" makes group "lr0"'s topology change notification enable. lrcfg reads and executes lines from top to bottom in turn.

FILES
/proc/net/lrcp Link redundancy status of each group and each physical interface.

DEFAULT_CONFIG_FILE
    Default configuration file.

AUTHOR
Yumo (Katsuyuki Yumoto) yumo@st.rim.or.jp