# # Copyright (c) 2001-2003 # Fraunhofer Institute for Open Communication Systems (FhG Fokus). # All rights reserved. # Copyright (c) 2004 # Hartmut Brandt. # All rights reserved. # # Author: Hartmut Brandt # # Redistribution and use in source and binary forms, with or without # modification, are permitted provided that the following conditions # are met: # 1. Redistributions of source code must retain the above copyright # notice, this list of conditions and the following disclaimer. # 2. Redistributions in binary form must reproduce the above copyright # notice, this list of conditions and the following disclaimer in the # documentation and/or other materials provided with the distribution. # # THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND # ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE # IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE # ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE # FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL # DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS # OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) # HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT # LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY # OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF # SUCH DAMAGE. # # Help file for the atmconfig utility # # $FreeBSD: src/sbin/atm/atmconfig/atmconfig.help,v 1.5.32.1 2010/02/10 00:26:20 kensmith Exp $ # ^0 intro ATM configuration utility. usage: atmconfig [common-options] command [subcommand] [options] Use 'atmconfig help' for general help or 'atmconfig help ' for help on 'command' or 'atmconfig help commands' for a list of commands. ^0 help ^^ help show help information Use one of the following commands to get help on atmconfig: atmconfig help options gives you help on common command line options atmconfig help commands prints a list of available commands (and help items) atmconfig help prints help on the given command (including a list of subcommands) atmconfig help gives help on the given subcommand ^0 options ^^ help options list common options Common command line options can be specified for all commands. They are written immediately before the command. The following options are available: -h print short help -t don't print headings for 'show'-type commands -v be verbose about all actions. ^0 commands ^^ help commands show available commands The following commands are available: $MAIN ^0 diag ^^ diag show/modify ATM hardware interfaces This command shows information about the ATM hardware interfaces in the system. A list of ATM devices is obtained by: atmconfig [common-options] diag list Information about the hardware configuration of the ATM interfaces is reported by: atmconfig [common-options] diag config [options] [ ...] The phy chip can be access with: atmconfig [common-options] diag phy print [options] atmconfig [common-options] diag phy show atmconfig [common-options] diag phy set atmconfig [common-options] diag phy set stats [options] A list of open VCCs can be obtained with: atmconfig [common-options] diag vcc [ ...] Driver internal statistics are printed with atmconfig [common-options] diag stats ^1 list usage: atmconfig [common-options] diag list List all known ATM devices in the system. ^1 config usage: atmconfig [common-options] diag config [-hardware] [-atm] [device ...] options: -hardware print hardware related information -atm print ATM related information If now device is given as argument information about all devices is shown. The default is to print only ATM related information. ^1 phy To show the type of the PHY and its state: atmconfig [common-options] diag phy show Change a PHY register (use with care): atmconfig [common-options] diag phy set Print the PHY registers in a human readable form: atmconfig [common-options] diag phy print [-numeric] The PHY statistics can be printed with: atmconfig [common-options] diag phy stats [-clear] ^2 show usage: atmconfig [common-options] diag phy show Show configuration and state information about the PHY chip on the given ATM interface. ^2 set usage: atmconfig [common-options] diag phy set Set the bits of given PHY chip register for which the corresponding bit in is one to the value of the corresponding bit in . All register bits that have a zero in are written back with there original value. ^2 print usage: atmconfig [common-options] diag phy print [-numeric] options: -numeric print registers in hex Print the registers of the PHY chip in a human readable format. ^2 stats usage: atmconfig [common-options] diag phy stats [-clear] options: -clear clear the statistics atomically after reading them Prints the PHY layer statistics of the PHY chip and optionally clears them. ^1 vcc usage: atmconfig [common-options] diag vcc [-abr] [-channel] [-traffic] [ ...] options: -abr print ABR specific traffic parameters -channel print VPI, VCI, AAL, traffic type and flags (default) -traffic print traffic parameters Prints a list of all open vccs. The default output is -channel. ^1 stats usage: atmconfig [common-options] diag stats Prints the driver-internal statistics. ^0 natm ^^ natm simple IP over ATM management (see natmip(4)) The group of CLIP commands is used to manage classical IP over ATM networking via NATM (see natm(4) and natmip(4)). A new PVC is added to a CLIP via: atmconfig [common-options] natm add [ [ ...]] The PVC can be deleted with: atmconfig [common-options] natm del The list of PVC that are currently active is retrieved with: atmconfig [common-options] natm show ^1 add usage: atmconfig [common-options] natm add [-printonly] [ [ ...]] options: -printonly don't execute, print the route(8) command This subcommand adds a new CLIP PVC on the ATM interface . The host on the other end of the PVC has IP address . is one of llc/snap (LLC/SNAP encapsulated frames in AAL5) or aal5 (AAL5 frames without LLC/SNAP). specifies the traffic type of the PVC and is one of UBR, CBR, VBR or ABR. If not given UBR is assumed. Depending on the traffic type none or more parameters can follow: ubr [] cbr vbr abr ^1 delete usage: atmconfig [common-options] natm delete [-printonly] or: atmconfig [common-options] natm delete [-printonly] options: -printonly don't execute, print the route(8) command This subcommand deletes and existing CLIP PVC that can bei either identified by the destination address or by the triple. ^1 show usage: atmconfig [common-options] natm show [-abr] [-numeric] options: -abr show ABR parameters for ABR connections -numeric print IP addresses numerically This subcommand prints all ATM routes.