core-lightning/doc/lightning-autoclean-once.7.md
Rusty Russell eb6b8551d4 tools/fromschema.py: don't try to handle more complex cases.
We only handle top-level objects with an array of objects:
make sure it is one before we call the routines.

Signed-off-by: Rusty Russell <rusty@rustcorp.com.au>
2023-01-30 15:15:41 -06:00

71 lines
2.7 KiB
Markdown

lightning-autoclean-once -- A single deletion of old invoices/payments/forwards
===============================================================================
SYNOPSIS
--------
**autoclean-once** *subsystem* *age*
DESCRIPTION
-----------
The **autoclean-once** RPC command tell the `autoclean` plugin to do a
single sweep to delete old entries. This is a manual alternative (or
addition) to the various `autoclean-...-age` parameters which
cause autoclean to run once per hour: see lightningd-config(5).
The *subsystem*s currently supported are:
* `failedforwards`: routed payments which did not succeed (`failed` or `local_failed` in listforwards `status`).
* `succeededforwards`: routed payments which succeeded (`settled` in listforwards `status`).
* `failedpays`: payment attempts which did not succeed (`failed` in listpays `status`).
* `succededpays`: payment attempts which succeeded (`complete` in listpays `status`).
* `expiredinvoices`: invoices which were not paid (and cannot be) (`expired` in listinvoices `status`).
* `paidinvoices`: invoices which were paid (`paid` in listinvoices `status).
*age* is a non-zero number in seconds.
RETURN VALUE
------------
[comment]: # (GENERATE-FROM-SCHEMA-START)
On success, an object containing **autoclean** is returned. It is an object containing:
- **succeededforwards** (object, optional):
- **cleaned** (u64): total number of deletions done this run
- **uncleaned** (u64): the total number of entries *not* deleted this run
- **failedforwards** (object, optional):
- **cleaned** (u64): total number of deletions done this run
- **uncleaned** (u64): the total number of entries *not* deleted this run
- **succeededpays** (object, optional):
- **cleaned** (u64): total number of deletions done this run
- **uncleaned** (u64): the total number of entries *not* deleted this run
- **failedpays** (object, optional):
- **cleaned** (u64): total number of deletions done this run
- **uncleaned** (u64): the total number of entries *not* deleted this run
- **paidinvoices** (object, optional):
- **cleaned** (u64): total number of deletions done this run
- **uncleaned** (u64): the total number of entries *not* deleted this run
- **expiredinvoices** (object, optional):
- **cleaned** (u64): total number of deletions done this run
- **uncleaned** (u64): the total number of entries *not* deleted this run
[comment]: # (GENERATE-FROM-SCHEMA-END)
AUTHOR
------
Rusty Russell <<rusty@rustcorp.com.au>> is mainly responsible.
SEE ALSO
--------
lightningd-config(5), lightning-autoclean-status(7)
RESOURCES
---------
Main web site: <https://github.com/ElementsProject/lightning>
[comment]: # ( SHA256STAMP:1f2819ff0d1a246efbe6dbd027083cb9c6dc0eedb4c7e44ead5d399c5fda07d4)