rgb-cln/doc/lightning-autoclean-status....

95 lines
3.3 KiB
Markdown
Raw Permalink Normal View History

lightning-autoclean-status -- Examine auto-delete of old invoices/payments/forwards
===================================================================================
SYNOPSIS
--------
**autoclean-status** [*subsystem*]
DESCRIPTION
-----------
The **autoclean-status** RPC command tells you about the status of
the autclean plugin, optionally for only one subsystem.
The subsystems 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).
RETURN VALUE
------------
Note that the ages parameters are set by various `autoclean-...-age`
parameters in your configuration: see lightningd-config(5).
[comment]: # (GENERATE-FROM-SCHEMA-START)
On success, an object containing **autoclean** is returned. It is an object containing:
- **succeededforwards** (object, optional):
- **enabled** (boolean): whether autocleaning is enabled for successful listforwards
- **cleaned** (u64): total number of deletions done (ever)
If **enabled** is *true*:
- **age** (u64): age (in seconds) to delete successful listforwards
- **failedforwards** (object, optional):
- **enabled** (boolean): whether autocleaning is enabled for failed listforwards
- **cleaned** (u64): total number of deletions done (ever)
If **enabled** is *true*:
- **age** (u64): age (in seconds) to delete failed listforwards
- **succeededpays** (object, optional):
- **enabled** (boolean): whether autocleaning is enabled for successful listpays/listsendpays
- **cleaned** (u64): total number of deletions done (ever)
If **enabled** is *true*:
- **age** (u64): age (in seconds) to delete successful listpays/listsendpays
- **failedpays** (object, optional):
- **enabled** (boolean): whether autocleaning is enabled for failed listpays/listsendpays
- **cleaned** (u64): total number of deletions done (ever)
If **enabled** is *true*:
- **age** (u64): age (in seconds) to delete failed listpays/listsendpays
- **paidinvoices** (object, optional):
- **enabled** (boolean): whether autocleaning is enabled for paid listinvoices
- **cleaned** (u64): total number of deletions done (ever)
If **enabled** is *true*:
- **age** (u64): age (in seconds) to paid listinvoices
- **expiredinvoices** (object, optional):
- **enabled** (boolean): whether autocleaning is enabled for expired (unpaid) listinvoices
- **cleaned** (u64): total number of deletions done (ever)
If **enabled** is *true*:
- **age** (u64): age (in seconds) to expired listinvoices
[comment]: # (GENERATE-FROM-SCHEMA-END)
AUTHOR
------
Rusty Russell <<rusty@rustcorp.com.au>> is mainly responsible.
SEE ALSO
--------
lightningd-config(5), lightning-listinvoices(7),
lightning-listpays(7), lightning-listforwards(7).
RESOURCES
---------
Main web site: <https://github.com/ElementsProject/lightning>
[comment]: # ( SHA256STAMP:0d997b9f41940245f25d5eb8ce9b9678c305bbdd3941cd17a1b2ba4c7d42310b)