extension (nrcmd)					extension (nrcmd)


NAME
    extension - Integrates user-written DHCP extensions into the DHCP server

SYNOPSIS
    extension list  
    extension listnames
    extension <name> create <lang> <file> <entry> [<attribute>=<value>...]
    extension <name> delete 
    extension <name> get <attribute>
    extension <name> set <attribute>=<value> [<attribute>=<value> ...]
    extension <name> unset <attribute> 
    extension <name> show

DESCRIPTION
    The extension command lets you configure extension modules. To
    extend the DHCP server with an extension module, you must do the
    following:
    
    1. Write the extension module in either Tcl, C or C++, and install
    it in the server scripts directory.
    
    2. Configure the DHCP server to recognize this extension, using
    this command. 
    
    3. Attach the configured extension to one or more DHCP script
    points using the dhcp attachExtension command.

EXAMPLES

    Create a tcl script, sample1, that does something.
    nrcmd> extension sample1 create tcl sample1.tcl sample_ext


STATUS

SEE ALSO

    dhcp AttachExtension

PROPERTIES
  Attributes:

    entry[5] (AT_STRING, Required, default: <none>)
        Identifies the entry point for the module.  This function is
        called from any extension point to which this module is bound.

    file[4] (AT_STRING, Required, default: <none>)
        Provides the filename relative to the directory extensions in the
        installation, or as an absolute pathname, but this cannot contain
        a sequence of two dots (..).

    init-args[7] (AT_STRING, Optional, default: <none>)
        Describes the arguments that should be passed to the init-entry
        point function. The arguments are passed in the environment
        dictionary using the key "Arguments".

    init-entry[6] (AT_STRING, Optional, default: <none>)
        Specifies the  name of the init entry point. If  set, the server
        calls this function when the server loads the module.

    lang[2] (AT_ENUMSTR(), Optional, default: <none>)
        Describes the language in which the script or module is implemented.
        'Tcl' indicates that the module is a Tcl script (tcl8.4). 'Dex'
        indicates that the module is a shared object with C calling
        interfaces.

    name[1] (AT_STRING, Required, default: <none>)
        Designates the script or module. The DHCP server uses
        this name to assign scripts or modules to script points.

