Working with Interface Status (asg if)

Description

Use the "asg if" command in Gaia gClishClosed The name of the global command line shell in Check Point Gaia operating system for Security Gateway Modules. Commands you run in this shell apply to all Security Gateway Module in the Security Group. or the Expert mode to:

  • Enable and disable the interfaces

  • Show information about interfaces:

    • IPv4, IPv6, and MAC address

    • Interface type

    • Link State

    • Speed

    • MTU

    • Duplex

Syntax

asg if -h

asg if -i <Interface1>[,<Interface2>,...,<InterfaceN>] [-v] [{enable | disable}]

asg if -ip <IP Address>

Parameters

Parameter

Description

-h

Shows the built-in help.

No Parameters

Shows information about all interfaces.

-i <Interface1>[,<Interface2>,...,<InterfaceN>]

Shows information only about the interfaces specified by their names.

  • You can specify one or more interfaces.

  • If you specify more than interface, you must separate their names by a comma without spaces.

    Example: asg if -i Sync,eth1-Mgmt1

-v

Shows verbose output.

Note - This view is not supported for logical interfaces (for example, Bond, VLAN, and ethX-MgmtY interfaces).

enable

Enables the specified interfaces.

disable

Disables the specified interfaces.

-ip <IP Address>

Shows information only about one interface specified by its IPv4 or IPv6 address.

Verbose Mode (asg if -v)

The Verbose Mode shows extended information, including information retrieved from the switch.

You can use the Verbose Mode for one interface or a comma-separated list of interfaces (without spaces).

This operation can take a few seconds for each interface.

[Expert@HostName-ch0x-0x:0]# asg if -i eth1-01 -v
Collecting information, may take few seconds
+----------------------------------------------------------------------------------------+
|Interfaces Data                                                                         |
+----------------------------------------------------------------------------------------+
|Interface|IPv4 Address         |Info        |State         |Speed   |MTU       |Duplex  |
|         |MAC  Address         |            |(ch1)/(ch2)   |        |          |        |
|         |IPv6 Address (global)|            |              |        |          |        |
|         |IPv6 Address (local) |            |              |        |          |        |
+---------+---------------------+------------+--------------+--------+----------+--------+
|eth1-01  |-                    |Bond slave  |(up)/(up)     |10G     |1500      |Full    |
|         |00:1c:7f:a1:01:0     |            |master:       |        |          |        |
|         |-                    |            |bond1(up)/(up)|        |          |        |
|         |-                    |            |              |        |          |        |
+---------+---------------------+------------+--------------+--------+----------+--------+
|Comment                                                                                 |
+----------------------------------------------------------------------------------------+
|internal interface                                                                      |
+----------------------------------------------------------------------------------------+
|Traffic                                                                                 |
+----------------------------------------------------------------------------------------+
|media            |In traffic |In pkt(uni/mul/brd)|Out traffic    |Out pkt(uni/mul/brd)  |
+-----------------+-----------+-------------------+---------------+----------------------+
|FTLF8528P2BNV-EM |28.8Kbps   |0pps/38pps/5pps    |4.1Mbps        |0pps/355pps/0pps      |
+----------------------------------------------------------------------------------------+
|Errors (total/pps)                                                                      |
+----------------------------------------------------------------------------------------+
|OutDiscards                  |InDiscards         |InErrors       |OutErrors             |
+-----------------------------+-------------------+---------------+----------------------+
|0/0                          |0/0                |0/0            |0/0                   |
+-----------------------------+-------------------+---------------+----------------------+
[Expert@HostName-ch0x-0x:0]#