admpppdial(1M)                   DG/UX R4.11                  admpppdial(1M)


NAME
       admpppdial - manage pppdialinfo database

SYNOPSIS
       admpppdial -o add -s 'send-expect-string' dialsystem

       admpppdial -o modify [ -n newdialsystem ] [ -s 'send-expect-string' ]
       dialsystem

       admpppdial -o delete dialsystem

       admpppdial -o list [ -qv ] [ dialsystem ... ]

   where:
       send-expect-string
                   A white-space delimited series of strings that are sent
                   to the modem (port) and received in response
       dialsystem  The name of an entry in the pppdialinfo database
       newdialsystem
                   The new name to assign to an entry in the pppdialinfo
                   database

DESCRIPTION
       Admpppdial manages the /etc/pppdialinfo database.  This database
       contains the PPP send-expect dialstrings utilized by pppd(1C).

   Operations
       add    Create a new pppdialinfo entry.

       modify Change an existing pppdialinfo entry.

       delete Remove an entry from the pppdialinfo database.

       list   List one or more entries from the pppdialinfo database.
              Information is listed about each of the dialsystems given; if
              dialsystem is unspecified, information about all entries is
              listed.

   Options
       -s send-expect-string
              Specify strings to be sent to the modem (port) and received in
              response to establish a remote asynchronous connection.  send-
              expect-string must be enclosed in single quote marks ('') to
              avoid special shell interpretation.

       -n newdialsystem
              Specify the new dialsystem name to assign to an existing
              pppdialinfo entry.

       -q     Behave "quietly," producing an unformatted listing.  Print no
              headers and no comments, print each entry on a separate line,
              and delimit fields within an entry with a single space
              character.

       -v     Behave verbosely, producing a formatted listing with headers
              and aligned columns.  This is the default.

   Output
       The list operation writes its output to stdout.

       The verbose form of the list operation outputs a header and the send-
       expect-strings for each dialsystem name.  Comments contained in the
       /etc/pppdialinfo database are suppressed.  Information is printed in
       aligned columns with column headers.

       If -q option is specified with the list operation, headers and
       comments are suppressed and each entry is printed on a separate line.
       The fields within the entry are delimited by a single space, and are
       in the following order:

                         dialsystem    send-expect-string

EXAMPLES
       To add dial-out/initialization information for a user named Smith:

       admpppdial -o add -s \
       'ATDT1234 CON \r ogin: name word: pswd $ exec\spppd' smith

       To change the dialsystem name from smith to jones:

       admpppdial -o modify -n jones smith

FILES
       /etc/pppdialinfo  Local PPP dialer database file.

DIAGNOSTICS
   Warnings
       None.

   Errors
       ·    The add operation is requested, and dialsystem already exists in
            the pppdialinfo database.

       ·    The delete or modify operation is requested, and dialsystem does
            not exist in the pppdialinfo database.

   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
       pppd(1C), sysadm(1M), pppdialinfo(4M), cap_defaults(5).

NOTES
       You must have write permission to the pppdialinfo database to use the
       add, delete, and modify operations.  To have such permission, you
       must have appropriate privilege, which, on a generic DG/UX system,
       means that you have superuser privilege, or an effective UID of root.
       See the appropriate_privilege(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
       cap_defaults(5) for the default capabilities for this command.


Licensed material--property of copyright holder(s)