From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on dcvr.yhbt.net X-Spam-Level: X-Spam-ASN: X-Spam-Status: No, score=-4.2 required=3.0 tests=ALL_TRUSTED,BAYES_00, DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF, T_SCC_BODY_TEXT_LINE shortcircuit=no autolearn=ham autolearn_force=no version=3.4.2 Received: from localhost (dcvr.yhbt.net [127.0.0.1]) by dcvr.yhbt.net (Postfix) with ESMTP id F10181F54E; Fri, 9 Sep 2022 18:01:50 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=80x24.org; s=selector1; t=1662746511; bh=NWkCXWzWK9HXqEaB4Pf1lfhqffgFGdzMJhzD/iRavUY=; h=Date:From:To:Cc:Subject:References:In-Reply-To:From; b=z+RXbrc87+qOQbaNgNHVSb/mP+u2RDynUlvbQ4058jjF91hij6XNCcFNkwMDX4yrH bN9EgfRdtfvZQGSH0KKkEORdxl9fYEtH1vYgr1MHmn3T3tuoTh78Cz2Dfod39Nuv9n yWTHj5Sk4weL5Z0ih6hrNdlCgfCDar2HXWX1QyvA= Date: Fri, 9 Sep 2022 18:00:36 +0000 From: Eric Wong To: meta@public-inbox.org Cc: Ricardo Ribalda Subject: [PATCH] doc: document --jobs for `lei q' and `lei up' Message-ID: <20220909180036.M255226@dcvr> References: <20220909174410.M560915@dcvr> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Disposition: inline In-Reply-To: <20220909174410.M560915@dcvr> List-Id: Eric Wong wrote: > There's also another patch coming to document the `--jobs|-j' CLI > switch for `lei up' and `lei q', but trying `-j ,1' may help you > if it's parallelism. Note the comma before `1', it accepts > `-j $Q,$W' since $Q is the number of query processes and $W is > the number of LeiToMail writers. -------8<----- From: Eric Wong Subject: [PATCH] doc: document --jobs for `lei q' and `lei up' These may be helpful for users on slow disks or limited IMAP connections. --- Documentation/lei-q.pod | 17 +++++++++++++++++ Documentation/lei-up.pod | 4 +++- 2 files changed, 20 insertions(+), 1 deletion(-) diff --git a/Documentation/lei-q.pod b/Documentation/lei-q.pod index 2f0c3bc6..8134223e 100644 --- a/Documentation/lei-q.pod +++ b/Documentation/lei-q.pod @@ -124,6 +124,23 @@ of the same thread. TODO: Warning: this flag may become persistent and saved in lei/store unless an MUA unflags it! (Behavior undecided) +=item --jobs=QUERY_WORKERS[,WRITE_WORKERS] +=item --jobs=,WRITE_WORKERS + +=item -j QUERY_WORKERS[,WRITE_WORKERS] +=item -j ,WRITE_WORKERS + +Set the number of query and write worker processes for parallelism. + +C defaults to the number of CPUs available, but 4 per +remote (HTTP/HTTPS) host. + +C defaults to the number of CPUs available for Maildir, +IMAP/IMAPS, and mbox* destinations. + +Omitting C but leaving the comma (C<,>) allows +one to only set C + =item --dedupe=STRATEGY =item -d STRATEGY diff --git a/Documentation/lei-up.pod b/Documentation/lei-up.pod index ac644a96..3b7c6f46 100644 --- a/Documentation/lei-up.pod +++ b/Documentation/lei-up.pod @@ -64,7 +64,9 @@ specified via C. =item --mua=CMD -C<--lock>, C<--alert>, and C<--mua> are all supported and +=item --jobs QUERY_WORKERS[,WRITE_WORKERS] + +C<--lock>, C<--alert>, C<--mua>, and C<--jobs> are all supported and documented in L. C<--mua> is incompatible with C<--all>.