Unix‎ > ‎Solaris‎ > ‎Solaris man pages‎ > ‎1m‎ > ‎

ippool


NAME
     ippool - user interface to the IP Filter pools

SYNOPSIS
     ippool -a [-dnv] [-m num] [-o role] -i ipaddr [/netmask]

     ippool -A [-dnv] [-m num] [-o role] [-S seed] [-t type]

     ippool -f file [-dnuv]

     ippool -F [-dv] [-o role] [-t type]

     ippool -l [-dv] [-m num] [-t type]

     ippool -r [-dnv] [-m num] [-o role] -i ipaddr [/netmask]

     ippool -R [-dnv] [-m num] [-o role] [-t type]

     ippool -s [-dtv] [-M core] [-N namelist]

DESCRIPTION
     The ippool utility is used to manage information  stored  in
     the  IP pools subsystem of IP Filter software. Configuration
     file information can be parsed and loaded  into  the  kernel
     and  currently  configured pools can be removed, changed, or
     inspected.

     ippool's use is restricted through  access  to  /dev/ippool.
     The  default permissions of /dev/ippool require ippool to be
     run as root for all operations.

     The command line options used are divided into two sections:
     the global options and the instance-specific options.

     ippool's use is restricted through  access  to  /dev/ipauth,
     /dev/ipl, and /dev/ipstate. The default permissions of these
     files require ippool to be run as root for all operations.

OPTIONS
     ippool supports the option categories described below.

  Global Options
     The following global options are supported:

     -d

         Toggle debugging of processing the configuration file.



     -n

         Prevents ippool from  doing  anything,  such  as  making
         ioctl calls, that would alter the currently running ker-
         nel.



     -v

         Turn verbose mode on.



  Instance-Specific Options
     The following instance-specific options are supported:

     -a

         Add a new data node to an existing pool in the kernel.



     -A

         Add a new (empty) pool to the kernel.



     -f file

         Read in IP pool configuration information from file  and
         load it into the kernel.



     -F

         Flush loaded pools from the kernel.



     -l

         Display a list of pools currently loaded into  the  ker-
         nel.



     -r

         Remove an existing data node from a pool in the kernel.


     -R

         Remove an existing pool from within the kernel.



     -s

         Display IP pool statistical information.



  Other Options
     The following, additional options are supported:

     -i ipaddr[/netmask]

         Sets the IP address for the operation  being  undertaken
         with  an  all-one's mask or, optionally, a specific net-
         mask, given in either dotted-quad notation or as a  sin-
         gle integer.



     -m poolname

         Sets the pool name for the current operation.



     -M core

         Specify an alternative path to /dev/kmem from  which  to
         retrieve statistical information.



     -N namelist

         Specify an alternative path to lookup symbol name infor-
         mation when retrieving statistical information.



     -o role

         Sets the role with  which  this  pool  is  to  be  used.
         Currently  only  ipf,  auth,  and  count are accepted as
         arguments to this option.



     -S seed

         Sets the hashing seed to the number specified.  For  use
         with hash-type pools only.



     -t type

         Sets the type of pool being  defined.  Must  be  one  of
         pool, hash, or group-map.



     -u

         When parsing a configuration file, rather than load  new
         pool data into the kernel, unload it.



FILES
     /dev/ippool

         Link to IP Filter pseudo device.



     /dev/kmem

         Special file that provides  access  to  virtual  address
         space.



     /etc/ipf/ippool.conf

         Location of ippool startup configuration file.



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








     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWipfu                    |
    |_____________________________|_____________________________|
    | Interface Stability         | Evolving                    |
    |_____________________________|_____________________________|


SEE ALSO
     ipf(1M), ipfstat(1M), ippool(4), attributes(5)

NOTES
     To view license terms, attribution,  and  copyright  for  IP
     Filter,  the  default path is /usr/lib/ipf/IPFILTER.LICENCE.
     If the Solaris operating environment has been installed any-
     where  other  than  the  default,  modify  the given path to
     access the file at the installed location.










Man pages from Solaris 10 Update 8. See docs.sun.com and www.oracle.com for further documentation and Solaris information.
Comments