Skip to content

lc command reference manual

$sub1(intro.md) $sub1(options.md)

Commands

The following commands are accepted by lc:

$sub2(md.md) $sub2(info.md) $sub2(admin.md)

Concepts

$sub2(../../../shared.in/lumina/concepts/lumina.md)

Commands

String patterns

Options that take strings as inputs can be enhanced through wildcards. The following wildcards are available:

%\ represents zero, one or multiple characters.

_\ represents one character.

To use wildcards in a string, it must be prefixed with like: e.g. -n like:%main%.

Timerange formats

For timeranges, the following syntaxes are supported:

  • <ts>..<ts> (from timestamp to (but not including) timestamp)
  • <ts> (only one timestamp)

Where <ts> can be of the form:

  • yyyy-mm-dd HH:MM:SS: e.g., 2022-09-12 11:38:22
  • yyyy-mm-dd: e.g., 2020-03-12
  • +|-<count><unit>: this is a "now-relative" timestamp, where <unit> must be one of w, d, H, M, S for weeks, days, hours, minutes or seconds respectively. E.g., -4d, +5w, -8H, +1H, …​

when using the <ts> syntax (i.e., only 1 timestamp is provided, not an actual range), the final range will be either "from now to \", or "from \ to now", depending on whether <ts> is before, or after, the present time.

Speed of retrieving changes

Although it may seem like a simple operation, lc hist show is actually a very demanding one: by default it will have to fetch bits of information from multiple tables (e.g., in order to provide information about which change was superseded by a later one.)

This can be significantly sped up through the use of --last-change: this option lets the server issue a much simpler query, resulting in significantly reduced processing time.