From 843ac3ce12956c8193da4c816114a502e1a7bc7c Mon Sep 17 00:00:00 2001 From: circulosmeos Date: Sun, 4 Jul 2021 22:40:44 +0200 Subject: [PATCH] v1.2 --- README.md | 10 +++++++--- configure.ac | 2 +- gztool.1 | 12 ++++++++++-- 3 files changed, 18 insertions(+), 6 deletions(-) diff --git a/README.md b/README.md index e214aa2..d29a651 100644 --- a/README.md +++ b/README.md @@ -98,14 +98,14 @@ Copy gztool.c to the directory where you compiled zlib, and do: Usage ===== - gztool (v1.1.1) + gztool (v1.2) GZIP files indexer, compressor and data retriever. Create small indexes for gzipped files and use them for quick and random-positioned data extraction. No more waiting when the end of a 10 GiB gzip is needed! //github.com/circulosmeos/gztool (by Roberto S. Galende) - $ gztool [-[abLnsv] #] [-cCdDeEfFhilpPStTwWxX|u[cCdD]] [-I ] ... + $ gztool [-[abLnsv] #] [-cCdDeEfFhilpPrRStTwWxX|u[cCdD]] [-I ] ... Note that actions `-bcStT` proceed to an index file creation (if none exists) INTERLEAVED with data flow. As data flow and @@ -145,6 +145,10 @@ Usage -P: like `-p`, but when used with `-[ST]` implies that checking for errors in stream is made as quick as possible as the gzip file grows. Warning: this may lead to some errors not being patched. + -r #: number of bytes to extract when using `-[bL]`. + Accepts '0', '0x', and suffixes 'kmgtpe' (^10) 'KMGTPE' (^2). + -R #: number of lines to extract when using `-[bL]`. + Accepts '0', '0x', and suffixes 'kmgtpe' (^10) 'KMGTPE' (^2). -s #: span in uncompressed MiB between index points when creating the index. By default is `10`. -S: Supervise indicated file: create a growing index, @@ -420,7 +424,7 @@ Other interesting links Version ======= -This version is **v1.1.1**. +This version is **v1.2**. Please, read the *Disclaimer*. In case of any errors, please open an [issue](https://github.com/circulosmeos/gztool/issues). diff --git a/configure.ac b/configure.ac index c5dfcf4..23484bf 100644 --- a/configure.ac +++ b/configure.ac @@ -1,4 +1,4 @@ -AC_INIT([gztool], [1.1.1], [roberto.s.galende@gmail.com]) +AC_INIT([gztool], [1.2], [roberto.s.galende@gmail.com]) AM_INIT_AUTOMAKE([-Wall -Werror foreign]) AC_PROG_CC AC_PROG_CC_C99 diff --git a/gztool.1 b/gztool.1 index 3ce33b3..6c6ec50 100644 --- a/gztool.1 +++ b/gztool.1 @@ -4,7 +4,7 @@ .\" First parameter, NAME, should be all caps .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection .\" other parameters are allowed: see man(7), man(1) -.TH gztool 1 "Feb 20 2021" "gztool v1.1" +.TH gztool 1 "Jul 04 2021" "gztool v1.2" .\" Please adjust this date whenever revising the manpage. .\" .\" Some roff macros, for reference: @@ -21,7 +21,7 @@ gztool \- extract random-positioned data from gzip files, even like `tail -f` .SH SYNOPSIS .B gztool -.RI \ [\ [-[abLnsv]\ #]\ [-cCdDeEfFhilpPStTwWxX|u[cCdD]]\ [-I\ ]\ ]\ "files"\ ... +.RI \ [\ [-[abLnsv]\ #]\ [-cCdDeEfFhilpPrRStTwWxX|u[cCdD]]\ [-I\ ]\ ]\ "files"\ ... .br Note that actions `-bcStT` proceed to an index file creation (if @@ -124,6 +124,14 @@ like `-p`, but when used with `-[ST]` implies that checking for errors in stream is made as quick as possible as the gzip file grows. Warning: this may lead to some errors not being patched. .TP +.BR \-r\ # +number of bytes to extract when using `-[bL]`. +Accepts '0', '0x', and suffixes 'kmgtpe' (^10) 'KMGTPE' (^2). +.TP +.BR \-R\ # +number of lines to extract when using `-[bL]`. +Accepts '0', '0x', and suffixes 'kmgtpe' (^10) 'KMGTPE' (^2). +.TP .BR \-s\ # span in uncompressed MiB between index points when creating the index. By default is `10`.