reportscheme(1M)                                    reportscheme(1M)


       NAME
             reportscheme - give authentication scheme information to
             client applications

       SYNOPSIS
             /usr/sbin/reportscheme [-d]

       DESCRIPTION
             The reportscheme command is a non-standing network service
             that tells client machine applications what authentication
             scheme to use for a specified network service.  The
             reportscheme service must exist on each port monitor that
             offers network services if the server wishes to enforce
             authentication scheme invocation.

             The Connection Server invokes the reportscheme service on the
             server machine on behalf of client applications and sends the
             name of the requested network service to be executed.  On the
             server side, reportscheme receives the name of the network
             service, searches the current transport's _pmtab database and
             finds the first entry for the specified network service.  If
             the service is not listed in the _pmtab file, reportscheme
             returns an error.  The Connection Server will then fail the
             connection request for the network service over the current
             transport.  If the service is found in the _pmtab file but no
             authentication information is listed, a NULL authentication
             scheme is assumed.

          Files
             /usr/sbin/reportscheme
             /etc/saf/pmtag/_pmtab

          Output
             reportscheme returns the following information:

                   the name of the authentication scheme for the requested
                   network service on the current port monitor

                   an indication of whether the network service will invoke
                   the authentication scheme as the imposer or the
                   responder

       USAGE
             Since reportscheme is used to report authentication schemes,
             there can be no authentication scheme associated with
             reportscheme itself.  If there were, client machines would not


                           Copyright 1994 Novell, Inc.               Page 1

      reportscheme(1M)                                    reportscheme(1M)


            be able to invoke the reportscheme service.

         Options
            -d    Turn on debugging.  All debugging information is written
                  to /var/adm/log/cs.debug.  The debugging information
                  related to reportscheme begins with an rs: tag.

         Examples
            The following shows a reportscheme entry from a sample _pmtab
            file.  reportscheme itself may not have an authentication
            scheme name in the scheme field of the _pmtab file, that is,
            it is always executed with a NULL authentication scheme.  A
            line similar to this must appear in the _pmtab file of every
            port monitor that the Connection Server expects to connect to.
            If the reportscheme service is not entered in a port monitor's
            _pmtab file, a NULL authentication scheme is assumed for all
            services under that port monitor.  The following represents a
            single, one-line entry in the _pmtab file; it is broken here
            so that it can be printed on the page.
            reportscheme::root:reserved:reserved::\x00020b02c00b6c180000000000000000
             /usr/sbin/reportscheme#

      REFERENCES
            cs_connect(3N), dial(3N)
























                          Copyright 1994 Novell, Inc.               Page 2