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
.