Manual Pages for UNIX Operating System command usage for man inetadm

System Administration Commands                        inetadm(1M)



NAME
     inetadm - observe or configure inetd-controlled services

SYNOPSIS
     inetadm


     inetadm -?


     inetadm -p


     inetadm -l {FMRI | pattern}


     inetadm -e {FMRI | pattern}


     inetadm -d {FMRI | pattern}


     inetadm -m {FMRI | pattern}... {name=value}...


     inetadm -M {name=value}...


DESCRIPTION
     The inetadm utility provides the following capabilities  for
     inetd-managed SMF services:

         o    Provides a list of all such services installed.

         o    Lists the services' properties and values.

         o    Allows enabling and disabling of services.

         o    Allows  modification   of   the   services'property
              values,  as  well as the default values provided by
              inetd.


     See smf(5) for a description of an SMF service.


     With  no  arguments,  inetadm  lists  all   services   under
     inetd(1M)   control,  including  such  attributes  as  their
     current run state and whether or not they are enabled.

OPTIONS




SunOS 5.11           Last change: 5 Jul 2007                    1






System Administration Commands                        inetadm(1M)



     For options taking one or more FMRI operands (see smf(5) for
     a  description  of an FMRI), if the operand specifies a ser-
     vice (instead of a service instance), and that  service  has
     only a single instance, inetadm operates on that instance.


     If a service name is supplied and it contains more than  one
     instances  or  a pattern is supplied and and it matches more
     than one instance, a warning message is displayed  and  that
     operand is ignored.


     For those options taking name=value parameters,  a  descrip-
     tion of each of the possible names and the allowed values is
     found in the inetd(1M) man page.


     The following options are supported:

     -?

         Display a usage message.


     -p

         Lists all default inet service property values  provided
         by  inetd  in the form of name=value pairs. If the value
         is of boolean type, it is listed as TRUE or FALSE.


     -l {FMRI | pattern}...

         List all properties for the specified service  instances
         as  name=value pairs. In addition, if the property value
         is inherited from the default value provided  by  inetd,
         the   name=value   pair   is  identified  by  the  token
         (default). Property inheritance occurs  when  properties
         do not have a specified service instance default.


     -e {FMRI | pattern}...

         Enable the specified service instances.


     -d {FMRI | pattern}...

         Disable the specified service instances.






SunOS 5.11           Last change: 5 Jul 2007                    2






System Administration Commands                        inetadm(1M)



     -m {FMRI | pattern}...{name=value}...

         Change the values of the  specified  properties  of  the
         identified  service  instances. Properties are specified
         as whitespace-separated name=value pairs. To  remove  an
         instance-specific value and accept the default value for
         a property, simply specify the property without a value,
         for example, name= .


     -M {name=value}...

         Change the values of the specified inetd default proper-
         ties.  Properties  are specified as whitespace-separated
         name=value pairs.


EXAMPLES
     Example 1 Displaying Properties for a Service


     The following command displays the properties for the  spray
     service.


       # inetadm -l network/rpc/spray:default
       SCOPE    NAME=VALUE
                name="sprayd"
                endpoint_type="tli"
                proto="datagram_v"
                isrpc=TRUE
                rpc_low_version=1
                rpc_high_version=1
                wait=TRUE
                exec="/usr/lib/netsvc/spray/rpc.sprayd"
                user="root"
       default  bind_addr=""
       default  bind_fail_max=-1
       default  bind_fail_interval=-1
       default  max_con_rate=-1
       default  max_copies=-1
       default  con_rate_offline=-1
       default  failrate_cnt=40
       default  failrate_interval=60
       default  inherit_env=TRUE
       default  tcp_trace=FALSE
       default  tcp_wrappers=FALSE
       default  connection_backlog=10


     Example 2 Displaying Default Properties




SunOS 5.11           Last change: 5 Jul 2007                    3






System Administration Commands                        inetadm(1M)



     The following command displays default properties.


       # inetadm -p
       NAME=VALUE
       bind_addr=""
       bind_fail_max=-1
       bind_fail_interval=-1
       max_con_rate=-1
       max_copies=-1
       con_rate_offline=-1
       failrate_cnt=40
       failrate_interval=60
       inherit_env=TRUE
       tcp_trace=FALSE
       tcp_wrappers=FALSE
       default  connection_backlog=10


     Example 3 Changing Property Values for a Service


     The following command  changes  rpc_high_version  to  3  and
     tcp_trace to TRUE for the spray service.


       # inetadm -m network/rpc/spray:default \
                rpc_high_version=3 tcp_trace=TRUE
       # inetadm -l network/rpc/spray:default
       SCOPE    NAME=VALUE
                name="sprayd"
                endpoint_type="tli"
                proto="datagram_v"
                isrpc=TRUE
                rpc_low_version=1
                rpc_high_version=3
                wait=TRUE
                exec="/usr/lib/netsvc/spray/rpc.sprayd"
                user="root"
       default  bind_addr=""
       default  bind_fail_max=-1
       default  bind_fail_interval=-1
       default  max_con_rate=-1
       default  max_copies=-1
       default  con_rate_offline=-1
       default  failrate_cnt=40
       default  failrate_interval=60
       default  inherit_env=TRUE
                tcp_trace=TRUE
       default  tcp_wrappers=FALSE
       default  connection_backlog=10




SunOS 5.11           Last change: 5 Jul 2007                    4






System Administration Commands                        inetadm(1M)



EXIT STATUS
     The following exit values are returned:

     0    Operation completed successfully.


     1    A fatal error occurred. An accompanying  error  message
          will provide further information.


     2    Invalid arguments were supplied, such as  an  ambiguous
          service FMRI or pattern.


ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWcs                      |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|


SEE ALSO
     inetd(1M), svccfg(1M), attributes(5), smf(5)
























SunOS 5.11           Last change: 5 Jul 2007                    5