admpf(1M)                      DG/UX R4.11MU05                     admpf(1M)


NAME
       admpf - manage the protocol file

SYNOPSIS
       admpf -o add [ -iqv ] package ...

       admpf -o delete [ -iqv ] package ...

       admpf -o list [ -npq ]


DESCRIPTION
       admpf manages the protocol file, /usr/etc/tcpdump.d/pf.  The protocol
       file consists of information required to recognize and decode
       protocol packets.  Packages of protocols can be added, deleted, and
       listed with this command.

   Operations
       add       Adds one or more packages to the protocol file.  Only a
                 user with appropriate privilege can perform this operation.

       delete    Removes one or more packages from the protocol file.  Only
                 a user with appropriate privilege can perform this
                 operation.

       list      By default, lists all packages added to the protocol file.
                 Other types of lists are printed, depending upon the option
                 that is used.

   Options
       -i        The interactive form of the add and delete operations
                 prompt the user before adding or deleting a package.  By
                 default, the user is not prompted.

       -n        The negative form of the list operation lists all packages
                 that are loaded but have not been added to the protocol
                 file.

       -p        The protocol form of the list operation prints a heirarchy
                 of all protocols which are described by the added packages.
                 The output is of the form:

                     proto: nested-list

                 where each protocol in the nested-list can directly follow
                 a proto protocol header.

       -q        The quiet option negates the verbose option.  The quiet
                 form of the list operation suppresses the printing of a
                 list's title.  By default, a title is printed.

       -v        The verbose form of the add and delete operations prints a
                 message if the operation completes successfully; otherwise,
                 nothing is printed unless an error occurs.


EXAMPLES
       In these examples, the system administrator performs the following
       actions: lists the packages which have been added to the protocol
       file; lists the packages which are loaded but have not been added to
       the protocol file; adds the package foo-package to the protocol file.

           admpf -o list
           admpf -o list -n
           admpf -o add foo-package


FILES
       /usr/etc/tcpdump.d/pf
                 The protocol file.


DIAGNOSTICS
   Warnings
        -  The add operation is requested but the package has already been
           added.

   Errors
        -  The add or delete operation is requested by a process without
           appropriate privilege.

        -  The add operation is requested, but an error is detected in the
           package to be added.

   Exit Codes
        0     The operation was successful.

        1     The operation was unsuccessful.

        2     The operation failed due to access restrictions.

        3     There was an error in the command line.

SEE ALSO
       tcpdump(1) capdefaults(5)

NOTES
       On a generic DG/UX system, appropriate privilege means that you have
       superuser privilege, or an effective UID of root.  See the
       appropriateprivilege(5) man page for more information.

       On a system that supports the DG/UX Capability option, appropriate
       privilege is defined as having one one or more specific capabilities
       enabled in the effective capability set of the user.  See
       capdefaults(5) for the default capabilities for this command.


Licensed material--property of copyright holder(s)