# S990FLTR.def: Controls Report Content Filtering # $Id: S990FLTR.def,v 1.9 2008/02/15 17:33:16 mschenke Exp $ # ARCS: $Header: /home/cvs/repository/RDA_4/src/scripting/lib/modules/S990FLTR.def,v 1.9 2008/02/15 17:33:16 mschenke Exp $ # # Change History # 20080215 MSC Improve the documentation. =head1 NAME S990FLTR - Control Report Content Filtering =head1 DESCRIPTION Adds filter functionality to RDA, which can mask sensitive data like host, domain, group and user names, IP addresses, LDAP domain components, and network masks. You can activate the filter by adding the C profile to your profile. For instance, -vdSCRP -p DB10g-Security RDA offers a default filter configuration based on the system configuration but end-users can create their own filter or they can customize the existing default filter. When the setup file exists already, enable the filter with the following command: -X Filter enable If the filter configuration is not performed, then default rules are created. The filter has a status flag (enabled or disabled), an ordered list of rule sets, limits, and substitution formats. When the filter is enabled, RDA applies each rule, in the specified order listed, to each generated report. Each rule set has one or more matching patterns, possible matching options, a substitution format, and a replacement string, which tells RDA what strings to find in the output and how to substitute them. The syntax for the filter commands is as follows: -X Filter ... =head1 FILTER MANAGEMENT COMMANDS =head2 ErdaE -X Filter add set EnameE [EdescriptionE] Adds a rule set. =over 4 =item * If the rule set already exists, then RDA moves the rule set to the end of the rule set list and resets the rule set description if present. =item * RDA adds a non-existing rule set to the end of the rule set list with a description if present. If the description is not present, then the rule set name is taken as the description. =back =head2 ErdaE -X Filter add pattern EnameE EpatternE Adds an extra pattern to an existing rule set. =head2 ErdaE -X Filter add format EnameE EsubstitutionE Adds a new substitution format to the filter. =head2 ErdaE -X Filter -f clear Clears all filtering, which means that filtering is disabled and that the whole filter definition is removed. =head2 ErdaE -X Filter delete format EnameE Deletes the substitution format. This works for user-defined substitution formats only. =head2 ErdaE -X Filter delete pattern EnameE EoffsetE Deletes a matching pattern from a rule set. Patterns are referenced by their offset (cf. the C command). =head2 ErdaE -X Filter delete set EnameE Deletes a rule set from the list of rule sets. =head2 ErdaE -X Filter disable Disables the filtering. =head2 ErdaE -X Filter enable Enables the filtering. When there is no existing rule set list, it also generates the default filter configuration based on the system configuration. =head2 ErdaE -X Filter export Prints out the entire current filter configuration. The output is a series of commands, which can be issued again to recreate the current filter (or parts of it) into another RDA setup. =head2 ErdaE -X Filter list formats Prints all internal and user-defined substitution formats. =head2 ErdaE -X Filter list set [EnameE] Displays the specified rule set and its component. When the name is omitted, all rule sets are reported. =head2 ErdaE -X Filter list sets Prints the ordered rule set list. =head2 ErdaE -X Filter -f reset Restores the default filter configuration. =head2 ErdaE -X Filter set format EsetE EformatE Specifies a format for this rule set. =head2 ErdaE -X Filter set options EsetE EoptionsE Defines pattern-matching options. Use C to ignore case. =head2 ErdaE -X Filter set string EsetE EstringE Sets the replacement string for this rule set. =head2 ErdaE -X Filter set gid [EminE] Defines the minimum group identifier value to consider when generating default filtering rules for groups on UNIX. When no argument is given, it resets it to the default value (101). =head2 ErdaE -X Filter set uid [EminE] Defines the minimum user identifier value to consider when generating default filtering rules for users on UNIX. When no argument is given, it resets it to the default value (101). =head2 ErdaE -X Filter [-d] test Tests the rules for a correct syntax. When the B<-d> option is used, the rules are printed to standard output. =head1 COPYRIGHT NOTICE Copyright (c) 2002-2008, Oracle. All rights reserved. =head1 TRADEMARK NOTICE Oracle, JD Edwards, PeopleSoft, and Siebel are registered trademarks of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners. =cut