Skip to main content

vserver export-policy netgroup cache show

Contributors
Suggest changes

Show the Netgroup Cache

Availability: This command is available to cluster and Vserver administrators at the admin privilege level.

Description

The vserver export-policy netgroup cache show command displays the contents of the export policy netgroup cache for a Vserver. Entries shown here correspond to the caches used to evaluate client membership in a netgroup. To show the netgroup cache, you must specify the following item:

  • Vserver: The name of the Vserver whose netgroup cache you want to display.

The following information is displayed per cache entry:

  • Vserver name: The name of the Vserver.

  • Netgroup name: The name of the netgroup.

  • State of the cache entry: The state of the cache entry. There are four possible values:

  • initializing: The cache entry is being populated for the first time.

  • ready: Processing of the cache entry is complete and it is ready to be used.

  • not-found: The netgroup could not be found.

  • abandoned: The cache entry has been abandoned.

  • Total number of hosts in the netgroup cache: The number of host names retrieved from the name service in mapping the netgroup to a list of hosts.

  • How long it took to expand the netgroup: How long it took to expand the netgroup the last time in the queue.

  • Entry is refreshing: If the entry is a complete miss or refresh.

  • Next refresh time: When the next refresh is scheduled to take place.

  • Netgroup by host state: Boolean state indicating if netgroup-by-host feature is used for resolving netgroup membership check.

  • Number of IP addresses cached: Number of client IP addresses that are matched for the netgroup. The count includes both positive and negative results.

Parameters

{ [-fields <fieldname>,…​]

If you specify the -fields <fieldname>, …​ parameter, the command output also includes the specified field or fields. You can use '-fields ?' to display the fields to specify.

| [-instance ] }

If you specify the -instance parameter, the command displays detailed information about all fields.

-vserver <vserver name> - Vserver

If you specify this parameter, the command displays the netgroup cache information only if the Vserver name matches the specified value.

[-netgroup <text>] - Name of the Netgroup

If you specify this parameter, the command displays the netgroup cache information only if the netgroup name matches the specified value.

[-cache-state {initializing|ready|not-found|abandoned}] - State of the Cache Entry

If you specify this parameter, the command displays the netgroup cache information only if the netgroup cache state matches the specified value.

[-total-hosts <integer>] - Total Number of Hosts in the Netgroup

If you specify this parameter, the command displays the netgroup cache information only if the netgroup record's count of host names matches the specified value.

[-expansion-duration <[[<hours>:]<minutes>:]<seconds>>] - Expansion Duration

If you specify this parameter, the command displays the netgroup cache information only if the netgroup record expansion time matches the specified value.

[-is-refreshing {true|false}] - Is Entry Refreshing?

If you specify this parameter, the command displays the netgroup cache information only if the netgroup record refreshing state matches the specified value.

[-time-next-refresh <Date>] - Next Refresh Time

If you specify this parameter, the command displays the netgroup cache information only if the time of the next scheduled refresh matches the specified value.

[-num-ip-addrs-cache <integer>] - Number of Cached IP Addresses

If you specify this parameter, the command displays the netgroup cache information only if the number of cached IP addresses matches the specified value.

Examples

The following example displays the netgroup cache for the Vserver vs1 and the netgroup netgroup1:

cluster1::> vserver export-policy netgroup cache show -vserver vs1 -netgroup netgroup1
Vserver  Netgroup   State
    -------- ---------- ------------
    vs1      netgroup1  Ready