Skip to main content

vserver fpolicy policy event show

Contributors
Suggest changes

Display events

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

Description

The vserver fpolicy policy event show command displays information about all FPolicy events belonging to the Vserver. Any Vserver administrator can see FPolicy events associated with their Vserver as well as FPolicy events created by the cluster administrator. The command output depends on the parameter or parameters specified with the command. If you do not specify any parameters, the command displays the following information about all FPolicy events:

  • Vserver name

  • FPolicy event name

  • Protocol name

  • List of file operations

  • List of filters

  • Volume operation

  • Monitor failed file operation

You can specify the -fields parameter to specify which fields of information to display about FPolicy events. You can specify additional parameters to display only information that matches those parameters. For example, to display information only about all CIFS events configured with the -volume-operation field set, run the command with the -fields parameter set to -event-name event-name -protocol`cifs-volume-operation`yes .

You can specify the -instance parameter to display all information for all policies in a list format.

Parameters

{ [-fields <fieldname>,…​]

If you specify the -fields <fieldname>, …​ parameter, the command only displays the fields that you specify.

| [-instance ] }

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

[-vserver <Vserver Name>] - Vserver

If you specify this parameter, the command displays information only about the FPolicy events for the specified Vserver. Events created on the admin Vserver by the cluster administrator are visible in all Vservers.

[-event-name <Event name>] - Event

If you specify this parameter, the command displays information only about the FPolicy event that matches the specified event name.

[-protocol <Protocol>] - Protocol

If you specify this parameter, the command displays information only about the FPolicy event or events that use the specified protocol.

[-file-operations <File Operation>,…​] - File Operations

If you specify this parameter, the command displays information only about the FPolicy event or events that use the specified file operation or operations.

[-filters <Filter>,…​] - Filters

If you specify this parameter, the command displays information only about the FPolicy event or events that use the specified filter or filters.

[-volume-operation {true|false}] - Send Volume Operation Notifications

If this field is set to true , then FPolicy displays information about those events for which it sends notifications when volumes are mounted or unmounted. If you set this parameter to true , the command displays information about events where the -volume-operation parameter is set true and volume operations such as mount and unmount are monitored. If you set this parameter to false , the command displays information about events where volume operations are not monitored.

[-monitor-fileop-failure {true|false}] - Send Failed File Operation Notifications

If you specify this parameter, the command displays information only about the FPolicy event or events that has -monitor-fileop-failure parameter set to the specified value.

Examples

The following example displays the information about all Vserver FPolicy policy events.

cluster1::> vserver fpolicy policy event show
                                Event                        File                        Volume
                Vserver         Name               Protocols Operations    Filters      Operation
                --------------- ------------------ --------- ------------- ------------ ------------
                Cluster         cserver_evt        cifs      open, close,  first-write, true
                                                             read, write   first-read
                vs1.example.com cserver_evt        cifs      open, close,  first-write, true
                                                             read, write   first-read
                vs1.example.com v1e1               cifs      open, read    first-read   -
                vs1.example.com v1e2               cifs      open          -            false
                vs1.example.com v1e3               nfsv4     open          -            true
                vs2.example.com cserver_evt        cifs      open, close,  first-write, true
                                                             read, write   first-read
                6 entries were displayed.

The following example displays event name information about all Vserver FPolicy policy events with CIFS as a protocol and with false as volume operation.

cluster1::> vserver fpolicy policy event show -fields event-name -protocol cifs -volume-operation false
               vserver         event-name
               --------------- ----------
               vs1.example.com v1e2