Go to main content

Managing Network Virtualization and Network Resources in Oracle® Solaris 11.3

Exit Print View

Updated: April 2018
 
 

Commands for Configuring Rings

To configure the rings of a datalink, use the following dladm subcommands:

  • # dladm show-linkprop link

    Displays the current values of the datalink properties, including Rx and Tx rings. For an example, see Example 72, Ring Use and Ring Assignments on a Datalink.

    The following table describes the ring properties that are displayed by using the dladm show-linkprop command.

    Ring Property
    Permission
    Description
    rxringsavail
    Read only
    Indicates the number of Rx rings that you can allocate to hardware-based clients on the physical datalink.
    rxhwclntavail
    Read only
    Indicates the number of hardware-based Rx clients that you can create on the physical datalink.
    rxrings
    Read and write
    Indicates the number of Rx rings exclusively used by the datalink. You can set this property to one of the three possible values:
    • hw indicates that you are configuring a hardware-based client. You can set this value, if the hardware-based Rx clients (rxhwclntavail) on the underlying physical link is greater than zero.

    • number indicates the number of rings that you can assign to a datalink. You can set this value, if the Rx rings (rxringsavail) on the underlying physical link is greater than zero.

    • sw indicates that the datalink is a software-based client.

    txringsavail
    Read only
    Indicates the number of Tx rings that you can allocate to hardware-based clients on the physical datalink.
    txhwclntavail
    Read only
    Indicates the number of hardware-based Tx clients that you can create on the physical datalink.
    txrings
    Read and write
    Indicates the number of Tx rings exclusively used by the datalink. You can set this property to one of the three possible values:
    • hw indicates that you are configuring a hardware-based client. You can set this value, if the hardware-based Tx clients (txhwclntavail) on the underlying physical link is greater than zero.

    • number indicates the number of rings that you can assign to a datalink. You can set this value, if the Tx rings (txringsavail) on the underlying physical link is greater than zero.

    • sw indicates that the datalink is a software-based client.

  • # dladm show-phys –H link

    Displays how the rings of a physical datalink are currently being used by existing clients.

  • # dladm create-vnic –p ring-properties –l link VNIC
    –p ring-properties

    Refers to the ring-properties whose values can be set.

    Creates a client with a specific number of Rx or Tx rings.

  • # dladm set-linkprop –p ring-properties VNIC

    Allocates rings to a specific client, provided that the rings are available and ring allocation is supported.