# tipc-bearer

## NAME



           tipc-bearer - show or modify TIPC bearers
    


## SYNOPSIS



           **tipc bearer add media udp name** _NAME_ **remoteip** _REMOTEIP_
    
           **tipc bearer enable**[ **domain** _DOMAIN_ ] [ **priority** _PRIORITY_ ] **media**
                   { { **eth** | **ib**} **device** _DEVICE_ } |
                   { **udp name** _NAME_ **localip** _LOCALIP_ [ **localport** _LOCALPORT_ ] [
                   **remoteip** _REMOTEIP_ ] [ **remoteport** _REMOTEPORT_ ] }
    
           **tipc bearer disable media**
                   { { **eth** | **ib**} **device** _DEVICE_ } |
                   { **udp name** _NAME_ }
    
           **tipc bearer set**{ **priority** _PRIORITY_ | **tolerance** _TOLERANCE_ | **window**
                   _WINDOW_ } **media**
                   { { **eth** | **ib**} **device** _DEVICE_ } |
                   { **udp name** _NAME_ }
    
           **tipc bearer get**[ **priority** | **tolerance** | **window**] **media**
                   { { **eth** | **ib**} **device** _DEVICE_ } |
                   { **udp name** _NAME_ [ **localip** | **localport** | **remoteip** |
                   **remoteport**] }
    
           **tipc bearer list**
    


## OPTIONS



           Options (flags) that can be passed anywhere in the command chain.
    
           **-h** , **--help**
                  Show help about last valid command. For example **tipc bearer**
                  **--help** will show bearer help and **tipc --help** will show
                  general help. The position of the option in the string is
                  irrelevant.
    


## DESCRIPTION



       **Bearer identification**
           **media** _MEDIA_
                  Specifies the TIPC media type for a particular bearer to
                  operate on.  Different media types have different ways of
                  identifying a unique bearer.  For example, **ib** and **eth**
                  identify a bearer with a _DEVICE_ while **udp** identify a bearer
                  with a _LOCALIP_ and a _NAME_
    
                  **ib** - Infiniband
    
                  **eth** - Ethernet
    
                  **udp** - User Datagram Protocol (UDP)
    
           **name** _NAME_
                  Logical bearer identifier valid for bearers on **udp** media.
    
           **device** _DEVICE_
                  Physical bearer device valid for bearers on **eth** and **ib**
                  media.
    
       **Bearer properties**
           **domain**
                  The addressing domain (region) in which a bearer will
                  establish links and accept link establish requests.
    
           **priority**
                  Default link priority inherited by all links subsequently
                  established over a bearer. A single bearer can only host
                  one link to a particular node. This means the default link
                  priority for a bearer typically affects which bearer to use
                  when communicating with a particular node in an multi
                  bearer setup. For more info about link priority see
                  tipc-link(8)
    
           **tolerance**
                  Default link tolerance inherited by all links subsequently
                  established over a bearer. For more info about link
                  tolerance see tipc-link(8)
    
           **window**
                  Default link window inherited by all links subsequently
                  established over a bearer. For more info about the link
                  window size see tipc-link(8)
    
       **UDP bearer options**
           **localip** _LOCALIP_
                  Specify a local IP v4/v6 address for a **udp** bearer.
    
           **localport** _LOCALPORT_
                  Specify the local port for a **udp** bearer. The default port
                  6118 is used if no port is specified.
    
           **remoteip** _REMOTEIP_
                  Specify a remote IP for a **udp** bearer. If no remote IP is
                  specified a **udp** bearer runs in multicast mode and tries to
                  auto-discover its neighbours.  The multicast IP address is
                  generated based on the TIPC network ID. If a remote IP is
                  specified the **udp** bearer runs in point-to-point mode.
    
                  Multiple **remoteip** addresses can be added via the **bearer add**
                  command. Adding one or more unicast **remoteip** addresses to
                  an existing **udp** bearer puts the bearer in replicast mode
                  where IP multicast is emulated by sending multiple unicast
                  messages to each configured **remoteip.** When a peer sees a
                  TIPC discovery message from an unknown peer the peer
                  address is automatically added to the **remoteip**(replicast)
                  list, thus only one side of a link needs to be manually
                  configured. A **remoteip** address cannot be added to a
                  multicast bearer.
    
           **remoteport** _REMOTEPORT_
                  Specify the remote port for a **udp** bearer. The default port
                  6118 is used if no port is specified.
    


## EXIT STATUS



           Exit status is 0 if command was successful or a positive integer
           upon failure.
    


* * *