# CLI command syntax This page explains gobgp client command syntax. ## basic command pattern gobgp \ \ opts... gobgp has three subcommands. - global - neighbor - policy - vrf - monitor - mrt ## 1. global subcommand ### 1.1. Operations for Global-Rib - add/del/show - #### - syntax ```shell # add Route % gobgp global rib add [-a
] # delete a specific Route % gobgp global rib del [-a
] # show all Route information % gobgp global rib [-a
] # show a specific route information % gobgp global rib [|] [-a
] ``` #### - example If you want to add routes with the address of the ipv4 to global rib： ```shell % gobgp global rib add 10.33.0.0 -a ipv4 ``` If you want to remove routes with the address of the ipv6 from global rib： ```shell % gobgp global rib del 2001:123:123:1::/64 -a ipv6 ``` #### - option The following options can be specified in the global subcommand: | short |long | description | |--------|---------------|--------------------------------------------| |a |address-family |specify the ipv4, ipv6, evpn, encap, or rtc |
## 2. neighbor subcommand ### 2.1. Show Neighbor Status #### - syntax ```shell # show neighbor's status as list % gobgp neighbor # show status of a specific neighbor % gobgp neighbor ``` ### 2.2. Operations for neighbor - shutdown/reset/softreset/enable/disable - #### - syntax ```shell % gobgp neighbor shutdown % gobgp neighbor reset % gobgp neighbor softreset [-a
] % gobgp neighbor softresetin [-a
] % gobgp neighbor softresetout [-a
] % gobgp neighbor enable % gobgp neighbor disable ``` #### - option The following options can be specified in the neighbor subcommand: | short |long | description | |--------|---------------|------------------------------| |a |address-family |specify the ipv4 or ipv6 | ### 2.3. Show Rib - local-rib/adj-rib-in/adj-rib-out - #### - syntax ```shell # show all routes in [local|adj-in|adj-out] table % gobgp neighbor [local|adj-in|adj-out] [-a
] # show a specific route in [local|adj-in|adj-out] table % gobgp neighbor [local|adj-in|adj-out] [|] [-a
] ``` #### - example If you want to show the local rib of ipv4 that neighbor(10.0.0.1) has： ```shell % gobgp neighbor 10.0.0.1 local -a ipv4 ``` #### - option The following options can be specified in the neighbor subcommand: | short |long | description | |--------|---------------|------------------------------| |a |address-family |specify the ipv4 or ipv6 | ### 2.4. Operations for Policy - add/del/show - #### - syntax ```shell # add policy to import-policy configuration % gobgp neighbor policy add import # add policy to export-policy configuration % gobgp neighbor policy add export # add policy to in-policy configuration % gobgp neighbor policy add in # delete import-policy configuration from specific neighbor % gobgp neighbor policy del import # delete export-policy configuration from specific neighbor % gobgp neighbor policy del export # delete in-policy configuration from specific neighbor % gobgp neighbor policy del in # show a specific policy information % gobgp neighbor policy ``` #### - example If you want to add the import policy to neighbor(10.0.0.1)： ```shell % gobgp neighbor 10.0.0.1 policy add import policy1,policy2 accept ``` You can specify multiple policy to neighbor separated by commas. \ means the operation(accept | reject) in the case where the route does not match the conditions of the policy.
## 3. policy subcommand ### 3.1. Operations for PrefixSet - add/del/show - #### - syntax ```shell # add PrefixSet % gobgp policy prefix add [] # delete all PrefixSet % gobgp policy prefix del all # delete a specific PrefixSet % gobgp policy prefix del [ ] # show all PrefixSet information % gobgp policy prefix # show a specific PrefixSet % gobgp policy prefix ``` #### - example If you want to add the PrefixSet： ```shell % gobgp policy prefix add ps1 10.33.0.0/16 16..24 ``` A PrefixSet it is possible to have multiple prefix, if you want to remove the PrefixSet to specify only PrefixSet name. ```shell % gobgp policy prefix del ps1 ``` If you want to remove one element(prefix) of PrefixSet, to specify a prefix in addition to the PrefixSet name. ```shell % gobgp policy prefix del ps1 10.33.0.0/16 ``` ### 3.2. Operations for NeighborSet - add/del/show - #### - syntax ```shell # add NeighborSet % gobgp policy neighbor add # delete all NeighborSet % gobgp policy neighbor del all # delete a specific NeighborSet % gobgp policy neighbor del [
] # show all NeighborSet information % gobgp policy neighbor # show a specific NeighborSet information % gobgp policy neighbor ``` #### - example If you want to add the NeighborSet： ```shell % gobgp policy neighbor add ns1 10.0.0.1 ``` A NeighborSet it is possible to have multiple address, if you want to remove the NeighborSet to specify only NeighborSet name. ```shell % gobgp policy neighbor del ns1 ``` If you want to remove one element(address) of NeighborSet, to specify a address in addition to the NeighborSet name. ```shell % gobgp policy prefix del ns1 10.0.0.1 ``` ### 3.3. Operations for AsPathSet - add/del/show - #### - syntax ```shell # add AsPathSet % gobgp policy aspath add # delete all AsPathSet % gobgp policy aspath del all # delete a specific AsPathSet % gobgp policy aspath del [] # show all AsPathSet information % gobgp policy aspath # show a specific AsPathSet information % gobgp policy aspath ``` #### - example If you want to add the AsPathSet： ```shell % gobgp policy aspath add ass1 ^65100 ``` You can specify the position using regexp-like expression as follows: - From: "^65100" means the route is passed from AS 65100 directly. - Any: "65100" means the route comes through AS 65100. - Origin: "65100$" means the route is originated by AS 65100. - Only: "^65100$" means the route is originated by AS 65100 and comes from it directly. Further you can specify the consecutive aspath and use regexp in each element as follows: - ^65100_65001 - 65100_[0-9]+_.*$ - ^6[0-9]_5.*_65.?00$ An AsPathSet it is possible to have multiple as path, if you want to remove the AsPathSet to specify only AsPathSet name. ```shell % gobgp policy aspath del ass1 ``` If you want to remove one element(as path) of AsPathSet, to specify an as path in addition to the AsPathSet name. ```shell % gobgp policy aspath del ass1 ^65100 ``` ### 3.4. Operations for CommunitySet - add/del/show - #### - syntax ```shell # add CommunitySet % gobgp policy community add # delete all CommunitySet % gobgp policy community del all # delete a specific CommunitySet % gobgp policy community del [] # show all CommunitySet information % gobgp policy community # show a specific CommunitySet information % gobgp policy community ``` #### - example If you want to add the CommunitySet： ```shell % gobgp policy community add cs1 65100:10 ``` You can specify the position using regexp-like expression as follows: - 6[0-9]+:[0-9]+ - ^[0-9]*:300$ A CommunitySet it is possible to have multiple community, if you want to remove the CommunitySet to specify only CommunitySet name. ```shell % gobgp policy neighbor del cs1 ``` If you want to remove one element(community) of CommunitySet, to specify a address in addition to the CommunitySet name. ```shell % gobgp policy prefix del cs1 65100:10 ``` ### 3.5. Operations for ExtCommunitySet - add/del/show - #### - syntax ```shell # add ExtCommunitySet % gobgp policy extcommunity add # delete all ExtCommunitySet % gobgp policy extcommunity del all # delete a specific ExtCommunitySet % gobgp policy extcommunity del [] # show all ExtCommunitySet information % gobgp policy extcommunity # show a specific ExtCommunitySet information % gobgp policy extcommunity ``` #### - example If you want to add the ExtCommunitySet： ```shell % gobgp policy extcommunity add ecs1 RT:65100:10 ``` Extended community set as \:\:\. If you read the [RFC4360](https://tools.ietf.org/html/rfc4360) and [RFC7153](https://tools.ietf.org/html/rfc7153), you can know more about Extended community. You can specify the position using regexp-like expression as follows: - RT:[0-9]+:[0-9]+ - SoO:10.0.10.10:[0-9]+ However, regular expressions for subtype can not be used, to use for the global admin and local admin. A ExtCommunitySet it is possible to have multiple extended community, if you want to remove the ExtCommunitySet to specify only ExtCommunitySet name. ```shell % gobgp policy neighbor del ecs1 ``` If you want to remove one element(extended community) of ExtCommunitySet, to specify a address in addition to the ExtCommunitySet name. ```shell % gobgp policy prefix del ecs1 RT:65100:10 ``` ### 3.6. Operations for RoutePolicy - add/del/show - #### - syntax ```shell # add RoutePolicy % gobgp policy routepoilcy add [] # delete all RoutePolicy % gobgp policy routepoilcy del all # delete a specific RoutePolicy % gobgp policy routepoilcy del [] # show all RoutePolicy information % gobgp policy routepoilcy # show a specific RoutePolicy information % gobgp policy routepoilcy ``` #### - example If you want to add the RoutePolicy： ```shell % gobgp policy routepolicy add policy1 state1 --c-prefix=ANY[ps1] --c-neighbor=INVERT[ns1] --c-aspath=ALL[ass1] --c-community=ALL[cs1] --c-extcommunity=ANY[ecs1] --c-aslen=eq,3 --a-route=reject --a-community=ADD[65100:20] --a-med=+100 --a-asprepend=65100,10 ``` However, it is not necessary to specify all of the options at once. For the condition of the following option in order to evaluate for each condition, match option(ANY, ALL or INVERT) is set as the ANY[\] - c-prefix - c-neighbor - c-aspath - c-community - c-extcommunity A RoutePolicy it is possible to have multiple statement, if you want to remove the RoutePolicy to specify only RoutePolicy name. ```shell % gobgp policy routepolicy del policy1 ``` If you want to remove one element(statement) of RoutePolicy, to specify a statement name in addition to the RoutePolicy name. ```shell % gobgp policy prefix del policy1 state1 ``` #### - option The following options can be specified in the policy subcommand: - options of condition | short |long | description | |--------|---------------|-----------------------------------------------------------------------------------------------------------------------------------| |- |c-prefix |specify the name that added prefix set in PrefixSet subcommand
match option: ”ANY or INVERT” can be set | |- |c-neighbor |specify the name that added neighbor set in NeighborSet subcommand
match option: ”ANY or INVERT” can be set | |- |c-aspath |specify the name that added as path set in AsPathSet subcommand
match option: ”ANY, ALL or INVERT” can be set | |- |c-community |specify the name that added community set in CommunitySet subcommand
match option: ”ANY, ALL or INVERT” can be set | |- |c-extcommunity |specify the name that added extended community set in ExtCommunitySet subcommand
match option: ”ANY, ALL or INVERT” can be set| |- |c-aslen |specify the operator(eq, ge, le) and value(numric) | - options of action | short |long | description | |--------|------------|---------------------------------------------------------------------------------------------------------------| |- |a-route |specify the action(accept, reject) of the route that match to the conditions | |- |a-community |specify the community operation of the route that match to the conditions | |- |a-med |specify the med operation of the route that match to the conditions | |- |a-asprepend |specify a combination of an AS number and repeat count(e.g. 65100,10) to prepend if the path matches conditions| ## 4. vrf subcommand ### 4.1 Add/Delete/Show VRF #### Syntax ```shell # add vrf % gobgp vrf add rd rt {import|export|both} ... # del vrf % gobgp vrf del # show vrf % gobgp vrf ``` #### Example ```shell % gobgp vrf add vrf1 rd 10.100:100 rt both 10.100:100 import 10.100:101 export 10.100:102 % gobgp vrf Name RD Import RT Export RT vrf1 10.100:100 10.100:100, 10.100:101 10.100:100, 10.100:101 % gobgp vrf del vrf1 % gobgp vrf Name RD Import RT Export RT ``` ### 4.2 Add/Delete/Show VRF routes #### Syntax ```shell # add routes to vrf % gobgp vrf rib add -a
# del routes from vrf % gobgp vrf rib del -a
# show routes in vrf % gobgp vrf ``` #### Example ```shell % gobgp vrf vrf1 rib add 10.0.0.0/24 % gobgp vrf vrf1 rib add 2001::/64 -a ipv6 % gobgp vrf vrf1 rib Network Next Hop AS_PATH Age Attrs 10.100:100:10.0.0.0/24 0.0.0.0 00:00:40 [{Origin: i} {Extcomms: [10.100:100], [10.100:101]}] % gobgp vrf vrf1 rib -a ipv6 Network Next Hop AS_PATH Age Attrs 10.100:100:2001::/64 :: 00:00:00 [{Origin: i} {Extcomms: [10.100:100], [10.100:101]}] % gobgp vrf vrf1 rib del 10.0.0.0/24 % gobgp vrf vrf1 rib del 2001::/64 ``` ## 5. monitor subcommand ### 5.1 monitor global rib #### Syntax ```shell # monitor global rib % gobgp monitor global rib ``` #### Example ```shell [TERM1] % gobgp monitor global rib [ROUTE] 10.0.0.0/24 via 0.0.0.0 aspath [] attrs [{Origin: i}] [TERM2] # monitor command blocks. add routes from another terminal % gobgp global rib add 10.0.0.0/24 ``` ### 5.2 monitor neighbor status #### Syntax ```shell # monitor neighbor status % gobgp monitor neighbor # monitor specific neighbor status % gobgp monitor neighbor ``` #### Example ```shell [TERM1] % gobgp monitor neighbor [NEIGH] 192.168.10.2 fsm: BGP_FSM_IDLE admin: ADMIN_STATE_DOWN [NEIGH] 192.168.10.2 fsm: BGP_FSM_ACTIVE admin: ADMIN_STATE_UP [NEIGH] 192.168.10.2 fsm: BGP_FSM_OPENSENT admin: ADMIN_STATE_UP [NEIGH] 192.168.10.2 fsm: BGP_FSM_OPENCONFIRM admin: ADMIN_STATE_UP [NEIGH] 192.168.10.2 fsm: BGP_FSM_ESTABLISHED admin: ADMIN_STATE_UP [TERM2] % gobgp neighbor 192.168.10.2 disable % gobgp neighbor 192.168.10.2 enable ``` ## 6. mrt subcommand ### 6.1 dump mrt records #### Syntax ```shell % gobgp mrt dump rib global [] % gobgp mrt dump rib neighbor [] ``` #### Options | short |long | description | |--------|--------|--------------------------------| | f | format | filename format | | o | outdir | output directory of dump files | #### Example see [MRT](https://github.com/osrg/gobgp/blob/master/docs/sources/mrt.md). ### 6.2 inject mrt records #### Syntax ```shell % gobgp mrt inject global [] ``` #### Example see [MRT](https://github.com/osrg/gobgp/blob/master/docs/sources/mrt.md).