7.3.51. register

Deprecated since version 5.0.1: Use plugin_register instead.

7.3.51.1. Summary

register command registers a plugin. You need to register a plugin before you use a plugin.

You need just one register command for a plugin in the same database because registered plugin information is written into the database. When you restart your groonga process, groonga process loads all registered plugins without register command.

Note

Registered plugins can be removed since Groonga 5.0.1. Use plugin_unregister in such a case.

7.3.51.2. Syntax

This command takes only one required parameter:

register path

7.3.51.3. Usage

Here is a sample that registers QueryExpanderTSV query expander that is included in ${PREFIX}/lib/groonga/plugins/query_expanders/tsv.so.

Execution example:

register query_expanders/tsv
# [[0, 1337566253.89858, 0.000355720520019531], true]

You can omit ${PREFIX}/lib/groonga/plugins/ and suffix (.so). They are completed automatically.

You can specify absolute path such as register /usr/lib/groonga/plugins/query_expanders/tsv.so.

7.3.51.4. Return value

register returns true as body on success such as:

[HEADER, true]

If register fails, error details are in HEADER.

See Output format for HEADER.

7.3.51.5. See also