7.3.55. shutdown — Groonga v7.0.6 documentation

# groonga - An open-source fulltext search engine and column store.

- 日本語

# 7.3.55. `shutdown`

## 7.3.55.1. Summary

`shutdown` stops the Groonga server process.

`shutdown` uses graceful shutdown by default. If there are some running commands, the Groonga server process stops after these running commands are finished. New command requests aren't processed after `shutdown` command is executed.

New in version 6.0.1: `shutdown` uses immediate shutdown by specifying `immediate` to `mode` parameter. The Groonga server process stops immediately even when there are some running commands.

Note

You need to set Request ID to all requests to use immediate shutdown.

## 7.3.55.2. Syntax

This command takes only one optional parameter:

    shutdown [mode=graceful]

## 7.3.55.3. Usage

`shutdown` use graceful shutdown by default:

Execution example:

    shutdown
    # [[0, 1337566253.89858, 0.000355720520019531], true]

You can specify `graceful` to `mode` parameter explicitly:

Execution example:

    shutdown --mode graceful
    # [[0, 1337566253.89858, 0.000355720520019531], true]

You can choose immediate shutdown by specifying `immediate` to `mode` parameter:

Execution example:

    shutdown --mode immediate
    # [[0, 1337566253.89858, 0.000355720520019531], true]

Immediate shutdown is useful when you don't have time for graceful shutdown. For example, Windows kills service that takes long time to stop on Windows shutdown.

## 7.3.55.4. Parameters

This section describes parameters of this command.

### 7.3.55.4.1. Required parameters

There is no required parameter.

### 7.3.55.4.2. Optional parameters

There are optional parameters.

#### 7.3.55.4.2.1. `mode`

Specifies shutdown mode. Here are available shutdown modes:

Value | Description
--- | ---
`graceful` | Stops after running commands are finished. This is the default.
`immediate` | New in version 6.0.1: Stops immediately even if there are some running commands.

## 7.3.55.5. Return value

`shutdown` returns `true` as body when shutdown is accepted:

    [HEADER, true]

If `shutdown` doesn't accept shutdown, error details are in `HEADER`.

See Output format for `HEADER`.