Commit to release date.

Reviewed-on: https://codeberg.org/ivarch/pv/pulls/168

.github/FUNDING.yml

@@ -1 +0,0 @@
-github: a-j-wood

.gitignore

@@ -1,3 +1,18 @@
-*~
+build-aux
+missing
+compile
+depcomp
+install-sh
+config.sub
+config.guess
+Makefile.in
+aclocal.m4
+autoscan.log
 configure
+configure.scan
+autom4te.cache
+ABOUT-NLS
+m4
+*~
+*.tar.gz
 patch-backlog

Makefile.am

@@ -0,0 +1,150 @@
+## Process this file with automake to produce Makefile.in
+
+AUTOMAKE_OPTIONS = subdir-objects
+
+SUBDIRS = po
+
+bin_PROGRAMS = pv
+dist_doc_DATA = README.md docs/INSTALL docs/COPYING docs/NEWS.md docs/ACKNOWLEDGEMENTS.md docs/DEVELOPERS.md
+dist_man1_MANS = docs/pv.1
+
+EXTRA_DIST = docs/pv.1.md docs/benchmark.sh docs/release.cf
+
+pv_SOURCES = \
+src/main/debug.c \
+src/main/help.c \
+src/main/main.c \
+src/main/options.c \
+src/main/version.c \
+src/pv/calc.c \
+src/pv/cursor.c \
+src/pv/display.c \
+src/pv/elapsedtime.c \
+src/pv/file.c \
+src/pv/format/averagerate.c \
+src/pv/format/barstyle.c \
+src/pv/format/bufferpercent.c \
+src/pv/format/bytes.c \
+src/pv/format/eta.c \
+src/pv/format/fineta.c \
+src/pv/format/lastwritten.c \
+src/pv/format/name.c \
+src/pv/format/previousline.c \
+src/pv/format/progressbar.c \
+src/pv/format/rate.c \
+src/pv/format/sgr.c \
+src/pv/format/timer.c \
+src/pv/loop.c \
+src/pv/number.c \
+src/pv/proctitle.c \
+src/pv/remote.c \
+src/pv/signal.c \
+src/pv/state.c \
+src/pv/string.c \
+src/pv/transfer.c \
+src/pv/watchpid.c \
+src/include/config-aux.h \
+src/include/options.h \
+src/include/pv-internal.h \
+src/include/pv.h
+
+## Allow tests to write diagnostic info to fd 9 to reach the original
+## stderr even when the test driver is sending test output to a file.
+AM_TESTS_FD_REDIRECT = 9>&2
+
+AM_TESTS_ENVIRONMENT = \
+  . $(srcdir)/tests/test-env.sh \
+  ;
+TESTS = \
+tests/Bug_-_Display_length_at_magnitude_boundary_-_Bytes.test \
+tests/Bug_-_Display_length_at_magnitude_boundary_-_Rate.test \
+tests/Bug_-_Install_all_files.test \
+tests/Display_-_--average-rate.test \
+tests/Display_-_--bits.test \
+tests/Display_-_--buffer-percent.test \
+tests/Display_-_--bytes.test \
+tests/Display_-_--eta_-_plausible_values.test \
+tests/Display_-_--fineta_-_plausible_values.test \
+tests/Display_-_--last-written.test \
+tests/Display_-_--numeric_--bytes_--line-mode.test \
+tests/Display_-_--numeric_--bytes.test \
+tests/Display_-_--numeric.test \
+tests/Display_-_--numeric_--timer.test \
+tests/Display_-_--progress_-_basic_movement.test \
+tests/Display_-_--progress_-_increasing.test \
+tests/Display_-_--quiet.test \
+tests/Display_-_--rate_-_displayed_value_changes.test \
+tests/Display_-_--timer_-_displayed_value_changes.test \
+tests/General_-_--pidfile.test \
+tests/General_-_--size_argument_handling.test \
+tests/Integrity_-_Basic.test \
+tests/Integrity_-_Binary_data.test \
+tests/Integrity_-_From_bursty_source.test \
+tests/Integrity_-_Large_file_support.test \
+tests/Integrity_-_On_output_pipe_close.test \
+tests/Integrity_-_When_adjusted_remotely.test \
+tests/Memory_safety_-_Basic.test \
+tests/Memory_safety_-_Process_title.test \
+tests/Memory_safety_-_Remote_control_receiver.test \
+tests/Memory_safety_-_Remote_control_sender.test \
+tests/Memory_safety_-_Watchfd.test \
+tests/Modifiers_-_--direct-io.test \
+tests/Modifiers_-_--force.test \
+tests/Modifiers_-_--interval.test \
+tests/Modifiers_-_--line-mode.test \
+tests/Modifiers_-_--size_from_file_size.test \
+tests/Modifiers_-_--size.test \
+tests/Modifiers_-_--sync.test \
+tests/Sparse_-_Basic.test \
+tests/Terminal_-_Detect_width.test \
+tests/Transfer_-_--rate-limit.test \
+tests/Transfer_-_--remote.test \
+tests/Transfer_-_--stop-at-size.test \
+tests/Transfer_-_--stop-at-size_reads.test \
+tests/Watchfd_-_Multiple_descriptors.test \
+tests/Watchfd_-_Single_descriptor.test
+
+EXTRA_DIST += $(TESTS) tests/run-valgrind.sh tests/test-env.sh
+
+docs/pv.1.md: $(srcdir)/docs/pv.1
+	test -d docs || mkdir docs
+	pandoc --from man --to markdown < $< | sed '/\*\*\*\*/{s/\*//g;s/^/**/;s/$$/**/}' | sed '/^```/,/^```/d' | sed 's/^\\\[/[/' > $@
+
+SUFFIXES = .c .o .e
+
+.c.e:
+	-splint -badflag +posixlib $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) $(AM_CPPFLAGS) $(CPPFLAGS) -DSPLINT=1 $< > $@ 2>&1
+	-flawfinder $< >> $@ 2>&1
+
+indent:
+	cd $(srcdir) && indent -npro -kr -i8 -cd42 -c45 -l120 src/*/*.c src/*/*/*.c
+
+indentclean:
+	rm -f $(srcdir)/src/*/*.c~ $(srcdir)/src/*/*/*.c~
+
+analyse: $(pv_SOURCES:.c=.e) FORCE
+	grep -E -e '^Finished checking --' -e 'Hits = ' $+ 2>/dev/null || true
+
+FORCE:
+
+clean-local:
+	rm -f src/*/*.e src/*/*/*.e
+
+# Convenience alias for "make check": "make test"
+test: check
+
+# Generate a package manifest if MAINTAINER is set.
+dist-hook:
+	if test -n "$(MAINTAINER)"; then \
+	  cd "$(top_distdir)" \
+	  && { printf "%s\n\n" "Check file integrity with 'sha512sum -c MANIFEST && echo OK'."; \
+	       find -type f -not -name MANIFEST -exec sha512sum '{}' ';' | sort -k 2; } \
+	     | gpg -u "$(MAINTAINER)" --clearsign > MANIFEST; \
+	else true; fi
+
+# "release" target - requires MAINTAINER variable to select GPG key.
+release: distcheck
+	gpg --list-secret-keys 2>&1 | grep -F 'uid' | grep -Fq "$(MAINTAINER)"
+	gpg -u "$(MAINTAINER)" -ab $(distdir).tar.gz
+	cp -f $(distdir).tar.gz.asc $(distdir).tar.gz.txt
+	chmod 644 $(distdir).tar.gz $(distdir).tar.gz.asc $(distdir).tar.gz.txt

README.md

@@ -1,53 +1,87 @@
-Introduction
-------------
+# Introduction
 
-This is the README for **pv** ("Pipe Viewer"), a terminal-based tool for
-monitoring the progress of data through a pipeline.  It can be inserted into
-any normal pipeline between two processes to give a visual indication of how
-quickly data is passing through, how long it has taken, how near to
-completion it is, and an estimate of how long it will be until completion.
+**pv** ("Pipe Viewer") is a terminal-based tool for monitoring the progress
+of data through a pipeline and modifying its flow.
+
+It can be inserted into any normal pipeline between two processes to give a
+visual indication of how quickly data is passing through, how long it has
+taken, how near to completion it is, and an estimate of how long it will be
+until completion.  Data flow rate, error handling strategy, buffer size, and
+cache interaction can all be adjusted.
+
+In "**\--watchfd**" mode, **pv** will inspect another process and show its
+progress through the files it has open.
 
 
-Documentation
--------------
+# Documentation
 
-A manual page is included in this distribution.  See "`man ./doc/quickref.1`",
-or "`man pv`" after installation.
+A manual page is included in this distribution ("`man pv`").  Before
+installation, it is in "[docs/pv.1](./docs/pv.1.md)".
 
-Changes are listed in "[doc/NEWS.md](./doc/NEWS.md)".  The to-do list is "[doc/TODO.md](./doc/TODO.md)".
+Changes are listed in "[docs/NEWS.md](./docs/NEWS.md)".
 
-Developers and translators, please see "[doc/DEVELOPERS.md](./doc/DEVELOPERS.md)".
+Developers and translators, please see "[docs/DEVELOPERS.md](./docs/DEVELOPERS.md)".
+
+Translators can use the Weblate instance hosted by Codeberg:
+[https://translate.codeberg.org/engage/pv/](https://translate.codeberg.org/engage/pv/)
+
+[![Translation status](https://translate.codeberg.org/widget/pv/multi-auto.svg)](https://translate.codeberg.org/engage/pv/)
+
+If you don't see your language listed, raise an issue on the issue tracker
+(or just email the maintainer) asking for it to be added.
 
 
-Compilation
------------
+# Installation
 
-If this is not a packaged release, first run "`./generate.sh`".
+See "[docs/INSTALL](./docs/INSTALL)" for more about the _configure_ script.
 
-To compile the package, type "`sh ./configure`", which should generate a
-Makefile for your system.  You may then type "`make`" to build everything.
-Note that GNU _make_ is required; this may be installed as _gmake_ on some
-systems, so if typing "`make`" gives an error, try "`gmake`" instead.
+The typical process for a system-wide install is:
 
-See the file "[doc/INSTALL](./doc/INSTALL)" for more about the _configure_ script.
+    sh ./configure --prefix=/usr
+    make
+    sudo make install
+
+This requires the build toolchain ("`sudo apt install build-essential`" on
+Debian or Ubuntu systems).
+
+If this is not a packaged release, the _configure_ script is not included.
+It is generated with the GNU build system tools (_autoconf_, _aclocal_,
+_autopoint_, _automake_); _gettext_ is also needed.  On Debian or Ubuntu,
+run "`sudo apt install automake autopoint gettext`".  Once those tools are
+in place, call "`autoreconf -is`" to generate the _configure_ script, and
+run it as described above.
 
 
-Author and acknowledgements
----------------------------
+# Copyright, bug reporting, and acknowledgements
 
-This package is copyright 2023 Andrew Wood, and is being distributed under
-the terms of the Artistic License 2.0.  For more details of this license,
-see the file "[doc/COPYING](./doc/COPYING)".
+See "[docs/ACKNOWLEDGEMENTS.md](./docs/ACKNOWLEDGEMENTS.md)" for a list of
+contributors.
 
-Report bugs in **pv** using the contact form linked from the home page, or
-though the [project issue tracker](https://github.com/a-j-wood/pv/issues).
+Copyright (C) 2002-2008, 2010, 2012-2015, 2017, 2021, 2023-2025 Andrew Wood.
+
+License GPLv3+: GNU GPL version 3 or later <https://www.gnu.org/licenses/gpl-3.0.html>.
+
+This program is free software: you can redistribute it and/or modify it
+under the terms of the GNU General Public License as published by the Free
+Software Foundation, either version 3 of the License, or (at your option)
+any later version.
+
+This program is distributed in the hope that it will be useful, but WITHOUT
+ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
+more details.
+
+You should have received a copy of the GNU General Public License, version
+3, in "[docs/COPYING](./docs/COPYING)".  If not, see
+<https://www.gnu.org/licenses/gpl-3.0.html>.
+
+Please report bugs or request features via the issue tracker linked from the
+home page.
 
 The **pv** home page is at:
 
-&nbsp;&nbsp;[http://www.ivarch.com/programs/pv.shtml](http://www.ivarch.com/programs/pv.shtml)
+> [https://ivarch.com/p/pv](https://ivarch.com/p/pv)
 
 The latest version can always be found here.
 
-**Please see "[doc/ACKNOWLEDGEMENTS.md](./doc/ACKNOWLEDGEMENTS.md)" for a list of contributors.**
-
 ---

autoconf/Makefile.in

@@ -1,14 +0,0 @@
-#
-# Files from which this is generated (inside directory `autoconf/make'):
-#
-#   package.mk          # package name and distribution details
-#   vars.mk             # compilation, shell and linking variables
-#   filelist.mk~        # lists of files (generated by "makemake.sh")
-#   unreal.mk           # phony targets
-#   modules.mk~         # module linking rules (generated by "makemake.sh")
-#   rules.mk            # compilation rules
-#   link.mk             # real top-level targets
-#   depend.mk~          # dependencies (generated by "makemake.sh")
-#
-#
-

autoconf/configure.in

@@ -1,184 +0,0 @@
-dnl Process this file with autoconf to produce a configure script.
-dnl
-dnl Copyright 2002-2008, 2010, 2012-2015, 2017, 2021, 2023 Andrew Wood
-dnl
-dnl Distributed under the Artistic License v2.0; see `doc/COPYING'.
-
-AC_INIT
-AC_CONFIG_SRCDIR([src/main/version.c])
-AC_CONFIG_AUX_DIR(autoconf/scripts)
-AC_CONFIG_HEADERS([src/include/config.h:autoconf/header.in])
-AH_BOTTOM([#include "config-aux.h"])
-
-dnl Package identity
-PACKAGE=`cat $srcdir/doc/PACKAGE`
-VERSION=`cat $srcdir/doc/VERSION`
-UCPACKAGE=`tr a-z A-Z < $srcdir/doc/PACKAGE`
-AC_SUBST(PACKAGE)
-AC_SUBST(VERSION)
-AC_SUBST(UCPACKAGE)
-AC_DEFINE_UNQUOTED([PACKAGE], ["$PACKAGE"], [Package name])
-AC_DEFINE_UNQUOTED([PROGRAM_NAME], ["$PACKAGE"], [Name of this program])
-AC_DEFINE_UNQUOTED([VERSION], ["$VERSION"], [Version of this program])
-AC_DEFINE([COPYRIGHT_YEAR], [_("2023")], [Copyright year])
-AC_DEFINE([COPYRIGHT_HOLDER], [_("Andrew Wood <andrew.wood@ivarch.com>")], [Copyright holder])
-AC_DEFINE([PROJECT_HOMEPAGE], ["http://www.ivarch.com/programs/" PROGRAM_NAME ".shtml"], [Project homepage])
-AC_DEFINE([BUG_REPORTS_TO], [_("<pv@ivarch.com>")], [Bug reporting email address])
-
-AC_LANG(C)
-CFLAGS=${CFLAGS:-"-O"}
-AC_PROG_CC
-AC_PROG_INSTALL
-AC_USE_SYSTEM_EXTENSIONS
-AC_C_CONST
-AC_HEADER_STDBOOL
-AC_SYS_LARGEFILE
-AC_HEADER_TIOCGWINSZ
-AC_CHECK_FUNCS(getopt_long getopt)
-AC_CHECK_HEADERS(getopt.h)
-AC_CHECK_FUNCS(memcpy basename vsnprintf strlcat)
-AC_CHECK_FUNCS(fdatasync)
-AC_CHECK_FUNCS(fpathconf sysconf posix_memalign)
-AC_CHECK_HEADERS(limits.h)
-AC_CHECK_HEADERS(wctype.h)
-AC_CHECK_HEADERS(termios.h)
-
-AC_ARG_ENABLE(debugging,
-  [  --enable-debugging      compile with debugging support],
-  if test "$enable_debugging" = "yes"; then
-  	CFLAGS="$CFLAGS -g -Wall"
-	AC_DEFINE([ENABLE_DEBUGGING], [1], [Debugging support enabled])
-  fi
-)
-
-AC_ARG_ENABLE(profiling,
-  [  --enable-profiling      compile with profiling support],
-  if test "$enable_profiling" = "yes"; then
-  	CFLAGS="-pg $CFLAGS"
-  fi
-)
-
-STATIC_NLS="no"
-AC_ARG_ENABLE(static-nls, [  --enable-static-nls     hardcode NLS with no support files],
-  if test "$enable_static_nls" = "yes"; then
-    STATIC_NLS="yes"
-  fi,
-  STATIC_NLS="no"
-)
-
-NLS_SUPPORT="no"
-AC_ARG_ENABLE(nls, [  --disable-nls           do not use Native Language Support],
-  if test "$enable_nls" = "yes"; then
-    NLS_SUPPORT="yes"
-  fi,
-  NLS_SUPPORT="yes"
-)
-
-SPLICE_SUPPORT="no"
-AC_ARG_ENABLE(splice, [  --disable-splice        do not use splice system call],
-  if test "$enable_splice" = "yes"; then
-    SPLICE_SUPPORT="yes"
-  fi,
-  SPLICE_SUPPORT="yes"
-)
-
-IPC_SUPPORT="no"
-AC_ARG_ENABLE(ipc, [  --disable-ipc           turn off IPC messaging],
-  if test "$enable_ipc" = "yes"; then
-    IPC_SUPPORT="yes"
-  fi,
-  IPC_SUPPORT="yes"
-)
-
-dnl AIX needs -lc128
-AC_EGREP_CPP([^yes$], [#ifdef _AIX
-yes
-#endif
-], [LIBS="$LIBS -lc128"])
-
-dnl Native Language Support
-if test "$NLS_SUPPORT" = "yes"; then
-  AC_DEFINE([ENABLE_NLS], [1], [Enable native language support])
-  AC_PATH_PROG(MSGFMT, msgfmt, NOMSGFMT)
-  AC_PATH_PROG(GMSGFMT, gmsgfmt, $MSGFMT)
-  AC_PATH_PROG(XGETTEXT, xgettext, xgettext)
-  if test "x$MSGFMT" = "xNOMSGFMT"; then
-    MSGFMT=""
-    STATIC_NLS="yes"
-  fi
-  if test "$STATIC_NLS" = "yes"; then
-    CATALOGS=""
-    NLSOBJ="src/nls/table.o"
-  else
-    AC_CHECK_LIB(intl, main)
-    AC_CHECK_LIB(i, main)
-  fi
-  CATOBJEXT=.mo
-  INSTOBJEXT=.mo
-  for lang in de fr pl pt; do
-    GMOFILES="$GMOFILES $lang.gmo"
-    POFILES="$POFILES \$(srcdir)/src/nls/$lang.po"
-    CATALOGS="$CATALOGS src/nls/$lang$CATOBJEXT";
-  done
-  if test "$STATIC_NLS" = "yes"; then
-    CATALOGS=""
-  else
-    AC_CHECK_FUNC(gettext,
-     [AC_DEFINE([HAVE_GETTEXT], [1], [The gettext function is available])
-      NLSOBJ=""
-     ], [CATALOGS=""; NLSOBJ="src/nls/table.o"
-     ]
-    )
-  fi
-fi
-AC_CHECK_HEADERS(libintl.h)
-AC_CHECK_HEADERS(locale.h)
-AC_SUBST(MSGFMT)
-AC_SUBST(GMSGFMT)
-AC_SUBST(XGETTEXT)
-AC_SUBST(CATOBJEXT)
-AC_SUBST(INSTOBJEXT)
-AC_SUBST(GMOFILES)
-AC_SUBST(POFILES)
-AC_SUBST(CATALOGS)
-AC_SUBST(NLSOBJ)
-
-if test "$IPC_SUPPORT" = "yes"; then
-  AC_CHECK_HEADERS(sys/ipc.h sys/param.h libgen.h)
-fi
-
-if test "$SPLICE_SUPPORT" = "yes"; then
-  AC_CHECK_FUNCS(splice)
-fi
-
-dnl This must go after all the compiler based tests above.
-AC_LANG_WERROR
-
-dnl Fudging for separate build directories.
-dnl
-subdirs=""
-for i in `find $srcdir/src -type d -print | sed s,$srcdir/,,`; do
-  subdirs="$subdirs $i"
-done
-
-dnl Stitch together the Makefile fragments.
-dnl
-mk_segments="autoconf/Makefile.in"
-for i in vars.mk package.mk filelist.mk~ unreal.mk modules.mk~ \
-         rules.mk link.mk depend.mk~; do
-  mk_segments="$mk_segments:autoconf/make/$i"
-done
-
-dnl Output files (and create build directory structure too).
-dnl
-AC_CONFIG_FILES([Makefile:$mk_segments doc/lsm:doc/lsm.in
-          doc/quickref.1:doc/quickref.1.in
-          src/.dummy:doc/NEWS.md])
-AC_CONFIG_COMMANDS([default],[rm -f src/.dummy
-  for i in $subdirs; do
-    test -d $i || mkdir $i
-  done
-],[subdirs="$subdirs"])
-AC_OUTPUT
-
-dnl EOF

autoconf/make/link.mk

@@ -1,11 +0,0 @@
-#
-# Targets.
-#
-
-$(package): src/main.o src/library.o src/pv.o @NLSOBJ@
-	$(CC) $(LINKFLAGS) $(CFLAGS) -o $@ src/main.o src/library.o src/pv.o @NLSOBJ@ $(LIBS)
-
-$(package)-static: src/main.o src/library.o src/pv.o @NLSOBJ@
-	$(CC) $(LINKFLAGS) $(CFLAGS) -static -o $@ src/main.o src/library.o src/pv.o @NLSOBJ@ $(LIBS)
-
-# EOF

autoconf/make/package.mk

@@ -1,17 +0,0 @@
-#
-# Package name, version, and distribution files.
-#
-
-package = @PACKAGE@
-version = @VERSION@
-PACKAGE = @PACKAGE@
-
-distfiles =		\
-$(srcdir)/README.md	\
-$(srcdir)/autoconf	\
-$(srcdir)/configure	\
-$(srcdir)/doc		\
-$(srcdir)/src		\
-$(srcdir)/tests
-
-# EOF

autoconf/make/rules.mk

@@ -1,47 +0,0 @@
-#
-# Compilation rules.
-#
-
-.SUFFIXES: .c .d .o .e
-
-.c.o:
-	$(CC) $(CFLAGS) $(CPPFLAGS) -c -o $@ $<
-
-.c.d:
-	sh $(srcdir)/autoconf/scripts/depend.sh \
-	   $(CC) $< $(<:%.c=%) $(srcdir) $(CFLAGS) $(CPPFLAGS) > $@
-
-.c.e:
-	-splint -badflag +posixlib $(CPPFLAGS) $< > $@ 2>&1
-	-flawfinder $< >> $@ 2>&1
-
-#
-# Native language support
-#
-
-%.mo: %.po
-	$(MSGFMT) -o $@ $<
-	@touch $@
-	@chmod 644 $@
-
-%.gmo: %.po
-	rm -f $@
-	$(GMSGFMT) -o $@ $<
-	@touch $@
-	@chmod 644 $@
-
-$(srcdir)/src/nls/$(PACKAGE).pot: $(allsrc)
-	$(XGETTEXT) --default-domain=$(PACKAGE) --directory=$(srcdir) \
-	            --add-comments --keyword=_ --keyword=N_ \
-	            $(allsrc)
-	if cmp -s $(PACKAGE).po $@; then \
-	  rm -f $(PACKAGE).po; \
-	else \
-	  rm -f $@; \
-	  mv $(PACKAGE).po $@; \
-	  chmod 644 $@; \
-	fi
-
-src/nls/table.c: $(POFILES)
-	sh $(srcdir)/autoconf/scripts/po2table.sh $(POFILES) > src/nls/table.c
-

autoconf/make/unreal.mk

@@ -1,188 +0,0 @@
-#
-# Rules for all phony targets.
-#
-
-.PHONY: all help make dep depend test check analyse \
-  clean depclean analysisclean indentclean distclean gitclean \
-  index manhtml indent update-po \
-  doc dist release \
-  install uninstall
-
-all: $(alltarg) $(CATALOGS)
-
-help:
-	@echo 'This Makefile has the following utility targets:'
-	@echo
-	@echo '  all             build all binary targets'
-	@echo '  install         install compiled package and manual'
-	@echo '  uninstall       uninstall the package'
-	@echo '  check / test    run standardised tests on the compiled binary'
-	@echo
-	@echo 'Developer targets:'
-	@echo
-	@echo '  make            rebuild the Makefile (after adding new files)'
-	@echo '  dep / depend    rebuild .d (dependency) files'
-	@echo '  analyse         run analysis tools on all .c files'
-	@echo '  clean           remove .o (object) files'
-	@echo '  depclean        remove .d (dependency) files'
-	@echo '  analysisclean   remove .e (analysis) files'
-	@echo '  indentclean     remove files left over from "make indent"'
-	@echo '  distclean       remove everything not distributed'
-	@echo '  gitclean        remove everything not in version control'
-	@echo
-	@echo '  index           generate an HTML index of source code'
-	@echo '  manhtml         output HTML man page to stdout'
-	@echo '  indent          reformat all source files with "indent"'
-	@echo '  update-po       update the .po files'
-	@echo
-	@echo '  dist            create a source tarball for distribution'
-	@echo '  release         create and sign tar.gz and tar.bz2'
-	@echo
-
-make:
-	echo > $(srcdir)/autoconf/make/filelist.mk~
-	echo > $(srcdir)/autoconf/make/modules.mk~
-	cd $(srcdir); \
-	bash autoconf/scripts/makemake.sh \
-	     autoconf/make/filelist.mk~ \
-	     autoconf/make/modules.mk~
-	sh ./config.status
-
-dep depend: $(alldep)
-	echo '#' > $(srcdir)/autoconf/make/depend.mk~
-	echo '# Dependencies.' >> $(srcdir)/autoconf/make/depend.mk~
-	echo '#' >> $(srcdir)/autoconf/make/depend.mk~
-	echo >> $(srcdir)/autoconf/make/depend.mk~
-	cat $(alldep) >> $(srcdir)/autoconf/make/depend.mk~
-	sh ./config.status
-
-analyse: $(allanalysis)
-
-clean:
-	rm -f $(allobj)
-
-depclean:
-	rm -f $(alldep)
-
-analysisclean:
-	rm -f $(allanalysis)
-
-indentclean:
-	cd $(srcdir) && for FILE in $(allsrc); do rm -f ./$${FILE}~; done
-
-update-po: $(srcdir)/src/nls/$(PACKAGE).pot
-	catalogs='$(CATALOGS)'; \
-	for cat in $$catalogs; do \
-	  lang=$(srcdir)/`echo $$cat | sed 's/$(CATOBJEXT)$$//'`; \
-	  mv $$lang.po $$lang.old.po; \
-	  if $(MSGMERGE) $$lang.old.po $(srcdir)/src/nls/$(PACKAGE).pot > $$lang.po; then \
-	    rm -f $$lang.old.po; \
-	  else \
-	    echo "msgmerge for $$cat failed!"; \
-	    rm -f $$lang.po; \
-	    mv $$lang.old.po $$lang.po; \
-	    chmod 644 $$lang.po; \
-	  fi; \
-	done
-
-distclean: clean depclean analysisclean
-	rm -f $(alltarg) src/include/config.h
-	rm -rf $(package)-$(version).tar* $(package)-$(version)
-	rm -f *.html config.*
-	rm Makefile
-
-gitclean: distclean
-	rm -f doc/lsm
-	rm -f doc/quickref.1
-	rm -f configure
-	rm -f src/nls/*.gmo src/nls/*.mo
-	echo > $(srcdir)/autoconf/make/depend.mk~
-	echo > $(srcdir)/autoconf/make/filelist.mk~
-	echo > $(srcdir)/autoconf/make/modules.mk~
-
-doc:
-	-true
-
-index:
-	(cd $(srcdir); sh autoconf/scripts/index.sh $(srcdir)) > index.html
-
-manhtml:
-	@man2html ./doc/quickref.1 \
-	| sed -e '1,/<BODY/d' -e '/<\/BODY/,$$d' \
-	      -e 's|<A [^>]*>&nbsp;</A>||ig' \
-	      -e 's|<A [^>]*>\([^<]*\)</A>|\1|ig' \
-	      -e '/<H1/d' -e 's|\(</H[0-9]>\)|\1<P>|ig' \
-	      -e 's/<DL COMPACT>/<DL>/ig' \
-	      -e 's/&lt;[0-9A-Za-z_.-]\+@[0-9A-Za-z_.-]\+&gt;//g' \
-	      -e 's|<I>\(http://.*\)</I>|<A HREF="\1">\1</A>|ig' \
-	| sed -e '1,/<HR/d' -e '/<H2>Index/,/<HR/d' \
-
-indent:
-	cd $(srcdir) && indent -npro -kr -i8 -cd42 -c45 -l120 $(allsrc)
-
-dist: doc update-po
-	rm -rf $(package)-$(version)
-	mkdir $(package)-$(version)
-	cp -dprf Makefile $(distfiles) $(package)-$(version)
-	cd $(package)-$(version); $(MAKE) distclean
-	cp -dpf doc/lsm             $(package)-$(version)/doc/
-	chmod 644 `find $(package)-$(version) -type f -print`
-	chmod 755 `find $(package)-$(version) -type d -print`
-	chmod 755 `find $(package)-$(version)/autoconf/scripts`
-	chmod 755 $(package)-$(version)/configure
-	rm -rf DUMMY `find $(package)-$(version) -type d -name CVS`
-	rm -rf DUMMY `find $(package)-$(version) -type d -name .svn`
-	tar cf $(package)-$(version).tar $(package)-$(version)
-	rm -rf $(package)-$(version)
-	-gzip -f9 $(package)-$(version).tar
-
-check test: $(alltarg)
-	sh $(srcdir)/autoconf/scripts/run-test.sh ./$(package) $(srcdir)
-
-install: all doc
-	$(srcdir)/autoconf/scripts/mkinstalldirs \
-	  "$(DESTDIR)$(bindir)"
-	$(srcdir)/autoconf/scripts/mkinstalldirs \
-	  "$(DESTDIR)$(mandir)/man1"
-	$(INSTALL) -m 755 $(package) \
-	                  "$(DESTDIR)$(bindir)/$(package)"
-	$(INSTALL) -m 644 doc/quickref.1 \
-	                  "$(DESTDIR)$(mandir)/man1/$(package).1"
-	if test -n "$(CATALOGS)"; then \
-	  catalogs='$(CATALOGS)'; \
-	  for cat in $$catalogs; do \
-	    name=`echo $$cat | sed 's,^.*/,,g'`; \
-	    if test "`echo $$name | sed 's/.*\(\..*\)/\1/'`" = ".gmo"; then \
-	      destdir=$(gnulocaledir); \
-	    else \
-	      destdir=$(localedir); \
-	    fi; \
-	    lang=`echo $$name | sed 's/$(CATOBJEXT)$$//'`; \
-	    dir=$(DESTDIR)$$destdir/$$lang/LC_MESSAGES; \
-	    $(srcdir)/autoconf/scripts/mkinstalldirs $$dir; \
-	    $(INSTALL_DATA) $$cat $$dir/$(PACKAGE)$(INSTOBJEXT); \
-	  done; \
-	fi
-
-uninstall:
-	-$(UNINSTALL) "$(DESTDIR)$(bindir)/$(package)"
-	-$(UNINSTALL) "$(DESTDIR)$(mandir)/man1/$(package).1"
-	-$(UNINSTALL) "$(DESTDIR)$(mandir)/man1/$(package).1.gz"
-	-if test -n "$(CATALOGS)"; then \
-	  catalogs='$(CATALOGS)'; \
-	  for cat in $$catalogs; do \
-	    name=`echo $$cat | sed 's,^.*/,,g'`; \
-	    if test "`echo $$name | sed 's/.*\(\..*\)/\1/'`" = ".gmo"; then \
-	      destdir=$(gnulocaledir); \
-	    else \
-	      destdir=$(localedir); \
-	    fi; \
-	    lang=`echo $$name | sed 's/$(CATOBJEXT)$$//'`; \
-	    dir=$(DESTDIR)$$destdir/$$lang/LC_MESSAGES; \
-	    $(UNINSTALL) $$dir/$(PACKAGE)$(INSTOBJEXT); \
-	  done; \
-	fi
-
-release: dist
-	-gpg --list-secret-keys 2>&1 | grep -F 'uid' | grep -Fq "$(MAINTAINER)" && gpg -u "$(MAINTAINER)" -ab *.tar.gz && cp $(package)-$(version).tar.gz.asc $(package)-$(version).tar.gz.txt
-	chmod 644 $(package)-$(version)*

autoconf/make/vars.mk

@@ -1,46 +0,0 @@
-#
-# Variables for Make.
-#
-
-srcdir = @srcdir@
-
-prefix = @prefix@
-exec_prefix = @exec_prefix@
-bindir = @bindir@
-infodir = @infodir@
-mandir = @mandir@
-etcdir = @prefix@/etc
-datadir = @datadir@
-datarootdir = @datarootdir@
-sbindir = @sbindir@
-
-VPATH = $(srcdir)
-
-localedir = $(datadir)/locale
-gnulocaledir = $(prefix)/share/locale
-
-CATALOGS = @CATALOGS@
-POFILES = @POFILES@
-GMSGFMT = @GMSGFMT@
-MSGFMT = @MSGFMT@
-XGETTEXT = @XGETTEXT@
-MSGMERGE = msgmerge
-CATOBJEXT = @CATOBJEXT@
-INSTOBJEXT = @INSTOBJEXT@
-
-SHELL = /bin/sh
-CC = @CC@
-INSTALL = @INSTALL@
-INSTALL_DATA = @INSTALL_DATA@
-UNINSTALL = rm -f
-
-LDFLAGS = -r
-LINKFLAGS = @LDFLAGS@
-DEFS = @DEFS@ -DLOCALEDIR=\"$(localedir)\"
-CFLAGS = @CFLAGS@
-CPPFLAGS = @CPPFLAGS@ -I$(srcdir)/src/include -Isrc/include $(DEFS)
-LIBS = @LIBS@
-
-alltarg = @PACKAGE@
-
-# EOF

autoconf/scripts/depend.sh

@@ -1,33 +0,0 @@
-#!/bin/sh
-#
-# Generate dependencies for a C source file.
-#
-
-CC="$1"
-shift
-file="$1"
-shift
-stem="$1"
-shift
-srcdir="$1"
-abssrc=$(echo "$srcdir" | sed ':1
-s,^\./,,g
-t1')
-shift
-
-abssrc=$(echo "$abssrc" | sed 's,\.,\\.,g')
-srcdir=$(echo "$srcdir" | sed 's,\.,\\.,g')
-
-$CC -M -MG "$@" "$file" \
-| sed \
-  -e "s,^.*\.o:,${stem}.d ${stem}.o:," \
-  -e 's,'"$srcdir"'/,,g' \
-  -e 's,'"$abssrc"'/,,g' \
-  -e 's, /[^ ]*,,g' \
-  -e '/^ \\$/d' -e 's/ \\$//' \
-| tr '\n' ' ' \
-| tr -s ' '
-
-echo
-
-# EOF

autoconf/scripts/index.sh

@@ -1,191 +0,0 @@
-#!/bin/sh
-#
-# Script to generate an HTML index of all C code from the current directory
-# downwards (skipping directories ending in ~). The header comment in each
-# file is listed, and each function's prototype and comment are given. A
-# list of "TODO:" comments is also generated.
-#
-# Outputs the HTML on standard output.
-#
-# If a parameter is given, it is the prefix to put before any "view file"
-# links, eg ".." to link to "../dir/file.c" instead of "dir/file.c".
-#
-# Skips any files containing the string !NOINDEX.
-#
-# Requires ctags and cproto.
-#
-
-command -v "ctags" >/dev/null 2>&1  || { echo "${0##*/}: ctags: command not found" 1>&2; exit 1; }
-command -v "cproto" >/dev/null 2>&1 || { echo "${0##*/}: cproto: command not found" 1>&2; exit 1; }
-
-linkPrefix=$1
-test -n "${linkPrefix}" || linkPrefix="."
-
-# Add "/" to the link prefix, and empty it entirely if it ends up just "./".
-linkPrefix=$(echo "${linkPrefix}" | sed 's,/*$,,')
-test "$linkPrefix" = "." && linkPrefix="" || linkPrefix="${linkPrefix}/"
-
-# Convert the given string to HTML-escaped values (<, >, & escaped) on
-# stdout.
-#
-html_safe () {
-	echo "$*" \
-	| sed -e 's|&|\&amp;|g;s|<|\&lt;|g;s|>|\&gt;|g'
-}
-
-
-# Convert the given string to HTML-escaped values (<, >, & escaped) on
-# stdout, also adding a <BR> to the end of each line.
-#
-html_safebr () {
-	echo "$*" \
-	| sed -e 's|&|\&amp;|g;s|<|\&lt;|g;s|>|\&gt;|g;s/$/<BR>/'
-}
-
-allEligibleFiles=$(
-  find . -name '*~' -prune -o -type f -name '*.c' \
-       -exec grep -FL '!NOINDEX' /dev/null '{}' ';'
-)
-
-ctagsOutput=$(
-  echo "${allEligibleFiles}" \
-  | ctags -nRf- -L- --c-types=f \
-  | sed 's/	.\//	/;s/;"	.*$//'
-)
-
-sourceFiles=$(echo "${ctagsOutput}" | cut -d '	' -f 2 | sort | uniq)
-
-echo '<HTML><HEAD>'
-echo '<TITLE>Source Code Index</TITLE>'
-echo '</HEAD><BODY>'
-echo '<H1><A NAME="top">Source Code Index</A></H1>'
-echo '<P><UL>'
-echo '<LI><A HREF="#files">File Listing</A></LI>'
-echo '<LI><A HREF="#funcs">Function Listing</A></LI>'
-echo '<LI><A HREF="#todo">To-Do Listing</A></LI>'
-echo '</UL></P>'
-
-echo '<H2><A NAME="files">File Listing</A></H2>'
-echo '<P><UL>'
-echo "${sourceFiles}" \
-| sed -e \
-  's|^.*$|<LI><CODE CLASS="filename"><A HREF="#file-\0">\0</A></CODE></LI>|'
-echo '</UL></P>'
-
-for sourceFile in ${sourceFiles}; do
-
-	sourceDir="${sourceFile##*/}"
-	test "${sourceDir}" = "${sourceFile}" && sourceDir="."
-	functionPrototypes=$(
-	  cproto -f1 -I. -Isrc/include -I"${sourceDir}" "${sourceFile}" 2>/dev/null \
-	  | sed -n 's/^.*[ *]\([^ *(]*\)(.*$/\1/p'
-	)
-	fileHeaderComment=$(
-	  sed -n -e '1,/\*\//{/\/\*/,/\*\//{s/^[\/ *]//;s/^\*[\/]*//;p;};}' \
-          < "${sourceFile}"
-        )
-	fileShortDescription=$(echo "${fileHeaderComment}" | sed -n '1,/^ *$/{/^ *[^ ]*/p;}')
-	fileLongDescription=$(echo "${fileHeaderComment}" | sed '1,/^ *$/d')
-
-	echo '<P><HR WIDTH="100%"></P>'
-	echo '<P><TABLE BORDER="0"><TR>'
-	echo '<TD VALIGN="TOP"><CODE CLASS="filename">'
-	echo '<A NAME="file-'"${sourceFile}"'">'"${sourceFile}"'</A></CODE></TD>'
-	echo '<TD VALIGN="TOP"> - </TD>'
-	echo '<TD VALIGN="TOP">'"$(html_safe "${fileShortDescription}")"'</TD>'
-	echo '</TR></TABLE></P>'
-	echo '<P><SMALL>[<A HREF="'"${linkPrefix}${sourceFile}"'">View File</A>]</SMALL></P>'
-	echo '<P><BLOCKQUOTE>'
-	html_safebr "${fileLongDescription}"
-	echo '</BLOCKQUOTE></P>'
-
-	if [ -n "${functionPrototypes}" ]; then
-		echo '<P>Functions defined:</P>'
-		echo '<P><UL>'
-		echo "${functionPrototypes}" \
-		| sed 's|^.*$|<A HREF="#func-\0---'"${sourceFile}"'">\0</A>|' \
-		| sed 's/^/<LI><CODE CLASS="funcname">/;s|$|</CODE></LI>|'
-		echo '</UL></P>'
-	fi
-
-	echo '<P ALIGN="RIGHT"><SMALL CLASS="navbar">['
-	echo '<A HREF="#top">Top</A> |'
-	echo '<A HREF="#todo">To Do</A> |'
-	echo '<A HREF="#funcs">Functions</A> ]</SMALL></P>'
-done
-
-echo '<H2><A NAME="funcs">Function Listing</A></H2>'
-echo '<P><UL>'
-
-echo "${ctagsOutput}" | while read -r functionName sourceFile sourceLineNo restOfLine; do
-	echo '<LI><CODE CLASS="funcname"><A' \
-	  'HREF="#func-'"${functionName}"'---'"${sourceFile}"'">'"${functionName}"'</A></CODE>' \
-	  '[<CODE CLASS="filename">'"${sourceFile}"'</CODE>]</LI>'
-done
-echo '</UL></P>'
-
-# shellcheck disable=SC2034
-echo "${ctagsOutput}" | while read -r functionName sourceFile sourceLineNo restOfLine; do
-
-	functionPrototype=$(
-	  sed -n "${sourceLineNo},/{/p" < "${sourceFile}" \
-	  | tr '\n' ' ' \
-	  | tr -d '{'
-	)
-
-	lastCommentOpenLineNo=$(sed -n '1,'"${sourceLineNo}"'{/\/\*/=;}' < "${sourceFile}" | sed -n '$p')
-	test -n "${lastCommentOpenLineNo}" || lastCommentOpenLineNo=1
-	lastCommentCloseLineNo=$(sed -n '1,'"${sourceLineNo}"'{/}/=;}' < "${sourceFile}" | sed -n '$p')
-	test -n "${lastCommentCloseLineNo}" || lastCommentCloseLineNo=1
-	functionHeaderComment=$(
-	  sed -n -e \
-	  "${lastCommentOpenLineNo},"'/\*\//{h;s/^[\/ *]//;s/^\*[\/]*//;p;x;/\*\//q;}' \
-	  < "${sourceFile}"
-	)
-	test "${lastCommentOpenLineNo}" -le "${lastCommentCloseLineNo}" && functionHeaderComment=""
-
-	echo '<P><HR WIDTH="100%"></P>'
-	echo '<P ALIGN="LEFT">'
-	echo '<CODE CLASS="funcname"><A' \
-	  'NAME="func-'"${functionName}"'---'"${sourceFile}"'">'"${functionName}"'</A></CODE>' \
-	  '[<CODE CLASS="filename"><A HREF="#file-'"${sourceFile}"'">'"${sourceFile}"'</A></CODE>]'
-	echo '</P>'
-
-	echo '<P><CODE CLASS="funcdef">'"$(html_safe "${functionPrototype}")"'</CODE></P>'
-
-	echo '<P><BLOCKQUOTE>'
-	html_safebr "${functionHeaderComment}"
-	echo '</BLOCKQUOTE></P>'
-
-	echo '<P ALIGN="RIGHT"><SMALL CLASS="navbar">['
-	echo '<A HREF="#top">Top</A> |'
-	echo '<A HREF="#todo">To Do</A> |'
-	echo '<A HREF="#files">Files</A> ]</SMALL></P>'
-done
-
-echo '<H2><A NAME="todo">To Do Listing</A></H2>'
-echo '<P><UL>'
-for sourceFile in ${sourceFiles}; do
-
-	todoLineNumbers=$(sed -n \
-	               -e '/\/\*.*\*\//!{/\/\*/,/\*\//{/TODO:/{=;};};}' \
-	               -e '/\/\*.*\*\//{/TODO:/{=;};}' \
-	           < "${sourceFile}")
-
-	test -n "${todoLineNumbers}" || continue
-
-	echo '<LI><CODE CLASS="filename"><A' \
-	  'HREF="#file-'"${sourceFile}"'">'"${sourceFile}"'</A></CODE>'
-	echo '<UL>'
-
-	for todoLineNo in ${todoLineNumbers}; do
-		todoNote=$(sed -n "${todoLineNo}"'{s/^.*TODO://;s/\*\/.*$//;p;}' < "${sourceFile}")
-		echo "<LI>[<B>${todoLineNo}</B>] $(html_safe "${todoNote}")</LI>"
-	done
-
-	echo '</UL></LI>'
-done
-
-echo '</BODY></HTML>'
-
-# EOF

autoconf/scripts/install-sh

@@ -1,541 +0,0 @@
-#!/bin/sh
-# install - install a program, script, or datafile
-
-scriptversion=2020-11-14.01; # UTC
-
-# This originates from X11R5 (mit/util/scripts/install.sh), which was
-# later released in X11R6 (xc/config/util/install.sh) with the
-# following copyright and license.
-#
-# Copyright (C) 1994 X Consortium
-#
-# Permission is hereby granted, free of charge, to any person obtaining a copy
-# of this software and associated documentation files (the "Software"), to
-# deal in the Software without restriction, including without limitation the
-# rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
-# sell copies of the Software, and to permit persons to whom the Software is
-# furnished to do so, subject to the following conditions:
-#
-# The above copyright notice and this permission notice shall be included in
-# all copies or substantial portions of the Software.
-#
-# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL THE
-# X CONSORTIUM BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN
-# AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNEC-
-# TION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
-#
-# Except as contained in this notice, the name of the X Consortium shall not
-# be used in advertising or otherwise to promote the sale, use or other deal-
-# ings in this Software without prior written authorization from the X Consor-
-# tium.
-#
-#
-# FSF changes to this file are in the public domain.
-#
-# Calling this script install-sh is preferred over install.sh, to prevent
-# 'make' implicit rules from creating a file called install from it
-# when there is no Makefile.
-#
-# This script is compatible with the BSD install script, but was written
-# from scratch.
-
-tab='	'
-nl='
-'
-IFS=" $tab$nl"
-
-# Set DOITPROG to "echo" to test this script.
-
-doit=${DOITPROG-}
-doit_exec=${doit:-exec}
-
-# Put in absolute file names if you don't have them in your path;
-# or use environment vars.
-
-chgrpprog=${CHGRPPROG-chgrp}
-chmodprog=${CHMODPROG-chmod}
-chownprog=${CHOWNPROG-chown}
-cmpprog=${CMPPROG-cmp}
-cpprog=${CPPROG-cp}
-mkdirprog=${MKDIRPROG-mkdir}
-mvprog=${MVPROG-mv}
-rmprog=${RMPROG-rm}
-stripprog=${STRIPPROG-strip}
-
-posix_mkdir=
-
-# Desired mode of installed file.
-mode=0755
-
-# Create dirs (including intermediate dirs) using mode 755.
-# This is like GNU 'install' as of coreutils 8.32 (2020).
-mkdir_umask=22
-
-backupsuffix=
-chgrpcmd=
-chmodcmd=$chmodprog
-chowncmd=
-mvcmd=$mvprog
-rmcmd="$rmprog -f"
-stripcmd=
-
-src=
-dst=
-dir_arg=
-dst_arg=
-
-copy_on_change=false
-is_target_a_directory=possibly
-
-usage="\
-Usage: $0 [OPTION]... [-T] SRCFILE DSTFILE
-   or: $0 [OPTION]... SRCFILES... DIRECTORY
-   or: $0 [OPTION]... -t DIRECTORY SRCFILES...
-   or: $0 [OPTION]... -d DIRECTORIES...
-
-In the 1st form, copy SRCFILE to DSTFILE.
-In the 2nd and 3rd, copy all SRCFILES to DIRECTORY.
-In the 4th, create DIRECTORIES.
-
-Options:
-     --help     display this help and exit.
-     --version  display version info and exit.
-
-  -c            (ignored)
-  -C            install only if different (preserve data modification time)
-  -d            create directories instead of installing files.
-  -g GROUP      $chgrpprog installed files to GROUP.
-  -m MODE       $chmodprog installed files to MODE.
-  -o USER       $chownprog installed files to USER.
-  -p            pass -p to $cpprog.
-  -s            $stripprog installed files.
-  -S SUFFIX     attempt to back up existing files, with suffix SUFFIX.
-  -t DIRECTORY  install into DIRECTORY.
-  -T            report an error if DSTFILE is a directory.
-
-Environment variables override the default commands:
-  CHGRPPROG CHMODPROG CHOWNPROG CMPPROG CPPROG MKDIRPROG MVPROG
-  RMPROG STRIPPROG
-
-By default, rm is invoked with -f; when overridden with RMPROG,
-it's up to you to specify -f if you want it.
-
-If -S is not specified, no backups are attempted.
-
-Email bug reports to bug-automake@gnu.org.
-Automake home page: https://www.gnu.org/software/automake/
-"
-
-while test $# -ne 0; do
-  case $1 in
-    -c) ;;
-
-    -C) copy_on_change=true;;
-
-    -d) dir_arg=true;;
-
-    -g) chgrpcmd="$chgrpprog $2"
-        shift;;
-
-    --help) echo "$usage"; exit $?;;
-
-    -m) mode=$2
-        case $mode in
-          *' '* | *"$tab"* | *"$nl"* | *'*'* | *'?'* | *'['*)
-            echo "$0: invalid mode: $mode" >&2
-            exit 1;;
-        esac
-        shift;;
-
-    -o) chowncmd="$chownprog $2"
-        shift;;
-
-    -p) cpprog="$cpprog -p";;
-
-    -s) stripcmd=$stripprog;;
-
-    -S) backupsuffix="$2"
-        shift;;
-
-    -t)
-        is_target_a_directory=always
-        dst_arg=$2
-        # Protect names problematic for 'test' and other utilities.
-        case $dst_arg in
-          -* | [=\(\)!]) dst_arg=./$dst_arg;;
-        esac
-        shift;;
-
-    -T) is_target_a_directory=never;;
-
-    --version) echo "$0 $scriptversion"; exit $?;;
-
-    --) shift
-        break;;
-
-    -*) echo "$0: invalid option: $1" >&2
-        exit 1;;
-
-    *)  break;;
-  esac
-  shift
-done
-
-# We allow the use of options -d and -T together, by making -d
-# take the precedence; this is for compatibility with GNU install.
-
-if test -n "$dir_arg"; then
-  if test -n "$dst_arg"; then
-    echo "$0: target directory not allowed when installing a directory." >&2
-    exit 1
-  fi
-fi
-
-if test $# -ne 0 && test -z "$dir_arg$dst_arg"; then
-  # When -d is used, all remaining arguments are directories to create.
-  # When -t is used, the destination is already specified.
-  # Otherwise, the last argument is the destination.  Remove it from $@.
-  for arg
-  do
-    if test -n "$dst_arg"; then
-      # $@ is not empty: it contains at least $arg.
-      set fnord "$@" "$dst_arg"
-      shift # fnord
-    fi
-    shift # arg
-    dst_arg=$arg
-    # Protect names problematic for 'test' and other utilities.
-    case $dst_arg in
-      -* | [=\(\)!]) dst_arg=./$dst_arg;;
-    esac
-  done
-fi
-
-if test $# -eq 0; then
-  if test -z "$dir_arg"; then
-    echo "$0: no input file specified." >&2
-    exit 1
-  fi
-  # It's OK to call 'install-sh -d' without argument.
-  # This can happen when creating conditional directories.
-  exit 0
-fi
-
-if test -z "$dir_arg"; then
-  if test $# -gt 1 || test "$is_target_a_directory" = always; then
-    if test ! -d "$dst_arg"; then
-      echo "$0: $dst_arg: Is not a directory." >&2
-      exit 1
-    fi
-  fi
-fi
-
-if test -z "$dir_arg"; then
-  do_exit='(exit $ret); exit $ret'
-  trap "ret=129; $do_exit" 1
-  trap "ret=130; $do_exit" 2
-  trap "ret=141; $do_exit" 13
-  trap "ret=143; $do_exit" 15
-
-  # Set umask so as not to create temps with too-generous modes.
-  # However, 'strip' requires both read and write access to temps.
-  case $mode in
-    # Optimize common cases.
-    *644) cp_umask=133;;
-    *755) cp_umask=22;;
-
-    *[0-7])
-      if test -z "$stripcmd"; then
-        u_plus_rw=
-      else
-        u_plus_rw='% 200'
-      fi
-      cp_umask=`expr '(' 777 - $mode % 1000 ')' $u_plus_rw`;;
-    *)
-      if test -z "$stripcmd"; then
-        u_plus_rw=
-      else
-        u_plus_rw=,u+rw
-      fi
-      cp_umask=$mode$u_plus_rw;;
-  esac
-fi
-
-for src
-do
-  # Protect names problematic for 'test' and other utilities.
-  case $src in
-    -* | [=\(\)!]) src=./$src;;
-  esac
-
-  if test -n "$dir_arg"; then
-    dst=$src
-    dstdir=$dst
-    test -d "$dstdir"
-    dstdir_status=$?
-    # Don't chown directories that already exist.
-    if test $dstdir_status = 0; then
-      chowncmd=""
-    fi
-  else
-
-    # Waiting for this to be detected by the "$cpprog $src $dsttmp" command
-    # might cause directories to be created, which would be especially bad
-    # if $src (and thus $dsttmp) contains '*'.
-    if test ! -f "$src" && test ! -d "$src"; then
-      echo "$0: $src does not exist." >&2
-      exit 1
-    fi
-
-    if test -z "$dst_arg"; then
-      echo "$0: no destination specified." >&2
-      exit 1
-    fi
-    dst=$dst_arg
-
-    # If destination is a directory, append the input filename.
-    if test -d "$dst"; then
-      if test "$is_target_a_directory" = never; then
-        echo "$0: $dst_arg: Is a directory" >&2
-        exit 1
-      fi
-      dstdir=$dst
-      dstbase=`basename "$src"`
-      case $dst in
-	*/) dst=$dst$dstbase;;
-	*)  dst=$dst/$dstbase;;
-      esac
-      dstdir_status=0
-    else
-      dstdir=`dirname "$dst"`
-      test -d "$dstdir"
-      dstdir_status=$?
-    fi
-  fi
-
-  case $dstdir in
-    */) dstdirslash=$dstdir;;
-    *)  dstdirslash=$dstdir/;;
-  esac
-
-  obsolete_mkdir_used=false
-
-  if test $dstdir_status != 0; then
-    case $posix_mkdir in
-      '')
-        # With -d, create the new directory with the user-specified mode.
-        # Otherwise, rely on $mkdir_umask.
-        if test -n "$dir_arg"; then
-          mkdir_mode=-m$mode
-        else
-          mkdir_mode=
-        fi
-
-        posix_mkdir=false
-	# The $RANDOM variable is not portable (e.g., dash).  Use it
-	# here however when possible just to lower collision chance.
-	tmpdir=${TMPDIR-/tmp}/ins$RANDOM-$$
-
-	trap '
-	  ret=$?
-	  rmdir "$tmpdir/a/b" "$tmpdir/a" "$tmpdir" 2>/dev/null
-	  exit $ret
-	' 0
-
-	# Because "mkdir -p" follows existing symlinks and we likely work
-	# directly in world-writeable /tmp, make sure that the '$tmpdir'
-	# directory is successfully created first before we actually test
-	# 'mkdir -p'.
-	if (umask $mkdir_umask &&
-	    $mkdirprog $mkdir_mode "$tmpdir" &&
-	    exec $mkdirprog $mkdir_mode -p -- "$tmpdir/a/b") >/dev/null 2>&1
-	then
-	  if test -z "$dir_arg" || {
-	       # Check for POSIX incompatibilities with -m.
-	       # HP-UX 11.23 and IRIX 6.5 mkdir -m -p sets group- or
-	       # other-writable bit of parent directory when it shouldn't.
-	       # FreeBSD 6.1 mkdir -m -p sets mode of existing directory.
-	       test_tmpdir="$tmpdir/a"
-	       ls_ld_tmpdir=`ls -ld "$test_tmpdir"`
-	       case $ls_ld_tmpdir in
-		 d????-?r-*) different_mode=700;;
-		 d????-?--*) different_mode=755;;
-		 *) false;;
-	       esac &&
-	       $mkdirprog -m$different_mode -p -- "$test_tmpdir" && {
-		 ls_ld_tmpdir_1=`ls -ld "$test_tmpdir"`
-		 test "$ls_ld_tmpdir" = "$ls_ld_tmpdir_1"
-	       }
-	     }
-	  then posix_mkdir=:
-	  fi
-	  rmdir "$tmpdir/a/b" "$tmpdir/a" "$tmpdir"
-	else
-	  # Remove any dirs left behind by ancient mkdir implementations.
-	  rmdir ./$mkdir_mode ./-p ./-- "$tmpdir" 2>/dev/null
-	fi
-	trap '' 0;;
-    esac
-
-    if
-      $posix_mkdir && (
-        umask $mkdir_umask &&
-        $doit_exec $mkdirprog $mkdir_mode -p -- "$dstdir"
-      )
-    then :
-    else
-
-      # mkdir does not conform to POSIX,
-      # or it failed possibly due to a race condition.  Create the
-      # directory the slow way, step by step, checking for races as we go.
-
-      case $dstdir in
-        /*) prefix='/';;
-        [-=\(\)!]*) prefix='./';;
-        *)  prefix='';;
-      esac
-
-      oIFS=$IFS
-      IFS=/
-      set -f
-      set fnord $dstdir
-      shift
-      set +f
-      IFS=$oIFS
-
-      prefixes=
-
-      for d
-      do
-        test X"$d" = X && continue
-
-        prefix=$prefix$d
-        if test -d "$prefix"; then
-          prefixes=
-        else
-          if $posix_mkdir; then
-            (umask $mkdir_umask &&
-             $doit_exec $mkdirprog $mkdir_mode -p -- "$dstdir") && break
-            # Don't fail if two instances are running concurrently.
-            test -d "$prefix" || exit 1
-          else
-            case $prefix in
-              *\'*) qprefix=`echo "$prefix" | sed "s/'/'\\\\\\\\''/g"`;;
-              *) qprefix=$prefix;;
-            esac
-            prefixes="$prefixes '$qprefix'"
-          fi
-        fi
-        prefix=$prefix/
-      done
-
-      if test -n "$prefixes"; then
-        # Don't fail if two instances are running concurrently.
-        (umask $mkdir_umask &&
-         eval "\$doit_exec \$mkdirprog $prefixes") ||
-          test -d "$dstdir" || exit 1
-        obsolete_mkdir_used=true
-      fi
-    fi
-  fi
-
-  if test -n "$dir_arg"; then
-    { test -z "$chowncmd" || $doit $chowncmd "$dst"; } &&
-    { test -z "$chgrpcmd" || $doit $chgrpcmd "$dst"; } &&
-    { test "$obsolete_mkdir_used$chowncmd$chgrpcmd" = false ||
-      test -z "$chmodcmd" || $doit $chmodcmd $mode "$dst"; } || exit 1
-  else
-
-    # Make a couple of temp file names in the proper directory.
-    dsttmp=${dstdirslash}_inst.$$_
-    rmtmp=${dstdirslash}_rm.$$_
-
-    # Trap to clean up those temp files at exit.
-    trap 'ret=$?; rm -f "$dsttmp" "$rmtmp" && exit $ret' 0
-
-    # Copy the file name to the temp name.
-    (umask $cp_umask &&
-     { test -z "$stripcmd" || {
-	 # Create $dsttmp read-write so that cp doesn't create it read-only,
-	 # which would cause strip to fail.
-	 if test -z "$doit"; then
-	   : >"$dsttmp" # No need to fork-exec 'touch'.
-	 else
-	   $doit touch "$dsttmp"
-	 fi
-       }
-     } &&
-     $doit_exec $cpprog "$src" "$dsttmp") &&
-
-    # and set any options; do chmod last to preserve setuid bits.
-    #
-    # If any of these fail, we abort the whole thing.  If we want to
-    # ignore errors from any of these, just make sure not to ignore
-    # errors from the above "$doit $cpprog $src $dsttmp" command.
-    #
-    { test -z "$chowncmd" || $doit $chowncmd "$dsttmp"; } &&
-    { test -z "$chgrpcmd" || $doit $chgrpcmd "$dsttmp"; } &&
-    { test -z "$stripcmd" || $doit $stripcmd "$dsttmp"; } &&
-    { test -z "$chmodcmd" || $doit $chmodcmd $mode "$dsttmp"; } &&
-
-    # If -C, don't bother to copy if it wouldn't change the file.
-    if $copy_on_change &&
-       old=`LC_ALL=C ls -dlL "$dst"     2>/dev/null` &&
-       new=`LC_ALL=C ls -dlL "$dsttmp"  2>/dev/null` &&
-       set -f &&
-       set X $old && old=:$2:$4:$5:$6 &&
-       set X $new && new=:$2:$4:$5:$6 &&
-       set +f &&
-       test "$old" = "$new" &&
-       $cmpprog "$dst" "$dsttmp" >/dev/null 2>&1
-    then
-      rm -f "$dsttmp"
-    else
-      # If $backupsuffix is set, and the file being installed
-      # already exists, attempt a backup.  Don't worry if it fails,
-      # e.g., if mv doesn't support -f.
-      if test -n "$backupsuffix" && test -f "$dst"; then
-        $doit $mvcmd -f "$dst" "$dst$backupsuffix" 2>/dev/null
-      fi
-
-      # Rename the file to the real destination.
-      $doit $mvcmd -f "$dsttmp" "$dst" 2>/dev/null ||
-
-      # The rename failed, perhaps because mv can't rename something else
-      # to itself, or perhaps because mv is so ancient that it does not
-      # support -f.
-      {
-        # Now remove or move aside any old file at destination location.
-        # We try this two ways since rm can't unlink itself on some
-        # systems and the destination file might be busy for other
-        # reasons.  In this case, the final cleanup might fail but the new
-        # file should still install successfully.
-        {
-          test ! -f "$dst" ||
-          $doit $rmcmd "$dst" 2>/dev/null ||
-          { $doit $mvcmd -f "$dst" "$rmtmp" 2>/dev/null &&
-            { $doit $rmcmd "$rmtmp" 2>/dev/null; :; }
-          } ||
-          { echo "$0: cannot unlink or rename $dst" >&2
-            (exit 1); exit 1
-          }
-        } &&
-
-        # Now rename the file to the real destination.
-        $doit $mvcmd "$dsttmp" "$dst"
-      }
-    fi || exit 1
-
-    trap '' 0
-  fi
-done
-
-# Local variables:
-# eval: (add-hook 'before-save-hook 'time-stamp)
-# time-stamp-start: "scriptversion="
-# time-stamp-format: "%:y-%02m-%02d.%02H"
-# time-stamp-time-zone: "UTC0"
-# time-stamp-end: "; # UTC"
-# End:

autoconf/scripts/makemake.sh

@@ -1,130 +0,0 @@
-#!/bin/sh
-#
-# Generate Makefile components "filelist.mk~" (list source, object, and
-# dependency files) and "modules.mk~" (linking rules for each directory's
-# overall object file) by scanning the directory "src" for files ending in
-# ".c", and for subdirectories not starting with "_".
-#
-# Modules live inside subdirectories called [^_]* - i.e. a directory "foo" will
-# have a rule created which links all code inside it to "foo.o".
-#
-# The directory "src/include" is never scanned; neither are CVS or SVN
-# directories.
-#
-
-listingsFile="$1"
-linkingRulesFile="$2"
-
-FIND="find"
-GREP="grep"
-command -v gfind 2>/dev/null | grep /gfind >/dev/null && FIND="gfind"
-command -v which ggrep 2>/dev/null | grep /ggrep >/dev/null && GREP="ggrep"
-
-{
-echo '# Automatically generated file listings'
-echo '#'
-echo "# Creation time: $(date)"
-echo
-} > "${listingsFile}"
-
-{
-echo '# Automatically generated module linking rules'
-echo '#'
-echo "# Creation time: $(date)"
-echo
-} > "${linkingRulesFile}"
-
-printf "%s" "Scanning for source files: "
-
-allsrc=$("${FIND}" src -type f -name "*.c" -print)
-allobj=$(echo "${allsrc}" | tr ' ' '\n' | sed 's/\.c$/.o/')
-alldep=$(echo "${allsrc}" | tr ' ' '\n' | sed 's/\.c$/.d/')
-allanalysis=$(echo "${allsrc}" | tr ' ' '\n' | sed 's/\.c$/.e/')
-
-echo "$(echo "${allsrc}" | wc -w | tr -d ' ') found"
-
-printf "%s" "Scanning for modules: "
-
-modules=$("${FIND}" src -type d -print \
-         | "${GREP}" -v '^src$' \
-         | "${GREP}" -v '/_' \
-         | "${GREP}" -v '^src/include' \
-         | "${GREP}" -v 'CVS' \
-         | "${GREP}" -v '.svn' \
-         | while read -r DIR; do \
-           CONTENT=$(/bin/ls -d "${DIR}"/* \
-                     | "${GREP}" -v '.po$' \
-                     | "${GREP}" -v '.gmo$' \
-                     | "${GREP}" -v '.mo$' \
-                     | "${GREP}" -v '.h$' \
-                     | sed -n '$p'); \
-           [ -n "$CONTENT" ] || continue; \
-           echo "${DIR}"; \
-	   done
-         )
-
-echo "up to $(echo "${modules}" | wc -w | tr -d ' ') found"
-
-echo "Writing module linking rules"
-
-printf "%s" "["
-for i in ${modules}; do printf "%s" " "; done
-printf "%s\r%s" "]" "["
-
-for i in ${modules}; do
-  printf "%s" "."
-  allobj="${allobj} ${i}.o"
-  deps=""
-  for j in "${i}"/*.c; do
-    [ -f "$j" ] || continue
-    newobj=$(echo "$j" | sed -e 's@\.c$@.o@')
-    deps="$deps $newobj"
-  done
-  for j in "${i}"/*; do
-    [ -d "$j" ] || continue
-    [ "$(basename "$j")" = "CVS" ] && continue
-    [ "$(basename "$j")" = ".svn" ] && continue
-    CONTENT=$(/bin/ls -d "$j"/* \
-             | "${GREP}" -v '.po$' \
-             | "${GREP}" -v '.gmo$' \
-             | "${GREP}" -v '.mo$' \
-             | "${GREP}" -v '.h$' \
-             | sed -n '$p')
-    [ -n "$CONTENT" ] || continue
-    deps="$deps $j.o"
-  done
-  [ -n "$deps" ] || continue
-  {
-  echo "$i.o: $deps"
-  echo "	\$(LD) \$(LDFLAGS) -o \$@ $deps"
-  echo
-  } >> "${linkingRulesFile}"
-done
-
-echo ']'
-
-echo "Listing source, object and dependency files"
-
-{
-printf "%s" "allsrc = "
-echo "$allsrc" | tr '\n' ' ' | sed 's,src/nls/cat-id-tbl.c,,' | sed -e 's/ $//;s/ / \\!/g' \
-| tr '!' '\n'
-echo
-echo
-printf "%s" "allobj = "
-echo "$allobj" | tr '\n' ' ' | sed -e 's/ $//;s/ / \\!/g' | tr '!' '\n'
-echo
-echo
-printf "%s" "alldep = "
-echo "$alldep" | tr '\n' ' ' | sed -e 's/ $//;s/ / \\!/g' | tr '!' '\n'
-echo
-echo
-printf "%s" "allanalysis = "
-echo "$allanalysis" | tr '\n' ' ' | sed -e 's/ $//;s/ / \\!/g' | tr '!' '\n'
-echo
-echo
-} >> "${listingsFile}"
-
-echo >> "${linkingRulesFile}"
-
-# EOF

autoconf/scripts/mkinstalldirs

@@ -1,33 +0,0 @@
-#!/bin/sh
-# mkinstalldirs --- make directory hierarchy
-# Author: Noah Friedman <friedman@prep.ai.mit.edu>
-# Created: 1993-05-16
-# Last modified: 1994-03-25
-# Public domain
-
-errstatus=0
-
-for file in ${1+"$@"} ; do 
-   set fnord `echo ":$file" | sed -ne 's/^:\//#/;s/^://;s/\// /g;s/^#/\//;p'`
-   shift
-
-   pathcomp=
-   for d in ${1+"$@"} ; do
-     pathcomp="$pathcomp$d"
-     case "$pathcomp" in
-       -* ) pathcomp=./$pathcomp ;;
-     esac
-
-     if test ! -d "$pathcomp"; then
-        echo "mkdir $pathcomp" 1>&2
-        mkdir "$pathcomp" || errstatus=$?
-        chmod 755 $pathcomp 2>/dev/null
-     fi
-
-     pathcomp="$pathcomp/"
-   done
-done
-
-exit $errstatus
-
-# mkinstalldirs ends here

autoconf/scripts/po2table.sh

@@ -1,63 +0,0 @@
-#!/bin/sh
-#
-# Messy script to convert all of the given .po files to a single C file on
-# stdout.
-
-cat <<EOF
-/*
- * Translation table - automatically generated by po2table.sh.
- */
-
-#include "config.h"
-#include <string.h>
-
-struct msgtable_s {
-	char *msgid;
-	char *msgstr;
-};
-
-
-struct msgtable_s *minigettext__gettable(char *lang)
-{
-	if (0 == lang)
-		return 0;
-
-EOF
-
-for POFILE in "$@"; do
-	LANG=$(basename "$POFILE" | sed 's/.po$//')
-	echo "	if (strncmp(lang, \"$LANG\", 2) == 0) {"
-	echo "		static struct msgtable_s data[] = {";
-
-	awk 'BEGIN{i=0;s=0;}
-	  /^msgid[ 	]+/ {
-	    if (s) print "			}, ";
-	    print "			{";
-	    print "				" substr($0,7);
-	    i=1;
-	    s=0;
-	  }
-	  /^msgstr[ 	]+/ {
-	    print "			,";
-	    i=0;s=1;
-	    print "				" substr($0,8);
-	  }
-	  /^[ 	]*"/ {
-	    if (i||s) print "				" $0;
-	  }
-	  END {if (i||s) print "			}\n";}
-	' < "$POFILE"
-	echo '			, { 0, 0 } };'
-	echo "		return data;"
-	echo "	}"
-done
-
-cat <<EOF
-
-	return 0;
-}
-
-/* EOF */
-EOF
-
-# EOF

autoconf/scripts/run-test.sh

@@ -1,210 +0,0 @@
-#!/bin/sh
-#
-# Parameters: testSubject sourcePath [testScript...]
-#
-# Run one or more test scripts.  The ${testSubject} is the path of the test
-# subject program, and the ${sourcePath} is the path to the top level of the
-# source directory.  If any ${testScript} parameters are given, they are the
-# tests to run (each one being either the full path to a script, or the base
-# filename of the script in the test directory).  If no test scripts are
-# listed, then all tests directly under "${sourcePath}/tests/" are run.
-#
-# Test scripts should be written to exit 0 if the test passed, 2 if the test
-# is to be skipped, or any other exit status to indicate failure.  They are
-# run via "sh -e", so any command exiting non-zero will cause the test
-# script to exit early.
-#
-# The test scripts can rely on the environment variables "testSubject",
-# "sourcePath", "workFile1", "workFile2", "workFile3", and "workFile4" being
-# populated, and should use those work files - which will be present and
-# empty - for scratch space.  They should not delete those files.
-#
-# When the test scripts are called, LANG and LC_ALL are set to "C".
-#
-# Anything output by a test script on stdout or stderr is captured and shown
-# after the "OK" / "FAILED" / "skipped" result description.
-#
-# The exit status of this script will be 1 if any test failed, 0 otherwise. 
-# A skipped test is not counted as a failure.
-#
-
-# Parameters.
-testSubject="$1"
-sourcePath="$2"
-shift
-shift
-selectedTests="$*"
-
-# Constants.
-formatCodesPass="setaf 2;bold"	# terminal capabilities for "pass" formatting
-formatCodesFail="setaf 1;bold"	# terminal capabilities for "fail" formatting
-formatCodesSkip="setaf 3"	# terminal capabilities for "skip" formatting
-formatCodesZero="setaf 4"	# terminal capabilities for zero result
-
-# Temporary working files, for the test scripts to use.
-workFile1=$(mktemp 2>/dev/null) || workFile1="./.tmp1"
-workFile2=$(mktemp 2>/dev/null) || workFile2="./.tmp2"
-workFile3=$(mktemp 2>/dev/null) || workFile3="./.tmp3"
-workFile4=$(mktemp 2>/dev/null) || workFile4="./.tmp4"
-
-# Clean up the temporary files on exit, in case we are interrupted.
-trap 'rm -f "${workFile1}" "${workFile2}" "${workFile3}" "${workFile4}"' EXIT
-
-# Variables used by the test scripts.
-export testSubject sourcePath workFile1 workFile2 workFile3 workFile4
-
-# Set everything to the "C" locale.
-LANG=C
-LC_ALL=C
-export LANG LC_ALL
-
-# If no tests were specified, list all test scripts under the source path.
-test -n "${selectedTests}" || selectedTests=$(find "${sourcePath}/tests" -maxdepth 1 -type f | sort -n)
-
-# Initial pass to count the number of tests and find the length of the
-# longest test name, to use when formatting the output.
-#
-numberOfTests=0
-maxTestNameLength=0
-for testScript in ${selectedTests}; do
-	# Find the test script, make sure it exists.
-	test -f "${testScript}" || testScript="${sourcePath}/tests/${testScript}"
-	test -f "${testScript}" || testScript=$(find "${sourcePath}/tests" -maxdepth 1 -type f -name "${testScript##*/}*" | sed -n '1p')
-	test -f "${testScript}" || continue
-
-	numberOfTests=$((1+numberOfTests))
-
-	testScriptLeaf="${testScript##*/}"
-	testName="$(echo "${testScriptLeaf%.sh}" | tr '_' ' ' | sed 's/ - /: /')"
-	testNameLength=${#testName}
-	test "${testNameLength}" -gt "${maxTestNameLength}" && maxTestNameLength="${testNameLength}"
-done
-
-# Set a minimum and maximum test name length.
-test "${maxTestNameLength}" -lt 10 && maxTestNameLength=10
-test "${maxTestNameLength}" -gt 60 && maxTestNameLength=60
-
-# Count the number of digits in the number of tests so we know how wide the
-# column for the test count should be.
-testCountWidth=${#numberOfTests}
-
-# Get the terminal width, for later display formatting calculations.
-#
-# We have to fiddle with `stty' because $COLUMNS is only in `bash', `resize`
-# is not available everywhere, and `stty' itself varies in its output format
-# between "columns 158" and "158 cols".
-#
-terminalWidth=80
-test -t 1 && terminalWidth=$(stty -a 2>/dev/null | tr ';' '\n' | grep -e cols -e columns | tr ' ' '\n' | grep '[0-9]' | sed -n 1p)
-test -n "${terminalWidth}" || terminalWidth=80
-
-# Remaining space left on each line after the result description.
-colsUsed=$((testCountWidth + 1 + testCountWidth + 2 + maxTestNameLength + 2 + 8 + 2))
-colsRemaining=0
-test "${colsUsed}" -lt "${terminalWidth}" && colsRemaining=$((terminalWidth - colsUsed))
-
-# Run all of the selected test scripts, formatting the output.
-#
-testPassCount=0
-testFailCount=0
-testSkipCount=0
-testNumber=0
-for testScript in ${selectedTests}; do
-	# Find the test script, make sure it exists.
-	test -f "${testScript}" || testScript="${sourcePath}/tests/${testScript}"
-	test -f "${testScript}" || testScript=$(find "${sourcePath}/tests" -maxdepth 1 -type f -name "${testScript##*/}*" | sed -n '1p')
-	test -f "${testScript}" || continue
-
-	testNumber=$((1+testNumber))
-
-	testScriptLeaf="${testScript##*/}"
-	testName="$(echo "${testScriptLeaf%.sh}" | tr '_' ' ' | sed 's/ - /: /')"
-	printf "%${testCountWidth}d/%d: %-${maxTestNameLength}.${maxTestNameLength}s  " "${testNumber}" "${numberOfTests}"  "${testName}"
-
-	# Run the test script, capturing the output and the exit status.
-	testExitStatus=0
-	testOutput=""
-	if test -s "${testScript}"; then
-		true > "${workFile1}"
-		true > "${workFile2}"
-		true > "${workFile3}"
-		true > "${workFile4}"
-		testOutput=$(sh -e "${testScript}" 2>&1)
-		testExitStatus=$?
-	else
-		testOutput="test script has not yet been written"
-		testExitStatus=2
-	fi
-
-	# Work out what we're going to say about this test result.
-	testResultDescription=""
-	resultFormatCodes=""
-	if test ${testExitStatus} -eq 0; then
-		resultFormatCodes="${formatCodesPass}"
-		testResultDescription="OK"
-		testPassCount=$((1+testPassCount))
-	elif test ${testExitStatus} -eq 2; then
-		resultFormatCodes="${formatCodesSkip}"
-		testResultDescription="skipped"
-		testSkipCount=$((1+testSkipCount))
-	else
-		resultFormatCodes="${formatCodesFail}"
-		testResultDescription="FAILED"
-		testFailCount=$((1+testFailCount))
-	fi
-
-	# If stdout is not a terminal, don't use terminal format codes.
-	test -t 1 || resultFormatCodes=""
-
-	# Show the description of the test result, and start a new line.
-	test -n "${resultFormatCodes}" && command -v tput >/dev/null 2>&1 && echo "${resultFormatCodes}" | tr ';' '\n' | tput -S 2>/dev/null
-	printf "%s" "${testResultDescription}"
-
-	# If there was any output from the test, display it - either on the
-	# current line, if there's space, or the next line, with each line
-	# prefixed with the test number.
-	if test -n "${testOutput}"; then
-		if test "${#testOutput}" -lt "${colsRemaining}" && ! test "$(echo "${testOutput}" | wc -l | tr -dc '0-9')" -gt 1 2>/dev/null; then
-			printf " - %s" "${testOutput}"
-		else
-			printf "\n%s" "$(echo "${testOutput}" | sed "s,^,$(printf "%${testCountWidth}d/%d: - " "${testNumber}" "${numberOfTests}"),")"
-		fi
-	fi
-	printf "\n"
-
-	test -n "${resultFormatCodes}" && command -v tput >/dev/null 2>&1 && tput sgr0 2>/dev/null
-done
-
-# Clean up.
-rm -f "${workFile1}" "${workFile2}" "${workFile3}" "${workFile4}"
-trap '' EXIT
-
-# Report the totals.
-printf "\n"
-printf "%s: " "Tests passed"
-numberFormatting="${formatCodesPass}"
-test "${testPassCount}" -gt 0 || numberFormatting="${formatCodesZero}"
-test -t 1 && command -v tput >/dev/null 2>&1 && echo "${numberFormatting}" | tr ';' '\n' | tput -S 2>/dev/null
-printf "%d" "${testPassCount}"
-test -t 1 && command -v tput >/dev/null 2>&1 && tput sgr0 2>/dev/null
-
-printf "   %s: " "Tests failed"
-numberFormatting="${formatCodesFail}"
-test "${testFailCount}" -gt 0 || numberFormatting="${formatCodesZero}"
-test -t 1 && command -v tput >/dev/null 2>&1 && echo "${numberFormatting}" | tr ';' '\n' | tput -S 2>/dev/null
-printf "%d" "${testFailCount}"
-test -t 1 && command -v tput >/dev/null 2>&1 && tput sgr0 2>/dev/null
-
-printf "   %s: " "Tests skipped"
-numberFormatting="${formatCodesSkip}"
-test "${testSkipCount}" -gt 0 || numberFormatting="${formatCodesZero}"
-test -t 1 && command -v tput >/dev/null 2>&1 && echo "${numberFormatting}" | tr ';' '\n' | tput -S 2>/dev/null
-printf "%d" "${testSkipCount}"
-test -t 1 && command -v tput >/dev/null 2>&1 && tput sgr0 2>/dev/null
-printf "\n"
-
-# Exit with status 1 if any test failed outright, 0 otherwise.
-test "${testFailCount}" -eq 0 || exit 1
-exit 0
-
-# EOF

configure.ac

@@ -0,0 +1,201 @@
+dnl Process this file with autoconf to produce a configure script.
+dnl
+dnl Copyright 2002-2008, 2010, 2012-2015, 2017, 2021, 2023-2025 Andrew Wood
+dnl
+dnl License GPLv3+: GNU GPL version 3 or later; see `docs/COPYING'.
+
+AC_INIT([pv], [1.10.0], [https://codeberg.org/ivarch/pv/issues], [pv], [https://ivarch.com/p/pv])
+AC_CONFIG_SRCDIR([src/include/config.h.in])
+AC_CONFIG_AUX_DIR([build-aux])
+AC_CONFIG_HEADERS([src/include/config.h])
+AM_INIT_AUTOMAKE([-Wall -Werror foreign])
+AC_LANG(C)
+AC_PROG_CC
+AC_PROG_INSTALL
+AC_USE_SYSTEM_EXTENSIONS
+AC_C_CONST
+AC_HEADER_STDBOOL
+AC_SYS_LARGEFILE
+AM_GNU_GETTEXT_VERSION([0.21])
+AM_GNU_GETTEXT([external])
+if test "$USE_NLS" = "yes"; then
+  CPPFLAGS="$CPPFLAGS -DLOCALEDIR=\\\"\$(localedir)\\\""
+  LIBS="$LIBS $LIBINTL"
+fi
+
+dnl Items we can use if present, but can do without if not present.
+AC_CHECK_FUNCS([getopt_long])
+AC_CHECK_FUNCS([vsnprintf strlcat strtoul memrchr])
+AC_CHECK_FUNCS([fdatasync])
+AC_CHECK_FUNCS([fpathconf sysconf posix_memalign posix_fadvise])
+AC_CHECK_FUNCS([nanosleep])
+AC_CHECK_FUNCS([setitimer])
+AC_CHECK_FUNCS([setproctitle])
+AC_CHECK_HEADERS([getopt.h])
+AC_CHECK_HEADERS([limits.h])
+AC_CHECK_HEADERS([langinfo.h])
+AC_CHECK_HEADERS([wctype.h])
+AC_CHECK_HEADERS([termios.h])
+AC_CHECK_HEADERS([libgen.h])
+AC_CHECK_HEADERS([sys/ioctl.h])
+AC_CHECK_HEADERS([libintl.h locale.h])
+AC_CHECK_HEADERS([sys/sysmacros.h])
+AC_CHECK_MEMBERS([struct stat.st_blksize])
+AC_CHECK_DECLS([SA_SIGINFO], [], [], [[#include <signal.h>]])
+
+AC_SEARCH_LIBS([sqrtl],[m])
+AC_SEARCH_LIBS([fmod],[m])
+AC_CHECK_HEADERS([math.h])
+AC_CHECK_FUNCS([sqrtl])
+AC_CHECK_FUNCS([fmod])
+
+dnl Libraries that may contain key functions.
+AC_SEARCH_LIBS([clock_gettime],[rt])
+
+dnl Items we can't do without.
+AC_CHECK_FUNCS([alarm basename clock_gettime dup2 getcwd memcpy memmove memset mkdir select setlocale strchr strerror strrchr strstr], [], [AC_MSG_ERROR([required function is missing])])
+AC_CHECK_HEADERS([fcntl.h sys/file.h sys/time.h unistd.h], [], [AC_MSG_ERROR([required header file is missing])])
+
+dnl Make sure all the types we use are defined.
+AC_TYPE_INT32_T
+AC_TYPE_MODE_T
+AC_TYPE_OFF_T
+AC_TYPE_PID_T
+AC_TYPE_SIZE_T
+AC_TYPE_SSIZE_T
+AC_TYPE_UID_T
+
+AC_CHECK_MEMBERS([struct stat.st_rdev])
+
+dnl Check whether a signal handler can see the PID of the sender.
+AC_MSG_CHECKING([siginfo_t provides a signal sender's PID])
+AC_RUN_IFELSE(
+[AC_LANG_PROGRAM([[
+#include <string.h>
+#include <signal.h>
+#include <unistd.h>
+
+static pid_t signalSender = 0;
+
+#ifdef SA_SIGINFO
+static void receiveUSR2( __attribute__((unused))
+			int sig, siginfo_t * info, __attribute__((unused))
+			void *ucontext)
+{
+	if (NULL != info)
+		signalSender = info->si_pid;
+}
+#endif
+]], [[
+	struct sigaction sa;
+	memset(&sa, 0, sizeof(sa));
+#ifdef SA_SIGINFO
+	sa.sa_sigaction = receiveUSR2;
+	(void) sigemptyset(&(sa.sa_mask));
+	sa.sa_flags = SA_SIGINFO;
+	(void) sigaction(SIGUSR2, &sa, NULL);
+	raise(SIGUSR2);
+#endif
+	return signalSender < 1 ? 1 : 0;
+]])], [
+AC_MSG_RESULT([yes])
+AC_DEFINE([SIGINFO_PROVIDES_PID], [1], [Signal handlers can determine the sending PID])
+], [
+AC_MSG_RESULT([no])
+], [
+AC_MSG_RESULT([cannot check, assuming yes])
+AC_DEFINE([SIGINFO_PROVIDES_PID], [1], [Signal handlers can determine the sending PID])
+]
+)
+
+AH_BOTTOM([#include "config-aux.h"])
+
+AC_ARG_ENABLE([debugging],
+  [AS_HELP_STRING([--enable-debugging], [compile with debugging support])],
+  if test "$enable_debugging" = "yes"; then
+  	CFLAGS="$CFLAGS -g -Wall"
+	AC_DEFINE([ENABLE_DEBUGGING], [1], [Debugging support enabled])
+  fi
+)
+
+AC_ARG_ENABLE([profiling],
+  [AS_HELP_STRING([--enable-profiling], [compile with profiling support])],
+  if test "$enable_profiling" = "yes"; then
+  	CFLAGS="-pg $CFLAGS"
+  fi
+)
+
+SPLICE_SUPPORT="no"
+AC_ARG_ENABLE([splice],
+  [AS_HELP_STRING([--disable-splice], [do not use splice system call])],
+  if test "$enable_splice" = "yes"; then
+    SPLICE_SUPPORT="yes"
+  fi,
+  SPLICE_SUPPORT="yes"
+)
+
+IPC_SUPPORT="no"
+AC_ARG_ENABLE([ipc],
+  [AS_HELP_STRING([--disable-ipc], [turn off IPC messaging])],
+  if test "$enable_ipc" = "yes"; then
+    IPC_SUPPORT="yes"
+  fi,
+  IPC_SUPPORT="yes"
+)
+
+AC_ARG_WITH([ncurses],
+  [AS_HELP_STRING([--without-ncurses], [disable the use of ncurses for terminal info])],
+  [],
+  [with_curses=yes])
+AS_IF([test "x$with_ncurses" != xno],
+[
+    AC_SEARCH_LIBS([tigetnum],[tinfo ncurses], [
+      AC_CHECK_HEADERS([term.h],[
+        AC_DEFINE([ENABLE_NCURSES], [1], [Build with ncurses support])
+      ])
+    ], [])
+],
+[])
+
+AC_ARG_ENABLE([static],
+  [AS_HELP_STRING([--enable-static], [enable static linking])],
+  [
+    if test "$enable_static" = "yes"; then
+      CFLAGS="$CFLAGS -static"
+    fi
+  ])
+
+dnl AIX needs -lc128
+AC_EGREP_CPP([^yes$], [#ifdef _AIX
+yes
+#endif
+], [LIBS="$LIBS -lc128"])
+
+if test "$IPC_SUPPORT" = "yes"; then
+  AC_CHECK_HEADERS([sys/ipc.h], [], [IPC_SUPPORT=no])
+  AC_CHECK_HEADERS([sys/shm.h], [], [IPC_SUPPORT=no])
+  AC_CHECK_HEADERS([sys/param.h])
+  if test "$IPC_SUPPORT" = "yes"; then
+    AC_CHECK_FUNCS([shmget], [], [IPC_SUPPORT=no])
+  fi
+fi
+
+if test "$IPC_SUPPORT" = "yes"; then
+  AC_DEFINE([HAVE_IPC], [1], [IPC support enabled])
+fi
+
+if test "$SPLICE_SUPPORT" = "yes"; then
+  AC_CHECK_FUNCS([splice])
+fi
+
+CPPFLAGS="$CPPFLAGS -I\$(top_srcdir)/src/include"
+
+dnl This must go after all the compiler based tests above.
+AC_LANG_WERROR
+
+AC_CONFIG_FILES([
+ po/Makefile.in
+ Makefile
+])
+
+AC_OUTPUT

doc/ACKNOWLEDGEMENTS.md

@@ -1,87 +0,0 @@
-The following people have contributed to this project, and their assistance
-is acknowledged and greatly appreciated:
-
- * Antoine Beaupré <anarcat@debian.org> - Debian package maintainer
- * Kevin Coyner <kcoyner@debian.org> - previous Debian package maintainer
- * Cédric Delfosse <cedric@debian.org> - previous Debian package maintainer
- * Jakub Hrozek <jhrozek@redhat.com> - Fedora package maintainer
- * Eduardo Aguiar <eduardo.oliveira@sondabrasil.com.br> - provided Portuguese (Brazilian) translation
- * Stéphane Lacasse <stephane@gorfou.ca> - provided French translation
- * Marcos Kreinacke <public@kreinacke.com> - provided German translation
- * Bartosz Feński <fenio@o2.pl> <http://skawina.eu.org/> - provided Polish translation along with Krystian Zubel
- * Joshua Jensen - reported RPM installation bug
- * Boris Folgmann <http://www.folgmann.com/en/> - reported cursor handling bug
- * Mathias Gumz - reported NLS bug
- * Daniel Roethlisberger - submitted patch to use lockfiles for "`-c`" if terminal locking fails
- * Adam Buchbinder - lots of help with a Cygwin port of "`-c`"
- * Mark Tomich <http://metuchen.dyndns.org> - suggested "`-B`" option
- * Gert Menke - reported bug when piping to `dd` with a large input buffer size
- * Ville Herva <Ville.Herva@iki.fi> - informative bug report about rate limiting performance
- * Elias Pipping - patch to compile properly on Darwin 9; potential NULL deref report
- * Patrick Collison - similar patch for OS X
- * Boris Lohner - reported problem that "`-L`" does not complain if given non-numeric value
- * Sebastian Kayser - supplied testing for *SIGPIPE*, demonstrated internationalisation problem
- * Laszlo Ersek <http://phptest11.atw.hu/> - reported shared memory leak on *SIGINT* with "`-c`"
- * Phil Rutschman <http://bandgap.rsnsoft.com/> - provided a patch for fully restoring terminal state on exit
- * Henry Precheur <http://henry.precheur.org/> - reporting and suggestions for "`--rate-limit`" bug when rate is under 10
- * E. Rosten <http://mi.eng.cam.ac.uk/~er258/> - supplied patch for block buffering in line mode
- * Kjetil Torgrim Homme - reported compilation error with default *CFLAGS* on non-GCC compilers
- * Alexandre de Verteuil - reported bug in OS X build and supplied test environment to fix in
- * Martin Baum - supplied patch to return nonzero exit status if terminated by signal
- * Sam Nelson <http://www.siliconfuture.net/> - supplied patch to fix trailing slash on *DESTDIR*
- * Daniel Pape - reported Cygwin installation problem due to *DESTDIR*
- * Philipp Beckers - ported to the Syabas PopcornHour A-100 series
- * Henry Gebhard <hsggebhardt@googlemail.com> - supplied patches to improve SI prefixes and add "`--average-rate`"
- * Vladimir Kokarev, Alexander Leo - reported that exit status did not reflect file errors
- * Thomas Rachel - submitted patches for IEEE1541 (MiB suffixes), 1+e03 bug
- * Guillaume Marcais - submitted speedup patch for line mode
- * Moritz Barsnick - submitted patch for compile warning in size calculation
- * Pawel Piatek - submitted RPM and patches for AIX
- * Sami Liedes - submitted patch for "`--timer`" and "`--bytes`" with "`--numeric`"
- * Steven Willis - reported problem with "`-R`" killing non-PV remote processes
- * Vladimir Pal, Vladimir Ermakov - submitted patch which led to development of "`--format`" option
- * Peter Samuelson <peter@p12n.org> - submitted patch to calculate size if stdout is a block device
- * Miguel Diaz - much Cygwin help (and packaging), found narrow-terminal bug
- * Jim Salter <http://ubuntuwiki.net> - commissioned work on the "`--skip-errors`" option
- * Wouter Pronk - reported build problem on SCO
- * Bryan Dongray <http://www.dongrays.com> - provided patches for test scripts failing on older Red Hats
- * Zev Weiss <www.bewilderbeest.net> - provided patch to fix `splice()` not using stdin
- * Zing Shishak - provided patch for "`--null`" / "`-0`" (count null terminated lines)
- * Jacek Wielemborek <http://deetah.jogger.pl/kategorie/english> - implemented fdwatch in Python, suggested PV port; reported bug with "`-l`" and ETA / size; many other contributions
- * Kim Krecht - suggested buffer fill status and last bytes output display options
- * Cristian Ciupitu <http://ciupicri.github.io>, Josh Stone - pointed out file descriptor leak with helpful suggestions (Josh Stone initially noticed the missing close)
- * Jan Seda - found issue with `splice()` and *SPLICE_F_NONBLOCK* causing slowdown
- * André Stapf - pointed out formatting problem e.g. 13GB -> 13.1GB which should be shown 13.0GB -> 13.1GB; highlighted on-startup row swapping in "`-c`"
- * Damon Harper <http://www.usrbin.ca/> - suggested "`-D`" / "`--delay-start`" option
- * Ganaël Laplanche <http://www.martymac.org> - provided patch for `lstat64()` on systems that do not support it
- * Peter Korsgaard <http://www.buildroot.net/> - provided similar patch for `lstat64()`, specifically for uClibc support; provided AIX cross-compilation patch to fix bug in "`-lc128`" check
- * Ralf Ramsauer <https://blog.ramses-pyramidenbau.de/> - reported bug which dropped transfer rate on terminal resize
- * Michiel Van Herwegen - reported and discussed bug with "`-l`" and ETA / size
- * Erkki Seppälä <http://www.inside.org/~flux/> - provided patch implementing "`-I`"
- * Eric A. Borisch - provided details of compatibility fix for "`%Lu`" in watchpid code
- * Jan Venekamp - reported MacOS buffer size interactions with pipes
- * Matt <https://github.com/lemonsqueeze/pv> - provided "rate-window" patches for rate calculation
- * [Filippo Valsorda](https://github.com/FiloSottile) - provided patch for stat64 issue on Apple Silicon
- * Matt Koscica, William Dillon - also reported stat64 issue on Apple Silicon
- * [Demitri Muna](https://github.com/demitri) - assisted with stat64 patch on Apple Silicon
- * Norman Rasmussen - suggested "`-c`" with "`-d PID:FD`", reject "`-N`" with "`-d PID`"
- * Andriy Gapon, Jonathan Elchison - reported bug where "`pv /dev/zero >/dev/null &`" stops immediately
- * Marcelo Chiesa - reported unused-result warnings when compiling PV 1.6.6
- * Jered Floyd - provided patches to improve "`--rate-limit`"
- * Christoph Biedl - provided ETA and dynamic interval patches
- * Richard Fonfara - provided German translations for "`pv --help`"
- * Johannes Gerer <http://johannesgerer.com> - suggested that "`-B`" should enable "`-C`"
- * Sam James - provided fix for number.c build issue caused by missing stddef.h
- * Jakub Wilk <jwilk@jwilk.net> - corrected README encoding
- * Frederik Eaton - reported issue with `<()` shell constructs
- * [gray](https://github.com/gray) - reported issue with "`--force`" and terminal process groups, and proposed a patch
- * [Luc Gommans](https://github.com/lgommans) / https://lgms.nl/ - provided a "momentary ETA" patch
- * [ikasty](https://github.com/ikasty) - added relative filename display to "`--watchfd`"
- * [Michael Weiß](https://github.com/quitschbo) - corrected behaviour when not attached to a terminal
- * [christoph-zededa](https://github.com/christoph-zededa) - provided OS X support for "`--watchfd`"
- * [Dave Beckett](https://github.com/dajobe) - added "`@filename`" syntax to "`--size`", and corrected an autoconf problem with stat64 on OS X
- * [Volodymyr Bychkovyak](https://github.com/vbychkoviak) - provided fix for rate limit behaviour with bursty traffic
- * [Nick Black](https://nick-black.com) - added "`--bits`" option
- * [Andrew Schulman](https://github.com/andrew-schulman) - provided reproducible example of terminal size detection issue in 1.7.17/1.7.18
-
----

doc/COPYING

@@ -1,171 +0,0 @@
-This package is free software, and is being distributed under the terms
-of the Artistic License 2.0.
-
-----------------------------------------------------------
-
-Artistic License 2.0
-
-Copyright (c) 2000-2006, The Perl Foundation.
-
-Everyone is permitted to copy and distribute verbatim copies of this
-license document, but changing it is not allowed.  Preamble
-
-This license establishes the terms under which a given free software
-Package may be copied, modified, distributed, and/or redistributed. The
-intent is that the Copyright Holder maintains some artistic control
-over the development of that Package while still keeping the Package
-available as open source and free software.
-
-You are always permitted to make arrangements wholly outside of this
-license directly with the Copyright Holder of a given Package. If the
-terms of this license do not permit the full use that you propose to
-make of the Package, you should contact the Copyright Holder and seek
-a different licensing arrangement.  Definitions
-
-"Copyright Holder" means the individual(s) or organization(s) named in
-the copyright notice for the entire Package.
-
-"Contributor" means any party that has contributed code or other material
-to the Package, in accordance with the Copyright Holder's procedures.
-
-"You" and "your" means any person who would like to copy, distribute,
-or modify the Package.
-
-"Package" means the collection of files distributed by the Copyright
-Holder, and derivatives of that collection and/or of those files. A given
-Package may consist of either the Standard Version, or a Modified Version.
-
-"Distribute" means providing a copy of the Package or making it accessible
-to anyone else, or in the case of a company or organization, to others
-outside of your company or organization.
-
-"Distributor Fee" means any fee that you charge for Distributing this
-Package or providing support for this Package to another party. It does
-not mean licensing fees.
-
-"Standard Version" refers to the Package if it has not been modified,
-or has been modified only in ways explicitly requested by the Copyright
-Holder.
-
-"Modified Version" means the Package, if it has been changed, and such
-changes were not explicitly requested by the Copyright Holder.
-
-"Original License" means this Artistic License as Distributed with the
-Standard Version of the Package, in its current version or as it may be
-modified by The Perl Foundation in the future.
-
-"Source" form means the source code, documentation source, and
-configuration files for the Package.
-
-"Compiled" form means the compiled bytecode, object code, binary, or any
-other form resulting from mechanical transformation or translation of
-the Source form.  Permission for Use and Modification Without Distribution
-
-(1) You are permitted to use the Standard Version and create and use
-Modified Versions for any purpose without restriction, provided that you
-do not Distribute the Modified Version.  Permissions for Redistribution
-of the Standard Version
-
-(2) You may Distribute verbatim copies of the Source form of the Standard
-Version of this Package in any medium without restriction, either gratis
-or for a Distributor Fee, provided that you duplicate all of the original
-copyright notices and associated disclaimers. At your discretion, such
-verbatim copies may or may not include a Compiled form of the Package.
-
-(3) You may apply any bug fixes, portability changes, and other
-modifications made available from the Copyright Holder. The resulting
-Package will still be considered the Standard Version, and as such will
-be subject to the Original License.  Distribution of Modified Versions
-of the Package as Source
-
-(4) You may Distribute your Modified Version as Source (either gratis
-or for a Distributor Fee, and with or without a Compiled form of the
-Modified Version) provided that you clearly document how it differs
-from the Standard Version, including, but not limited to, documenting
-any non-standard features, executables, or modules, and provided that
-you do at least ONE of the following:
-
-(a) make the Modified Version available to the Copyright Holder of the
-Standard Version, under the Original License, so that the Copyright Holder
-may include your modifications in the Standard Version.
-(b) ensure that installation of your Modified Version does not prevent the
-user installing or running the Standard Version. In addition, the Modified
-Version must bear a name that is different from the name of the Standard
-Version.
-(c) allow anyone who receives a copy of the Modified Version to make
-the Source form of the Modified Version available to others under
-(i) the Original License or
-(ii) a license that permits the licensee to freely copy, modify and
-redistribute the Modified Version using the same licensing terms that apply
-to the copy that the licensee received, and requires that the Source form of
-the Modified Version, and of any works derived from it, be made freely
-available in that license fees are prohibited but Distributor Fees are
-allowed.  Distribution of Compiled Forms of the Standard Version or Modified
-Versions without the Source
-
-(5) You may Distribute Compiled forms of the Standard Version without
-the Source, provided that you include complete instructions on how to
-get the Source of the Standard Version. Such instructions must be valid
-at the time of your distribution. If these instructions, at any time
-while you are carrying out such distribution, become invalid, you must
-provide new instructions on demand or cease further distribution. If
-you provide valid instructions or cease distribution within thirty days
-after you become aware that the instructions are invalid, then you do
-not forfeit any of your rights under this license.
-
-(6) You may Distribute a Modified Version in Compiled form without the
-Source, provided that you comply with Section 4 with respect to the
-Source of the Modified Version.  Aggregating or Linking the Package
-
-(7) You may aggregate the Package (either the Standard Version or
-Modified Version) with other packages and Distribute the resulting
-aggregation provided that you do not charge a licensing fee for the
-Package. Distributor Fees are permitted, and licensing fees for other
-components in the aggregation are permitted. The terms of this license
-apply to the use and Distribution of the Standard or Modified Versions
-as included in the aggregation.
-
-(8) You are permitted to link Modified and Standard Versions with other
-works, to embed the Package in a larger work of your own, or to build
-stand-alone binary or bytecode versions of applications that include the
-Package, and Distribute the result without restriction, provided the
-result does not expose a direct interface to the Package.  Items That
-are Not Considered Part of a Modified Version
-
-(9) Works (including, but not limited to, modules and scripts) that
-merely extend or make use of the Package, do not, by themselves, cause
-the Package to be a Modified Version. In addition, such works are not
-considered parts of the Package itself, and are not subject to the terms
-of this license.  General Provisions
-
-(10) Any use, modification, and distribution of the Standard or Modified
-Versions is governed by this Artistic License. By using, modifying or
-distributing the Package, you accept this license. Do not use, modify,
-or distribute the Package, if you do not accept this license.
-
-(11) If your Modified Version has been derived from a Modified Version
-made by someone other than you, you are nevertheless required to ensure
-that your Modified Version complies with the requirements of this license.
-
-(12) This license does not grant you the right to use any trademark,
-service mark, tradename, or logo of the Copyright Holder.
-
-(13) This license includes the non-exclusive, worldwide, free-of-charge
-patent license to make, have made, use, offer to sell, sell, import
-and otherwise transfer the Package with respect to any patent claims
-licensable by the Copyright Holder that are necessarily infringed by the
-Package. If you institute patent litigation (including a cross-claim or
-counterclaim) against any party alleging that the Package constitutes
-direct or contributory patent infringement, then this Artistic License
-to you shall terminate on the date that such litigation is filed.
-
-(14) Disclaimer of Warranty: THE PACKAGE IS PROVIDED BY THE COPYRIGHT
-HOLDER AND CONTRIBUTORS "AS IS' AND WITHOUT ANY EXPRESS OR IMPLIED
-WARRANTIES. THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
-PARTICULAR PURPOSE, OR NON-INFRINGEMENT ARE DISCLAIMED TO THE EXTENT
-PERMITTED BY YOUR LOCAL LAW. UNLESS REQUIRED BY LAW, NO COPYRIGHT HOLDER
-OR CONTRIBUTOR WILL BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, OR
-CONSEQUENTIAL DAMAGES ARISING IN ANY WAY OUT OF THE USE OF THE PACKAGE,
-EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
-
-----------------------------------------------------------

doc/DEVELOPERS.md

@@ -1,125 +0,0 @@
-Notes for developers and translators
-====================================
-
-The following "`configure`" options will be of interest to developers and
-translators:
-
- * `--enable-debugging` - build in debugging support
- * `--enable-profiling` - build in support for profiling
- * `--enable-static-nls` - compile translations directly into the program
-
-These "`make`" targets are available:
-
- * `make help` - describe all of the "`.PHONY`" targets
- * `make index` - generate a source code index
- * `make analyse` - run _splint_ and _flawfinder_ on all C source files
-
-
-Debugging and profiling support
--------------------------------
-
-When "`./configure --enable-debugging`" is used, the "`pv`" produced by
-"`make`" will support an extra option, "`--debug FILE`", which will cause
-debugging output to be written to *FILE*.  This is not recommended for
-production builds due to the extra processing it introduces, and the
-potential size of the output.
-
-Within the code, "`debug()`" is used in a similar way to "`printf()`".  It
-will automatically include the calling function, source file, and line
-number, so they don't need to be included in the parameters.  When debugging
-support is not enabled, it evaluates to a null statement.
-
-This does mean that if you call "`debug()`", make sure it has no side
-effects, as they won't be present in builds without debugging support.
-
-Builds produced after "`./configure --enable-profiling`" will write profile
-data when run, to be used with _gprof_.  See "`man gprof`" for details.
-
-
-Source code indexing
---------------------
-
-Running "`make index`" calls a script which uses _cproto_ and _ctags_ to
-generate a single file, "`index.html`", which lists all C source files, all
-functions within them, and all TODOs marked in the code.
-
-It relies on each function having a comment block directly before it,
-describing what it does.
-
-The indexing script pre-dates the author's knowledge of documentation
-generation tools like Doxygen, and is over 20 years old.  If it contains
-bugs, then rather than fixing them, it may be worth looking at how to alter
-the C sources to better suit widely available documentation generation
-tools.  Please open issues or start discussions about this if it comes up.
-
-
-Source code analysis
---------------------
-
-Running "`make analyse`" runs _splint_ and _flawfinder_ on all C sources,
-writing the output of both programs to files named "`*.e`" for each "`*.c`".
-
-There are no dependency rules set up for these "`.e`" files, so if a header
-file is altered, either run "`make analysisclean`", manually remove the
-relevant "`.e`" files, or update the timestamp of the relevant "`.c`" files
-before running "`make analyse`" again.
-
-The eventual goal is for all C source files to generate zero warnings from
-either tool.
-
-
-Translation notes
------------------
-
-The message catalogues used to translate program messages into other
-languages are in the "`src/nls/`" directory, named "`xx.po`", where "`xx`"
-is the ISO 639-1 2-letter language code, such as "`fr`" for French.
-
-Each of these files contains lines like this:
-
-    #: src/pv/cursor.c:85
-    msgid "failed to get terminal name"
-    msgstr "erro ao ler o nome do terminal"
-
-The comment line, starting "`#`", shows the source filename and line number
-at which this message can be found.  The "`msgid`" is the original message
-in the program, in English.  The "`msgstr`" is the translated text.
-
-It is the "`msgstr`" lines which need to be updated by translators.
-
-Message catalogue files should all be encoded as UTF-8.
-
-To quickly test translations, use "`./configure --enable-static-nls`".  This
-is not recommended for production use, because it replaces the system
-internationalisation libraries with some very simplistic alternatives, but
-it has the benefit of compiling the message catalogues directly into the
-program.
-
-This means that after making a change to a "`.po`" file, do this:
-
-    make
-    LANG=de LC_ALL=en_GB.UTF-8 ./pv --help
-
-Replace "`--help`" with whatever is appropriate for your test.  In this
-example, the language being tested is "`de`" (German), on a system which is
-otherwise running in English with UTF-8 support.
-
-To add a new language, edit "`autoconf/configure.in`".  Look for this line:
-
-    for lang in de fr pl pt; do
-
-Add the new language code before the "`; do`".
-
-Create the new message catalogue file under "`src/nls/`" by copying
-"`src/nls/pv.pot`" to "`src/nls/xx.po`", where "`xx`" is the language code,
-and adjusting it.
-
-Then run "`./generate.sh`" to generate a new "`configure`" script; you will
-need to run "`./configure --enable-static-nls`" and "`make`" afterwards.
-
-When the source code is updated, running "`make`" will update the "`pv.pot`"
-file so that it lists where all the messages are in the source, and running
-"`make update-po`" will use _msgmerge_ to update all of the "`.po`" files
-from the updated "`pv.pot`" file.  After doing this, look for missing
-translations (empty "`msgstr`" lines) or translations marked as "fuzzy", as
-these will need to be corrected by translators.

doc/NEWS.md

@@ -1,425 +0,0 @@
-1.7.24 - 30 July 2023
-
-  * fix: correct terminal size detection, broken in 1.7.17 by the configuration script rewrite ([GH#72](https://github.com/a-j-wood/pv/issues/72))
-  * security: removed *DEBUG* environment variable in debug mode, added "`--debug`" instead
-  * cleanup: added "`make analyse`" to run "`splint`" and "`flawfinder`" on all source files
-  * cleanup: corrected detection of boolean capability
-  * cleanup: word wrapping of "`--help`" output is now multi-byte locale aware
-  * cleanup: adjusted "`indent`" rules to line length of 120 and reformatted code
-
-1.7.18 - 28 July 2023 
-
-  * fix: language file installation had been broken by the configuration script rewrite
-
-1.7.17 - 27 July 2023
-
- * feature: new "`--sync`" option to flush cache to disk after every write (related to [GH#6](https://github.com/a-j-wood/pv/issues/6), to improve accuracy when writing to slow disks)
- * feature: new "`--direct-io`" option to bypass cache - implements [GH#29 "Option to enable *O_DIRECT*"](https://github.com/a-j-wood/pv/issues/29) - requested by Romain Kang, Jacek Wielemborek
- * fix: correct byte prefix size to 2 spaces in rate display, so progress display size remains constant at low transfer rates
- * cleanup: rewrote `configure.in` as per suggestions in newer "`autoconf`" manuals
- * cleanup: replaced `header.in` with one generated by "`autoheader`", moving custom logic to a separate header file "`config-aux.h`"
- * cleanup: added copyright notice to all source files as per GNU standards
- * cleanup: changed "`--version`" output to conform to GNU standards
- * cleanup: replaced backticks with `$()` in all shell scripts that did not come from elsewhere, as backticks are deprecated and harder to read
- * cleanup: improved the output formatting of "`make test`"
- * cleanup: extended the "`make test`" mechanism to allow certain tests to be skipped on platforms that cannot support them
- * cleanup: skip the "pipe" test (for *SIGPIPE*) if GNU "`head`" is not available, so that "`make test`" on stock OpenBSD 7.3 works
- * cleanup: added a lot more tests to "`make test`"
- * cleanup: replace all calls to `sprintf()` and `snprintf()` with a new wrapper function `pv_snprintf()` to improve security and compatibility
- * cleanup: replace all calls to `strcat()` with a wrapper `pv_strlcat()` to improve security and compatibility
- * cleanup: replace all `write()` calls to the terminal with a wrapper `pv_write_retry()` for consistency
- * cleanup: tidy up and fix compilation warning in "`--watchfd`" code
- * cleanup: rewrote all local shell scripts to pass analysis by [ShellCheck](https://www.shellcheck.net)
-
-1.7.0 - 17 July 2023
-
- * dropped: support for Red Hat Enterprise Linux and its derivatives has been dropped; removed the RPM spec file, and will no longer build binaries
- * feature: the "`--size`" option now accepts "`@filename`" to use the size of another file (pull request [#57](https://github.com/a-j-wood/pv/pull/57) supplied by [Dave Beckett](https://github.com/dajobe))
- * feature: the "`--watchfd`" option is now available on OS X (pull request [#60](https://github.com/a-j-wood/pv/pull/60) supplied by [christoph-zededa](https://github.com/christoph-zededa))
- * feature: new "`--bits`" option to show bit count instead of byte count (adapted from pull request [#63](https://github.com/a-j-wood/pv/pull/63) supplied by [Nick Black](https://nick-black.com))
- * feature: new "`--average-rate-window`" option, to set the window over which the average rate is calculated, also used for ETA (modified from pull request [#65](https://github.com/a-j-wood/pv/pull/65) supplied by [lemonsqueeze](https://github.com/lemonsqueeze))
- * feature: the "`--watchfd`" option will now show relative filenames, if they are under the current directory (pull request [#66](https://github.com/a-j-wood/pv/pull/66) supplied by [ikasty](https://github.com/ikasty))
- * fix: correction to `pv_in_foreground()` to behave as its comment block says it should, when not on a terminal - corrects [GH#19 "No output in Arch Linux initcpio after 1.6.6"](https://github.com/a-j-wood/pv/issues/19), [GH#31 "No output written from inside zsh <() construct"](https://github.com/a-j-wood/pv/issues/31), [GH#55 "pv Stopped Working in the Background"](https://github.com/a-j-wood/pv/issues/55) (pull request [#64](https://github.com/a-j-wood/pv/pull/64) supplied by [Michael Weiß](https://github.com/quitschbo))
- * fix: workaround for OS X 11 behaviour in configure script regarding stat64 at compile time (pull request [#57](https://github.com/a-j-wood/pv/pull/57) supplied by [Dave Beckett](https://github.com/dajobe))
- * fix: workaround for macOS equivalence of stat to stat64 - patches from [Filippo Valsorda](https://github.com/FiloSottile) and [Demitri Muna](https://github.com/demitri), correcting [GH#33 "Fix compilation problems due to `stat64()` on Apple Silicon"](https://github.com/a-j-wood/pv/issues/33)
- * fix: add burst rate limit to transfer, so rate limits are not broken by bursty traffic (pull request [#62](https://github.com/a-j-wood/pv/pull/62) supplied by [Volodymyr Bychkovyak](https://github.com/vbychkoviak))
- * fix: corrected "`--force`" option so it will still output progress when not in the same process group as the owner of the terminal - corrects [GH#23 "No output with "`-f`" when run in background after 1.6.6"](https://github.com/a-j-wood/pv/issues/23) and helps to correct [GH#31 "No output written from inside zsh <() construct"](https://github.com/a-j-wood/pv/issues/31)
- * fix: corrected elapsed time display to show as D:HH:MM:SS after 1 day, like the ETA does - corrects [GH#16 "Show days in same format in ETA as in elapsed time"](https://github.com/a-j-wood/pv/issues/16)
- * fix: corrected bug where percentages went down after 100% when in "`--numeric`" mode with a "`--size`" that was too small - corrects [GH#26 "Correct "`-n`" behaviour when going past 100% of "`-s`" size"](https://github.com/a-j-wood/pv/issues/26)
- * i18n: recoded Polish translation file to UTF-8
- * i18n: removed inaccurate fuzzy translation matches
- * docs: moved all open issues into GitHub and updated the TODO list
- * docs: renamed README to README.md and altered it to Markdown format
- * docs: moved contributors from the README to docs/ACKNOWLEDGEMENTS.md
- * docs: moved TODO to TODO.md and altered it to Markdown format
- * docs: moved NEWS to NEWS.md, converted it to UTF-8, and altered it to Markdown format
-
-1.6.20 - 12 September 2021
-
- * fix: add missing `stddef.h` include to `number.c` (Sam James)
-
-1.6.19 - 5 September 2021
-
- * fix: starting pv in the background no longer immediately stops unless the transfer is to/from the terminal (Andriy Gapon, Jonathan Elchison)
- * fix: using "`-B`", "`-A`", or "`-T`" now switches on "`-C`" implicitly (Johannes Gerer, André Stapf)
- * fix: AIX build fixes (Peter Korsgaard)
- * i18n: updated German "`--help`" translations (Richard Fonfara)
- * i18n: switched to UTF-8 encoding, added missing translations (de,fr,pt)
- * docs: new "common switches" manual section (Jacek Wielemborek)
- * docs: use placeholder instead of `/dev/sda` in the manual (Pranav Peshwe)
- * docs: mention MacOS pipes and "`-B 1024`" in the manual (Jan Venekamp)
- * docs: correct shell in `autoconf/scripts/index.sh` (Juan Picca)
- * cleanup: various compiler warnings cleaned up
-
- Full changelog is below:
- * (r181) added common switches section to manual (Jacek Wielemborek)
- * (r184) use placeholder instead of /dev/sda in the manual (Pranav Peshwe)
- * (r185) replace ash with sh in autoconf/scripts/index.sh (Juan Picca)
- * (r185) added note to manual about "`-B 1024`" in MacOS pipes (Jan Venekamp)
- * (r185) fix AIX config check when the CWD contains "yes" (Peter Korsgaard)
- * (r189) (#1556) updated German "`--help`" translations (Richard Fonfara)
- * (r189) updated missing German translations and changed to UTF-8 encoding
- * (r191) updated missing French translations and changed to UTF-8 encoding
- * (r193) updated missing Portuguese translations, changed to UTF-8 encoding
- * (r196) (#1563) using "`-B`", "`-A`", or "`-T`" now switches on "`-C`" implicitly (Johannes Gerer, André Stapf)
- * (r199) fixed numerous compiler warnings in newer GCC versions
- * (r200,205) fixed bug where "`pv /dev/zero >/dev/null &`" stopped immediately (Jonathan Elchison, Andriy Gapon)
- * (r203,205) marked unused arguments with GCC unused attribute, started using boolean data type for flags, corrected more compiler warnings
-
-1.6.6 - 30 June 2017
-
- * (r161) use `%llu` instead of `%Lu` for better compatibility (Eric A. Borisch)
- * (r162) (#1532) fix target buffer size ("`-B`") being ignored (AndCycle, Ilya Basin, Antoine Beaupré)
- * (r164) cap read/write sizes, and check elapsed time during read/write cycles, to avoid display hangs with large buffers or slow media; also remove `select()` call from repeated_write function as it slows the transfer down and the wrapping `alarm()` means it is unnecessary
- * (r169) (#1477) use alternate form for transfer counter, such that 13GB is shown as 13.0GB so it's the same width as 13.1GB (André Stapf)
- * (r171) cleanup: units corrections in man page, of the form kb -> KiB
- * (r175) report error in "`-d`" if process fd directory is unreadable, or if process disappears before we start the main loop (Jacek Wielemborek)
-
-1.6.0 - 15 March 2015
-
- * fix lstat64 support when unavailable - separate patches supplied by Ganael Laplanche and Peter Korsgaard
- * (#1506) new option "`-D`" / "`--delay-start`" to only show bar after N seconds (Damon Harper)
- * new option "`--fineta`" / "`-I`" to show ETA as time of day rather than time remaining - patch supplied by Erkki Seppälä (r147)
- * (#1509) change ETA ("`--eta`" / "`-e`") so that days are given if the hours remaining are 24 or more (Jacek Wielemborek)
- * (#1499) repeat read and write attempts on partial buffer fill/empty to work around post-signal transfer rate drop reported by Ralf Ramsauer
- * (#1507) do not try to calculate total size in line mode, due to bug reported by Jacek Wielemborek and Michiel Van Herwegen
- * cleanup: removed defunct RATS comments and unnecessary copyright notices
- * clean up displayed lines when using "`--watchfd PID`", when PID exits
- * output errors on a new line to avoid overwriting transfer bar
-
-1.5.7 - 26 August 2014
-
- * show KiB instead of incorrect kiB (Debian bug #706175)
- * (#1284) do not gzip man page, for non-Linux OSes (Bob Friesenhahn)
- * work around "awk" bug in `tests/016-numeric-timer` in decimal "," locales
- * fix "`make rpm`" and "`make srpm`", extend "`make release`" to sign releases
-
-1.5.3 - 4 May 2014
-
- * remove *SPLICE_F_NONBLOCK* to fix problem with slow `splice()` (Jan Seda)
-
-1.5.2 - 10 February 2014
-
- * allow "`--watchfd`" to look at block devices
- * let "`--watchfd PID:FD`" work with "`--size N`"
- * moved contributors out of the manual as the list was too long (NB everyone is still listed in the README and always will be)
-
-1.5.1 - 23 January 2014
-
- * new option "`--watchfd`" - suggested by Jacek Wielemborek and "fdwatch"
- * use non-block flag with `splice()`
- * new display option "`--buffer-percent`", suggested by Kim Krecht
- * new display option "`--last-written`", suggested by Kim Krecht
- * new transfer option "`--no-splice`"
- * fix for minor bug which dropped display elements after one empty one
- * fix for single fd leak on exit (Cristian Ciupitu)
-
-1.4.12 - 5 August 2013
-
- * new option "`--null`" - patch supplied by Zing Shishak
- * AIX build fix (add "`-lc128`") - with help from Pawel Piatek
- * AIX "`-c`" fixes - with help from Pawel Piatek
- * SCO build fix (`po2table.sh`) - reported by Wouter Pronk
- * test scripts fix for older distributions - patch from Bryan Dongray
- * fix for `splice()` not using stdin - patch from Zev Weiss
-
-1.4.6 - 22 January 2013
-
- * added patch from Pawel Piatek to omit *O_NOFOLLOW* in AIX
-
-1.4.5 - 10 January 2013
-
- * updated manual page to show known problem with "`-R`" on Cygwin
-
-1.4.4 - 11 December 2012
-
- * added debugging, see "`pv -h`" when `configure` is run with "`--enable-debugging`"
- * rewrote cursor positioning code used when IPC is unavailable (Cygwin)
- * fixed cursor positioning cursor read answerback problem (Cygwin/Solaris)
- * fixed bug causing crash when progress displayed with too-small terminal
-
-1.4.0 - 6 December 2012
-
- * new option "`--skip-errors`" commissioned by Jim Salter
- * if stdout is a block device, and we don't know the total size, use the size of that block device as the total (Peter Samuelson)
- * new option "`--stop-at-size`" to stop after "`--size`" bytes
- * report correct filename on read errors
- * fix use-after-free bug in remote PID cleanup code
- * refactored large chunks of code to make it more readable and to replace most static variables with a state structure
-
-1.3.9 - 5 November 2012
-
- * allow "`--format`" parameters to be sent with "`--remote`"
- * configure option "`--disable-ipc`"
- * added tests for "`--numeric`" with "`--timer`" and "`--bytes`"
- * added tests for "`--remote`"
-
-1.3.8 - 29 October 2012
-
- * new "`--pidfile`" option to save process ID to a file
- * integrated patch for "`--numeric`" with "`--timer`" and "`--bytes`" (Sami Liedes)
- * removed signalling from "`--remote`" to prevent accidental process kills
- * new "`--format`" option (originally Vladimir Pal / Vladimir Ermakov)
-
-1.3.4 - 27 June 2012
-
- * new "`--disable-splice`" configure script option
- * fixed line mode size count with multiple files (Moritz Barsnick)
- * fixes for AIX core dumps (Pawel Piatek)
-
-1.3.1 - 9 June 2012
-
- * do not use `splice()` if the write buffer is not empty (Thomas Rachel)
- * added test 15 (pipe transfers), and new test script
-
-1.3.0 - 5 June 2012
-
- * added Tiger build patch from Olle Jonsson
- * fix 1024-boundary display garble (Debian bug #586763)
- * use `splice`(2) where available (Debian bug #601683)
- * added known bugs section of the manual page
- * fixed average rate test, 12 (Andrew Macheret)
- * use IEEE1541 units (Thomas Rachel)
- * bug with rate limit under 10 fixed (Henry Precheur)
- * speed up PV line mode (patch: Guillaume Marcais)
- * remove `LD=ld` from `vars.mk` to fix cross-compilation (paintitgray/PV#1291)
-
-1.2.0 - 14 December 2010
-
- * integrated improved SI prefixes and "`--average-rate`" (Henry Gebhardt)
- * return nonzero if exiting due to *SIGTERM* (Martin Baum)
- * patch from Phil Rutschman to restore terminal properly on exit
- * fix i18n especially for "`--help`" (Sebastian Kayser)
- * refactored `pv_display`
- * we now have a coherent, documented, exit status
- * modified pipe test and new cksum test from Sebastian Kayser
- * default *CFLAGS* to just "`-O`" for non-GCC (Kjetil Torgrim Homme)
- * LFS compile fix for OS X 10.4 (Alexandre de Verteuil)
- * remove *DESTDIR* `/` suffix (Sam Nelson, Daniel Pape)
- * fixed potential NULL deref in transfer (Elias Pipping / LLVM/Clang)
-
-1.1.4 - 6 March 2008
-
- * patch from Elias Pipping correcting compilation failure on Darwin 9
- * patch from Patrick Collison correcting similar problems on OS X
- * trap *SIGINT* / *SIGHUP* / *SIGTERM* so we clean up IPCs on exit (Laszlo Ersek)
- * abort if numeric option, eg "`-L`", has non-numeric value (Boris Lohner)
-
-1.1.0 - 30 August 2007
-
- * new option "`--remote`" ("`-R`") to control an already-running process
- * new option "`--line-mode`" ("`-l`") to count lines instead of bytes
- * fix for "`-L`" to be less resource intensive
- * fix for input/output equivalence check on Mac OS X
- * fix for size calculation in pipelines on Mac OS X
- * fixed "`make uninstall`"
- * removed "`/debian`" directory at request of new Debian maintainer
-
-1.0.1 - 4 August 2007
-
- * licensing change from Artistic to Artistic 2.0
- * removed the "`-l`" / "`--license`" option
-
-1.0.0 - 2 August 2007
-
- * act more like "`cat`" - just skip unreadable files, don't abort
- * removed text version of manual page, and obsolete Info file generation
- * code cleanup and separation of PV internals from CLI front-end
-
-0.9.9 - 5 February 2007
-
- * new option "`--buffer-size`" ("`-B`") suggested by Mark Tomich
- * build fix: HP/UX largefile compile fix from Timo Savinen
- * maintain better buffer filling during transfers
- * workaround: "`pv /dev/zero | dd bs=1M count=1k`" bug (reported by Gert Menke)
- * dropped support for the Texinfo manual
-
-0.9.6 - 27 February 2006
-
- * bugfix: `key_t` incompatibility with Cygwin
- * bugfix: interval ("`-i`") parameter parses numbers after decimal point
- * build fix: use static NLS if `msgfmt` is unavailable
- * on the final update, blank out the now-zero ETA
-
-0.9.2 - 1 September 2005
-
- * Daniel Roethlisberger patch: use lockfiles if terminal locking fails
-
-0.9.1 - 16 June 2005
-
- * minor RPM spec file fix for Fedora Core 4
-
-0.9.0 - 15 November 2004
-
- * minor NLS bugfix
-
-0.8.9 - 6 November 2004
-
- * decimal values now accepted for rate and size, eg "`-L 1.23M`"
- * code cleanup
- * developers: "`make help`" now lists Makefile targets
-
-0.8.6 - 29 June 2004
-
- * use `uu_lock()` for terminal locking on FreeBSD
-
-0.8.5 - 2 May 2004
-
- * cursor positioning ("`-c`") reliability improved on systems with IPC
- * minor fix: made test 005 more reliable
- * new option "`--height`" ("`-H`")
-
-0.8.2 - 24 April 2004
-
- * allow k,m,g,t suffixes on numbers
- * added "`srpm`" and "`release`" Makefile targets
-
-0.8.1 - 19 April 2004
-
- * bugfix in cursor positioning ("`-c`")
-
-0.8.0 - 12 February 2004
-
- * replaced GNU getopt with my library code
- * replaced GNU gettext with my very minimal replacement
- * use *DESTDIR* instead of *RPM_BUILD_ROOT* for optional installation prefix
- * looked for flaws using RATS, cleaned up code
-
-0.7.0 - 8 February 2004
-
- * display buffer management fixes (thanks Cédric Delfosse)
- * replaced "`--enable-debug`" with "`--enable-debugging`" and "`--enable-profiling`"
-
-0.6.4 - 14 January 2004
-
- * fixed minor bug in RPM installation
- * bugfix in "`make index`" (only of interest to developers)
-
-0.6.3 - 22 December 2003
-
- * fixed transient bug that reported "resource unavailable" occasionally
-
-0.6.2 - 6 August 2003
-
- * block devices now have their size read correctly, so "`pv /dev/hda1`" works
- * minor code cleanups (mainly removal of CVS "Id" tags)
-
-0.6.0 - 3 August 2003
-
- * doing *^Z* then "`bg`" then "`fg`" now continues displaying
-
-0.5.9 - 23 July 2003
-
- * fix for test 007 when not in C locale
- * fix for build process to use *CPPFLAGS*
- * fix for build process to use correct i18n libraries
- * fix for build process - more portable sed in dependency generator
- * fix for install process - remember to `mkinstalldirs` before installing
- * fixes for building on Mac OS X
-
-0.5.3 - 4 May 2003
-
- * added Polish translation thanks to Bartosz Feński <fenio@o2.pl> <http://skawina.eu.org/> and Krystian Zubel
- * moved `doc/debian` to `./debian` at insistence of common sense
- * minor Solaris 8 compatibility fixes
- * seems to compile and test OK on Mac OS X
-
-0.5.0 - 15 April 2003
-
- * added French translation thanks to Stéphane Lacasse <stephane@gorfou.ca>
- * added German translation thanks to Marcos Kreinacke <public@kreinacke.com>
- * switched LGPL reference from "Library" to "Lesser"
-
-0.4.9 - 18 February 2003
-
- * support for >2GB files added where available (Debian bug #180986)
- * added `doc/debian` dir (from Cédric Delfosse)
- * added "`make rpm`" and "`make deb`" targets to build RPM and Debian packages
- * added a "`make pv-static`" rule to build a statically linked version
-
-0.4.5 - 13 December 2002
-
- * added Portuguese (Brazilian) translation thanks to Eduardo Aguiar
-
-0.4.4 - 7 December 2002
-
- * pause/resume support - don't count time while stopped
- * stop output when resumed in the background
- * terminal size change support
- * bugfix: "`<=>`" indicator no longer sticks at right hand edge
-
-0.4.0 - 27 November 2002
-
- * allow decimal interval values, eg 0.1, 0.5, etc
- * some simple tests added ("`make check`")
- * smoother throughput limiting ("`--rate-limit`"), now done in 0.1sec chunks
- * bounds-check interval values ("`-i`") - max update interval now 10 minutes
- * more reliable non-blocking output to keep display updated
- * no longer rely on `atoll()`
- * don't output final blank line if "`--numeric`"
- * use `fcntl()` instead of `flock()` for Solaris compatibility
-
-0.3.0 - 25 November 2002
-
- * handle broken output pipe gracefully
- * continue updating display even when output pipe is blocking
-
-0.2.6 - 21 October 2002
-
- * we now ignore *EINTR* on `select()`
- * variable-size buffer (still need to add code to change size)
- * added (tentative) support for internationalisation
- * removed superfluous "`--no-progress`", etc options
- * optimised transfer by using bigger buffers, based on `st_blksize`
- * added "`--wait`" option to wait until transfer begins before showing progress
- * added "`--rate-limit`" option to limit rate to a maximum throughput
- * added "`--quiet`" option (no output at all) to be used with "`--rate-limit`"
-
-0.2.5 - 23 July 2002
-
- * added *[FILE]...* arguments, like "`cat`"
- * function separation in code
- * some bug fixes related to numeric overflow
-
-0.2.3 - 19 July 2002
-
- * Texinfo manual written, man page updated
- * byte counter added
-
-0.2.0 - 18 July 2002
-
- * ETA counter added
- * screen width estimation added
- * progress bar added
-
-0.1.0 - 17 July 2002
-
- * main loop created
- * rate counter added
- * elapsed time counter added
- * percentage calculation added
-
-0.0.1 - 16 July 2002
-
- * package created
- * first draft of man page written

doc/PACKAGE

@@ -1 +0,0 @@
-pv

doc/TODO.md

@@ -1,45 +0,0 @@
-Things still to do.  (GH#n) indicates the Github issue tracker number.
-
-Bugs
-----
-
- * ([GH#5](https://github.com/a-j-wood/pv/issues/5)) Transfer IPC leadership on exit of leader
- * ([GH#13](https://github.com/a-j-wood/pv/issues/13)) Use `clock_gettime()` in ETA calculation to cope with machine suspend/resume (Mateju Miroslav)
- * ([GH#20](https://github.com/a-j-wood/pv/issues/20)) Terminal state is not restored correctly in all cases (VA)
- * ([GH#24](https://github.com/a-j-wood/pv/issues/24)) Race condition with multiple "`pv -c`" leaves terminal state inconsistent (Lars Ellenberg, Viktor Ashirov)
- * ([GH#34](https://github.com/a-j-wood/pv/issues/34)) Continue timer even if input or output is blocking (Martin Probst - Jun 2017)
-
-Feature requests
-----------------
-
- * ([GH#3](https://github.com/a-j-wood/pv/issues/3)) Option ("`-x`"?) to use xterm title line for status (Joachim Haga)
- * ([GH#4](https://github.com/a-j-wood/pv/issues/4)) Option for process title (Martin Sarsale) as "`pv - name:FooProcess -xyz - transferred: 1.3GB - 500KB/s - running: 10:15:30s`"
- * ([GH#6](https://github.com/a-j-wood/pv/issues/6)) Look at effect of *O_SYNC* or `fsync` on performance; update counters during buffer flush
- * ([GH#9](https://github.com/a-j-wood/pv/issues/9)) Option to switch rate to per minute if really slow
- * ([GH#10](https://github.com/a-j-wood/pv/issues/10)) Add watchfd tests
- * ([GH#11](https://github.com/a-j-wood/pv/issues/11)) Option "`--progress-from FILE`", read last number and use it as bytes read (Jacek Wielemborek)
- * ([GH#12](https://github.com/a-j-wood/pv/issues/12)) Allow multiple "`-d`" options (Linus Heckemann for multiple PID:FD; Jacek Wielemborek)
- * ([GH#15](https://github.com/a-j-wood/pv/issues/15)) Use Unicode for more granular progress bar (Alexander Petrossian)
- * ([GH#17](https://github.com/a-j-wood/pv/issues/17)) Allow "`-r`" with "`-l`" and "`-n`" to output lines/sec (Roland Kletzing)
- * ([GH#22](https://github.com/a-j-wood/pv/issues/22)) Options to skip input and seek on output (Jason A. Pfeil, Feb 2022)
- * ([GH#25](https://github.com/a-j-wood/pv/issues/25)) Normalise progress to 100% on overrun (Andrej Gantvorg)
- * ([GH#35](https://github.com/a-j-wood/pv/issues/35)) Allow decimal values for "`-s`", "`-L`", "`-B`" (Thomas Watson - Aug 2020)
- * ([GH#36](https://github.com/a-j-wood/pv/issues/36)) Ignore *SIGWINCH* (window size change) if "`-w`" / "`-H`" provided
- * ([GH#37](https://github.com/a-j-wood/pv/issues/37)) Allow "`-E`" to take a block size argument so errors cause a skip to the next block (Anthony DeRobertis - Oct 2016)
- * ([GH#38](https://github.com/a-j-wood/pv/issues/38)) Reset ETA on *SIGUSR1* (Jacek Wielemborek - Jan 2019)
- * ([GH#39](https://github.com/a-j-wood/pv/issues/39)) Use `posix_fadvise()` like `cat`(1) does (Jacek Wielemborek - Oct 2015)
- * ([GH#40](https://github.com/a-j-wood/pv/issues/40)) Permit "`-c`" with "`-d PID:FD`", reject "`-N`" with "`-d PID`" (Norman Rasmussen - Nov 2020)
- * ([GH#41](https://github.com/a-j-wood/pv/issues/41)) Improve how backwards-moving reads are shown in "`--watchfd`" (Ryan Cooley - Dec 2017)
- * ([GH#42](https://github.com/a-j-wood/pv/issues/42)) Option to discard stdin so nothing is written to stdout (André Stapf - Apr 2017)
- * ([GH#43](https://github.com/a-j-wood/pv/issues/43)) Differentiate between "`--eta`" and "`--fineta`" in display (André Stapf - Apr 2017)
- * ([GH#45](https://github.com/a-j-wood/pv/issues/45)) Option "`--sparse`" (with block size option) to write sparse output (Andriy Galetski - Apr 2019)
- * ([GH#46](https://github.com/a-j-wood/pv/issues/46)) Option to show speed gauge (% max speed) if progress not known (Ryan Cooley - Jun 2019)
- * ([GH#47](https://github.com/a-j-wood/pv/issues/47)) Analyse splice and buffer usage to improve performance
- * ([GH#48](https://github.com/a-j-wood/pv/issues/48)) Option to show multiple files with individual sizes and a cumulative total (Zach Riggle - Jul 2021)
- * ([GH#49](https://github.com/a-j-wood/pv/issues/49)) Option to provide stats for avg/min/max/stddev throughput (Venky.N.Iyer)
- * ([GH#50](https://github.com/a-j-wood/pv/issues/50)) Allow pv to report on a whole pipeline at once (Will Entriken - Feb 2011)
- * ([GH#54](https://github.com/a-j-wood/pv/issues/54)) Run command every n percent ([haarp](https://github.com/haarp))
- * ([GH#56](https://github.com/a-j-wood/pv/issues/56)) Support for backgrounding pv, and allowing it to be monitored separately ([jimbobmcgee](https://github.com/jimbobmcgee))
- * ([GH#67](https://github.com/a-j-wood/pv/issues/67)) Wrap another process to monitor its stdin & stdout ([Alex Mason](https://github.com/axman6))
-
-Any assistance would be appreciated.

doc/VERSION

@@ -1 +0,0 @@
-1.7.24

doc/lsm.in

@@ -1,19 +0,0 @@
-Begin3
-Title:		@PACKAGE@
-Version:	@VERSION@
-Entered-date:	30JUL23
-Description:	A tool for monitoring the progress of data through a
-		pipeline.  It can be inserted into any normal pipeline
-		between two processes to give a visual indication of how
-		quickly data is passing through, how long it has taken, how
-		near to completion it is, and an estimate of how long it
-		will be until completion.
-Keywords:	progress bar, console, pipe, transfer rate
-Author:		Andrew Wood <andrew.wood@ivarch.com>
-Maintained-by:	Andrew Wood <andrew.wood@ivarch.com>
-Primary-site:	http://www.ivarch.com/programs/@PACKAGE@.shtml
-Alternate-site:	
-Original-site:
-Platforms:	
-Copying-policy:	Artistic 2.0
-End

doc/quickref.1.in

@@ -1,681 +0,0 @@
-.TH @UCPACKAGE@ 1 "July 2023" Linux "User Manuals"
-.SH NAME
-@PACKAGE@ \- monitor the progress of data through a pipe
-.SH SYNOPSIS
-.B @PACKAGE@
-[\fIOPTION\fR]
-[\fIFILE\fR]...
-.br
-.B @PACKAGE@
-[\fI\-h\fR|\fI\-V\fR]
-
-
-.SH DESCRIPTION
-.B @PACKAGE@
-shows the progress of data through a pipeline by giving information such as
-time elapsed, percentage completed (with progress bar), current throughput
-rate, total data transferred, and ETA.
-
-To use it, insert it in a pipeline between two processes, with the
-appropriate options.  Its standard input will be passed through to its
-standard output and progress will be shown on standard error.
-
-.B @PACKAGE@
-will copy each supplied
-.B FILE
-in turn to standard output
-.BR "" "(" -
-means standard input), or if no
-.BR FILE s
-are specified just standard input is copied. This is the same behaviour
-as
-.BR cat (1).
-
-A simple example to watch how quickly a file is transferred using
-.BR nc (1):
-
-.RS
-.B @PACKAGE@ file | nc -w 1 somewhere.com 3000
-.RE
-
-A similar example, transferring a file from another process and passing the
-expected size to
-.BR @PACKAGE@ :
-
-.RS
-.B cat file | @PACKAGE@ -s 12345 | nc -w 1 somewhere.com 3000
-.RE
-
-A more complicated example using numeric output to feed into the
-.BR dialog (1)
-program for a full-screen progress display:
- 
-.RS
-.B (tar cf - . \e
-.br
-.B " | @PACKAGE@ -n -s $(du -sb . | awk '{print $1}') \e"
-.br
-.B " | gzip -9 > out.tgz) 2>&1 \e"
-.br
-.B | dialog --gauge 'Progress' 7 70
-.RE
-
-Taking an image of a disk, skipping errors:
-
-.RS
-.B @PACKAGE@ -EE /dev/your/disk/device > disk-image.img
-.RE
-
-Writing an image back to a disk:
-
-.RS
-.B @PACKAGE@ disk-image.img > /dev/your/disk/device
-.RE
-
-Zeroing a disk:
-
-.RS
-.B @PACKAGE@ < /dev/zero > /dev/your/disk/device
-.RE
-
-Note that if the input size cannot be calculated, and the output is a block
-device, then the size of the block device will be used and
-.B @PACKAGE@
-will automatically stop at that size as if
-.B \-S
-had been given.
-
-(Linux only): Watching file descriptor 3 opened by another process 1234:
-
-.RS
-.B @PACKAGE@ -d 1234:3
-.RE
-
-(Linux only): Watching all file descriptors used by process 1234:
-
-.RS
-.B @PACKAGE@ -d 1234
-.RE
-
-
-.SH OPTIONS
-.B @PACKAGE@
-takes many options, which are divided into display switches, output
-modifiers, and general options.
-
-
-.SH DISPLAY SWITCHES
-If no display switches are specified,
-.B @PACKAGE@
-behaves as if
-.BR \-p ", " \-t ", " \-e ", " \-r ", and " \-b
-had been given (i.e. everything except average rate is switched on).
-Otherwise, only those display types that are explicitly switched on will be
-shown.
-.TP
-.B \-p, \-\-progress
-Turn the progress bar on.  If standard input is not a file and no
-size was given (with the
-.B \-s
-modifier), the progress bar cannot indicate how close to completion the
-transfer is, so it will just move left and right to indicate that data is
-moving.
-.TP
-.B \-t, \-\-timer
-Turn the timer on.  This will display the total elapsed time that
-.B @PACKAGE@
-has been running for.
-.TP
-.B \-e, \-\-eta
-Turn the ETA timer on.  This will attempt to guess, based on current
-transfer rates and the total data size, how long it will be before
-completion.  This option will have no effect if the total data size cannot
-be determined.
-.TP
-.B \-I, \-\-fineta
-Turn the ETA timer on, but display the estimated local time of arrival
-instead of time left.  When the estimated time is more than 6 hours in the
-future, the date is shown as well.
-.TP
-.B \-r, \-\-rate
-Turn the rate counter on.  This will display the current rate of data
-transfer.
-.TP
-.B \-a, \-\-average\-rate
-Turn the average rate counter on.  This will display the current average
-rate of data transfer (default: last 30s, see --average-rate-window).
-.TP
-.B \-b, \-\-bytes
-Turn the total byte counter on.  This will display the total amount of
-data transferred so far.
-.TP
-.B \-8, \-\-bits
-Display the total bits instead of the total bytes.  The output suffix will
-be "b" instead of "B".
-.TP
-.B \-T, \-\-buffer\-percent
-Turn on the transfer buffer percentage display.  This will show the
-percentage of the transfer buffer in use - but see the caveat under
-.B %T
-in the
-.B FORMATTING
-section below.  Implies
-.BR \-C .
-.TP
-.B \-A, \-\-last\-written NUM
-Show the last
-.B NUM
-bytes written - but see the caveat under
-.B %nA
-in the
-.B FORMATTING
-section below.  Implies
-.BR \-C .
-.TP
-.B \-F, \-\-format FORMAT
-Ignore the options
-.BR \-p ,
-.BR \-t ,
-.BR \-e ,
-.BR \-r ,
-.BR \-a ,
-.BR \-b ,
-.BR \-T ,
-and
-.BR \-A ,
-and instead use the format string
-.B FORMAT
-to determine the output format.  See the
-.B FORMATTING
-section below.
-.TP
-.B \-n, \-\-numeric
-Numeric output.  Instead of giving a visual indication of progress,
-.B @PACKAGE@
-will give an integer percentage, one per line, on standard error, suitable
-for piping (via convoluted redirection) into
-.BR dialog (1).
-Note that
-.B \-f
-is not required if
-.B \-n
-is being used.
-.TP
-.B ""
-Note that if
-.B \-\-numeric
-is in use, then adding
-.B \-\-bytes
-will cause the number of bytes processed so far to be output instead of a
-percentage; if
-.B \-\-line\-mode
-is also in use as well as
-.B \-\-bytes
-and
-.BR \-\-numeric ,
-then instead of bytes or a percentage, the number of lines
-so far is output.  And finally, if
-.B \-\-timer
-is added to
-.BR \-\-numeric ,
-then each output line is prefixed with the elapsed time 
-so far, as a decimal number of seconds.
-.TP
-.B \-q, \-\-quiet
-No output.  Useful if the
-.B \-L
-option is being used on its own to just limit the transfer rate of a pipe.
-
-
-.SH OUTPUT MODIFIERS
-.TP
-.B \-W, \-\-wait
-Wait until the first byte has been transferred before showing any progress
-information or calculating any ETAs.  Useful if the program you are piping to
-or from requires extra information before it starts, eg piping data into
-.BR gpg (1)
-or
-.BR mcrypt (1)
-which require a passphrase before data can be processed.
-.TP
-.B \-D, \-\-delay-start SEC
-Wait until 
-.B SEC
-seconds have passed before showing any progress information, for example in
-a script where you only want to show a progress bar if it starts taking a
-long time.  Note that this can be a decimal such as 0.5.
-.TP
-.B \-s SIZE, \-\-size SIZE
-Assume the total amount of data to be transferred is
-.B SIZE
-bytes when calculating percentages and ETAs.  The same suffixes of "k", "m"
-etc can be used as with
-.BR -L .
-.TP
-.B ""
-If
-.B SIZE
-starts with
-.BR "@" ,
-the size of file whose name follows the
-.B @
-will be used.
-.TP
-.B ""
-Note that
-.B \-\-size
-has no effect if used with
-.B -d PID
-to watch all file descriptors of a process, but will work with
-.BR "-d PID:FD" .
-.TP
-.B \-l, \-\-line\-mode
-Instead of counting bytes, count lines (newline characters). The progress
-bar will only move when a new line is found, and the value passed to the
-.B \-s
-option will be interpreted as a line count.  Note that file sizes are not
-automatically calculated when this option is used, to avoid having to read
-all files twice.
-.TP
-.B \-0, \-\-null
-Count lines as null terminated.  This option implies \-\-line\-mode.
-.TP
-.B \-i SEC, \-\-interval SEC
-Wait
-.B SEC
-seconds between updates.  The default is to update every second.
-Note that this can be a decimal such as 0.1.
-.TP
-.B \-m SEC, \-\-average-rate-window SEC
-Compute current average rate over a
-.B SEC
-seconds window for average rate and ETA calculations (default 30s).
-.TP
-.B \-w WIDTH, \-\-width WIDTH
-Assume the terminal is
-.B WIDTH
-characters wide, instead of trying to work it out (or assuming 80 if it
-cannot be guessed).
-.TP
-.B \-H HEIGHT, \-\-height HEIGHT
-Assume the terminal is
-.B HEIGHT
-rows high, instead of trying to work it out (or assuming 25 if it
-cannot be guessed).
-.TP
-.B \-N NAME, \-\-name NAME
-Prefix the output information with
-.BR NAME .
-Useful in conjunction with
-.B \-c
-if you have a complicated pipeline and you want to be able to tell different
-parts of it apart.
-.TP
-.B \-f, \-\-force
-Force output.  Normally,
-.B @PACKAGE@
-will not output any visual display if standard error is not a terminal. 
-This option forces it to do so.
-.TP
-.B \-c, \-\-cursor
-Use cursor positioning escape sequences instead of just using carriage
-returns.  This is useful in conjunction with
-.B \-N
-(name) if you are using multiple
-.B @PACKAGE@
-invocations in a single, long, pipeline.
-
-
-.SH DATA TRANSFER MODIFIERS
-.TP
-.B \-L RATE, \-\-rate-limit RATE
-Limit the transfer to a maximum of
-.B RATE
-bytes per second.  A suffix of "K", "M", "G", or "T" can be added to denote
-kibibytes (*1024), mebibytes, and so on.
-.TP
-.B \-B BYTES, \-\-buffer-size BYTES
-Use a transfer buffer size of
-.B BYTES
-bytes.  A suffix of "K", "M", "G", or "T" can be added to denote
-kibibytes (*1024), mebibytes, and so on.  The default buffer size is the
-block size of the input file's filesystem multiplied by 32 (512KiB max), or
-400KiB if the block size cannot be determined.  This can be useful on
-platforms like MacOS which perform better in pipelines with specific buffer
-sizes such as 1024.  Implies
-.BR \-C .
-.TP
-.B \-C, \-\-no-splice
-Never use
-.BR splice (2),
-even if it would normally be possible.  The
-.BR splice (2)
-system call is a more efficient way of transferring data from or to a pipe
-than regular
-.BR read (2)
-and
-.BR write (2),
-but means that the transfer buffer may not be used.  This prevents
-.B \-A
-and
-.B \-T
-from working, and makes
-.B \-B
-redundant, so using
-.BR \-A ,
-.BR \-T ,
-or
-.B \-B
-automatically switches on
-.BR \-C .
-Switching on
-.B \-C
-results in a small loss of transfer efficiency.
-(This option has no effect on systems where
-.BR splice (2)
-is unavailable).
-.TP
-.B \-E, \-\-skip-errors
-Ignore read errors by attempting to skip past the offending sections.  The
-corresponding parts of the output will be null bytes.  At first only a few
-bytes will be skipped, but if there are many errors in a row then the skips
-will move up to chunks of 512.  This is intended to be similar to
-.B dd conv=sync,noerror
-but has not been as thoroughly tested.
-.TP
-.B ""
-Specify
-.B \-E
-twice to only report a read error once per file, instead of reporting each
-byte range skipped.
-.TP
-.B \-S, \-\-stop-at-size
-If a size was specified with
-.BR \-s ,
-stop transferring data once that many bytes have been written, instead of
-continuing to the end of input.
-.TP
-.B \-Y, \-\-sync
-After every write operation, synchronise the buffer caches to disk - see
-.BR fdatasync (2).
-This has no effect when the output is a pipe.  Using
-.B \-Y
-may improve the accuracy of the progress bar when writing to a slow disk.
-.TP
-.B \-K, \-\-direct-io
-Set the
-.I O_DIRECT
-flag on all inputs and outputs, if it is available.  This will minimise
-the effect of caches, at the cost of performance.  Due to memory alignment
-requirements, it also may cause read or write failures with an error of
-"Invalid argument", especially if reading and writing files across a variety
-of filesystems in a single
-.B @PACKAGE@
-call.  Use this option with caution.
-.TP
-.B \-d PID[:FD], \-\-watchfd PID[:FD]
-Instead of transferring data, watch file descriptor
-.B FD
-of process
-.BR PID ,
-and show its progress.  The
-.B @PACKAGE@
-process will exit when
-.B FD
-either changes to a different file, changes read/write mode, or is closed;
-other data transfer modifiers - and remote control - may not be used with
-this option.
-.TP
-.B ""
-If only a
-.B PID
-is specified, then that process will be watched, and all regular files and
-block devices it opens will be shown with a progress bar.  The
-.B @PACKAGE@
-process will exit when process
-.B PID
-exits.
-.TP
-.B \-R PID, \-\-remote PID
-If
-.B PID
-is an instance of
-.B @PACKAGE@
-that is already running,
-.B \-R PID
-will cause that instance to act as though it had been given
-this instance's command line instead.  For example, if
-.B @PACKAGE@ -L 123K
-is running with process ID 9876, then running
-.B @PACKAGE@ -R 9876 -L 321K
-will cause it to start using a rate limit of 321KiB instead of 123KiB.
-Note that some options cannot be changed while running, such as
-.BR \-c ,
-.BR \-l ,
-.BR \-f ,
-.BR \-D ,
-.BR \-E ,
-and
-.BR \-S .
-
-.SH GENERAL OPTIONS
-.TP
-.B \-P FILE, \-\-pidfile FILE
-Save the process ID of
-.B @PACKAGE@
-in
-.BR FILE .
-The file will be truncated if it already exists, and will be removed when
-.B @PACKAGE@
-exits.  While
-.B @PACKAGE@
-is running, it will contain a single number - the process ID of
-.B @PACKAGE@
-- followed by a newline.
-.TP
-.B \-h, \-\-help
-Print a usage message on standard output and exit successfully.
-.TP
-.B \-V, \-\-version         
-Print version information on standard output and exit successfully.
-
-
-.SH FORMATTING
-If the
-.B \-F
-option is given, then the output format is determined by the given format
-string.  Within that string, the following sequences can be used:
-.TP
-.B %p
-Progress bar.
-Expands to fill the remaining space. Should only be specified once.
-Equivalent to
-.BR \-p .
-.TP
-.B %t
-Elapsed time.  Equivalent to
-.BR \-t .
-.TP
-.B %e
-ETA as time remaining.  Equivalent to
-.BR \-e .
-.TP
-.B %I
-ETA as local time of completion.  Equivalent to
-.BR \-I .
-.TP
-.B %r
-Current data transfer rate.  Equivalent to
-.BR \-r .
-.TP
-.B %a
-Average data transfer rate.  Equivalent to
-.BR \-a .
-.TP
-.B %b
-Bytes transferred so far (or lines if
-.B \-l
-was specified).  Equivalent to
-.BR \-b .
-If
-.B \-\-bits
-was specified, 
-.B %b
-shows the bits transferred so far, not bytes.
-.TP
-.B %T
-Percentage of the transfer buffer in use.  Equivalent to
-.BR \-T .
-Shows "{----}" if the transfer is being done with
-.BR splice (2),
-since splicing to or from pipes does not use the buffer.
-.TP
-.B %nA
-Show the last 
-.B n
-bytes written (e.g.
-.B %16A
-for the last 16 bytes).
-Shows only dots if the transfer is being done with
-.BR splice (2),
-since splicing to or from pipes does not use the buffer.
-.TP
-.B %N
-Name prefix given by
-.BR -N .
-Padded to 9 characters with spaces, and suffixed with :.
-.TP
-.B %%
-A single %.
-.P
-The format string equivalent of turning on all display switches is
-.BR "\`%N %b %T %t %r %a %p %e'" .
-
-
-.SH COMMON SWITCHES
-Some suggested common switch combinations:
-
-.TP
-.B @PACKAGE@ -ptebar
-Show a progress bar, elapsed time, estimated completion time, byte counter,
-average rate, and current rate.
-.TP
-.B @PACKAGE@ -betlap
-Show a progress bar, elapsed time, estimated completion time, line counter,
-and average rate, counting lines instead of bytes.
-.TP
-.B @PACKAGE@ -t
-Show only the elapsed time - useful as a simple timer, e.g.
-.BR "sleep 10m | pv -t" .
-.TP
-.B @PACKAGE@ -pterb
-The default behaviour: progress bar, elapsed time, estimated completion
-time, current rate, and byte counter.
-
-.P
-On MacOS, it may be useful to specify
-.B -B 1024
-in a pipeline, as this may improve performance.
-
-
-.SH EXIT STATUS
-An exit status of 1 indicates a problem with the
-.B \-R
-or
-.B \-P
-options.
-
-Any other exit status is a bitmask of the following:
-
-.TP
-.B 2
-One or more files could not be accessed, 
-.BR stat (2)ed,
-or opened.
-.TP
-.B 4
-An input file was the same as the output file.
-.TP
-.B 8
-Internal error with closing a file or moving to the next file.
-.TP
-.B 16
-There was an error while transferring data from one or more input files.
-.TP
-.B 32
-A signal was caught that caused an early exit.
-.TP
-.B 64
-Memory allocation failed.
-
-.P
-A zero exit status indicates no problems.
-
-
-.SH AUTHOR
-Written by Andrew Wood, with patches submitted by various other people. 
-Please see the package's ACKNOWLEDGEMENTS file for a complete list of
-contributors.
-
-
-.SH KNOWN PROBLEMS
-The following problems are known to exist in
-.BR @PACKAGE@ :
-.TP
-.B *
-In some versions of
-.BR bash (1)
-and
-.BR zsh (1),
-the construct
-.B <(pv filename)
-will not output any progress to the terminal when run from an interactive
-shell, due to the subprocess being run in a separate process group from the
-one that owns the terminal.  In these cases, use
-.BR \-\-force .
-.P
-.TP
-.B *
-The
-.B -c
-option does not work properly on Cygwin without
-.B cygserver
-running, if started near the bottom of the screen (IPC is needed to handle
-the terminal scrolling).  To fix this, start
-.B cygserver
-before using
-.BR "@PACKAGE@ -c" .
-.P
-.TP
-.B *
-The
-.B -R
-option is not available on Cygwin without
-.B cygserver
-running (SYSV IPC is needed). To fix this, start
-.B cygserver
-before running the instance of
-.B @PACKAGE@
-you want, at runtime, to change the parameters of.
-.P
-If you find any other problems, please report them.
-
-
-.SH REPORTING BUGS
-Report bugs in
-.B @PACKAGE@
-to pv@ivarch.com or use the contact form linked from the
-.B @PACKAGE@
-home page: <http://www.ivarch.com/programs/pv.shtml>
-
-
-.SH "SEE ALSO"
-.BR cat (1),
-.BR dialog (1),
-.BR splice (2),
-.BR open (2)
-(for
-.IR O_DIRECT )
-
-.SH LICENSE
-This is free software, distributed under the ARTISTIC 2.0 license.

doc/release-checklist

@@ -1,18 +0,0 @@
-Before releasing a new version, go through this checklist:
-
-  - check for patches from https://tracker.debian.org/pkg/pv
-  - bump doc/VERSION
-  - bump doc/lsm.in
-  - check doc/NEWS.md is up to date
-  - check manual is up to date
-  - make indent; make indent indentclean
-  - make update-po
-  - make test
-  - commit to repository
-  - wipe build directory, re-run generate.sh and configure
-  - make release MAINTAINER=<signing-user>
-  - make manhtml | tidy -asxhtml | sed -e '1,/<body>/d' -e '/<\/body>/,$d'
-  - update HTML for todo and news
-  - copy and sign tar.gz to HTML directory (sig as both .asc and .txt)
-  - submit new release to Sourceforge
-  - upload HTML

docs/ACKNOWLEDGEMENTS.md

@@ -0,0 +1,136 @@
+The following people have contributed to this project, and their assistance
+is acknowledged and greatly appreciated:
+
+ * Antoine Beaupré <anarcat@debian.org> - Debian package maintainer
+ * Kevin Coyner <kcoyner@debian.org> - previous Debian package maintainer
+ * Cédric Delfosse <cedric@debian.org> - previous Debian package maintainer
+ * Jakub Hrozek <jhrozek@redhat.com> - Fedora package maintainer
+ * Eduardo Aguiar <eduardo.oliveira@sondabrasil.com.br> - provided Portuguese (Brazilian) translation
+ * Stéphane Lacasse <stephane@gorfou.ca> - provided French translation
+ * Marcos Kreinacke <public@kreinacke.com> - provided German translation
+ * Bartosz Feński <fenio@o2.pl> <http://skawina.eu.org/> - provided Polish translation along with Krystian Zubel
+ * Joshua Jensen - reported RPM installation bug
+ * Boris Folgmann <http://www.folgmann.com/en/> - reported cursor handling bug
+ * Mathias Gumz - reported NLS bug
+ * Daniel Roethlisberger - submitted patch to use lockfiles for **-c** if terminal locking fails
+ * Adam Buchbinder - lots of help with a Cygwin port of **-c**
+ * Mark Tomich <http://metuchen.dyndns.org> - suggested **-B** option
+ * Gert Menke - reported bug when piping to `dd` with a large input buffer size
+ * Ville Herva <Ville.Herva@iki.fi> - informative bug report about rate limiting performance
+ * Elias Pipping - patch to compile properly on Darwin 9; potential NULL deref report
+ * Patrick Collison - similar patch for OS X
+ * Boris Lohner - reported problem that **-L** does not complain if given non-numeric value
+ * Sebastian Kayser - supplied testing for *SIGPIPE*, demonstrated internationalisation problem
+ * Laszlo Ersek <http://phptest11.atw.hu/> - reported shared memory leak on *SIGINT* with **-c**
+ * Phil Rutschman <http://bandgap.rsnsoft.com/> - provided a patch for fully restoring terminal state on exit
+ * Henry Precheur <http://henry.precheur.org/> - reporting and suggestions for **--rate-limit** bug when rate is under 10
+ * E. Rosten <http://mi.eng.cam.ac.uk/~er258/> - supplied patch for block buffering in line mode
+ * Kjetil Torgrim Homme - reported compilation error with default *CFLAGS* on non-GCC compilers
+ * Alexandre de Verteuil - reported bug in OS X build and supplied test environment to fix in
+ * Martin Baum - supplied patch to return nonzero exit status if terminated by signal
+ * Sam Nelson <http://www.siliconfuture.net/> - supplied patch to fix trailing slash on *DESTDIR*
+ * Daniel Pape - reported Cygwin installation problem due to *DESTDIR*
+ * Philipp Beckers - ported to the Syabas PopcornHour A-100 series
+ * Henry Gebhard <hsggebhardt@googlemail.com> - supplied patches to improve SI prefixes and add **--average-rate**
+ * Vladimir Kokarev, Alexander Leo - reported that exit status did not reflect file errors
+ * Thomas Rachel - submitted patches for IEEE1541 (MiB suffixes), 1+e03 bug
+ * Guillaume Marcais - submitted speedup patch for line mode
+ * Moritz Barsnick - submitted patch for compile warning in size calculation
+ * Pawel Piatek - submitted RPM and patches for AIX
+ * Sami Liedes - submitted patch for **--timer** and **--bytes** with **--numeric**
+ * Steven Willis - reported problem with **-R** killing non-PV remote processes
+ * Vladimir Pal, Vladimir Ermakov - submitted patch which led to development of **--format** option
+ * Peter Samuelson <peter@p12n.org> - submitted patch to calculate size if stdout is a block device
+ * Miguel Diaz - much Cygwin help (and packaging), found narrow-terminal bug
+ * Jim Salter <http://ubuntuwiki.net> - commissioned work on the **--skip-errors** option
+ * Wouter Pronk - reported build problem on SCO
+ * Bryan Dongray <http://www.dongrays.com> - provided patches for test scripts failing on older Red Hats
+ * Zev Weiss <www.bewilderbeest.net> - provided patch to fix `splice()` not using stdin
+ * Zing Shishak - provided patch for **--null** / **-0** (count null terminated lines)
+ * Jacek Wielemborek <http://deetah.jogger.pl/kategorie/english> - implemented fdwatch in Python, suggested PV port; reported bug with **-l** and ETA / size; many other contributions
+ * Kim Krecht - suggested buffer fill status and last bytes output display options
+ * Cristian Ciupitu <http://ciupicri.github.io>, Josh Stone - pointed out file descriptor leak with helpful suggestions (Josh Stone initially noticed the missing close)
+ * Jan Seda - found issue with `splice()` and *SPLICE_F_NONBLOCK* causing slowdown
+ * André Stapf - pointed out formatting problem e.g. 13GB -> 13.1GB which should be shown 13.0GB -> 13.1GB; highlighted on-startup row swapping in **-c**, and suggested **--discard**; suggested making **--fineta** have a "FIN" prefix
+ * Damon Harper <http://www.usrbin.ca/> - suggested **-D** / **--delay-start** option
+ * Ganaël Laplanche <http://www.martymac.org> - provided patch for `lstat64()` on systems that do not support it
+ * Peter Korsgaard <http://www.buildroot.net/> - provided similar patch for `lstat64()`, specifically for uClibc support; provided AIX cross-compilation patch to fix bug in **-lc128** check
+ * Ralf Ramsauer <https://blog.ramses-pyramidenbau.de/> - reported bug which dropped transfer rate on terminal resize
+ * Michiel Van Herwegen - reported and discussed bug with **-l** and ETA / size
+ * Erkki Seppälä <http://www.inside.org/~flux/> - provided patch implementing **-I**
+ * Eric A. Borisch - provided details of compatibility fix for "`%Lu`" in watchpid code
+ * Jan Venekamp - reported MacOS buffer size interactions with pipes
+ * Matt <https://github.com/lemonsqueeze/pv> - provided "rate-window" patches for rate calculation
+ * [Filippo Valsorda](https://github.com/FiloSottile) - provided patch for stat64 issue on Apple Silicon
+ * Matt Koscica, William Dillon - also reported stat64 issue on Apple Silicon
+ * [Demitri Muna](https://github.com/demitri) - assisted with stat64 patch on Apple Silicon
+ * Norman Rasmussen - suggested **-c** with **-d PID:FD**, reject **-N** with **-d PID**
+ * Andriy Gapon, Jonathan Elchison - reported bug where "`pv /dev/zero >/dev/null &`" stops immediately
+ * Marcelo Chiesa - reported unused-result warnings when compiling PV 1.6.6
+ * Jered Floyd - provided patches to improve **--rate-limit**
+ * Christoph Biedl - provided ETA and dynamic interval patches
+ * Richard Fonfara - provided German translations for "`pv --help`"
+ * Johannes Gerer <http://johannesgerer.com> - suggested that **-B** should enable **-C**
+ * Sam James - provided fix for number.c build issue caused by missing stddef.h
+ * Jakub Wilk <jwilk@jwilk.net> - corrected README encoding
+ * Frederik Eaton - reported issue with `<()` shell constructs
+ * [gray](https://github.com/gray) - reported issue with **--force** and terminal process groups, and proposed a patch
+ * [Luc Gommans](https://github.com/lgommans) / https://lgms.nl/ - provided a "momentary ETA" patch
+ * [ikasty](https://github.com/ikasty) - added relative filename display to **--watchfd**
+ * [Michael Weiß](https://github.com/quitschbo) - corrected behaviour when not attached to a terminal
+ * [christoph-zededa](https://github.com/christoph-zededa) - provided OS X support for **--watchfd**
+ * [Dave Beckett](https://github.com/dajobe) - added "`@filename`" syntax to **--size**, and corrected an autoconf problem with stat64 on OS X
+ * [Volodymyr Bychkovyak](https://github.com/vbychkoviak) - provided fix for rate limit behaviour with bursty traffic
+ * [Nick Black](https://nick-black.com) - added **--bits** option
+ * [Andrew Schulman](https://github.com/andrew-schulman) - provided reproducible example of terminal size detection issue in 1.7.17/1.7.18
+ * [fuschia74](https://github.com/fuchsia74) - provided **--enable-static**  patch for "`configure`"
+ * [Wilhelm von Thiele](https://github.com/TurtleWilly) - assisted with OS X cleanups ([#73](https://codeberg.org/ivarch/pv/issues/73), [#74](https://codeberg.org/ivarch/pv/issues/74))
+ * Matějů Miroslav, Ing. - suggested fix for ETA and elapsed time faults when suspending and resuming a machine ([#13](https://codeberg.org/ivarch/pv/issues/13))
+ * Anthony DeRobertis - suggested the **--error-skip-block** option ([#37](https://codeberg.org/ivarch/pv/issues/37))
+ * Benoit Pierre - provided patches for compilation without IPC support, without HAVE_STRUCT_STAT_ST_BLKSIZE, and on MacOS
+ * [gustav-b](https://codeberg.org/gustav-b) - suggested percentage formatting correction ([#80](https://codeberg.org/ivarch/pv/issues/80))
+ * [Thomas Bertels](https://codeberg.org/tbertels) - updated French translations ([#83](https://codeberg.org/ivarch/pv/pulls/83))
+ * [kevinruddy](https://codeberg.org/kevinruddy) - added decimal units option ([#85](https://codeberg.org/ivarch/pv/pulls/85))
+ * [xmort](https://codeberg.org/xmort) - added **--output** option ([#90](https://codeberg.org/ivarch/pv/pulls/90))
+ * [bogiord](https://codeberg.org/bogiord) - reported the loss of output block device size detection in 1.8.10, and suggested the fix ([#91](https://codeberg.org/ivarch/pv/issues/91))
+ * [eborisch](https://codeberg.org/eborisch) - provided fix for misbehaviour when used with "`zfs send`" due to treating zero sized writes (generally due to timer interruption) as end of file ([#92](https://codeberg.org/ivarch/pv/pulls/92), [#93](https://codeberg.org/ivarch/pv/pulls/93))
+ * [alexanderperlis](https://codeberg.org/alexanderperlis) - provided initial support for block devices with **--size `@`FILE** ([#94](https://codeberg.org/ivarch/pv/pulls/94))
+ * [jettero](https://codeberg.org/jettero) - reported double-free coredump when using **--watchfd** after 1.8.10 ([#96](https://codeberg.org/ivarch/pv/issues/96))
+ * Venky.N.Iyer - suggested **--stats** ([#49](https://codeberg.org/ivarch/pv/issues/49))
+ * Roland Kletzing - suggested **--rate** with **--numeric** ([#17](https://codeberg.org/ivarch/pv/issues/17))
+ * [Michael Mior](https://codeberg.org/michaelmior) - suggested **--store-and-forward** ([#100](https://codeberg.org/ivarch/pv/issues/100))
+ * [dbungert](https://codeberg.org/dbungert) - reported issue with *valgrind* 3.23 misreporting leaking file descriptors ([#97](https://codeberg.org/ivarch/pv/issues/97))
+ * Joachim Haga - suggested showing progress in the window title ([#3](https://codeberg.org/ivarch/pv/issues/3))
+ * [Martin Sarsale](https://github.com/runa) - suggested showing progress in the process title ([#4](https://codeberg.org/ivarch/pv/issues/4))
+ * [2bits](https://github.com/2bits) - reported position sensing fault with **--watchfd** in 1.9.0 ([#118](https://codeberg.org/ivarch/pv/issues/118))
+ * [heitbaum](https://codeberg.org/heitbaum) - assisted with cross-compilation fault introduced in 1.9.7 ([#120](https://codeberg.org/ivarch/pv/issues/120))
+ * [meego](https://codeberg.org/meego) - suggested "**%nL**", the last line preview ([#121](https://codeberg.org/ivarch/pv/issues/121))
+ * [Alexander Petrossian](https://github.com/neopaf) - suggested using Unicode output for a more granular progress bar, and provided the codepoints to use ([#15](https://codeberg.org/ivarch/pv/issues/15))
+ * [jmealo](https://codeberg.org/jmealo) - suggested JSON progress output ([#127](https://codeberg.org/ivarch/pv/issues/127))
+ * [ipaqmaster](https://codeberg.org/ipaqmaster) - investigated 100%-CPU utilisation bug when piping to a command that has exited ([#164](https://codeberg.org/ivarch/pv/issues/164))
+ * Andriy Galetski, and also [thinrope](https://codeberg.org/thinrope) - suggested the "**--sparse**" option ([#45](https://codeberg.org/ivarch/pv/issues/45))
+ * [KimHansen](https://codeberg.org/KimHansen) - suggested that "**--watchfd**" should keep its display when the process ends ([#81](https://codeberg.org/ivarch/pv/issues/81))
+
+Translations provided through [Codeberg Weblate](https://translate.codeberg.org/projects/pv/):
+
+ * **Czech**
+   * [mmatous](https://translate.codeberg.org/user/mmatous/) (135)
+ * **French**
+   * anonymous suggestions (7)
+   * [milimarg](https://codeberg.org/milimarg) (13)
+   * [Maxi_Mega](https://translate.codeberg.org/user/Maxi_Mega/) (11)
+ * **German**
+   * [Hartmut Goebel](https://translate.codeberg.org/user/htgoebel/) (77)
+   * [m0yellow](https://translate.codeberg.org/user/m0yellow/) (9)
+   * [Benny](https://translate.codeberg.org/user/Benny/) (7)
+   * [kre](https://translate.codeberg.org/user/kre/) (2)
+   * [fnetX](https://translate.codeberg.org/user/fnetX/) (1)
+ * **Polish**
+   * [coralpink](https://translate.codeberg.org/user/coralpink/) (106)
+ * **Russian**
+   * [0ko](https://translate.codeberg.org/user/0ko/) (157)
+ * **Turkish**
+   * [omerdduran](https://translate.codeberg.org/user/omerdduran/) (129)
+   * [Oğuz Ersen](https://codeberg.org/ersen) (8)
+
+---

docs/COPYING

@@ -0,0 +1,674 @@
+                    GNU GENERAL PUBLIC LICENSE
+                       Version 3, 29 June 2007
+
+ Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+                            Preamble
+
+  The GNU General Public License is a free, copyleft license for
+software and other kinds of works.
+
+  The licenses for most software and other practical works are designed
+to take away your freedom to share and change the works.  By contrast,
+the GNU General Public License is intended to guarantee your freedom to
+share and change all versions of a program--to make sure it remains free
+software for all its users.  We, the Free Software Foundation, use the
+GNU General Public License for most of our software; it applies also to
+any other work released this way by its authors.  You can apply it to
+your programs, too.
+
+  When we speak of free software, we are referring to freedom, not
+price.  Our General Public Licenses are designed to make sure that you
+have the freedom to distribute copies of free software (and charge for
+them if you wish), that you receive source code or can get it if you
+want it, that you can change the software or use pieces of it in new
+free programs, and that you know you can do these things.
+
+  To protect your rights, we need to prevent others from denying you
+these rights or asking you to surrender the rights.  Therefore, you have
+certain responsibilities if you distribute copies of the software, or if
+you modify it: responsibilities to respect the freedom of others.
+
+  For example, if you distribute copies of such a program, whether
+gratis or for a fee, you must pass on to the recipients the same
+freedoms that you received.  You must make sure that they, too, receive
+or can get the source code.  And you must show them these terms so they
+know their rights.
+
+  Developers that use the GNU GPL protect your rights with two steps:
+(1) assert copyright on the software, and (2) offer you this License
+giving you legal permission to copy, distribute and/or modify it.
+
+  For the developers' and authors' protection, the GPL clearly explains
+that there is no warranty for this free software.  For both users' and
+authors' sake, the GPL requires that modified versions be marked as
+changed, so that their problems will not be attributed erroneously to
+authors of previous versions.
+
+  Some devices are designed to deny users access to install or run
+modified versions of the software inside them, although the manufacturer
+can do so.  This is fundamentally incompatible with the aim of
+protecting users' freedom to change the software.  The systematic
+pattern of such abuse occurs in the area of products for individuals to
+use, which is precisely where it is most unacceptable.  Therefore, we
+have designed this version of the GPL to prohibit the practice for those
+products.  If such problems arise substantially in other domains, we
+stand ready to extend this provision to those domains in future versions
+of the GPL, as needed to protect the freedom of users.
+
+  Finally, every program is threatened constantly by software patents.
+States should not allow patents to restrict development and use of
+software on general-purpose computers, but in those that do, we wish to
+avoid the special danger that patents applied to a free program could
+make it effectively proprietary.  To prevent this, the GPL assures that
+patents cannot be used to render the program non-free.
+
+  The precise terms and conditions for copying, distribution and
+modification follow.
+
+                       TERMS AND CONDITIONS
+
+  0. Definitions.
+
+  "This License" refers to version 3 of the GNU General Public License.
+
+  "Copyright" also means copyright-like laws that apply to other kinds of
+works, such as semiconductor masks.
+
+  "The Program" refers to any copyrightable work licensed under this
+License.  Each licensee is addressed as "you".  "Licensees" and
+"recipients" may be individuals or organizations.
+
+  To "modify" a work means to copy from or adapt all or part of the work
+in a fashion requiring copyright permission, other than the making of an
+exact copy.  The resulting work is called a "modified version" of the
+earlier work or a work "based on" the earlier work.
+
+  A "covered work" means either the unmodified Program or a work based
+on the Program.
+
+  To "propagate" a work means to do anything with it that, without
+permission, would make you directly or secondarily liable for
+infringement under applicable copyright law, except executing it on a
+computer or modifying a private copy.  Propagation includes copying,
+distribution (with or without modification), making available to the
+public, and in some countries other activities as well.
+
+  To "convey" a work means any kind of propagation that enables other
+parties to make or receive copies.  Mere interaction with a user through
+a computer network, with no transfer of a copy, is not conveying.
+
+  An interactive user interface displays "Appropriate Legal Notices"
+to the extent that it includes a convenient and prominently visible
+feature that (1) displays an appropriate copyright notice, and (2)
+tells the user that there is no warranty for the work (except to the
+extent that warranties are provided), that licensees may convey the
+work under this License, and how to view a copy of this License.  If
+the interface presents a list of user commands or options, such as a
+menu, a prominent item in the list meets this criterion.
+
+  1. Source Code.
+
+  The "source code" for a work means the preferred form of the work
+for making modifications to it.  "Object code" means any non-source
+form of a work.
+
+  A "Standard Interface" means an interface that either is an official
+standard defined by a recognized standards body, or, in the case of
+interfaces specified for a particular programming language, one that
+is widely used among developers working in that language.
+
+  The "System Libraries" of an executable work include anything, other
+than the work as a whole, that (a) is included in the normal form of
+packaging a Major Component, but which is not part of that Major
+Component, and (b) serves only to enable use of the work with that
+Major Component, or to implement a Standard Interface for which an
+implementation is available to the public in source code form.  A
+"Major Component", in this context, means a major essential component
+(kernel, window system, and so on) of the specific operating system
+(if any) on which the executable work runs, or a compiler used to
+produce the work, or an object code interpreter used to run it.
+
+  The "Corresponding Source" for a work in object code form means all
+the source code needed to generate, install, and (for an executable
+work) run the object code and to modify the work, including scripts to
+control those activities.  However, it does not include the work's
+System Libraries, or general-purpose tools or generally available free
+programs which are used unmodified in performing those activities but
+which are not part of the work.  For example, Corresponding Source
+includes interface definition files associated with source files for
+the work, and the source code for shared libraries and dynamically
+linked subprograms that the work is specifically designed to require,
+such as by intimate data communication or control flow between those
+subprograms and other parts of the work.
+
+  The Corresponding Source need not include anything that users
+can regenerate automatically from other parts of the Corresponding
+Source.
+
+  The Corresponding Source for a work in source code form is that
+same work.
+
+  2. Basic Permissions.
+
+  All rights granted under this License are granted for the term of
+copyright on the Program, and are irrevocable provided the stated
+conditions are met.  This License explicitly affirms your unlimited
+permission to run the unmodified Program.  The output from running a
+covered work is covered by this License only if the output, given its
+content, constitutes a covered work.  This License acknowledges your
+rights of fair use or other equivalent, as provided by copyright law.
+
+  You may make, run and propagate covered works that you do not
+convey, without conditions so long as your license otherwise remains
+in force.  You may convey covered works to others for the sole purpose
+of having them make modifications exclusively for you, or provide you
+with facilities for running those works, provided that you comply with
+the terms of this License in conveying all material for which you do
+not control copyright.  Those thus making or running the covered works
+for you must do so exclusively on your behalf, under your direction
+and control, on terms that prohibit them from making any copies of
+your copyrighted material outside their relationship with you.
+
+  Conveying under any other circumstances is permitted solely under
+the conditions stated below.  Sublicensing is not allowed; section 10
+makes it unnecessary.
+
+  3. Protecting Users' Legal Rights From Anti-Circumvention Law.
+
+  No covered work shall be deemed part of an effective technological
+measure under any applicable law fulfilling obligations under article
+11 of the WIPO copyright treaty adopted on 20 December 1996, or
+similar laws prohibiting or restricting circumvention of such
+measures.
+
+  When you convey a covered work, you waive any legal power to forbid
+circumvention of technological measures to the extent such circumvention
+is effected by exercising rights under this License with respect to
+the covered work, and you disclaim any intention to limit operation or
+modification of the work as a means of enforcing, against the work's
+users, your or third parties' legal rights to forbid circumvention of
+technological measures.
+
+  4. Conveying Verbatim Copies.
+
+  You may convey verbatim copies of the Program's source code as you
+receive it, in any medium, provided that you conspicuously and
+appropriately publish on each copy an appropriate copyright notice;
+keep intact all notices stating that this License and any
+non-permissive terms added in accord with section 7 apply to the code;
+keep intact all notices of the absence of any warranty; and give all
+recipients a copy of this License along with the Program.
+
+  You may charge any price or no price for each copy that you convey,
+and you may offer support or warranty protection for a fee.
+
+  5. Conveying Modified Source Versions.
+
+  You may convey a work based on the Program, or the modifications to
+produce it from the Program, in the form of source code under the
+terms of section 4, provided that you also meet all of these conditions:
+
+    a) The work must carry prominent notices stating that you modified
+    it, and giving a relevant date.
+
+    b) The work must carry prominent notices stating that it is
+    released under this License and any conditions added under section
+    7.  This requirement modifies the requirement in section 4 to
+    "keep intact all notices".
+
+    c) You must license the entire work, as a whole, under this
+    License to anyone who comes into possession of a copy.  This
+    License will therefore apply, along with any applicable section 7
+    additional terms, to the whole of the work, and all its parts,
+    regardless of how they are packaged.  This License gives no
+    permission to license the work in any other way, but it does not
+    invalidate such permission if you have separately received it.
+
+    d) If the work has interactive user interfaces, each must display
+    Appropriate Legal Notices; however, if the Program has interactive
+    interfaces that do not display Appropriate Legal Notices, your
+    work need not make them do so.
+
+  A compilation of a covered work with other separate and independent
+works, which are not by their nature extensions of the covered work,
+and which are not combined with it such as to form a larger program,
+in or on a volume of a storage or distribution medium, is called an
+"aggregate" if the compilation and its resulting copyright are not
+used to limit the access or legal rights of the compilation's users
+beyond what the individual works permit.  Inclusion of a covered work
+in an aggregate does not cause this License to apply to the other
+parts of the aggregate.
+
+  6. Conveying Non-Source Forms.
+
+  You may convey a covered work in object code form under the terms
+of sections 4 and 5, provided that you also convey the
+machine-readable Corresponding Source under the terms of this License,
+in one of these ways:
+
+    a) Convey the object code in, or embodied in, a physical product
+    (including a physical distribution medium), accompanied by the
+    Corresponding Source fixed on a durable physical medium
+    customarily used for software interchange.
+
+    b) Convey the object code in, or embodied in, a physical product
+    (including a physical distribution medium), accompanied by a
+    written offer, valid for at least three years and valid for as
+    long as you offer spare parts or customer support for that product
+    model, to give anyone who possesses the object code either (1) a
+    copy of the Corresponding Source for all the software in the
+    product that is covered by this License, on a durable physical
+    medium customarily used for software interchange, for a price no
+    more than your reasonable cost of physically performing this
+    conveying of source, or (2) access to copy the
+    Corresponding Source from a network server at no charge.
+
+    c) Convey individual copies of the object code with a copy of the
+    written offer to provide the Corresponding Source.  This
+    alternative is allowed only occasionally and noncommercially, and
+    only if you received the object code with such an offer, in accord
+    with subsection 6b.
+
+    d) Convey the object code by offering access from a designated
+    place (gratis or for a charge), and offer equivalent access to the
+    Corresponding Source in the same way through the same place at no
+    further charge.  You need not require recipients to copy the
+    Corresponding Source along with the object code.  If the place to
+    copy the object code is a network server, the Corresponding Source
+    may be on a different server (operated by you or a third party)
+    that supports equivalent copying facilities, provided you maintain
+    clear directions next to the object code saying where to find the
+    Corresponding Source.  Regardless of what server hosts the
+    Corresponding Source, you remain obligated to ensure that it is
+    available for as long as needed to satisfy these requirements.
+
+    e) Convey the object code using peer-to-peer transmission, provided
+    you inform other peers where the object code and Corresponding
+    Source of the work are being offered to the general public at no
+    charge under subsection 6d.
+
+  A separable portion of the object code, whose source code is excluded
+from the Corresponding Source as a System Library, need not be
+included in conveying the object code work.
+
+  A "User Product" is either (1) a "consumer product", which means any
+tangible personal property which is normally used for personal, family,
+or household purposes, or (2) anything designed or sold for incorporation
+into a dwelling.  In determining whether a product is a consumer product,
+doubtful cases shall be resolved in favor of coverage.  For a particular
+product received by a particular user, "normally used" refers to a
+typical or common use of that class of product, regardless of the status
+of the particular user or of the way in which the particular user
+actually uses, or expects or is expected to use, the product.  A product
+is a consumer product regardless of whether the product has substantial
+commercial, industrial or non-consumer uses, unless such uses represent
+the only significant mode of use of the product.
+
+  "Installation Information" for a User Product means any methods,
+procedures, authorization keys, or other information required to install
+and execute modified versions of a covered work in that User Product from
+a modified version of its Corresponding Source.  The information must
+suffice to ensure that the continued functioning of the modified object
+code is in no case prevented or interfered with solely because
+modification has been made.
+
+  If you convey an object code work under this section in, or with, or
+specifically for use in, a User Product, and the conveying occurs as
+part of a transaction in which the right of possession and use of the
+User Product is transferred to the recipient in perpetuity or for a
+fixed term (regardless of how the transaction is characterized), the
+Corresponding Source conveyed under this section must be accompanied
+by the Installation Information.  But this requirement does not apply
+if neither you nor any third party retains the ability to install
+modified object code on the User Product (for example, the work has
+been installed in ROM).
+
+  The requirement to provide Installation Information does not include a
+requirement to continue to provide support service, warranty, or updates
+for a work that has been modified or installed by the recipient, or for
+the User Product in which it has been modified or installed.  Access to a
+network may be denied when the modification itself materially and
+adversely affects the operation of the network or violates the rules and
+protocols for communication across the network.
+
+  Corresponding Source conveyed, and Installation Information provided,
+in accord with this section must be in a format that is publicly
+documented (and with an implementation available to the public in
+source code form), and must require no special password or key for
+unpacking, reading or copying.
+
+  7. Additional Terms.
+
+  "Additional permissions" are terms that supplement the terms of this
+License by making exceptions from one or more of its conditions.
+Additional permissions that are applicable to the entire Program shall
+be treated as though they were included in this License, to the extent
+that they are valid under applicable law.  If additional permissions
+apply only to part of the Program, that part may be used separately
+under those permissions, but the entire Program remains governed by
+this License without regard to the additional permissions.
+
+  When you convey a copy of a covered work, you may at your option
+remove any additional permissions from that copy, or from any part of
+it.  (Additional permissions may be written to require their own
+removal in certain cases when you modify the work.)  You may place
+additional permissions on material, added by you to a covered work,
+for which you have or can give appropriate copyright permission.
+
+  Notwithstanding any other provision of this License, for material you
+add to a covered work, you may (if authorized by the copyright holders of
+that material) supplement the terms of this License with terms:
+
+    a) Disclaiming warranty or limiting liability differently from the
+    terms of sections 15 and 16 of this License; or
+
+    b) Requiring preservation of specified reasonable legal notices or
+    author attributions in that material or in the Appropriate Legal
+    Notices displayed by works containing it; or
+
+    c) Prohibiting misrepresentation of the origin of that material, or
+    requiring that modified versions of such material be marked in
+    reasonable ways as different from the original version; or
+
+    d) Limiting the use for publicity purposes of names of licensors or
+    authors of the material; or
+
+    e) Declining to grant rights under trademark law for use of some
+    trade names, trademarks, or service marks; or
+
+    f) Requiring indemnification of licensors and authors of that
+    material by anyone who conveys the material (or modified versions of
+    it) with contractual assumptions of liability to the recipient, for
+    any liability that these contractual assumptions directly impose on
+    those licensors and authors.
+
+  All other non-permissive additional terms are considered "further
+restrictions" within the meaning of section 10.  If the Program as you
+received it, or any part of it, contains a notice stating that it is
+governed by this License along with a term that is a further
+restriction, you may remove that term.  If a license document contains
+a further restriction but permits relicensing or conveying under this
+License, you may add to a covered work material governed by the terms
+of that license document, provided that the further restriction does
+not survive such relicensing or conveying.
+
+  If you add terms to a covered work in accord with this section, you
+must place, in the relevant source files, a statement of the
+additional terms that apply to those files, or a notice indicating
+where to find the applicable terms.
+
+  Additional terms, permissive or non-permissive, may be stated in the
+form of a separately written license, or stated as exceptions;
+the above requirements apply either way.
+
+  8. Termination.
+
+  You may not propagate or modify a covered work except as expressly
+provided under this License.  Any attempt otherwise to propagate or
+modify it is void, and will automatically terminate your rights under
+this License (including any patent licenses granted under the third
+paragraph of section 11).
+
+  However, if you cease all violation of this License, then your
+license from a particular copyright holder is reinstated (a)
+provisionally, unless and until the copyright holder explicitly and
+finally terminates your license, and (b) permanently, if the copyright
+holder fails to notify you of the violation by some reasonable means
+prior to 60 days after the cessation.
+
+  Moreover, your license from a particular copyright holder is
+reinstated permanently if the copyright holder notifies you of the
+violation by some reasonable means, this is the first time you have
+received notice of violation of this License (for any work) from that
+copyright holder, and you cure the violation prior to 30 days after
+your receipt of the notice.
+
+  Termination of your rights under this section does not terminate the
+licenses of parties who have received copies or rights from you under
+this License.  If your rights have been terminated and not permanently
+reinstated, you do not qualify to receive new licenses for the same
+material under section 10.
+
+  9. Acceptance Not Required for Having Copies.
+
+  You are not required to accept this License in order to receive or
+run a copy of the Program.  Ancillary propagation of a covered work
+occurring solely as a consequence of using peer-to-peer transmission
+to receive a copy likewise does not require acceptance.  However,
+nothing other than this License grants you permission to propagate or
+modify any covered work.  These actions infringe copyright if you do
+not accept this License.  Therefore, by modifying or propagating a
+covered work, you indicate your acceptance of this License to do so.
+
+  10. Automatic Licensing of Downstream Recipients.
+
+  Each time you convey a covered work, the recipient automatically
+receives a license from the original licensors, to run, modify and
+propagate that work, subject to this License.  You are not responsible
+for enforcing compliance by third parties with this License.
+
+  An "entity transaction" is a transaction transferring control of an
+organization, or substantially all assets of one, or subdividing an
+organization, or merging organizations.  If propagation of a covered
+work results from an entity transaction, each party to that
+transaction who receives a copy of the work also receives whatever
+licenses to the work the party's predecessor in interest had or could
+give under the previous paragraph, plus a right to possession of the
+Corresponding Source of the work from the predecessor in interest, if
+the predecessor has it or can get it with reasonable efforts.
+
+  You may not impose any further restrictions on the exercise of the
+rights granted or affirmed under this License.  For example, you may
+not impose a license fee, royalty, or other charge for exercise of
+rights granted under this License, and you may not initiate litigation
+(including a cross-claim or counterclaim in a lawsuit) alleging that
+any patent claim is infringed by making, using, selling, offering for
+sale, or importing the Program or any portion of it.
+
+  11. Patents.
+
+  A "contributor" is a copyright holder who authorizes use under this
+License of the Program or a work on which the Program is based.  The
+work thus licensed is called the contributor's "contributor version".
+
+  A contributor's "essential patent claims" are all patent claims
+owned or controlled by the contributor, whether already acquired or
+hereafter acquired, that would be infringed by some manner, permitted
+by this License, of making, using, or selling its contributor version,
+but do not include claims that would be infringed only as a
+consequence of further modification of the contributor version.  For
+purposes of this definition, "control" includes the right to grant
+patent sublicenses in a manner consistent with the requirements of
+this License.
+
+  Each contributor grants you a non-exclusive, worldwide, royalty-free
+patent license under the contributor's essential patent claims, to
+make, use, sell, offer for sale, import and otherwise run, modify and
+propagate the contents of its contributor version.
+
+  In the following three paragraphs, a "patent license" is any express
+agreement or commitment, however denominated, not to enforce a patent
+(such as an express permission to practice a patent or covenant not to
+sue for patent infringement).  To "grant" such a patent license to a
+party means to make such an agreement or commitment not to enforce a
+patent against the party.
+
+  If you convey a covered work, knowingly relying on a patent license,
+and the Corresponding Source of the work is not available for anyone
+to copy, free of charge and under the terms of this License, through a
+publicly available network server or other readily accessible means,
+then you must either (1) cause the Corresponding Source to be so
+available, or (2) arrange to deprive yourself of the benefit of the
+patent license for this particular work, or (3) arrange, in a manner
+consistent with the requirements of this License, to extend the patent
+license to downstream recipients.  "Knowingly relying" means you have
+actual knowledge that, but for the patent license, your conveying the
+covered work in a country, or your recipient's use of the covered work
+in a country, would infringe one or more identifiable patents in that
+country that you have reason to believe are valid.
+
+  If, pursuant to or in connection with a single transaction or
+arrangement, you convey, or propagate by procuring conveyance of, a
+covered work, and grant a patent license to some of the parties
+receiving the covered work authorizing them to use, propagate, modify
+or convey a specific copy of the covered work, then the patent license
+you grant is automatically extended to all recipients of the covered
+work and works based on it.
+
+  A patent license is "discriminatory" if it does not include within
+the scope of its coverage, prohibits the exercise of, or is
+conditioned on the non-exercise of one or more of the rights that are
+specifically granted under this License.  You may not convey a covered
+work if you are a party to an arrangement with a third party that is
+in the business of distributing software, under which you make payment
+to the third party based on the extent of your activity of conveying
+the work, and under which the third party grants, to any of the
+parties who would receive the covered work from you, a discriminatory
+patent license (a) in connection with copies of the covered work
+conveyed by you (or copies made from those copies), or (b) primarily
+for and in connection with specific products or compilations that
+contain the covered work, unless you entered into that arrangement,
+or that patent license was granted, prior to 28 March 2007.
+
+  Nothing in this License shall be construed as excluding or limiting
+any implied license or other defenses to infringement that may
+otherwise be available to you under applicable patent law.
+
+  12. No Surrender of Others' Freedom.
+
+  If conditions are imposed on you (whether by court order, agreement or
+otherwise) that contradict the conditions of this License, they do not
+excuse you from the conditions of this License.  If you cannot convey a
+covered work so as to satisfy simultaneously your obligations under this
+License and any other pertinent obligations, then as a consequence you may
+not convey it at all.  For example, if you agree to terms that obligate you
+to collect a royalty for further conveying from those to whom you convey
+the Program, the only way you could satisfy both those terms and this
+License would be to refrain entirely from conveying the Program.
+
+  13. Use with the GNU Affero General Public License.
+
+  Notwithstanding any other provision of this License, you have
+permission to link or combine any covered work with a work licensed
+under version 3 of the GNU Affero General Public License into a single
+combined work, and to convey the resulting work.  The terms of this
+License will continue to apply to the part which is the covered work,
+but the special requirements of the GNU Affero General Public License,
+section 13, concerning interaction through a network will apply to the
+combination as such.
+
+  14. Revised Versions of this License.
+
+  The Free Software Foundation may publish revised and/or new versions of
+the GNU General Public License from time to time.  Such new versions will
+be similar in spirit to the present version, but may differ in detail to
+address new problems or concerns.
+
+  Each version is given a distinguishing version number.  If the
+Program specifies that a certain numbered version of the GNU General
+Public License "or any later version" applies to it, you have the
+option of following the terms and conditions either of that numbered
+version or of any later version published by the Free Software
+Foundation.  If the Program does not specify a version number of the
+GNU General Public License, you may choose any version ever published
+by the Free Software Foundation.
+
+  If the Program specifies that a proxy can decide which future
+versions of the GNU General Public License can be used, that proxy's
+public statement of acceptance of a version permanently authorizes you
+to choose that version for the Program.
+
+  Later license versions may give you additional or different
+permissions.  However, no additional obligations are imposed on any
+author or copyright holder as a result of your choosing to follow a
+later version.
+
+  15. Disclaimer of Warranty.
+
+  THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
+APPLICABLE LAW.  EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
+HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
+OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
+THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+PURPOSE.  THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM
+IS WITH YOU.  SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF
+ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
+
+  16. Limitation of Liability.
+
+  IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
+WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS
+THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
+GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
+USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
+DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
+PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),
+EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
+SUCH DAMAGES.
+
+  17. Interpretation of Sections 15 and 16.
+
+  If the disclaimer of warranty and limitation of liability provided
+above cannot be given local legal effect according to their terms,
+reviewing courts shall apply local law that most closely approximates
+an absolute waiver of all civil liability in connection with the
+Program, unless a warranty or assumption of liability accompanies a
+copy of the Program in return for a fee.
+
+                     END OF TERMS AND CONDITIONS
+
+            How to Apply These Terms to Your New Programs
+
+  If you develop a new program, and you want it to be of the greatest
+possible use to the public, the best way to achieve this is to make it
+free software which everyone can redistribute and change under these terms.
+
+  To do so, attach the following notices to the program.  It is safest
+to attach them to the start of each source file to most effectively
+state the exclusion of warranty; and each file should have at least
+the "copyright" line and a pointer to where the full notice is found.
+
+    <one line to give the program's name and a brief idea of what it does.>
+    Copyright (C) <year>  <name of author>
+
+    This program is free software: you can redistribute it and/or modify
+    it under the terms of the GNU General Public License as published by
+    the Free Software Foundation, either version 3 of the License, or
+    (at your option) any later version.
+
+    This program is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+    GNU General Public License for more details.
+
+    You should have received a copy of the GNU General Public License
+    along with this program.  If not, see <https://www.gnu.org/licenses/>.
+
+Also add information on how to contact you by electronic and paper mail.
+
+  If the program does terminal interaction, make it output a short
+notice like this when it starts in an interactive mode:
+
+    <program>  Copyright (C) <year>  <name of author>
+    This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
+    This is free software, and you are welcome to redistribute it
+    under certain conditions; type `show c' for details.
+
+The hypothetical commands `show w' and `show c' should show the appropriate
+parts of the General Public License.  Of course, your program's commands
+might be different; for a GUI interface, you would use an "about box".
+
+  You should also get your employer (if you work as a programmer) or school,
+if any, to sign a "copyright disclaimer" for the program, if necessary.
+For more information on this, and how to apply and follow the GNU GPL, see
+<https://www.gnu.org/licenses/>.
+
+  The GNU General Public License does not permit incorporating your program
+into proprietary programs.  If your program is a subroutine library, you
+may consider it more useful to permit linking proprietary applications with
+the library.  If this is what you want to do, use the GNU Lesser General
+Public License instead of this License.  But first, please read
+<https://www.gnu.org/licenses/why-not-lgpl.html>.

docs/DEVELOPERS.md

@@ -0,0 +1,173 @@
+# Notes for developers and translators
+
+The following _configure_ options will be of interest to developers and
+translators:
+
+ * **--enable-debugging** - build in debugging support
+ * **--enable-profiling** - build in support for profiling
+
+These targets are available when running _make_:
+
+ * "`make analyse`" - run _splint_ and _flawfinder_ on all C source files
+
+
+## Debugging and profiling support
+
+When "`./configure --enable-debugging`" is used, the _pv_ produced by _make_
+will support an extra option, "**--debug FILE**", which will cause debugging
+output to be written to *FILE*.  This is not recommended for production
+builds due to the extra processing it introduces, and the potential size of
+the output.
+
+Within the code, "**debug()**" is used in a similar way to "**printf()**". 
+It will automatically include the calling function, source file, and line
+number, so they don't need to be included in the parameters.  When debugging
+support is not enabled, it evaluates to a null statement.
+
+This does mean that if you call "**debug()**", make sure it has no side
+effects, as they won't be present in builds without debugging support.
+
+Builds produced after "`./configure --enable-profiling`" will write profile
+data when run, to be used with _gprof_.  See "`man gprof`" for details. 
+Please note that the memory safety checks will fail with profiling enabled.
+
+
+## Source code analysis
+
+Running "`make analyse`" runs _splint_ and _flawfinder_ on all C sources,
+writing the output of both programs to files named _"*.e"_ for each _"*.c"_.
+
+There are no dependency rules set up for these _".e"_ files, so if a header
+file is altered, manually remove the relevant _".e"_ files, or update the
+timestamp of the relevant _".c"_ files, before running "`make analyse`"
+again.
+
+The goal is for all C source files to generate zero warnings from either
+tool.
+
+Wherever warnings are disabled by annotations to the source, there should be
+associated commentary nearby explaining the rationale behind it, and any
+assumptions made.  This is so that there can be some assurance that the
+issue highlighted by the analyser has been considered properly, as well as
+documenting anything that might need further work if the surrounding code is
+altered in future.
+
+
+## Translation notes
+
+Translators can use the Weblate instance hosted by Codeberg:
+[https://translate.codeberg.org/projects/pv/](https://translate.codeberg.org/projects/pv/)
+
+If you don't see your language listed, raise an issue on the issue tracker
+(or just email the maintainer) asking for it to be added.
+
+Alternatively, read on for details of how to maintain the translations
+directly within the source tree.
+
+The message catalogues used to translate program messages into other
+languages are in the _"po/"_ directory, named _"xx.po"_, where _"xx"_
+is the ISO 639-1 2-letter language code, such as "**fr**" for French.
+
+Each of these files contains lines like this:
+
+    #: src/pv/cursor.c:85
+    msgid "failed to get terminal name"
+    msgstr "erro ao ler o nome do terminal"
+
+The comment line, starting _"#"_, shows the source filename and line number
+at which this message can be found.  The _"msgid"_ is the original message
+in the program, in English.  The _"msgstr"_ is the translated text.
+
+It is the _"msgstr"_ lines which need to be updated by translators.
+
+Message catalogue files should all be encoded as UTF-8.
+
+After making a change to a _".po"_ file, test it by compiling it and
+installing to a temporary location, like this:
+
+    ./configure --enable-debugging --prefix=/tmp/yourtest
+    make clean
+    make install
+    localedef -f UTF-8 -i de_DE /tmp/yourtest/share/locale/de_DE.UTF-8
+    bash
+    export LOCPATH=/tmp/yourtest/share/locale
+    export LC_ALL=de_DE.UTF-8
+    export LANGUAGE=de_DE
+    /tmp/yourtest/bin/pv --help
+    exit
+
+Replace "**--help**" with whatever is appropriate for your test.  In this
+example, the language being tested is _"de"_ (German), on a system which is
+running with UTF-8 support.
+
+In the example above, a new shell is started by typing "`bash`" so that
+after your tests, "`exit`" will return you to your previous shell with your
+language settings intact.
+
+Note that at the start, you have to re-run _configure_ with "**--prefix**"
+rather than using "`make DESTDIR=...`", because the locale directory is set
+at compile time.  Also, on Debian at least, both the environment variables
+_"LC_ALL"_ and _"LANGUAGE"_ must be set.
+
+To find untranslated strings in a language that's already supported but
+which you can help with gaps in, use this command:
+
+    msgattrib --untranslated < po/fr.po
+
+replacing _"po/fr.po"_ as appropriate.
+
+To add a new language, create the new message catalogue file under _"po/"_
+by copying _"po/pv.pot"_ to _"po/xx.po"_, where _"xx"_ is the language code,
+and adjusting it.  The _".pot"_ file is generated automatically by _make_.
+
+Next, add the language code to _"po/LINGUAS"_ - this is a list of the
+2-letter codes of the supported languages.
+
+Finally, run "`./config.status`" and "`make -C po update-po`".
+
+When the source code is updated, running "`make -C po update-po`" will
+update the _"pv.pot"_ file so that it lists where all the messages are in
+the source.  It will also use _msgmerge_ to update all of the _".po"_ files
+from the updated _"pv.pot"_ file.  After doing this, look for missing
+translations (empty _"msgstr"_ lines) or translations marked as "fuzzy", as
+these will need to be corrected by translators.
+
+
+## Release checklist
+
+The package maintainer should run through these steps for a new release:
+
+ * Check for patches and bug reports:
+   * <https://codeberg.org/ivarch/pv/issues>
+   * <https://tracker.debian.org/pkg/pv>
+   * <https://launchpad.net/ubuntu/+source/pv>
+   * <https://archlinux.org/packages/extra/x86_64/pv/>
+   * <https://packages.gentoo.org/packages/sys-apps/pv>
+   * <https://cvsweb.openbsd.org/ports/sysutils/pv/>
+   * <https://packages.fedoraproject.org/pkgs/pv/pv/>
+ * Run "`make indent; make indent indentclean check`"
+ * Check that _po/POTFILES.in_ is up to date
+ * Run "`make -C po update-po`"
+ * Run "`make analyse`" and see whether remaining warnings can be addressed
+ * Version bump and documentation checks:
+   * Update the version in _configure.ac_ and _docs/NEWS.md_
+   * Check that _docs/NEWS.md_ is up to date
+   * Check that the manual _docs/pv.1_ is up to date
+   * Run "`make docs/pv.1.md`" and, if using VPATH, copy the result to the source directory
+   * Check that the year displayed by _src/main/version.c_ is correct
+ * Ensure everything has been committed to the repository
+ * Run "`autoreconf -is`" in the source directory
+ * Consistency and build checks:
+   * Wipe the build directory, and run _configure_ there
+   * Run "`make distcheck`"
+   * Run "`./configure && make check`" on all test systems including Cygwin, using the `tar.gz` that was just created
+   * Run a cross-compilation check
+ * Run "`make release MAINTAINER=<signing-user>`"
+ * Update the project web site:
+   * Copy the release _.tar.gz_, _.txt_, and _.asc_ files to the web site
+   * Use "`pandoc --from markdown --to html`" to convert the news and manual to HTML
+   * Update the news and manual on the web site
+   * Update the version numbers on the web site
+   * Update the package index on the web site
+ * Create a new release in the repository, and apply the associated tag
+

docs/NEWS.md

@@ -0,0 +1,608 @@
+### 1.10.0 - 7 November 2025
+
+ * *feature:* new **--query** option to show the transfer status of another running **pv** ([#101](https://codeberg.org/ivarch/pv/issues/101))
+ * *fix:* make the timers work consistently in **--watchfd** if paused and resumed ([#169](https://codeberg.org/ivarch/pv/issues/169))
+
+### 1.9.44 - 18 October 2025
+
+ * *feature:* new **--sparse** option to write sparse output ([#45](https://codeberg.org/ivarch/pv/issues/45))
+ * *fix:* don't clear the **--watchfd** display when the watched process ends ([#81](https://codeberg.org/ivarch/pv/issues/81))
+
+### 1.9.42 - 11 October 2025
+
+ * *feature:* permit multiple arguments to **--watchfd** ([#12](https://codeberg.org/ivarch/pv/issues/12))
+ * *feature:* new "**=NAME**" syntax for **--watchfd** to watch processes by name using **pgrep**(1) ([#95](https://codeberg.org/ivarch/pv/issues/95))
+ * *feature:* new "**@LISTFILE**" syntax for **--watchfd** to watch processes listed in a file
+ * *fix:* improve support for changing the format of a **--watchfd** process with **--remote**
+ * *fix:* don't read more than **--size** bytes when using **--stop-at-size** ([#166](https://codeberg.org/ivarch/pv/issues/166))
+ * *fix:* transfer nothing if **--stop-at-size** is given a **--size** of 0 ([#166](https://codeberg.org/ivarch/pv/issues/166))
+ * *i18n:* Finnish translation stub added
+ * *i18n:* Turkish translations updated
+
+### 1.9.34 - 26 July 2025
+
+ * *fix:* prevent tight loop consuming CPU when waiting for a partially filled output pipe to be drained ([#164](https://codeberg.org/ivarch/pv/issues/164))
+ * *fix:* correct a memory handling fault when using **--bar-style** with **--watchfd** ([#163](https://codeberg.org/ivarch/pv/issues/163))
+ * *i18n:* French translations updated
+
+### 1.9.31 - 28 January 2025
+
+ * *feature:* the **--format** option can now be used with **--numeric** for customised numeric output, such as JSON ([#127](https://codeberg.org/ivarch/pv/issues/127))
+ * *i18n:* German translations updated
+ * *i18n:* Polish translations updated
+ * *i18n:* Russian translations updated
+
+### 1.9.27 - 12 January 2025
+
+ * *fix:* turn off IPC support if _sys/shm.h_ is not available, for compilation on Termux
+ * *fix:* bypass valgrind checks on ARM by default due to false positives
+
+### 1.9.25 - 22 December 2024
+
+ * *fix:* test failure of **--watchfd** on macOS corrected ([#124](https://codeberg.org/ivarch/pv/issues/124))
+
+### 1.9.24 - 19 December 2024
+
+ * *feature:* new **--format** sequences for graphical progress bars - "**%{bar-block}**", "**%{bar-granular}**", and "**%{bar-shaded}**" ([#15](https://codeberg.org/ivarch/pv/issues/15))
+ * *feature:* new **--format** sequence "**%{sgr:colour,...}**" to use ECMA-48 Select Graphic Rendition codes to add colours
+ * *feature:* new **--bar-style** option to change the default bar style ([#15](https://codeberg.org/ivarch/pv/issues/15))
+ * *feature:* allow decimal values such as "1.5G" with "**--size**", "**--rate-limit**", "**--buffer-size**", and "**error-skip-block**" ([#35](https://codeberg.org/ivarch/pv/issues/35))
+ * *cleanup:* improve progress bar granularity on wide displays by internally tracking the transfer percentage as a decimal number
+ * *cleanup:* correct detection of **--remote** usability on GNU Hurd
+ * *cleanup:* reduce likelihood of race conditions in tests when running on slow systems
+ * *cleanup:* reduce memory footprint
+ * *docs:* simplified the synopsis section of the manual
+
+### 1.9.15 - 8 December 2024
+
+ * *feature:* new **--format** sequence "**%nL**", showing the most recent line written ([#121](https://codeberg.org/ivarch/pv/issues/121))
+ * *feature:* each **--format** sequence now has a more readable equivalent name, for example "**%r**" can be written as "**%{rate}**"
+ * *feature:* new **--format** sequences "**%{progress-bar-only}**" and "**%{progress-amount-only}**"
+ * *fix:* allow **--format** to include "%nA" more than once, with different "n" values ([#122](https://codeberg.org/ivarch/pv/issues/122))
+ * *fix:* allow **--format** to include "%p" more than once, with optional width prefix
+ * *fix:* calculate width correctly when wide characters are in **--format** strings
+ * *fix:* add _configure_ script fallback for **--remote** check when cross-compiling ([#120](https://codeberg.org/ivarch/pv/issues/120))
+ * *fix:* allow **extra-display** to be changed by **--remote** ([#123](https://codeberg.org/ivarch/pv/issues/123))
+ * *cleanup:* refactored display formatters into separate functions
+ * *cleanup:* improve format parser handling of dangling or invalid "%" sequences
+
+### 1.9.7 - 2 December 2024
+
+ * *feature:* new **--extra-display** option to update window and process titles ([#3](https://codeberg.org/ivarch/pv/issues/3), [#4](https://codeberg.org/ivarch/pv/issues/4))
+ * *fix:* correct failure to report file positions in **--watchfd** ([#118](https://codeberg.org/ivarch/pv/issues/118))
+ * *i18n:* Russian translations added
+ * *cleanup:* tests added for **--watchfd** ([#10](https://codeberg.org/ivarch/pv/issues/10))
+ * *cleanup:* worked around file descriptor leak false positives in valgrind 3.23 ([#97](https://codeberg.org/ivarch/pv/issues/97))
+ * *cleanup:* cleared all *shellcheck* warnings in the test scripts
+ * *cleanup:* check at compile-time whether **--remote** is going to be usable ([#119](https://codeberg.org/ivarch/pv/issues/119))
+
+### 1.9.0 - 15 October 2024
+
+ * *feature:* new **--store-and-forward** option to read input to a file first, then write it to the output ([#100](https://codeberg.org/ivarch/pv/issues/100))
+ * *feature:* new **--stats** option to show transfer stats at the end, like "`ping`" ([#49](https://codeberg.org/ivarch/pv/issues/49))
+ * *feature:* **--rate** can now be used with **--numeric** ([#17](https://codeberg.org/ivarch/pv/issues/17))
+ * *feature:* **--gauge** with **--progress** to show rate gauge when size is unknown ([#46](https://codeberg.org/ivarch/pv/issues/46))
+ * *i18n:* comprehensive German translations update
+ * *i18n:* comprehensive Polish translations update
+ * *i18n:* complete Turkish translations added
+ * *i18n:* complete Czech translations added
+ * *i18n:* updates to French translations
+ * *fix:* resume stopped pipelines when running in the background (part of [#56](https://codeberg.org/ivarch/pv/issues/56))
+ * *fix:* inspect the output pipe buffer to give a more accurate progress indicator of how much the next command has consumed
+ * *fix:* prefix completion time (**--fineta**) with *FIN* rather than *ETA* ([#43](https://codeberg.org/ivarch/pv/issues/43))
+ * *fix:* surround average rate (**--average-rate**) with brackets rather than square brackets
+ * *fix:* correct a memory leak in **--watchfd PID**
+ * *fix:* make **--direct-io** work correctly with **--output** instead of assuming stdout
+ * *fix:* call `posix_fadvise()` on every input, not just the first one
+ * *fix:* write UTC timestamps in debugging mode to avoid lockups in signal handlers
+ * *security:* added a signed *MANIFEST* file to releases
+ * *cleanup:* removed TODO.md, since it's just an outdated copy of the issue tracker
+ * *cleanup:* re-ordered structure members to reduce padding
+ * *cleanup:* improved readability of *SIGTTOU* handling code
+ * *cleanup:* refactored to separate display, transfer, and calculation more cleanly
+ * *cleanup:* instead of moving stderr when backgrounded, set a suspend-output flag
+
+### 1.8.14 - 7 September 2024
+
+ * *fix:* correct double-free on exit when using **--watchfd** ([#96](https://codeberg.org/ivarch/pv/issues/96)) reported by [jettero](https://codeberg.org/jettero)
+
+### 1.8.13 - 18 August 2024
+
+ * *feature:* when using **--size @FILE**, *FILE* can be a block device, and its size will be used (pull request [#94](https://codeberg.org/ivarch/pv/pulls/94)) supplied by [alexanderperlis](https://codeberg.org/alexanderperlis)
+
+### 1.8.12 - 18 July 2024
+
+ * *fix:* correct the detection of output block device size that was broken in 1.8.10 ([#91](https://codeberg.org/ivarch/pv/issues/91))
+ * *fix:* do not treat a zero/interrupted write as an end of file (pull requests [#92](https://codeberg.org/ivarch/pv/pulls/92) and [#93](https://codeberg.org/ivarch/pv/pulls/93))
+
+### 1.8.10 - 15 June 2024
+
+ * *feature:* new **--output** option to write to a file instead of standard output (pull request [#90](https://codeberg.org/ivarch/pv/pulls/90)) supplied by [xmort](https://codeberg.org/xmort)
+
+### 1.8.9 - 21 April 2024
+
+ * *feature:* new **--si** option to display and interpret size suffixes in multiples of 1000 rather than 1024 (pull request [#85](https://codeberg.org/ivarch/pv/pulls/85)) supplied by [kevinruddy](https://codeberg.org/kevinruddy)
+ * *fix:* continue producing progress output when the output is blocking writes ([#34](https://codeberg.org/ivarch/pv/issues/34), [#86](https://codeberg.org/ivarch/pv/issues/86), [#87](https://codeberg.org/ivarch/pv/issues/87))
+ * *fix:* honour the *TMPDIR* / *TMP* environment variables again, rather than hard-coding "`/tmp`", when using a terminal lock file (originally removed in 1.8.0) ([#88](https://codeberg.org/ivarch/pv/issues/88))
+ * *i18n:* corrections and missing strings added to French translations (pull request [#83](https://codeberg.org/ivarch/pv/pulls/83)) supplied by [Thomas Bertels](https://codeberg.org/tbertels)
+
+### 1.8.5 - 19 November 2023
+
+ * *fix:* corrected percentage formatting so it doesn't jump from 2 to 3 characters wide at 100% ([#80](https://codeberg.org/ivarch/pv/issues/80))
+ * *fix:* replaced **--remote** mechanism, using a temporary file instead of SysV IPC, so it can work reliably even when there are multiple PV instances
+ * *fix:* corrected compilation failure when without IPC support
+ * *security:* addressed all issues highlighted by the software auditing tools "`splint`" and "`flawfinder`" (see "`make analyse`") ([#77](https://codeberg.org/ivarch/pv/issues/77))
+ * *cleanup:* compilation warnings fixed on non-IPC and MacOS systems
+
+### 1.8.0 - 24 September 2023
+
+#### Features
+
+ * *feature:* new **--discard** option to discard input as if writing to */dev/null* ([#42](https://codeberg.org/ivarch/pv/issues/42))
+ * *feature:* new **--error-skip-block** option to make **--skip-errors** skip whole blocks ([#37](https://codeberg.org/ivarch/pv/issues/37))
+ * *feature:* use `posix_fadvise()` like `cat`(1) does, to improve efficiency ([#39](https://codeberg.org/ivarch/pv/issues/39))
+ * *feature:* new **--enable-static** option to "`configure`" for static builds ([#75](https://codeberg.org/ivarch/pv/pull/75))
+
+#### Security
+
+ * *security:* with **--pidfile**, write to a temporary file and rename it into place, to improve security
+ * *security:* keep self-contained copies of name and format string in PV internal state for memory safety
+ * *security:* ignore *TMP* / *TMPDIR* environment variables when using a terminal lock file
+
+#### Fixes
+
+ * *fix:* only report errors about missing files when starting to transfer from them, not while calculating size, and behave more like `cat`(1) by skipping them and moving on
+ * *fix:* auto-calculate total line count with **--line-mode** when all inputs are regular files
+ * *fix:* use `clock_gettime()` in ETA calculation to cope with machine suspend/resume ([#13](https://codeberg.org/ivarch/pv/issues/13))
+ * *fix:* if **--width** or **--height** were provided, do not change them when the window size changes ([#36](https://codeberg.org/ivarch/pv/issues/36))
+ * *fix:* when a file descriptor position in **--watchfd** moves backwards, show the rate using the correct prefix ([#41](https://codeberg.org/ivarch/pv/issues/41))
+ * *fix:* rewrite terminal state save/restore so state is not intermittently garbled on exit when using **--cursor** ([#20](https://codeberg.org/ivarch/pv/issues/20)), ([#24](https://codeberg.org/ivarch/pv/issues/24))
+
+#### Cleanups
+
+ * *cleanup:* addressed many potential issues highlighted by the software auditing tools "`splint`" and "`flawfinder`" (see new target "`make analyse`")
+ * *cleanup:* switched the build system to GNU Automake
+ * *cleanup:* replaced the test harness with the one native to GNU Automake
+ * *cleanup:* added a test for terminal width detection to "`make check`"
+ * *cleanup:* added a test to "`make check`" to ensure that "`make install`" installs everything expected
+ * *cleanup:* replaced *AC_HEADER_TIOCGWINSZ* with *AC_CHECK_HEADERS(sys/ioctl.h)* for better MacOS compatibility ([#74](https://codeberg.org/ivarch/pv/issues/74))
+ * *cleanup:* with **--sync**, call `fsync()` instead of `fdatasync()` on incapable systems ([#73](https://codeberg.org/ivarch/pv/issues/73))
+ * *cleanup:* the manual is now a static file instead of needing to be built with "`configure`"
+
+#### Dropped items
+
+ * *dropped:* dropped support for **--enable-static-nls**
+ * *dropped:* removed the Linux Software Map file, as the LSM project appears to be long dead
+ * *dropped:* will no longer publish to SourceForge as it has a chequered history and is unnecessary
+ * *dropped:* removed project from GitHub and moved to Codeberg - see "[Give Up GitHub](https://giveupgithub.org/)"
+
+#### Other items
+
+ * licensing change from Artistic 2.0 to GPLv3+
+
+### 1.7.24 - 30 July 2023
+
+ * *fix:* correct terminal size detection, broken in 1.7.17 by the configuration script rewrite ([#72](https://codeberg.org/ivarch/pv/issues/72))
+ * *security:* removed *DEBUG* environment variable in debug mode, added **--debug** instead
+ * *cleanup:* added "`make analyse`" to run "`splint`" and "`flawfinder`" on all source files
+ * *cleanup:* corrected detection of boolean capability
+ * *cleanup:* word wrapping of **--help** output is now multi-byte locale aware
+ * *cleanup:* adjusted "`indent`" rules to line length of 120 and reformatted code
+
+### 1.7.18 - 28 July 2023
+
+ * *fix:* language file installation had been broken by the configuration script rewrite
+
+### 1.7.17 - 27 July 2023
+
+ * *feature:* new **--sync** option to flush cache to disk after every write (related to [#6](https://codeberg.org/ivarch/pv/issues/6), to improve accuracy when writing to slow disks)
+ * *feature:* new **--direct-io** option to bypass cache - implements [#29 "Option to enable O_DIRECT"](https://codeberg.org/ivarch/pv/issues/29) - requested by Romain Kang, Jacek Wielemborek
+ * *fix:* correct byte prefix size to 2 spaces in rate display, so progress display size remains constant at low transfer rates
+ * *cleanup:* rewrote `configure.in` as per suggestions in newer "`autoconf`" manuals
+ * *cleanup:* replaced `header.in` with one generated by "`autoheader`", moving custom logic to a separate header file "`config-aux.h`"
+ * *cleanup:* added copyright notice to all source files as per GNU standards
+ * *cleanup:* changed **--version** output to conform to GNU standards
+ * *cleanup:* replaced backticks with `$()` in all shell scripts that did not come from elsewhere, as backticks are deprecated and harder to read
+ * *cleanup:* improved the output formatting of "`make test`"
+ * *cleanup:* extended the "`make test`" mechanism to allow certain tests to be skipped on platforms that cannot support them
+ * *cleanup:* skip the "pipe" test (for *SIGPIPE*) if GNU "`head`" is not available, so that "`make test`" on stock OpenBSD 7.3 works
+ * *cleanup:* added a lot more tests to "`make test`"
+ * *cleanup:* replace all calls to `sprintf()` and `snprintf()` with a new wrapper function `pv_snprintf()` to improve security and compatibility
+ * *cleanup:* replace all calls to `strcat()` with a wrapper `pv_strlcat()` to improve security and compatibility
+ * *cleanup:* replace all `write()` calls to the terminal with a wrapper `pv_write_retry()` for consistency
+ * *cleanup:* tidy up and fix compilation warning in **--watchfd** code
+ * *cleanup:* rewrote all local shell scripts to pass analysis by [ShellCheck](https://www.shellcheck.net)
+
+### 1.7.0 - 17 July 2023
+
+ * *dropped:* support for Red Hat Enterprise Linux and its derivatives has been dropped; removed the RPM spec file, and will no longer build binaries
+ * *feature:* the **--size** option now accepts "`@filename`" to use the size of another file (pull request [#57](https://codeberg.org/ivarch/pv/pull/57) supplied by [Dave Beckett](https://github.com/dajobe))
+ * *feature:* the **--watchfd** option is now available on OS X (pull request [#60](https://codeberg.org/ivarch/pv/pull/60) supplied by [christoph-zededa](https://github.com/christoph-zededa))
+ * *feature:* new **--bits** option to show bit count instead of byte count (adapted from pull request [#63](https://codeberg.org/ivarch/pv/pull/63) supplied by [Nick Black](https://nick-black.com))
+ * *feature:* new **--average-rate-window** option, to set the window over which the average rate is calculated, also used for ETA (modified from pull request [#65](https://codeberg.org/ivarch/pv/pull/65) supplied by [lemonsqueeze](https://github.com/lemonsqueeze))
+ * *feature:* the **--watchfd** option will now show relative filenames, if they are under the current directory (pull request [#66](https://codeberg.org/ivarch/pv/pull/66) supplied by [ikasty](https://github.com/ikasty))
+ * *fix:* correction to `pv_in_foreground()` to behave as its comment block says it should, when not on a terminal - corrects [#19 "No output in Arch Linux initcpio after 1.6.6"](https://codeberg.org/ivarch/pv/issues/19), [#31 "No output written from inside zsh <() construct"](https://codeberg.org/ivarch/pv/issues/31), [#55 "pv Stopped Working in the Background"](https://codeberg.org/ivarch/pv/issues/55) (pull request [#64](https://codeberg.org/ivarch/pv/pull/64) supplied by [Michael Weiß](https://github.com/quitschbo))
+ * *fix:* workaround for OS X 11 behaviour in configure script regarding stat64 at compile time (pull request [#57](https://codeberg.org/ivarch/pv/pull/57) supplied by [Dave Beckett](https://github.com/dajobe))
+ * *fix:* workaround for macOS equivalence of stat to stat64 - patches from [Filippo Valsorda](https://github.com/FiloSottile) and [Demitri Muna](https://github.com/demitri), correcting [#33 "Fix compilation problems due to `stat64()` on Apple Silicon"](https://codeberg.org/ivarch/pv/issues/33)
+ * *fix:* add burst rate limit to transfer, so rate limits are not broken by bursty traffic (pull request [#62](https://codeberg.org/ivarch/pv/pull/62) supplied by [Volodymyr Bychkovyak](https://github.com/vbychkoviak))
+ * *fix:* corrected **--force** option so it will still output progress when not in the same process group as the owner of the terminal - corrects [#23 "No output with "-f" when run in background after 1.6.6"](https://codeberg.org/ivarch/pv/issues/23) and helps to correct [#31 "No output written from inside zsh <() construct"](https://codeberg.org/ivarch/pv/issues/31)
+ * *fix:* corrected elapsed time display to show as D:HH:MM:SS after 1 day, like the ETA does - corrects [#16 "Show days in same format in ETA as in elapsed time"](https://codeberg.org/ivarch/pv/issues/16)
+ * *fix:* corrected bug where percentages went down after 100% when in **--numeric** mode with a **--size** that was too small - corrects [#26 "Correct "-n" behaviour when going past 100% of "-s" size"](https://codeberg.org/ivarch/pv/issues/26)
+ * *i18n:* recoded Polish translation file to UTF-8
+ * *i18n:* removed inaccurate fuzzy translation matches
+ * *docs:* moved all open issues into GitHub and updated the TODO list
+ * *docs:* renamed README to README.md and altered it to Markdown format
+ * *docs:* moved contributors from the README to docs/ACKNOWLEDGEMENTS.md
+ * *docs:* moved TODO to TODO.md and altered it to Markdown format
+ * *docs:* moved NEWS to NEWS.md, converted it to UTF-8, and altered it to Markdown format
+
+### 1.6.20 - 12 September 2021
+
+ * *fix:* add missing `stddef.h` include to `number.c` (Sam James)
+
+### 1.6.19 - 5 September 2021
+
+ * *fix:* starting pv in the background no longer immediately stops unless the transfer is to/from the terminal (Andriy Gapon, Jonathan Elchison)
+ * *fix:* using **-B**, **-A**, or **-T** now switches on **-C** implicitly (Johannes Gerer, André Stapf)
+ * *fix:* AIX build fixes (Peter Korsgaard)
+ * *i18n:* updated German **--help** translations (Richard Fonfara)
+ * *i18n:* switched to UTF-8 encoding, added missing translations (de,fr,pt)
+ * *docs:* new "common switches" manual section (Jacek Wielemborek)
+ * *docs:* use placeholder instead of `/dev/sda` in the manual (Pranav Peshwe)
+ * *docs:* mention MacOS pipes and **-B 1024** in the manual (Jan Venekamp)
+ * *docs:* correct shell in `autoconf/scripts/index.sh` (Juan Picca)
+ * *cleanup:* various compiler warnings cleaned up
+
+Full changelog is below:
+
+ * (r181) added common switches section to manual (Jacek Wielemborek)
+ * (r184) use placeholder instead of /dev/sda in the manual (Pranav Peshwe)
+ * (r185) replace ash with sh in autoconf/scripts/index.sh (Juan Picca)
+ * (r185) added note to manual about **-B 1024** in MacOS pipes (Jan Venekamp)
+ * (r185) fix AIX config check when the CWD contains "yes" (Peter Korsgaard)
+ * (r189) (#1556) updated German **--help** translations (Richard Fonfara)
+ * (r189) updated missing German translations and changed to UTF-8 encoding
+ * (r191) updated missing French translations and changed to UTF-8 encoding
+ * (r193) updated missing Portuguese translations, changed to UTF-8 encoding
+ * (r196) (#1563) using **-B**, **-A**, or **-T** now switches on **-C** implicitly (Johannes Gerer, André Stapf)
+ * (r199) fixed numerous compiler warnings in newer GCC versions
+ * (r200,205) fixed bug where "`pv /dev/zero >/dev/null &`" stopped immediately (Jonathan Elchison, Andriy Gapon)
+ * (r203,205) marked unused arguments with GCC unused attribute, started using boolean data type for flags, corrected more compiler warnings
+
+### 1.6.6 - 30 June 2017
+
+ * (r161) use `%llu` instead of `%Lu` for better compatibility (Eric A. Borisch)
+ * (r162) (#1532) fix target buffer size (**-B**) being ignored (AndCycle, Ilya Basin, Antoine Beaupré)
+ * (r164) cap read/write sizes, and check elapsed time during read/write cycles, to avoid display hangs with large buffers or slow media; also remove `select()` call from repeated_write function as it slows the transfer down and the wrapping `alarm()` means it is unnecessary
+ * (r169) (#1477) use alternate form for transfer counter, such that 13GB is shown as 13.0GB so it's the same width as 13.1GB (André Stapf)
+ * (r171) cleanup: units corrections in man page, of the form kb -> KiB
+ * (r175) report error in **-d** if process fd directory is unreadable, or if process disappears before we start the main loop (Jacek Wielemborek)
+
+### 1.6.0 - 15 March 2015
+
+ * fix lstat64 support when unavailable - separate patches supplied by Ganael Laplanche and Peter Korsgaard
+ * (#1506) new option **-D** / **--delay-start** to only show bar after N seconds (Damon Harper)
+ * new option **--fineta** / **-I** to show ETA as time of day rather than time remaining - patch supplied by Erkki Seppälä (r147)
+ * (#1509) change ETA (**--eta** / **-e**) so that days are given if the hours remaining are 24 or more (Jacek Wielemborek)
+ * (#1499) repeat read and write attempts on partial buffer fill/empty to work around post-signal transfer rate drop reported by Ralf Ramsauer
+ * (#1507) do not try to calculate total size in line mode, due to bug reported by Jacek Wielemborek and Michiel Van Herwegen
+ * cleanup: removed defunct RATS comments and unnecessary copyright notices
+ * clean up displayed lines when using **--watchfd PID**, when PID exits
+ * output errors on a new line to avoid overwriting transfer bar
+
+### 1.5.7 - 26 August 2014
+
+ * show KiB instead of incorrect kiB (Debian bug #706175)
+ * (#1284) do not gzip man page, for non-Linux OSes (Bob Friesenhahn)
+ * work around "awk" bug in `tests/016-numeric-timer` in decimal "," locales
+ * fix "`make rpm`" and "`make srpm`", extend "`make release`" to sign releases
+
+### 1.5.3 - 4 May 2014
+
+ * remove *SPLICE_F_NONBLOCK* to fix problem with slow `splice()` (Jan Seda)
+
+### 1.5.2 - 10 February 2014
+
+ * allow **--watchfd** to look at block devices
+ * let **--watchfd PID:FD** work with **--size N**
+ * moved contributors out of the manual as the list was too long (NB everyone is still listed in the README and always will be)
+
+### 1.5.1 - 23 January 2014
+
+ * new option **--watchfd** - suggested by Jacek Wielemborek and "fdwatch"
+ * use non-block flag with `splice()`
+ * new display option **--buffer-percent**, suggested by Kim Krecht
+ * new display option **--last-written**, suggested by Kim Krecht
+ * new transfer option **--no-splice**
+ * fix for minor bug which dropped display elements after one empty one
+ * fix for single fd leak on exit (Cristian Ciupitu)
+
+### 1.4.12 - 5 August 2013
+
+ * new option **--null** - patch supplied by Zing Shishak
+ * AIX build fix (add "`-lc128`") - with help from Pawel Piatek
+ * AIX **-c** fixes - with help from Pawel Piatek
+ * SCO build fix (`po2table.sh`) - reported by Wouter Pronk
+ * test scripts fix for older distributions - patch from Bryan Dongray
+ * fix for `splice()` not using stdin - patch from Zev Weiss
+
+### 1.4.6 - 22 January 2013
+
+ * added patch from Pawel Piatek to omit *O_NOFOLLOW* in AIX
+
+### 1.4.5 - 10 January 2013
+
+ * updated manual page to show known problem with **-R** on Cygwin
+
+### 1.4.4 - 11 December 2012
+
+ * added debugging, see "`pv -h`" when `configure` is run with **--enable-debugging**
+ * rewrote cursor positioning code used when IPC is unavailable (Cygwin)
+ * fixed cursor positioning cursor read answerback problem (Cygwin/Solaris)
+ * fixed bug causing crash when progress displayed with too-small terminal
+
+### 1.4.0 - 6 December 2012
+
+ * new option **--skip-errors** commissioned by Jim Salter
+ * if stdout is a block device, and we don't know the total size, use the size of that block device as the total (Peter Samuelson)
+ * new option **--stop-at-size** to stop after **--size** bytes
+ * report correct filename on read errors
+ * fix use-after-free bug in remote PID cleanup code
+ * refactored large chunks of code to make it more readable and to replace most static variables with a state structure
+
+### 1.3.9 - 5 November 2012
+
+ * allow **--format** parameters to be sent with **--remote**
+ * configure option **--disable-ipc**
+ * added tests for **--numeric** with **--timer** and **--bytes**
+ * added tests for **--remote**
+
+### 1.3.8 - 29 October 2012
+
+ * new **--pidfile** option to save process ID to a file
+ * integrated patch for **--numeric** with **--timer** and **--bytes** (Sami Liedes)
+ * removed signalling from **--remote** to prevent accidental process kills
+ * new **--format** option (originally Vladimir Pal / Vladimir Ermakov)
+
+### 1.3.4 - 27 June 2012
+
+ * new **--disable-splice** configure script option
+ * fixed line mode size count with multiple files (Moritz Barsnick)
+ * fixes for AIX core dumps (Pawel Piatek)
+
+### 1.3.1 - 9 June 2012
+
+ * do not use `splice()` if the write buffer is not empty (Thomas Rachel)
+ * added test 15 (pipe transfers), and new test script
+
+### 1.3.0 - 5 June 2012
+
+ * added Tiger build patch from Olle Jonsson
+ * fix 1024-boundary display garble (Debian bug #586763)
+ * use `splice`(2) where available (Debian bug #601683)
+ * added known bugs section of the manual page
+ * fixed average rate test, 12 (Andrew Macheret)
+ * use IEEE1541 units (Thomas Rachel)
+ * bug with rate limit under 10 fixed (Henry Precheur)
+ * speed up PV line mode (patch: Guillaume Marcais)
+ * remove `LD=ld` from `vars.mk` to fix cross-compilation (paintitgray/PV#1291)
+
+### 1.2.0 - 14 December 2010
+
+ * integrated improved SI prefixes and **--average-rate** (Henry Gebhardt)
+ * return nonzero if exiting due to *SIGTERM* (Martin Baum)
+ * patch from Phil Rutschman to restore terminal properly on exit
+ * fix i18n especially for **--help** (Sebastian Kayser)
+ * refactored `pv_display`
+ * we now have a coherent, documented, exit status
+ * modified pipe test and new cksum test from Sebastian Kayser
+ * default *CFLAGS* to just "`-O`" for non-GCC (Kjetil Torgrim Homme)
+ * LFS compile fix for OS X 10.4 (Alexandre de Verteuil)
+ * remove *DESTDIR* `/` suffix (Sam Nelson, Daniel Pape)
+ * fixed potential NULL deref in transfer (Elias Pipping / LLVM/Clang)
+
+### 1.1.4 - 6 March 2008
+
+ * patch from Elias Pipping correcting compilation failure on Darwin 9
+ * patch from Patrick Collison correcting similar problems on OS X
+ * trap *SIGINT* / *SIGHUP* / *SIGTERM* so we clean up IPCs on exit (Laszlo Ersek)
+ * abort if numeric option, eg **-L**, has non-numeric value (Boris Lohner)
+
+### 1.1.0 - 30 August 2007
+
+ * new option **--remote** (**-R**) to control an already-running process
+ * new option **--line-mode** (**-l**) to count lines instead of bytes
+ * fix for **-L** to be less resource intensive
+ * fix for input/output equivalence check on Mac OS X
+ * fix for size calculation in pipelines on Mac OS X
+ * fixed "`make uninstall`"
+ * removed "`/debian`" directory at request of new Debian maintainer
+
+### 1.0.1 - 4 August 2007
+
+ * licensing change from Artistic to Artistic 2.0
+ * removed the **-l** / **--license** option
+
+### 1.0.0 - 2 August 2007
+
+ * act more like "`cat`" - just skip unreadable files, don't abort
+ * removed text version of manual page, and obsolete Info file generation
+ * code cleanup and separation of PV internals from CLI front-end
+
+### 0.9.9 - 5 February 2007
+
+ * new option **--buffer-size** (**-B**) suggested by Mark Tomich
+ * build fix: HP/UX largefile compile fix from Timo Savinen
+ * maintain better buffer filling during transfers
+ * workaround: "`pv /dev/zero | dd bs=1M count=1k`" bug (reported by Gert Menke)
+ * dropped support for the Texinfo manual
+
+### 0.9.6 - 27 February 2006
+
+ * bugfix: `key_t` incompatibility with Cygwin
+ * bugfix: interval (**-i**) parameter parses numbers after decimal point
+ * build fix: use static NLS if `msgfmt` is unavailable
+ * on the final update, blank out the now-zero ETA
+
+### 0.9.2 - 1 September 2005
+
+ * Daniel Roethlisberger patch: use lockfiles if terminal locking fails
+
+### 0.9.1 - 16 June 2005
+
+ * minor RPM spec file fix for Fedora Core 4
+
+### 0.9.0 - 15 November 2004
+
+ * minor NLS bugfix
+
+### 0.8.9 - 6 November 2004
+
+ * decimal values now accepted for rate and size, eg **-L 1.23M**
+ * code cleanup
+ * developers: "`make help`" now lists Makefile targets
+
+### 0.8.6 - 29 June 2004
+
+ * use `uu_lock()` for terminal locking on FreeBSD
+
+### 0.8.5 - 2 May 2004
+
+ * cursor positioning (**-c**) reliability improved on systems with IPC
+ * minor fix: made test 005 more reliable
+ * new option **--height** (**-H**)
+
+### 0.8.2 - 24 April 2004
+
+ * allow k,m,g,t suffixes on numbers
+ * added "`srpm`" and "`release`" Makefile targets
+
+### 0.8.1 - 19 April 2004
+
+ * bugfix in cursor positioning (**-c**)
+
+### 0.8.0 - 12 February 2004
+
+ * replaced GNU getopt with my library code
+ * replaced GNU gettext with my very minimal replacement
+ * use *DESTDIR* instead of *RPM_BUILD_ROOT* for optional installation prefix
+ * looked for flaws using RATS, cleaned up code
+
+### 0.7.0 - 8 February 2004
+
+ * display buffer management fixes (thanks Cédric Delfosse)
+ * replaced **--enable-debug** with **--enable-debugging** and **--enable-profiling**
+
+### 0.6.4 - 14 January 2004
+
+ * fixed minor bug in RPM installation
+ * bugfix in "`make index`" (only of interest to developers)
+
+### 0.6.3 - 22 December 2003
+
+ * fixed transient bug that reported "resource unavailable" occasionally
+
+### 0.6.2 - 6 August 2003
+
+ * block devices now have their size read correctly, so "`pv /dev/hda1`" works
+ * minor code cleanups (mainly removal of CVS "Id" tags)
+
+### 0.6.0 - 3 August 2003
+
+ * doing *^Z* then "`bg`" then "`fg`" now continues displaying
+
+### 0.5.9 - 23 July 2003
+
+ * fix for test 007 when not in C locale
+ * fix for build process to use *CPPFLAGS*
+ * fix for build process to use correct i18n libraries
+ * fix for build process - more portable sed in dependency generator
+ * fix for install process - remember to `mkinstalldirs` before installing
+ * fixes for building on Mac OS X
+
+### 0.5.3 - 4 May 2003
+
+ * added Polish translation thanks to Bartosz Feński <fenio@o2.pl> <http://skawina.eu.org/> and Krystian Zubel
+ * moved `doc/debian` to `./debian` at insistence of common sense
+ * minor Solaris 8 compatibility fixes
+ * seems to compile and test OK on Mac OS X
+
+### 0.5.0 - 15 April 2003
+
+ * added French translation thanks to Stéphane Lacasse <stephane@gorfou.ca>
+ * added German translation thanks to Marcos Kreinacke <public@kreinacke.com>
+ * switched LGPL reference from "Library" to "Lesser"
+
+### 0.4.9 - 18 February 2003
+
+ * support for >2GB files added where available (Debian bug #180986)
+ * added `doc/debian` dir (from Cédric Delfosse)
+ * added "`make rpm`" and "`make deb`" targets to build RPM and Debian packages
+ * added a "`make pv-static`" rule to build a statically linked version
+
+### 0.4.5 - 13 December 2002
+
+ * added Portuguese (Brazilian) translation thanks to Eduardo Aguiar
+
+### 0.4.4 - 7 December 2002
+
+ * pause/resume support - don't count time while stopped
+ * stop output when resumed in the background
+ * terminal size change support
+ * bugfix: "`<=>`" indicator no longer sticks at right hand edge
+
+### 0.4.0 - 27 November 2002
+
+ * allow decimal interval values, eg 0.1, 0.5, etc
+ * some simple tests added ("`make check`")
+ * smoother throughput limiting (**--rate-limit**), now done in 0.1sec chunks
+ * bounds-check interval values (**-i**) - max update interval now 10 minutes
+ * more reliable non-blocking output to keep display updated
+ * no longer rely on `atoll()`
+ * don't output final blank line if **--numeric**
+ * use `fcntl()` instead of `flock()` for Solaris compatibility
+
+### 0.3.0 - 25 November 2002
+
+ * handle broken output pipe gracefully
+ * continue updating display even when output pipe is blocking
+
+### 0.2.6 - 21 October 2002
+
+ * we now ignore *EINTR* on `select()`
+ * variable-size buffer (still need to add code to change size)
+ * added (tentative) support for internationalisation
+ * removed superfluous **--no-progress**, etc options
+ * optimised transfer by using bigger buffers, based on `st_blksize`
+ * added **--wait** option to wait until transfer begins before showing progress
+ * added **--rate-limit** option to limit rate to a maximum throughput
+ * added **--quiet** option (no output at all) to be used with **--rate-limit**
+
+### 0.2.5 - 23 July 2002
+
+ * added *[FILE]...* arguments, like "`cat`"
+ * function separation in code
+ * some bug fixes related to numeric overflow
+
+### 0.2.3 - 19 July 2002
+
+ * Texinfo manual written, man page updated
+ * byte counter added
+
+### 0.2.0 - 18 July 2002
+
+ * ETA counter added
+ * screen width estimation added
+ * progress bar added
+
+### 0.1.0 - 17 July 2002
+
+ * main loop created
+ * rate counter added
+ * elapsed time counter added
+ * percentage calculation added
+
+### 0.0.1 - 16 July 2002
+
+ * package created
+ * first draft of man page written

docs/benchmark.sh

@@ -18,7 +18,7 @@ dd if=/dev/zero of="${test_input}" bs=1k count=1k >/dev/null 2>&1
 echo -e "Buf(k)\tRate(k)\tReads\tRsize\tWrites\tWsize"
 
 for ((buffer=100; buffer<=1000; buffer+=100)); do
-	for ((rate=0; rate<=1000; rate+=100)); do
+	for ((rate=100; rate<=1000; rate+=100)); do
 		rateparm="-L ${rate}k"
 		test ${rate} -eq 0 && rateparm=""
 		strace -tt -o "${strace_output}" \
@@ -35,5 +35,3 @@ for ((buffer=100; buffer<=1000; buffer+=100)); do
 		echo -e "${buffer}\t${rate}\t${rdata}\t${wdata}"
 	done
 done
-
-# EOF

docs/pv.1

@@ -0,0 +1,854 @@
+.TH PV 1 2025-11-07 pv-1.10.0 "User Commands"
+.\"
+.SH NAME
+pv \- monitor and manage the progress of data through a pipe
+.\"
+.SH SYNOPSIS
+.B pv
+[\fIOPTION\fR]... [\fIFILE\fR]...
+.PP
+\fBpv\fR [\fIOPTION\fR]... \fB\-d\fR|\fB\-\-watchfd\fR
+\fIPID\fR[:\fIFD\fR]|=\fINAME\fR|@\fILISTFILE\fR...
+.PP
+\fBpv\fR \fB\-R\fR|\fB\-\-remote\fR \fIPID\fR [\fIOPTION\fR]...
+.PP
+\fBpv\fR \fB\-Q\fR|\fB\-\-query\fR \fIPID\fR [\fIOPTION\fR]...
+.\"
+.SH DESCRIPTION
+Show the progress of data through a pipeline by giving information such as
+time elapsed, percentage completed (with progress bar), current throughput
+rate, total data transferred, and ETA.
+The data flow rate, error handling strategy, buffer size, and cache
+interaction can all be adjusted.
+.PP
+Each \fIFILE\fR is copied to standard output.
+With no \fIFILE\fR, or when \fIFILE\fR is \*(lq-\*(rq, standard input is
+read.
+.PP
+In \*(lq\fB\-\-watchfd\fR\*(rq mode, inspect another process and show its
+progress through the files it has open.
+.\"
+.SH OPTIONS
+.\"
+.SS "Display switches"
+If no display switches are specified, \fBpv\fR behaves as if
+\*(lq\fB\-\-progress\fR\*(rq, \*(lq\fB\-\-timer\fR\*(rq,
+\*(lq\fB\-\-eta\fR\*(rq, \*(lq\fB\-\-rate\fR\*(rq, and
+\*(lq\fB\-\-bytes\fR\*(rq had been given.
+Otherwise, only those display types that are explicitly switched on will be
+shown.
+.TP
+.B \-p, \-\-progress
+Turn the progress bar on.
+If any inputs are not files, or are unreadable, and no size was explicitly
+given with \*(lq\fB\-\-size\fR\*(rq, the progress bar cannot indicate how
+close to completion the transfer is, so it will just move left and right to
+indicate that data is moving - or, with \*(lq\fB\-\-gauge\fR\*(rq, the bar
+will indicate the current rate as a percentage of the maximum rate seen so
+far.
+.TP
+.B \-t, \-\-timer
+Turn the timer on.
+This will display the total elapsed time that \fBpv\fR has been running for.
+.TP
+.B \-e, \-\-eta
+Turn the ETA countdown on.
+This will estimate, based on current transfer rates and the total data size,
+how long it will be before completion.
+The countdown is prefixed with \*(lqETA\*(rq.
+This option will have no effect if the total data size cannot be determined.
+.TP
+.B \-I, \-\-fineta
+Turn the ETA countdown on, but display the estimated local time at which the
+transfer will finish, instead of the amount of time remaining.
+When the estimated time is more than 6 hours in the future, the date is
+shown as well.
+The time is prefixed with \*(lqFIN\*(rq for finish time.
+As with \*(lq\fB\-\-eta\fR\*(rq, this option will have no effect if the
+total data size cannot be determined.
+.TP
+.B \-r, \-\-rate
+Turn the rate counter on.
+This will display the current rate of data transfer.
+The rate is shown in square brackets \*(lq[]\*(rq.
+.TP
+.B \-a, \-\-average\-rate
+Turn the average rate counter on.
+This will display the current average rate of data transfer, over the last
+30 seconds by default (see \*(lq\fB\-\-average-rate-window\fR\*(rq).
+The average rate is shown in brackets \*(lq()\*(rq.
+.TP
+.B \-b, \-\-bytes
+Turn the total byte counter on.
+This will display the total amount of data transferred so far.
+.TP
+.B \-T, \-\-buffer\-percent
+Turn on the transfer buffer percentage display.
+This will show the percentage of the transfer buffer in use.
+Implies \*(lq\fB\-\-no\-splice\fR\*(rq.
+The transfer buffer percentage is shown in curly brackets \*(lq{}\*(rq.
+.TP
+.BI \-A\  NUM \fR,\ \fB\-\-last\-written\  NUM
+Show the last \fINUM\fR bytes written.
+Implies \*(lq\fB\-\-no\-splice\fR\*(rq.
+.TP
+.BI \-F\  FORMAT \fR,\ \fB\-\-format\  FORMAT
+Ignore all of the above options and instead use the format string
+\fIFORMAT\fR to determine the output format.
+See the \fBFORMATTING\fR section below.
+.TP
+.B \-n, \-\-numeric
+Numeric output.
+Instead of giving a visual indication of progress, write an integer
+percentage, one per line, on standard error, suitable for passing to a tool
+such as \fBdialog\fR(1).
+Note that \*(lq\fB\-\-force\fR\*(rq is not required if
+\*(lq\fB\-\-numeric\fR\*(rq is being used.
+.IP
+Combining \*(lq\fB\-\-numeric\fR\*(rq with \*(lq\fB\-\-bytes\fR\*(rq will
+cause the number of bytes processed so far to be output instead of a
+percentage.
+Adding \*(lq\fB\-\-line\-mode\fR\*(rq as well as \*(lq\fB\-\-bytes\fR\*(rq
+writes the number of lines instead of bytes or a percentage.
+Adding \*(lq\fB\-\-rate\fR\*(rq adds the transfer rate to each output line
+(if \*(lq\fB\-\-bytes\fR\*(rq is also in use, the rate comes after the
+byte/line count).
+Adding \*(lq\fB\-\-timer\fR\*(rq prefixes each output line with the elapsed
+time so far, as a decimal number of seconds.
+.IP
+Combining \*(lq\fB\-\-numeric\fR\*(rq with \*(lq\fB\-\-format\fR\*(rq allows
+for custom output.  The default format string components for
+\*(lq\fB\-\-numeric\fR\*(rq are
+\*(lq\fB%t\~%b\~%r\~%{progress\-amount\-only}\fR\*(rq in that order, each
+item being active or inactive according to the rules above (so the default
+with no other options is \*(lq\fB%{progress\-amount\-only}\fR\*(rq.
+.TP
+.B \-q, \-\-quiet
+No output.
+Useful if the \*(lq\fB\-\-rate\-limit\fR\*(rq option is being used on its
+own to limit the transfer rate of a pipe.
+.\"
+.SS "Output modifiers"
+.TP
+.B \-8, \-\-bits
+Use bits instead of bytes for the byte and rate counters.
+The output suffix will be \*(lqb\*(rq instead of \*(lqB\*(rq.
+.TP
+.B \-k, \-\-si
+Display and interpret suffixes as multiples of 1000 rather than the default
+of 1024.
+Note that this only takes effect on options after this one, so for
+consistency, specify this option first.
+.TP
+.B \-W, \-\-wait
+Wait until the first byte has been transferred before showing any progress
+information or calculating any ETAs.
+Useful if the program you are piping to or from requires extra information
+before it starts, such as when piping data into \fBgpg\fR(1) or
+\fBmcrypt\fR(1) which require a passphrase before data can be processed.
+.TP
+.BI \-D\  SEC \fR,\ \fB\-\-delay\-start\  SEC
+Wait until \fISEC\fR seconds have passed before showing any progress
+information, for example in a script where you only want to show a progress
+bar if it starts taking a long time.
+The value of \fISEC\fR can be a decimal such as \*(lq0.5\*(rq.
+.TP
+.BI \-s\  SIZE \fR,\ \fB\-\-size\  SIZE
+Assume the total amount of data to be transferred is \fISIZE\fR bytes when
+calculating percentages and ETAs.
+A suffix of \*(lqK\*(rq, \*(lqM\*(rq, \*(lqG\*(rq, or \*(lqT\*(rq can be
+added to denote kibibytes (*1024), mebibytes, gibibytes, tebibytes.
+If \*(lq\fB\-\-si\fR\*(rq appears before this option, suffixes will denote
+kilobytes (*1000), megabytes, and so on instead.
+.IP
+If \fISIZE\fR starts with \*(lq\fB@\fR\*(rq, the size of file whose name
+follows the @ will be used.
+.TP
+.B \-g, \-\-gauge
+If the progress bar is shown but the size is not known, then instead of
+moving the bar left and right to show progress, show the current transfer
+rate as a percentage of the maximum rate seen so far.
+.TP
+.B \-l, \-\-line\-mode
+Instead of counting bytes, count lines (newline characters).
+The progress bar will only move when a new line is found, and the value
+passed to \*(lq\fB\-\-size\fR\*(rq will be interpreted as a line count.
+.IP
+If this option is used without \*(lq\fB\-\-size\fR\*(rq, the "total size"
+(in this case, total line count) is calculated by reading through all input
+files once before transfer starts.
+If any inputs are pipes or non-regular files, or are unreadable, the total
+size will not be calculated.
+.TP
+.B \-0, \-\-null
+Count lines as terminated with a null byte instead of with a newline.
+This option implies \*(lq\fB\-\-line\-mode\fR\*(rq.
+.TP
+.BI \-i\  SEC \fR,\ \fB\-\-interval\  SEC
+Wait \fISEC\fR seconds between updates.
+The default is to update every second.
+The value of \fISEC\fR can be a decimal such as \*(lq0.1\*(rq.
+.TP
+.BI \-m\  SEC \fR,\ \fB\-\-average-rate-window\  SEC
+Compute current average rate over a \fISEC\fR seconds window for average
+rate and ETA calculations.
+The default is 30 seconds.
+The value must be an integer.
+.TP
+.BI \-w\  WIDTH \fR,\ \fB\-\-width\  WIDTH
+Assume the terminal is \fIWIDTH\fR columns wide, instead of trying to work
+it out (or assuming 80 if it cannot be guessed).
+If this option is used, the output width will not be adjusted if the width
+of the terminal changes while the transfer is running.
+.TP
+.BI \-H\  HEIGHT \fR,\ \fB\-\-height\  HEIGHT
+Assume the terminal is \fIHEIGHT\fR rows high, instead of trying to work it
+out (or assuming 25 if it cannot be guessed).
+If this option is used, the output height will not be adjusted if the height
+of the terminal changes while the transfer is running.
+.TP
+.BI \-N\  NAME \fR,\ \fB\-\-name\  NAME
+Prefix the output information with \fINAME\fR.
+Useful in conjunction with \*(lq\fB\-\-cursor\fR\*(rq if you have a
+complicated pipeline and you want to be able to tell different parts of it
+apart.
+.TP
+.BI \-u\  STYLE \fR,\ \fB\-\-bar\-style\  STYLE
+Change the default progress bar style shown by \*(lq\fB\-\-progress\fR\*(rq,
+or by the \*(lq\fB\-\-format\fR\*(rq sequences \*(lq\fB%{progress}\fR\*(rq
+or \*(lq\fB%{progress\-bar\-only}\fR\*(rq, to \fISTYLE\fR.
+The \fISTYLE\fR can be one of \fBplain\fR (the default), \fBblock\fR,
+\fBgranular\fR, or \fBshaded\fR.
+These styles are described in the \fBFORMATTING\fR section below.
+.TP
+.BI \-x\  SPEC \fR,\ \fB\-\-extra\-display\  SPEC
+As well as displaying progress to the terminal, also write it to \fISPEC\fR.
+The \fISPEC\fR must start with a comma-separated list of destinations, and
+can optionally be followed by a colon and a format string.
+The destinations can be \fBwindowtitle\fR or \fBwindow\fR for the xterm
+window title, and \fBprocesstitle\fR, \fBproctitle\fR, \fBprocess\fR, or
+\fBproc\fR for the process title displayed by \fBps\fR(1).
+If a format string is not supplied, the same format is used as for the
+terminal.
+For example, \*(lq\fB\-x\~'window,process:%t\~%b\~%r'\fR\*(rq will show the
+elapsed time, bytes transferred, and rate, in both the window title and the
+process title.
+.TP
+.B \-v, \-\-stats
+At the end of the transfer, write an additional line showing the transfer
+rate minimum, maximum, mean, and standard deviation.
+The values are always in bytes per second (or bits, with
+\*(lq\fB\-\-bits\fR\*(rq).
+.TP
+.B \-f, \-\-force
+Force output.
+Normally, \fBpv\fR will not output any visual display if standard error is
+not a terminal.
+This option forces it to do so.
+.TP
+.B \-c, \-\-cursor
+Use cursor positioning escape sequences instead of just using carriage
+returns.
+This is useful in conjunction with \*(lq\fB\-\-name\fR\*(rq if you are using
+multiple \fBpv\fR invocations in a single pipeline.
+.\"
+.SS "Data transfer modifiers"
+.TP
+.BI \-o\  FILE \fR,\ \fB\-\-output\  FILE
+Write data to \fIFILE\fR instead of standard output.
+If the file already exists, it will be truncated.
+.TP
+.BI \-L\  RATE \fR,\ \fB\-\-rate-limit\  RATE
+Limit the transfer to a maximum of \fIRATE\fR bytes per second.
+The same suffixes as \*(lq\fB\-\-size\fR\*(rq can be used.
+.TP
+.BI \-B\  BYTES \fR,\ \fB\-\-buffer-size\  BYTES
+Use a transfer buffer size of \fIBYTES\fR bytes.
+The same suffixes as \*(lq\fB\-\-size\fR\*(rq can be used.
+The default buffer size is the block size of the input file's filesystem
+multiplied by 32 (512KiB max), or 400KiB if the block size cannot be
+determined.
+This can be useful on platforms like macOS with pipelines that perform
+better with specific buffer sizes such as 1024.
+Implies \*(lq\fB\-\-no\-splice\fR\*(rq.
+.TP
+.B \-C, \-\-no-splice
+Never use \fBsplice\fR(2), even if it would normally be possible.
+The \fBsplice\fR(2) system call is a more efficient way of transferring data
+from or to a pipe than regular \fBread\fR(2) and \fBwrite\fR(2), but means
+that the transfer buffer may not be used.
+This prevents \*(lq\fB\-\-buffer\-percent\fR\*(rq and
+\*(lq\fB\-\-last\-written\fR\*(rq from working, cannot work with
+\*(lq\fB\-\-sparse\fR\*(rq or \*(lq\fB\-\-discard\fR\*(rq, and makes
+\*(lq\fB\-\-buffer\-size\fR\*(rq redundant, so using any of those options
+automatically switches on \*(lq\fB\-\-no\-splice\fR\*(rq.
+Switching on this option results in a small loss of transfer efficiency.
+It has no effect on systems where \fBsplice\fR(2) is unavailable.
+.TP
+.B \-E, \-\-skip-errors
+Ignore read errors by attempting to skip past the offending sections.
+The corresponding parts of the output will be null bytes.
+At first only a few bytes will be skipped, but if there are many errors in a
+row then the skips will move up to chunks of 512.
+This is intended to be similar to \*(lq\fIdd\~conv=sync,noerror\fR\*(rq.
+.IP
+Specify \*(lq\fB\-\-skip\-errors\fR\*(rq twice to only report a read error
+once per file, instead of reporting each byte range skipped.
+.TP
+.BI \-Z\  BYTES \fR,\ \fB\-\-error\-skip\-block\  BYTES
+When ignoring read errors with \*(lq\fB\-\-skip\-errors\fR\*(rq, instead of
+trying to adaptively skip by reading small amounts and skipping
+progressively larger sections until a read succeeds, move to the next file
+block of \fIBYTES\fR bytes as soon as an error occurs.
+There may still be some shorter skips where the block being skipped
+coincides with the end of the transfer buffer.
+The same suffixes as \*(lq\fB\-\-size\fR\*(rq can be used.
+.IP
+This option can only be used with \*(lq\fB\-\-skip\-errors\fR\*(rq
+and is intended for use when reading from a block device, such as
+\*(lq\fB\-\-skip\-errors\~\-\-error\-skip\-block\~4K\fR\*(rq
+to skip in 4 kibibyte blocks.
+This will speed up reads from faulty media, at the expense of potentially
+losing more data.
+.TP
+.B \-S, \-\-stop-at-size
+If a size was specified with \*(lq\fB\-\-size\fR\*(rq, stop transferring
+data once that many bytes have been written, instead of continuing to the
+end of input.
+.TP
+.B \-Y, \-\-sync
+After every write operation, synchronise the buffer caches to disk with
+\fBfdatasync\fR(2).
+This has no effect when the output is a pipe.
+Using \*(lq\fB\-\-sync\fR\*(rq may improve the accuracy of the progress bar
+when writing to a slow disk.
+.TP
+.B \-K, \-\-direct-io
+Set the \fBO_DIRECT\fR flag on all inputs and outputs, if it is available.
+This will minimise the effect of caches, at the cost of performance.
+Due to memory alignment requirements, it also may cause read or write
+failures with an error of \*(lqInvalid argument\*(rq, especially if reading
+and writing files across a variety of filesystems in a single \fBpv\fR call.
+Use this option with caution.
+.TP
+.B \-O, \-\-sparse
+When writing null bytes, try to seek, producing a sparse output file.
+Implies \*(lq\fB\-\-no\-splice\fR\*(rq.
+On filesystems without sparse file support, or when the output is not
+seekable, this option will have no effect other than to turn on
+\*(lq\fB\-\-no\-splice\fR\*(rq.
+.TP
+.B \-X, \-\-discard
+Instead of transferring input data to standard output, discard it.
+This is equivalent to redirecting standard output to \fI/dev/null\fR,
+except that \fBwrite\fR(2) is never called.
+Implies \*(lq\fB\-\-no\-splice\fR\*(rq.
+.TP
+.BI \-U\  FILE \fR,\ \fB\-\-store\-and\-forward\  FILE
+Instead of passing data through immediately, do it in two stages - first
+read all input and write it to \fIFILE\fR, and then once the input is
+exhausted, read all of \fIFILE\fR and write it to the output.
+\fIFILE\fR remains in place afterwards, unless it is
+\*(lq\fB-\fR\*(rq, in which case \fBpv\fR creates a temporary file for this
+purpose, and automatically removes it afterwards.
+.IP
+This can be useful if you have a pipeline which generates data (your
+input) quickly but you don't know the size, and you wish to pass it to some
+slower process, once all of the input has been generated and you know its
+size, so you can see its progress.
+Note that when doing this with relatively small amounts of data,
+\*(lq\fB\-\-no-splice\fR\*(rq may be preferable so that pipe buffering
+doesn't affect the progress display.
+.\"
+.\"
+.SS "Alternative operating modes"
+.TP
+\fB\-d\fR, \fB\-\-watchfd\fR \fIPID\fR[:\fIFD\fR]|=\fINAME\fR|@\fILISTFILE\fR...
+Instead of transferring data, watch file descriptor \fIFD\fR of process
+\fIPID\fR, and show its progress.
+Other data transfer modifiers - and remote control - may not be used with
+this option.
+.IP
+If a \fIPID\fR is specified without an \fIFD\fR, then that process will be
+watched, and all regular files and block devices it opens will be shown with
+a progress bar.
+.IP
+If a \fINAME\fR is specified, prefixed with "=", then processes with that
+name will be found with \fBpgrep\fR(1), and as watched described above.
+.IP
+If a \fILISTFILE\fR is specified, prefixed with "@", the lines in that file
+will be used as additional arguments.
+.IP
+All remaining non-option arguments will also be treated as additional
+arguments.
+.IP
+The \fBpv\fR process will exit when all \fIFD\fRs have either changed to a
+different file, changed read/write mode, or have closed, and all \fIPID\fRs
+(without a specific \fIFD\fR) have exited.
+.TP
+.BI \-R\  PID \fR,\ \fB\-\-remote\  PID
+Remotely control another instance of \fBpv\fR with process ID \fIPID\fR,
+making it act as though it had been given this instance's command line.
+For example, if \*(lq\fBpv\~\-\-rate\-limit\~123K\fR\*(rq is running with
+process ID 9876, then running
+\*(lq\fBpv\~\-\-remote\~9876\~\-\-rate\-limit\~321K\fR\*(rq will cause
+process 9876 to start using a rate limit of 321KiB instead of 123KiB.
+Note that some options cannot be changed while running, such as
+\*(lq\fB\-\-cursor\fR\*(rq, \*(lq\fB\-\-line\-mode\fR\*(rq,
+\*(lq\fB\-\-force\fR\*(rq, \*(lq\fB\-\-delay\-start\fR\*(rq,
+\*(lq\fB\-\-skip\-errors\fR\*(rq, and \*(lq\fB\-\-stop\-at\-size\fR\*(rq.
+.TP
+.BI \-Q\  PID \fR,\ \fB\-\-query\  PID
+Display the transfer progress of another instance of \fBpv\fR with process
+ID \fIPID\fR, owned by the same user.
+.IP
+Some output modifiers can only be used while querying another process if
+they match those of that process - such as
+\*(lq\fB\-\-line\-mode\fR\*(rq,
+\*(lq\fB\-\-null\fR\*(rq, and
+\*(lq\fB\-\-average\-rate\-window\fR\*(rq.
+Data transfer modifiers will have no effect.
+.\"
+.SS "Other options"
+.TP
+.BI \-P\  FILE \fR,\ \fB\-\-pidfile\  FILE
+Save the process ID of \fBpv\fR in \fIFILE\fR.
+The file will be replaced if it already exists, and will be removed when
+\fBpv\fR exits.
+While \fBpv\fR is running, \fIFILE\fR will contain a single number - the
+process ID of \fBpv\fR - followed by a newline.
+.TP
+.B \-h, \-\-help
+Print a usage message on standard output and exit successfully.
+.TP
+.B \-V, \-\-version         
+Print version information on standard output and exit successfully.
+.\"
+.SH FORMATTING
+Format strings used by \*(lq\fB\-\-format\fR\*(rq and
+\*(lq\fB\-\-extra\-display\fR\*(rq can contain the following sequences:
+.TP
+.BR %p ", " %{progress}
+Progress bar (suffixed with a percentage if the size is known).
+Equivalent to \*(lq\fB\-\-progress\fR\*(rq.
+Expands to fill the remaining space unless prefixed by a number to set the
+width, such as \*(lq\fB%20p\fR\*(rq or \*(lq\fB%20{progress}\fR\*(rq.
+.TP
+.BR %{progress\-bar\-only}
+Progress bar, without any sides, and without any percentage displayed
+afterwards.
+Expands to fill the remaining space unless prefixed by a number.
+.TP
+.B %{progress\-amount\-only}
+The percentage completion (or maximum rate, with \*(lq\fB\-\-gauge\fR\*(rq
+when the size is unknown).
+.TP
+.B %{bar\-plain}
+Progress bar in the standard plain format, without any sides, and without
+any percentage displayed afterwards.
+Expands to fill the remaining space unless prefixed by a number.
+.TP
+.B %{bar\-block}
+Progress bar using Unicode full blocks, without any sides, and without any
+percentage displayed afterwards.
+Expands to fill the remaining space unless prefixed by a number.
+If UTF-8 output is not available, the plain format is used.
+.TP
+.B %{bar\-granular}
+Progress bar using Unicode full blocks, and 1/8th blocks for partial fills,
+providing a more granular display.
+Like the other \*(lq%{bar}\*(rq strings this shows the bar without any
+sides, and without any percentage displayed afterwards, and expands to fill
+the remaining space unless prefixed by a number.
+If UTF-8 output is not available, the plain format is used.
+.TP
+.B %{bar\-shaded}
+Progress bar using Unicode full blocks and shade characters - dark and
+medium shade are used for partial fills, and the light shade is used for the
+background.
+Like the other \*(lq%{bar}\*(rq strings this shows the bar without any
+sides, and without any percentage displayed afterwards, and expands to fill
+the remaining space unless prefixed by a number.
+If UTF-8 output is not available, the plain format is used.
+.TP
+.BR %t ", " %{timer}
+Elapsed time.
+Equivalent to \*(lq\fB\-\-timer\fR\*(rq.
+.TP
+.BR %e ", " %{eta}
+ETA as time remaining.
+Equivalent to \*(lq\fB\-\-eta\fR\*(rq.
+.TP
+.BR %I ", " %{fineta}
+ETA as local time at which the transfer will finish.
+Equivalent to \*(lq\fB\-\-fineta\fR\*(rq.
+.TP
+.BR %r ", " %{rate}
+Current data transfer rate.
+Equivalent to \*(lq\fB\-\-rate\fR\*(rq.
+.TP
+.BR %a ", " %{average\-rate}
+Average data transfer rate.
+Equivalent to \*(lq\fB\-\-average\-rate\fR\*(rq.
+.TP
+.BR %b ", " %{bytes} ", " %{transferred}
+Bytes transferred so far (or lines if \*(lq\fB\-\-line\-mode\fR\*(rq was specified).
+Equivalent to \*(lq\fB\-\-bytes\fR\*(rq.
+If \*(lq\fB\-\-bits\fR\*(rq was specified, \*(lq\fB%b\fR\*(rq shows the bits
+transferred so far, not bytes.
+.TP
+.BR %T ", " %{buffer\-percent}
+Percentage of the transfer buffer in use.
+Equivalent to \*(lq\fB\-\-buffer\-percent\fR\*(rq.
+Displays \*(lq{\-\-\-\-}\*(rq if the transfer is being done with
+\fBsplice\fR(2), since splicing to or from pipes does not use the buffer.
+.TP
+.BR %nA ", " %n{last\-written}
+Show the last \fIn\fR bytes written (for example, \*(lq\fB%16A\fR\*(rq shows
+the last 16 bytes).
+Shows only dots if the transfer is being done with \fBsplice\fR(2), since
+splicing to or from pipes does not use the buffer.
+.TP
+.BR %nL ", " %n{previous\-line}
+Show the first \fIn\fR bytes of the most recently written line (for example,
+\*(lq\fB%40L\fR\*(rq shows the first 40 bytes).
+If no \fIn\fR is given, then this expands to fill the available space.
+Shows only spaces if the transfer is being done with \fBsplice\fR(2).
+.TP
+.BR %N ", " %{name}
+Show the name prefix given by \*(lq\fB\-\-name\fR\*(rq.
+Padded to 9 characters with spaces, and suffixed with \*(lq:\*(rq.
+.TP
+.B %{sgr:colour,...}
+Emit ECMA-48 SGR (Select Graphic Rendition) codes if the terminal supports
+colours, where \fIcolour,...\fR is a comma-separated list of any of the
+keywords below, or the numeric values from \fBconsole_codes\fR(4).  If
+colour support is not available, nothing is emitted.
+.IP
+Supported keywords are:
+\fBreset\fR or \fBnone\fR,
+\fBblack\fR,
+\fBred\fR,
+\fBgreen\fR,
+\fBbrown\fR or \fByellow\fR,
+\fBblue\fR,
+\fBmagenta\fR,
+\fBcyan\fR,
+\fBwhite\fR,
+\fBfg\-black\fR,
+\fBfg\-red\fR,
+\fBfg\-green\fR,
+\fBfg\-brown\fR or \fBfg\-yellow\fR,
+\fBfg\-blue\fR,
+\fBfg\-magenta\fR,
+\fBfg\-cyan\fR,
+\fBfg\-white\fR,
+\fBfg\-default\fR,
+\fBbg\-black\fR,
+\fBbg\-red\fR,
+\fBbg\-green\fR,
+\fBbg\-brown\fR or \fBbg\-yellow\fR,
+\fBbg\-blue\fR,
+\fBbg\-magenta\fR,
+\fBbg\-cyan\fR,
+\fBbg\-white\fR,
+\fBbg\-default\fR,
+\fBbold\fR,
+\fBdim\fR,
+\fBitalic\fR,
+\fBunderscore\fR or \fBunderline\fR,
+\fBblink\fR,
+\fBreverse\fR,
+\fBno\-bold\fR or \fBno\-dim\fR,
+\fBno\-italic\fR,
+\fBno\-underscore\fR or \fBno\-underline\fR,
+\fBno\-blink\fR,
+\fBno\-reverse\fR.
+.IP
+With colours, the optional "fg-" prefix indicates foreground; a prefix of
+"bg-" indicates background.
+.IP
+For example, \*(lq\fB%{sgr:green,bold}TEXT%{sgr:reset}\fR\*(lq will make
+\fITEXT\fR bold green on supported terminals.
+.TP
+.B %%
+A single \*(lq%\*(rq.
+.PP
+Any other contents are reproduced in the progress display as-is.
+.PP
+The format string equivalent of the default display switches is
+\*(lq\fB%b\~%t\~%r\~%p\~%e\fR\*(rq.
+.\"
+.SH EXAMPLES
+Some suggested common switch combinations:
+.TP
+.B pv \-ptebar
+Show a progress bar, elapsed time, estimated completion time, byte counter,
+average rate, and current rate.
+.TP
+.B pv \-betlap
+Show a progress bar, elapsed time, estimated completion time, line counter,
+and average rate, counting lines instead of bytes.
+.TP
+.B pv \-btrpg
+Show the amount transferred, elapsed time, current rate, and a gauge showing
+the current rate as a percentage of the maximum rate seen - useful in a
+pipeline where the total size is unknown.
+(If the size \fIis\fR known, these options will show the percentage
+completion instead of the rate gauge).
+.TP
+.B pv \-t
+Show only the elapsed time - useful as a simple timer, such as
+\*(lq\fBsleep\~10m\~|\~pv\~\-t\fR\*(rq.
+.TP
+.B pv \-pterb
+The default behaviour: progress bar, elapsed time, estimated completion
+time, current rate, and byte counter.
+.PP
+On macOS, it may be useful to specify \*(lq\fB\-\-buffer\-size\~1024\fR\*(rq
+in a pipeline, as this may improve performance.
+.PP
+To watch how quickly a file is transferred using \fBnc\fR(1):
+.PP
+.in +4
+.EX
+pv file | nc \-w 1 somewhere.com 3000
+.EE
+.in
+.PP
+A similar example, transferring a file from another process and passing the
+expected size to \fBpv\fR:
+.PP
+.in +4
+.EX
+cat file | pv \-\-size 12345 | nc \-w 1 somewhere.com 3000
+.EE
+.in
+.PP
+To watch the progress of creating a tar.gz archive:
+.PP
+.in +4
+.EX
+tar cf \- directory/ \e
+| pv \-\-size $(du \-sb directory/ | awk '{print $1}') \e
+| gzip \-9 \e
+> out.tar.gz
+.EE
+.in
+.PP
+Taking an image of a disk, skipping errors:
+.PP
+.in +4
+.EX
+pv \-EE /dev/your/disk/device > disk-image.img
+.EE
+.in
+.PP
+Writing an image back to a disk:
+.PP
+.in +4
+.EX
+pv disk-image.img > /dev/your/disk/device
+.EE
+.in
+.PP
+Zeroing a disk:
+.PP
+.in +4
+.EX
+pv < /dev/zero > /dev/your/disk/device
+.EE
+.in
+.PP
+Note that if the input size cannot be calculated, and the output is a block
+device, then the size of the block device will be used and \fBpv\fR will
+automatically stop at that size as if \*(lq\fB\-\-stop\-at\-size\fR\*(rq had
+been given.
+.PP
+(Linux and macOS only): Watching file descriptor 3 opened by another process 1234:
+.PP
+.in +4
+.EX
+pv \-\-watchfd 1234:3
+.EE
+.in
+.PP
+(Linux and macOS only): Watching all file descriptors used by process 1234:
+.PP
+.in +4
+.EX
+pv \-\-watchfd 1234
+.EE
+.in
+.PP
+Rate-limiting the transfer between two processes in a pipeline, with no
+display:
+.PP
+.in +4
+.EX
+producer | pv \-\-quiet \-\-rate\-limit 1M | consumer
+.EE
+.in
+.PP
+Sending logs to a processing script, showing the most recent line as part of
+the progress display:
+.PP
+.in +4
+.EX
+pv \-\-format '%a %p : %L' big.log | processing-script
+.EE
+.in
+.PP
+Showing progress as lines of JSON data:
+.PP
+.in +4
+.EX
+pv \-\-numeric \-\-format '{"elapsed":%t,"bytes":%b,"rate":%r,"percentage":%{progress-amount-only}}' big.log | processing-script
+.EE
+.in
+.\"
+.SH EXIT STATUS
+An exit status of 1 indicates a problem with the \*(lq\fB\-\-remote\fR\*(rq,
+\*(lq\fB\-\-query\fR\*(rq, or \*(lq\fB\-\-pidfile\fR\*(rq options.
+.PP
+Any other exit status is a bitmask of the following:
+.TP 5
+\~\fB2\fR
+One or more files could not be accessed, \fBstat\fR(2)ed, or opened.
+.TP
+\~\fB4\fR
+An input file was the same as the output file.
+.TP
+\~\fB8\fR
+Internal error with closing a file or moving to the next file.
+.TP
+\~\fB16\fR
+There was an error while transferring data from one or more input files.
+.TP
+\~\fB32\fR
+A signal was caught that caused an early exit.
+.TP
+\~\fB64\fR
+Memory allocation failed.
+.PP
+A zero exit status indicates no problems.
+.\"
+.SH ENVIRONMENT
+The following environment variables may affect \fBpv\fR:
+.TP
+.B HOME
+The current user's home directory.
+This may be used by \*(lq\fB\-\-remote\fR\*(rq and \*(lq\fB\-\-query\fR\*(rq
+to exchange messages between \fBpv\fR instances: if the \fI/run/user/UID/\fR
+directory does not exist (where \fIUID\fR is the current user ID), then
+\fI$HOME/.pv/\fR will be used instead.
+.TP
+.BR TMPDIR ", " TMP
+The directory to create per-tty lock files for the terminal when using
+\*(lq\fB\-\-cursor\fR\*(rq.
+If \fBTMPDIR\fR is set to a non-empty value, it is the directory under which
+lock files are created.
+Otherwise, \fBTMP\fR is used.
+If neither are set, then \fI/tmp\fR is used.
+.\"
+.SH NOTES
+In some versions of \fBbash\fR(1) and \fBzsh\fR(1), the construct
+\*(lq\fB<(pv\~filename)\fR\*(rq will not output any progress to the terminal
+when run from an interactive shell, due to the subprocess being run in a
+separate process group from the one that owns the terminal.
+In these cases, use \*(lq\fB\-\-force\fR\*(rq.
+.PP
+If \fBpv\fR is used in a pipeline in \fBzsh\fR version 5.8, and the last
+command in the pipeline is based on shell builtins, \fBzsh\fR takes control
+of the terminal away from \fBpv\fR, preventing progress from being
+displayed.
+For example, this will produce no progress bar:
+.PP
+.in +4n
+.EX
+pv InputFile | { while read \-r line; do sleep 0.1; done; }
+.EE
+.in
+.PP
+To work around this, put the last commands of the pipeline in
+normal brackets to force the use of a subshell:
+.PP
+.in +4n
+.EX
+pv InputFile | ( while read \-r line; do sleep 0.1; done; )
+.EE
+.in
+.PP
+Refer to
+.UR https://codeberg.org/ivarch/pv/issues/105
+issue #105
+.UE
+for full details.
+.PP
+The \*(lq\fB\-\-remote\fR\*(rq and \*(lq\fB\-\-query\fR\*(rq options require
+that either \fI/run/user/<uid>/\fR or \fI$HOME/\fR can be written to, for
+inter-process communication.
+.PP
+The \*(lq\fB\-\-size\fR\*(rq option has no effect if used with
+\*(lq\fB\-\-watchfd\fR\~\fIPID\fR\*(rq to watch all file descriptors of a
+process, but will work with \*(lq\fB\-\-watchfd\fR\~\fIPID\fR:\fIFD\fR\*(rq
+to watch a single file descriptor.
+.PP
+If the input size cannot be calculated, and the output is a block device,
+then \fBpv\fR will read the output device's size, use that as if it had been
+passed to \*(lq\fB\-\-size\fR\*(rq, and activate
+\*(lq\fB\-\-stop\-at\-size\fR\*(rq.
+.PP
+The \*(lq\fB%nA\fR\*(rq and \*(lq\fB%nL\fR\*(rq format sequences may not be
+effective with small input files, and \*(lq\fB%nL\fR\*(rq may be a few lines
+out due to buffering within the pipeline itself.
+.PP
+Numbers passed to \*(lq\fB\-\-size\fR\*(rq, \*(lq\fB\-\-rate\-limit\fR\*(rq,
+\*(lq\fB\-\-buffer\-size\fR\*(rq, and \*(lq\fB\-\-error\-skip\-block\fR\*(rq
+may all be expressed as decimals if followed by a suffix, so for example
+\*(lq\fI\-\-size\~1.5G\fR\*(rq is equivalent to
+\*(lq\fI\-\-size\~1536M\fR\*(rq.
+.PP
+Numbers passed to \*(lq\fB\-\-interval\fR\*(rq and
+\*(lq\fB\-\-delay\-start\fR\*(rq may be integers or decimals, but may not
+have a suffix.
+.PP
+Numbers passed to \*(lq\fB\-\-last\-written\fR\*(rq,
+\*(lq\fB\-\-width\fR\*(rq, \*(lq\fB\-\-height\fR\*(rq,
+\*(lq\fB\-\-average\-rate\-window\fR\*(rq, \*(lq\fB\-\-remote\fR\*(rq, and
+\*(lq\fB\-\-query\fR\*(rq must be integers with no suffix.
+.PP
+When \*(lq\fB\-\-sparse\fR\*(rq is in effect and output is being written to
+a file, that file may look like it has stopped growing if inspected with
+\fBls\fR(1) while null bytes are being written, even though \fBpv\fR still
+reports progress.
+This is because of the way sparse output is achieved, and the file will be
+the correct size when the transfer ends.
+.\"
+.SH REPORTING BUGS
+Please report bugs or feature requests via the issue tracker linked from the
+.UR https://ivarch.com/p/pv
+\fBpv\fR home page
+.UE .
+.\"
+.SH "SEE ALSO"
+.BR cat (1),
+.BR splice (2),
+.BR fdatasync (2),
+.BR open (2)
+(for \fBO_DIRECT\fR),
+.BR console_codes (4)
+.\"
+.SH COPYRIGHT
+Copyright \(co 2002-2008, 2010, 2012-2015, 2017, 2021, 2023-2025 Andrew Wood.
+.PP
+License GPLv3+:
+.UR https://www.gnu.org/licenses/gpl-3.0.html
+GNU GPL version 3 or later
+.UE .
+.PP
+This is free software: you are free to change and redistribute it.  There is
+NO WARRANTY, to the extent permitted by law.
+.PP
+Please see the package's ACKNOWLEDGEMENTS file for a complete list of
+contributors.

docs/pv.1.md

@@ -0,0 +1,809 @@
+# NAME
+
+pv - monitor and manage the progress of data through a pipe
+
+# SYNOPSIS
+
+**pv** \[*OPTION*\]\... \[*FILE*\]\...
+
+**pv** \[*OPTION*\]\... **-d**\|**\--watchfd**
+*PID*\[:*FD*\]\|=*NAME*\|@*LISTFILE*\...
+
+**pv** **-R**\|**\--remote** *PID* \[*OPTION*\]\...
+
+**pv** **-Q**\|**\--query** *PID* \[*OPTION*\]\...
+
+# DESCRIPTION
+
+Show the progress of data through a pipeline by giving information such
+as time elapsed, percentage completed (with progress bar), current
+throughput rate, total data transferred, and ETA. The data flow rate,
+error handling strategy, buffer size, and cache interaction can all be
+adjusted.
+
+Each *FILE* is copied to standard output. With no *FILE*, or when *FILE*
+is "-", standard input is read.
+
+In "**\--watchfd**" mode, inspect another process and show its progress
+through the files it has open.
+
+# OPTIONS
+
+## Display switches
+
+If no display switches are specified, **pv** behaves as if
+"**\--progress**", "**\--timer**", "**\--eta**", "**\--rate**", and
+"**\--bytes**" had been given. Otherwise, only those display types that
+are explicitly switched on will be shown.
+
+**-p, \--progress**
+
+:   Turn the progress bar on. If any inputs are not files, or are
+    unreadable, and no size was explicitly given with "**\--size**", the
+    progress bar cannot indicate how close to completion the transfer
+    is, so it will just move left and right to indicate that data is
+    moving - or, with "**\--gauge**", the bar will indicate the current
+    rate as a percentage of the maximum rate seen so far.
+
+**-t, \--timer**
+
+:   Turn the timer on. This will display the total elapsed time that
+    **pv** has been running for.
+
+**-e, \--eta**
+
+:   Turn the ETA countdown on. This will estimate, based on current
+    transfer rates and the total data size, how long it will be before
+    completion. The countdown is prefixed with "ETA". This option will
+    have no effect if the total data size cannot be determined.
+
+**-I, \--fineta**
+
+:   Turn the ETA countdown on, but display the estimated local time at
+    which the transfer will finish, instead of the amount of time
+    remaining. When the estimated time is more than 6 hours in the
+    future, the date is shown as well. The time is prefixed with "FIN"
+    for finish time. As with "**\--eta**", this option will have no
+    effect if the total data size cannot be determined.
+
+**-r, \--rate**
+
+:   Turn the rate counter on. This will display the current rate of data
+    transfer. The rate is shown in square brackets "\[\]".
+
+**-a, \--average-rate**
+
+:   Turn the average rate counter on. This will display the current
+    average rate of data transfer, over the last 30 seconds by default
+    (see "**\--average-rate-window**"). The average rate is shown in
+    brackets "()".
+
+**-b, \--bytes**
+
+:   Turn the total byte counter on. This will display the total amount
+    of data transferred so far.
+
+**-T, \--buffer-percent**
+
+:   Turn on the transfer buffer percentage display. This will show the
+    percentage of the transfer buffer in use. Implies
+    "**\--no-splice**". The transfer buffer percentage is shown in curly
+    brackets "{}".
+
+**-A NUM, \--last-written NUM**
+
+:   Show the last *NUM* bytes written. Implies "**\--no-splice**".
+
+**-F FORMAT, \--format FORMAT**
+
+:   Ignore all of the above options and instead use the format string
+    *FORMAT* to determine the output format. See the **FORMATTING**
+    section below.
+
+**-n, \--numeric**
+
+:   Numeric output. Instead of giving a visual indication of progress,
+    write an integer percentage, one per line, on standard error,
+    suitable for passing to a tool such as **dialog**(1). Note that
+    "**\--force**" is not required if "**\--numeric**" is being used.
+
+    Combining "**\--numeric**" with "**\--bytes**" will cause the number
+    of bytes processed so far to be output instead of a percentage.
+    Adding "**\--line-mode**" as well as "**\--bytes**" writes the
+    number of lines instead of bytes or a percentage. Adding
+    "**\--rate**" adds the transfer rate to each output line (if
+    "**\--bytes**" is also in use, the rate comes after the byte/line
+    count). Adding "**\--timer**" prefixes each output line with the
+    elapsed time so far, as a decimal number of seconds.
+
+    Combining "**\--numeric**" with "**\--format**" allows for custom
+    output. The default format string components for "**\--numeric**"
+    are "**%t %b %r %{progress-amount-only}**" in that order, each item
+    being active or inactive according to the rules above (so the
+    default with no other options is "**%{progress-amount-only}**".
+
+**-q, \--quiet**
+
+:   No output. Useful if the "**\--rate-limit**" option is being used on
+    its own to limit the transfer rate of a pipe.
+
+## Output modifiers
+
+**-8, \--bits**
+
+:   Use bits instead of bytes for the byte and rate counters. The output
+    suffix will be "b" instead of "B".
+
+**-k, \--si**
+
+:   Display and interpret suffixes as multiples of 1000 rather than the
+    default of 1024. Note that this only takes effect on options after
+    this one, so for consistency, specify this option first.
+
+**-W, \--wait**
+
+:   Wait until the first byte has been transferred before showing any
+    progress information or calculating any ETAs. Useful if the program
+    you are piping to or from requires extra information before it
+    starts, such as when piping data into **gpg**(1) or **mcrypt**(1)
+    which require a passphrase before data can be processed.
+
+**-D SEC, \--delay-start SEC**
+
+:   Wait until *SEC* seconds have passed before showing any progress
+    information, for example in a script where you only want to show a
+    progress bar if it starts taking a long time. The value of *SEC* can
+    be a decimal such as "0.5".
+
+**-s SIZE, \--size SIZE**
+
+:   Assume the total amount of data to be transferred is *SIZE* bytes
+    when calculating percentages and ETAs. A suffix of "K", "M", "G", or
+    "T" can be added to denote kibibytes (\*1024), mebibytes, gibibytes,
+    tebibytes. If "**\--si**" appears before this option, suffixes will
+    denote kilobytes (\*1000), megabytes, and so on instead.
+
+    If *SIZE* starts with "**@**", the size of file whose name follows
+    the @ will be used.
+
+**-g, \--gauge**
+
+:   If the progress bar is shown but the size is not known, then instead
+    of moving the bar left and right to show progress, show the current
+    transfer rate as a percentage of the maximum rate seen so far.
+
+**-l, \--line-mode**
+
+:   Instead of counting bytes, count lines (newline characters). The
+    progress bar will only move when a new line is found, and the value
+    passed to "**\--size**" will be interpreted as a line count.
+
+    If this option is used without "**\--size**", the \"total size\" (in
+    this case, total line count) is calculated by reading through all
+    input files once before transfer starts. If any inputs are pipes or
+    non-regular files, or are unreadable, the total size will not be
+    calculated.
+
+**-0, \--null**
+
+:   Count lines as terminated with a null byte instead of with a
+    newline. This option implies "**\--line-mode**".
+
+**-i SEC, \--interval SEC**
+
+:   Wait *SEC* seconds between updates. The default is to update every
+    second. The value of *SEC* can be a decimal such as "0.1".
+
+**-m SEC, \--average-rate-window SEC**
+
+:   Compute current average rate over a *SEC* seconds window for average
+    rate and ETA calculations. The default is 30 seconds. The value must
+    be an integer.
+
+**-w WIDTH, \--width WIDTH**
+
+:   Assume the terminal is *WIDTH* columns wide, instead of trying to
+    work it out (or assuming 80 if it cannot be guessed). If this option
+    is used, the output width will not be adjusted if the width of the
+    terminal changes while the transfer is running.
+
+**-H HEIGHT, \--height HEIGHT**
+
+:   Assume the terminal is *HEIGHT* rows high, instead of trying to work
+    it out (or assuming 25 if it cannot be guessed). If this option is
+    used, the output height will not be adjusted if the height of the
+    terminal changes while the transfer is running.
+
+**-N NAME, \--name NAME**
+
+:   Prefix the output information with *NAME*. Useful in conjunction
+    with "**\--cursor**" if you have a complicated pipeline and you want
+    to be able to tell different parts of it apart.
+
+**-u STYLE, \--bar-style STYLE**
+
+:   Change the default progress bar style shown by "**\--progress**", or
+    by the "**\--format**" sequences "**%{progress}**" or
+    "**%{progress-bar-only}**", to *STYLE*. The *STYLE* can be one of
+    **plain** (the default), **block**, **granular**, or **shaded**.
+    These styles are described in the **FORMATTING** section below.
+
+**-x SPEC, \--extra-display SPEC**
+
+:   As well as displaying progress to the terminal, also write it to
+    *SPEC*. The *SPEC* must start with a comma-separated list of
+    destinations, and can optionally be followed by a colon and a format
+    string. The destinations can be **windowtitle** or **window** for
+    the xterm window title, and **processtitle**, **proctitle**,
+    **process**, or **proc** for the process title displayed by
+    **ps**(1). If a format string is not supplied, the same format is
+    used as for the terminal. For example,
+    "**-x \'window,process:%t %b %r\'**" will show the elapsed time,
+    bytes transferred, and rate, in both the window title and the
+    process title.
+
+**-v, \--stats**
+
+:   At the end of the transfer, write an additional line showing the
+    transfer rate minimum, maximum, mean, and standard deviation. The
+    values are always in bytes per second (or bits, with "**\--bits**").
+
+**-f, \--force**
+
+:   Force output. Normally, **pv** will not output any visual display if
+    standard error is not a terminal. This option forces it to do so.
+
+**-c, \--cursor**
+
+:   Use cursor positioning escape sequences instead of just using
+    carriage returns. This is useful in conjunction with "**\--name**"
+    if you are using multiple **pv** invocations in a single pipeline.
+
+## Data transfer modifiers
+
+**-o FILE, \--output FILE**
+
+:   Write data to *FILE* instead of standard output. If the file already
+    exists, it will be truncated.
+
+**-L RATE, \--rate-limit RATE**
+
+:   Limit the transfer to a maximum of *RATE* bytes per second. The same
+    suffixes as "**\--size**" can be used.
+
+**-B BYTES, \--buffer-size BYTES**
+
+:   Use a transfer buffer size of *BYTES* bytes. The same suffixes as
+    "**\--size**" can be used. The default buffer size is the block size
+    of the input file\'s filesystem multiplied by 32 (512KiB max), or
+    400KiB if the block size cannot be determined. This can be useful on
+    platforms like macOS with pipelines that perform better with
+    specific buffer sizes such as 1024. Implies "**\--no-splice**".
+
+**-C, \--no-splice**
+
+:   Never use **splice**(2), even if it would normally be possible. The
+    **splice**(2) system call is a more efficient way of transferring
+    data from or to a pipe than regular **read**(2) and **write**(2),
+    but means that the transfer buffer may not be used. This prevents
+    "**\--buffer-percent**" and "**\--last-written**" from working,
+    cannot work with "**\--sparse**" or "**\--discard**", and makes
+    "**\--buffer-size**" redundant, so using any of those options
+    automatically switches on "**\--no-splice**". Switching on this
+    option results in a small loss of transfer efficiency. It has no
+    effect on systems where **splice**(2) is unavailable.
+
+**-E, \--skip-errors**
+
+:   Ignore read errors by attempting to skip past the offending
+    sections. The corresponding parts of the output will be null bytes.
+    At first only a few bytes will be skipped, but if there are many
+    errors in a row then the skips will move up to chunks of 512. This
+    is intended to be similar to "*dd conv=sync,noerror*".
+
+    Specify "**\--skip-errors**" twice to only report a read error once
+    per file, instead of reporting each byte range skipped.
+
+**-Z BYTES, \--error-skip-block BYTES**
+
+:   When ignoring read errors with "**\--skip-errors**", instead of
+    trying to adaptively skip by reading small amounts and skipping
+    progressively larger sections until a read succeeds, move to the
+    next file block of *BYTES* bytes as soon as an error occurs. There
+    may still be some shorter skips where the block being skipped
+    coincides with the end of the transfer buffer. The same suffixes as
+    "**\--size**" can be used.
+
+    This option can only be used with "**\--skip-errors**" and is
+    intended for use when reading from a block device, such as
+    "**\--skip-errors \--error-skip-block 4K**" to skip in 4 kibibyte
+    blocks. This will speed up reads from faulty media, at the expense
+    of potentially losing more data.
+
+**-S, \--stop-at-size**
+
+:   If a size was specified with "**\--size**", stop transferring data
+    once that many bytes have been written, instead of continuing to the
+    end of input.
+
+**-Y, \--sync**
+
+:   After every write operation, synchronise the buffer caches to disk
+    with **fdatasync**(2). This has no effect when the output is a pipe.
+    Using "**\--sync**" may improve the accuracy of the progress bar
+    when writing to a slow disk.
+
+**-K, \--direct-io**
+
+:   Set the **O_DIRECT** flag on all inputs and outputs, if it is
+    available. This will minimise the effect of caches, at the cost of
+    performance. Due to memory alignment requirements, it also may cause
+    read or write failures with an error of "Invalid argument",
+    especially if reading and writing files across a variety of
+    filesystems in a single **pv** call. Use this option with caution.
+
+**-O, \--sparse**
+
+:   When writing null bytes, try to seek, producing a sparse output
+    file. Implies "**\--no-splice**". On filesystems without sparse file
+    support, or when the output is not seekable, this option will have
+    no effect other than to turn on "**\--no-splice**".
+
+**-X, \--discard**
+
+:   Instead of transferring input data to standard output, discard it.
+    This is equivalent to redirecting standard output to */dev/null*,
+    except that **write**(2) is never called. Implies
+    "**\--no-splice**".
+
+**-U FILE, \--store-and-forward FILE**
+
+:   Instead of passing data through immediately, do it in two stages -
+    first read all input and write it to *FILE*, and then once the input
+    is exhausted, read all of *FILE* and write it to the output. *FILE*
+    remains in place afterwards, unless it is "**-**", in which case
+    **pv** creates a temporary file for this purpose, and automatically
+    removes it afterwards.
+
+    This can be useful if you have a pipeline which generates data (your
+    input) quickly but you don\'t know the size, and you wish to pass it
+    to some slower process, once all of the input has been generated and
+    you know its size, so you can see its progress. Note that when doing
+    this with relatively small amounts of data, "**\--no-splice**" may
+    be preferable so that pipe buffering doesn\'t affect the progress
+    display.
+
+## Alternative operating modes
+
+**-d**, **\--watchfd** *PID*\[:*FD*\]\|=*NAME*\|@*LISTFILE*\...
+
+:   Instead of transferring data, watch file descriptor *FD* of process
+    *PID*, and show its progress. Other data transfer modifiers - and
+    remote control - may not be used with this option.
+
+    If a *PID* is specified without an *FD*, then that process will be
+    watched, and all regular files and block devices it opens will be
+    shown with a progress bar.
+
+    If a *NAME* is specified, prefixed with \"=\", then processes with
+    that name will be found with **pgrep**(1), and as watched described
+    above.
+
+    If a *LISTFILE* is specified, prefixed with \"@\", the lines in that
+    file will be used as additional arguments.
+
+    All remaining non-option arguments will also be treated as
+    additional arguments.
+
+    The **pv** process will exit when all *FD*s have either changed to a
+    different file, changed read/write mode, or have closed, and all
+    *PID*s (without a specific *FD*) have exited.
+
+**-R PID, \--remote PID**
+
+:   Remotely control another instance of **pv** with process ID *PID*,
+    making it act as though it had been given this instance\'s command
+    line. For example, if "**pv \--rate-limit 123K**" is running with
+    process ID 9876, then running
+    "**pv \--remote 9876 \--rate-limit 321K**" will cause process 9876
+    to start using a rate limit of 321KiB instead of 123KiB. Note that
+    some options cannot be changed while running, such as
+    "**\--cursor**", "**\--line-mode**", "**\--force**",
+    "**\--delay-start**", "**\--skip-errors**", and
+    "**\--stop-at-size**".
+
+**-Q PID, \--query PID**
+
+:   Display the transfer progress of another instance of **pv** with
+    process ID *PID*, owned by the same user.
+
+    Some output modifiers can only be used while querying another
+    process if they match those of that process - such as
+    "**\--line-mode**", "**\--null**", and "**\--average-rate-window**".
+    Data transfer modifiers will have no effect.
+
+## Other options
+
+**-P FILE, \--pidfile FILE**
+
+:   Save the process ID of **pv** in *FILE*. The file will be replaced
+    if it already exists, and will be removed when **pv** exits. While
+    **pv** is running, *FILE* will contain a single number - the process
+    ID of **pv** - followed by a newline.
+
+**-h, \--help**
+
+:   Print a usage message on standard output and exit successfully.
+
+**-V, \--version**
+
+:   Print version information on standard output and exit successfully.
+
+# FORMATTING
+
+Format strings used by "**\--format**" and "**\--extra-display**" can
+contain the following sequences:
+
+**%p**, **%{progress}**
+
+:   Progress bar (suffixed with a percentage if the size is known).
+    Equivalent to "**\--progress**". Expands to fill the remaining space
+    unless prefixed by a number to set the width, such as "**%20p**" or
+    "**%20{progress}**".
+
+**%{progress-bar-only}**
+
+:   Progress bar, without any sides, and without any percentage
+    displayed afterwards. Expands to fill the remaining space unless
+    prefixed by a number.
+
+**%{progress-amount-only}**
+
+:   The percentage completion (or maximum rate, with "**\--gauge**" when
+    the size is unknown).
+
+**%{bar-plain}**
+
+:   Progress bar in the standard plain format, without any sides, and
+    without any percentage displayed afterwards. Expands to fill the
+    remaining space unless prefixed by a number.
+
+**%{bar-block}**
+
+:   Progress bar using Unicode full blocks, without any sides, and
+    without any percentage displayed afterwards. Expands to fill the
+    remaining space unless prefixed by a number. If UTF-8 output is not
+    available, the plain format is used.
+
+**%{bar-granular}**
+
+:   Progress bar using Unicode full blocks, and 1/8th blocks for partial
+    fills, providing a more granular display. Like the other "%{bar}"
+    strings this shows the bar without any sides, and without any
+    percentage displayed afterwards, and expands to fill the remaining
+    space unless prefixed by a number. If UTF-8 output is not available,
+    the plain format is used.
+
+**%{bar-shaded}**
+
+:   Progress bar using Unicode full blocks and shade characters - dark
+    and medium shade are used for partial fills, and the light shade is
+    used for the background. Like the other "%{bar}" strings this shows
+    the bar without any sides, and without any percentage displayed
+    afterwards, and expands to fill the remaining space unless prefixed
+    by a number. If UTF-8 output is not available, the plain format is
+    used.
+
+**%t**, **%{timer}**
+
+:   Elapsed time. Equivalent to "**\--timer**".
+
+**%e**, **%{eta}**
+
+:   ETA as time remaining. Equivalent to "**\--eta**".
+
+**%I**, **%{fineta}**
+
+:   ETA as local time at which the transfer will finish. Equivalent to
+    "**\--fineta**".
+
+**%r**, **%{rate}**
+
+:   Current data transfer rate. Equivalent to "**\--rate**".
+
+**%a**, **%{average-rate}**
+
+:   Average data transfer rate. Equivalent to "**\--average-rate**".
+
+**%b**, **%{bytes}**, **%{transferred}**
+
+:   Bytes transferred so far (or lines if "**\--line-mode**" was
+    specified). Equivalent to "**\--bytes**". If "**\--bits**" was
+    specified, "**%b**" shows the bits transferred so far, not bytes.
+
+**%T**, **%{buffer-percent}**
+
+:   Percentage of the transfer buffer in use. Equivalent to
+    "**\--buffer-percent**". Displays "{\-\-\--}" if the transfer is
+    being done with **splice**(2), since splicing to or from pipes does
+    not use the buffer.
+
+**%nA**, **%n{last-written}**
+
+:   Show the last *n* bytes written (for example, "**%16A**" shows the
+    last 16 bytes). Shows only dots if the transfer is being done with
+    **splice**(2), since splicing to or from pipes does not use the
+    buffer.
+
+**%nL**, **%n{previous-line}**
+
+:   Show the first *n* bytes of the most recently written line (for
+    example, "**%40L**" shows the first 40 bytes). If no *n* is given,
+    then this expands to fill the available space. Shows only spaces if
+    the transfer is being done with **splice**(2).
+
+**%N**, **%{name}**
+
+:   Show the name prefix given by "**\--name**". Padded to 9 characters
+    with spaces, and suffixed with ":".
+
+**%{sgr:colour,\...}**
+
+:   Emit ECMA-48 SGR (Select Graphic Rendition) codes if the terminal
+    supports colours, where *colour,\...* is a comma-separated list of
+    any of the keywords below, or the numeric values from
+    **console_codes**(4). If colour support is not available, nothing is
+    emitted.
+
+    Supported keywords are: **reset** or **none**, **black**, **red**,
+    **green**, **brown** or **yellow**, **blue**, **magenta**, **cyan**,
+    **white**, **fg-black**, **fg-red**, **fg-green**, **fg-brown** or
+    **fg-yellow**, **fg-blue**, **fg-magenta**, **fg-cyan**,
+    **fg-white**, **fg-default**, **bg-black**, **bg-red**,
+    **bg-green**, **bg-brown** or **bg-yellow**, **bg-blue**,
+    **bg-magenta**, **bg-cyan**, **bg-white**, **bg-default**, **bold**,
+    **dim**, **italic**, **underscore** or **underline**, **blink**,
+    **reverse**, **no-bold** or **no-dim**, **no-italic**,
+    **no-underscore** or **no-underline**, **no-blink**, **no-reverse**.
+
+    With colours, the optional \"fg-\" prefix indicates foreground; a
+    prefix of \"bg-\" indicates background.
+
+    For example, "**%{sgr:green,bold}TEXT%{sgr:reset}**" will make
+    *TEXT* bold green on supported terminals.
+
+**%%**
+
+:   A single "%".
+
+Any other contents are reproduced in the progress display as-is.
+
+The format string equivalent of the default display switches is
+"**%b %t %r %p %e**".
+
+# EXAMPLES
+
+Some suggested common switch combinations:
+
+**pv -ptebar**
+
+:   Show a progress bar, elapsed time, estimated completion time, byte
+    counter, average rate, and current rate.
+
+**pv -betlap**
+
+:   Show a progress bar, elapsed time, estimated completion time, line
+    counter, and average rate, counting lines instead of bytes.
+
+**pv -btrpg**
+
+:   Show the amount transferred, elapsed time, current rate, and a gauge
+    showing the current rate as a percentage of the maximum rate seen -
+    useful in a pipeline where the total size is unknown. (If the size
+    *is* known, these options will show the percentage completion
+    instead of the rate gauge).
+
+**pv -t**
+
+:   Show only the elapsed time - useful as a simple timer, such as
+    "**sleep 10m \| pv -t**".
+
+**pv -pterb**
+
+:   The default behaviour: progress bar, elapsed time, estimated
+    completion time, current rate, and byte counter.
+
+On macOS, it may be useful to specify "**\--buffer-size 1024**" in a
+pipeline, as this may improve performance.
+
+To watch how quickly a file is transferred using **nc**(1):
+
+    pv file | nc -w 1 somewhere.com 3000
+
+A similar example, transferring a file from another process and passing
+the expected size to **pv**:
+
+    cat file | pv --size 12345 | nc -w 1 somewhere.com 3000
+
+To watch the progress of creating a tar.gz archive:
+
+    tar cf - directory/ \
+    | pv --size $(du -sb directory/ | awk '{print $1}') \
+    | gzip -9 \
+    > out.tar.gz
+
+Taking an image of a disk, skipping errors:
+
+    pv -EE /dev/your/disk/device > disk-image.img
+
+Writing an image back to a disk:
+
+    pv disk-image.img > /dev/your/disk/device
+
+Zeroing a disk:
+
+    pv < /dev/zero > /dev/your/disk/device
+
+Note that if the input size cannot be calculated, and the output is a
+block device, then the size of the block device will be used and **pv**
+will automatically stop at that size as if "**\--stop-at-size**" had
+been given.
+
+(Linux and macOS only): Watching file descriptor 3 opened by another
+process 1234:
+
+    pv --watchfd 1234:3
+
+(Linux and macOS only): Watching all file descriptors used by process
+1234:
+
+    pv --watchfd 1234
+
+Rate-limiting the transfer between two processes in a pipeline, with no
+display:
+
+    producer | pv --quiet --rate-limit 1M | consumer
+
+Sending logs to a processing script, showing the most recent line as
+part of the progress display:
+
+    pv --format '%a %p : %L' big.log | processing-script
+
+Showing progress as lines of JSON data:
+
+    pv --numeric --format '{"elapsed":%t,"bytes":%b,"rate":%r,"percentage":%{progress-amount-only}}' big.log | processing-script
+
+# EXIT STATUS
+
+An exit status of 1 indicates a problem with the "**\--remote**",
+"**\--query**", or "**\--pidfile**" options.
+
+Any other exit status is a bitmask of the following:
+
+ **2**
+
+:   One or more files could not be accessed, **stat**(2)ed, or opened.
+
+ **4**
+
+:   An input file was the same as the output file.
+
+ **8**
+
+:   Internal error with closing a file or moving to the next file.
+
+ **16**
+
+:   There was an error while transferring data from one or more input
+    files.
+
+ **32**
+
+:   A signal was caught that caused an early exit.
+
+ **64**
+
+:   Memory allocation failed.
+
+A zero exit status indicates no problems.
+
+# ENVIRONMENT
+
+The following environment variables may affect **pv**:
+
+**HOME**
+
+:   The current user\'s home directory. This may be used by
+    "**\--remote**" and "**\--query**" to exchange messages between
+    **pv** instances: if the */run/user/UID/* directory does not exist
+    (where *UID* is the current user ID), then *\$HOME/.pv/* will be
+    used instead.
+
+**TMPDIR**, **TMP**
+
+:   The directory to create per-tty lock files for the terminal when
+    using "**\--cursor**". If **TMPDIR** is set to a non-empty value, it
+    is the directory under which lock files are created. Otherwise,
+    **TMP** is used. If neither are set, then */tmp* is used.
+
+# NOTES
+
+In some versions of **bash**(1) and **zsh**(1), the construct
+"**\<(pv filename)**" will not output any progress to the terminal when
+run from an interactive shell, due to the subprocess being run in a
+separate process group from the one that owns the terminal. In these
+cases, use "**\--force**".
+
+If **pv** is used in a pipeline in **zsh** version 5.8, and the last
+command in the pipeline is based on shell builtins, **zsh** takes
+control of the terminal away from **pv**, preventing progress from being
+displayed. For example, this will produce no progress bar:
+
+    pv InputFile | { while read -r line; do sleep 0.1; done; }
+
+To work around this, put the last commands of the pipeline in normal
+brackets to force the use of a subshell:
+
+    pv InputFile | ( while read -r line; do sleep 0.1; done; )
+
+Refer to [issue #105](https://codeberg.org/ivarch/pv/issues/105) for
+full details.
+
+The "**\--remote**" and "**\--query**" options require that either
+*/run/user/\<uid\>/* or *\$HOME/* can be written to, for inter-process
+communication.
+
+The "**\--size**" option has no effect if used with
+"**\--watchfd** *PID*" to watch all file descriptors of a process, but
+will work with "**\--watchfd** *PID*:*FD*" to watch a single file
+descriptor.
+
+If the input size cannot be calculated, and the output is a block
+device, then **pv** will read the output device\'s size, use that as if
+it had been passed to "**\--size**", and activate "**\--stop-at-size**".
+
+The "**%nA**" and "**%nL**" format sequences may not be effective with
+small input files, and "**%nL**" may be a few lines out due to buffering
+within the pipeline itself.
+
+Numbers passed to "**\--size**", "**\--rate-limit**",
+"**\--buffer-size**", and "**\--error-skip-block**" may all be expressed
+as decimals if followed by a suffix, so for example "*\--size 1.5G*" is
+equivalent to "*\--size 1536M*".
+
+Numbers passed to "**\--interval**" and "**\--delay-start**" may be
+integers or decimals, but may not have a suffix.
+
+Numbers passed to "**\--last-written**", "**\--width**",
+"**\--height**", "**\--average-rate-window**", "**\--remote**", and
+"**\--query**" must be integers with no suffix.
+
+When "**\--sparse**" is in effect and output is being written to a file,
+that file may look like it has stopped growing if inspected with
+**ls**(1) while null bytes are being written, even though **pv** still
+reports progress. This is because of the way sparse output is achieved,
+and the file will be the correct size when the transfer ends.
+
+# REPORTING BUGS
+
+Please report bugs or feature requests via the issue tracker linked from
+the [**pv** home page](https://ivarch.com/p/pv).
+
+# SEE ALSO
+
+**cat**(1), **splice**(2), **fdatasync**(2), **open**(2) (for
+**O_DIRECT**), **console_codes**(4)
+
+# COPYRIGHT
+
+Copyright © 2002-2008, 2010, 2012-2015, 2017, 2021, 2023-2025 Andrew
+Wood.
+
+License GPLv3+: [GNU GPL version 3 or
+later](https://www.gnu.org/licenses/gpl-3.0.html).
+
+This is free software: you are free to change and redistribute it. There
+is NO WARRANTY, to the extent permitted by law.
+
+Please see the package\'s ACKNOWLEDGEMENTS file for a complete list of
+contributors.

docs/release.cf

@@ -0,0 +1,51 @@
+# Configuration for the foss-release.sh script.
+# The script is here: https://codeberg.org/ivarch/scripts
+
+set maintainer andrew.wood@ivarch.com
+set mainprogram auto
+set version auto
+set mandir docs
+set newsdir docs
+
+export SKIP_VALGRIND_TESTS=1
+
+section Initial checks
+action check_po
+action check_version_news
+action check_version_autoconf
+action check_version_man
+
+section Initial build
+action configure
+action make
+action check_analyse
+action check_version_program
+action check_version_year
+
+section Documentation and source reformatting
+action man_md
+action man_html
+action news_html
+action make_indent
+
+section Update po files
+action make_update_po
+
+section Run autoreconf
+action autoreconf
+
+section Commit check
+action check_git_status
+
+section Release archive
+action check_make_distcheck
+action make_dist
+
+section Lab tests
+action labtest
+
+section Sign release
+action sign_tarball
+
+section Build OS packages
+action parmo_build

generate.sh

@@ -1,44 +0,0 @@
-#!/bin/sh
-#
-# Script to autogenerate the `configure' script, and the config header
-# template if `autoconf' is available, and then rebuild the dependency list.
-
-set -e
-
-cd $(dirname $0)
-
-test -t 1 && echo "${0##*/}: running autoconf"
-autoconf autoconf/configure.in > configure
-chmod 755 configure
-
-if command -v autoheader >/dev/null; then
-	test -t 1 && echo "${0##*/}: running autoheader"
-	autoheader autoconf/configure.in
-else
-	test -t 1 && echo "${0##*/}: autoheader not found, skipping"
-fi
-
-echo > autoconf/make/depend.mk~
-echo > autoconf/make/filelist.mk~
-echo > autoconf/make/modules.mk~
-
-MAKE=make
-command -v gmake >/dev/null 2>&1 && MAKE=gmake
-
-rm -rf .gen
-mkdir .gen
-cd .gen
-
-test -t 1 && echo "${0##*/}: running new \`configure' script"
-sh ../configure
-
-test -t 1 && echo "${0##*/}: regenerating Makefile fragments"
-$MAKE make
-$MAKE dep
-
-test -t 1 && echo "${0##*/}: cleaning up"
-cd ..
-rm -rf .gen
-rm -rf autom4te.cache autoconf/autom4te.cache
-
-# EOF

po/.gitignore

@@ -0,0 +1,9 @@
+Makevars.template
+*.sed
+*.gmo
+*.header
+*.sin
+*.pot
+Rules-quot
+stamp-po
+*~

po/LINGUAS

@@ -0,0 +1,9 @@
+cs
+de
+es
+fi
+fr
+pl
+pt
+ru
+tr

po/Makefile.in.in

@@ -0,0 +1,510 @@
+# Makefile for PO directory in any package using GNU gettext.
+# Copyright (C) 1995-2000 Ulrich Drepper <drepper@gnu.ai.mit.edu>
+# Copyright (C) 2000-2020 Free Software Foundation, Inc.
+#
+# Copying and distribution of this file, with or without modification,
+# are permitted in any medium without royalty provided the copyright
+# notice and this notice are preserved.  This file is offered as-is,
+# without any warranty.
+#
+# Origin: gettext-0.21
+GETTEXT_MACRO_VERSION = 0.20
+
+PACKAGE = @PACKAGE@
+VERSION = @VERSION@
+PACKAGE_BUGREPORT = @PACKAGE_BUGREPORT@
+
+SED = @SED@
+SHELL = /bin/sh
+@SET_MAKE@
+
+srcdir = @srcdir@
+top_srcdir = @top_srcdir@
+VPATH = @srcdir@
+
+prefix = @prefix@
+exec_prefix = @exec_prefix@
+datarootdir = @datarootdir@
+datadir = @datadir@
+localedir = @localedir@
+gettextsrcdir = $(datadir)/gettext/po
+
+INSTALL = @INSTALL@
+INSTALL_DATA = @INSTALL_DATA@
+
+# We use $(mkdir_p).
+# In automake <= 1.9.x, $(mkdir_p) is defined either as "mkdir -p --" or as
+# "$(mkinstalldirs)" or as "$(install_sh) -d". For these automake versions,
+# @install_sh@ does not start with $(SHELL), so we add it.
+# In automake >= 1.10, @mkdir_p@ is derived from ${MKDIR_P}, which is defined
+# either as "/path/to/mkdir -p" or ".../install-sh -c -d". For these automake
+# versions, $(mkinstalldirs) and $(install_sh) are unused.
+mkinstalldirs = $(SHELL) @install_sh@ -d
+install_sh = $(SHELL) @install_sh@
+MKDIR_P = @MKDIR_P@
+mkdir_p = @mkdir_p@
+
+# When building gettext-tools, we prefer to use the built programs
+# rather than installed programs.  However, we can't do that when we
+# are cross compiling.
+CROSS_COMPILING = @CROSS_COMPILING@
+
+GMSGFMT_ = @GMSGFMT@
+GMSGFMT_no = @GMSGFMT@
+GMSGFMT_yes = @GMSGFMT_015@
+GMSGFMT = $(GMSGFMT_$(USE_MSGCTXT))
+XGETTEXT_ = @XGETTEXT@
+XGETTEXT_no = @XGETTEXT@
+XGETTEXT_yes = @XGETTEXT_015@
+XGETTEXT = $(XGETTEXT_$(USE_MSGCTXT))
+MSGMERGE = @MSGMERGE@
+MSGMERGE_UPDATE = @MSGMERGE@ --update
+MSGMERGE_FOR_MSGFMT_OPTION = @MSGMERGE_FOR_MSGFMT_OPTION@
+MSGINIT = msginit
+MSGCONV = msgconv
+MSGFILTER = msgfilter
+
+POFILES = @POFILES@
+GMOFILES = @GMOFILES@
+UPDATEPOFILES = @UPDATEPOFILES@
+DUMMYPOFILES = @DUMMYPOFILES@
+DISTFILES.common = Makefile.in.in remove-potcdate.sin \
+$(DISTFILES.common.extra1) $(DISTFILES.common.extra2) $(DISTFILES.common.extra3)
+DISTFILES = $(DISTFILES.common) Makevars POTFILES.in \
+$(POFILES) $(GMOFILES) \
+$(DISTFILES.extra1) $(DISTFILES.extra2) $(DISTFILES.extra3)
+
+POTFILES = \
+
+CATALOGS = @CATALOGS@
+
+POFILESDEPS_ = $(srcdir)/$(DOMAIN).pot
+POFILESDEPS_yes = $(POFILESDEPS_)
+POFILESDEPS_no =
+POFILESDEPS = $(POFILESDEPS_$(PO_DEPENDS_ON_POT))
+
+DISTFILESDEPS_ = update-po
+DISTFILESDEPS_yes = $(DISTFILESDEPS_)
+DISTFILESDEPS_no =
+DISTFILESDEPS = $(DISTFILESDEPS_$(DIST_DEPENDS_ON_UPDATE_PO))
+
+# Makevars gets inserted here. (Don't remove this line!)
+
+all: all-@USE_NLS@
+
+
+.SUFFIXES:
+.SUFFIXES: .po .gmo .sed .sin .nop .po-create .po-update
+
+# The .pot file, stamp-po, .po files, and .gmo files appear in release tarballs.
+# The GNU Coding Standards say in
+# <https://www.gnu.org/prep/standards/html_node/Makefile-Basics.html>:
+#   "GNU distributions usually contain some files which are not source files
+#    ... . Since these files normally appear in the source directory, they
+#    should always appear in the source directory, not in the build directory.
+#    So Makefile rules to update them should put the updated files in the
+#    source directory."
+# Therefore we put these files in the source directory, not the build directory.
+
+# During .po -> .gmo conversion, take into account the most recent changes to
+# the .pot file. This eliminates the need to update the .po files when the
+# .pot file has changed, which would be troublesome if the .po files are put
+# under version control.
+$(GMOFILES): $(srcdir)/$(DOMAIN).pot
+.po.gmo:
+	@lang=`echo $* | sed -e 's,.*/,,'`; \
+	test "$(srcdir)" = . && cdcmd="" || cdcmd="cd $(srcdir) && "; \
+	echo "$${cdcmd}rm -f $${lang}.gmo && $(MSGMERGE) $(MSGMERGE_FOR_MSGFMT_OPTION) -o $${lang}.1po $${lang}.po $(DOMAIN).pot && $(GMSGFMT) -c --statistics --verbose -o $${lang}.gmo $${lang}.1po && rm -f $${lang}.1po"; \
+	cd $(srcdir) && \
+	rm -f $${lang}.gmo && \
+	$(MSGMERGE) $(MSGMERGE_FOR_MSGFMT_OPTION) -o $${lang}.1po $${lang}.po $(DOMAIN).pot && \
+	$(GMSGFMT) -c --statistics --verbose -o t-$${lang}.gmo $${lang}.1po && \
+	mv t-$${lang}.gmo $${lang}.gmo && \
+	rm -f $${lang}.1po
+
+.sin.sed:
+	sed -e '/^#/d' $< > t-$@
+	mv t-$@ $@
+
+
+all-yes: $(srcdir)/stamp-po
+all-no:
+
+# Ensure that the gettext macros and this Makefile.in.in are in sync.
+CHECK_MACRO_VERSION = \
+	test "$(GETTEXT_MACRO_VERSION)" = "@GETTEXT_MACRO_VERSION@" \
+	  || { echo "*** error: gettext infrastructure mismatch: using a Makefile.in.in from gettext version $(GETTEXT_MACRO_VERSION) but the autoconf macros are from gettext version @GETTEXT_MACRO_VERSION@" 1>&2; \
+	       exit 1; \
+	     }
+
+# $(srcdir)/$(DOMAIN).pot is only created when needed. When xgettext finds no
+# internationalized messages, no $(srcdir)/$(DOMAIN).pot is created (because
+# we don't want to bother translators with empty POT files). We assume that
+# LINGUAS is empty in this case, i.e. $(POFILES) and $(GMOFILES) are empty.
+# In this case, $(srcdir)/stamp-po is a nop (i.e. a phony target).
+
+# $(srcdir)/stamp-po is a timestamp denoting the last time at which the CATALOGS
+# have been loosely updated. Its purpose is that when a developer or translator
+# checks out the package from a version control system, and the $(DOMAIN).pot
+# file is not under version control, "make" will update the $(DOMAIN).pot and
+# the $(CATALOGS), but subsequent invocations of "make" will do nothing. This
+# timestamp would not be necessary if updating the $(CATALOGS) would always
+# touch them; however, the rule for $(POFILES) has been designed to not touch
+# files that don't need to be changed.
+$(srcdir)/stamp-po: $(srcdir)/$(DOMAIN).pot
+	@$(CHECK_MACRO_VERSION)
+	test ! -f $(srcdir)/$(DOMAIN).pot || \
+	  test -z "$(GMOFILES)" || $(MAKE) $(GMOFILES)
+	@test ! -f $(srcdir)/$(DOMAIN).pot || { \
+	  echo "touch $(srcdir)/stamp-po" && \
+	  echo timestamp > $(srcdir)/stamp-poT && \
+	  mv $(srcdir)/stamp-poT $(srcdir)/stamp-po; \
+	}
+
+# Note: Target 'all' must not depend on target '$(DOMAIN).pot-update',
+# otherwise packages like GCC can not be built if only parts of the source
+# have been downloaded.
+
+# This target rebuilds $(DOMAIN).pot; it is an expensive operation.
+# Note that $(DOMAIN).pot is not touched if it doesn't need to be changed.
+# The determination of whether the package xyz is a GNU one is based on the
+# heuristic whether some file in the top level directory mentions "GNU xyz".
+# If GNU 'find' is available, we avoid grepping through monster files.
+$(DOMAIN).pot-update: $(POTFILES) $(srcdir)/POTFILES.in remove-potcdate.sed
+	package_gnu="$(PACKAGE_GNU)"; \
+	test -n "$$package_gnu" || { \
+	  if { if (LC_ALL=C find --version) 2>/dev/null | grep GNU >/dev/null; then \
+	         LC_ALL=C find -L $(top_srcdir) -maxdepth 1 -type f -size -10000000c -exec grep -i 'GNU @PACKAGE@' /dev/null '{}' ';' 2>/dev/null; \
+	       else \
+	         LC_ALL=C grep -i 'GNU @PACKAGE@' $(top_srcdir)/* 2>/dev/null; \
+	       fi; \
+	     } | grep -v 'libtool:' >/dev/null; then \
+	     package_gnu=yes; \
+	   else \
+	     package_gnu=no; \
+	   fi; \
+	}; \
+	if test "$$package_gnu" = "yes"; then \
+	  package_prefix='GNU '; \
+	else \
+	  package_prefix=''; \
+	fi; \
+	if test -n '$(MSGID_BUGS_ADDRESS)' || test '$(PACKAGE_BUGREPORT)' = '@'PACKAGE_BUGREPORT'@'; then \
+	  msgid_bugs_address='$(MSGID_BUGS_ADDRESS)'; \
+	else \
+	  msgid_bugs_address='$(PACKAGE_BUGREPORT)'; \
+	fi; \
+	case `$(XGETTEXT) --version | sed 1q | sed -e 's,^[^0-9]*,,'` in \
+	  '' | 0.[0-9] | 0.[0-9].* | 0.1[0-5] | 0.1[0-5].* | 0.16 | 0.16.[0-1]*) \
+	    $(XGETTEXT) --default-domain=$(DOMAIN) --directory=$(top_srcdir) \
+	      --add-comments=TRANSLATORS: \
+	      --files-from=$(srcdir)/POTFILES.in \
+	      --copyright-holder='$(COPYRIGHT_HOLDER)' \
+	      --msgid-bugs-address="$$msgid_bugs_address" \
+	      $(XGETTEXT_OPTIONS) @XGETTEXT_EXTRA_OPTIONS@ \
+	    ;; \
+	  *) \
+	    $(XGETTEXT) --default-domain=$(DOMAIN) --directory=$(top_srcdir) \
+	      --add-comments=TRANSLATORS: \
+	      --files-from=$(srcdir)/POTFILES.in \
+	      --copyright-holder='$(COPYRIGHT_HOLDER)' \
+	      --package-name="$${package_prefix}@PACKAGE@" \
+	      --package-version='@VERSION@' \
+	      --msgid-bugs-address="$$msgid_bugs_address" \
+	      $(XGETTEXT_OPTIONS) @XGETTEXT_EXTRA_OPTIONS@ \
+	    ;; \
+	esac
+	test ! -f $(DOMAIN).po || { \
+	  if test -f $(srcdir)/$(DOMAIN).pot-header; then \
+	    sed -e '1,/^#$$/d' < $(DOMAIN).po > $(DOMAIN).1po && \
+	    cat $(srcdir)/$(DOMAIN).pot-header $(DOMAIN).1po > $(DOMAIN).po && \
+	    rm -f $(DOMAIN).1po \
+	    || exit 1; \
+	  fi; \
+	  if test -f $(srcdir)/$(DOMAIN).pot; then \
+	    sed -f remove-potcdate.sed < $(srcdir)/$(DOMAIN).pot > $(DOMAIN).1po && \
+	    sed -f remove-potcdate.sed < $(DOMAIN).po > $(DOMAIN).2po && \
+	    if cmp $(DOMAIN).1po $(DOMAIN).2po >/dev/null 2>&1; then \
+	      rm -f $(DOMAIN).1po $(DOMAIN).2po $(DOMAIN).po; \
+	    else \
+	      rm -f $(DOMAIN).1po $(DOMAIN).2po $(srcdir)/$(DOMAIN).pot && \
+	      mv $(DOMAIN).po $(srcdir)/$(DOMAIN).pot; \
+	    fi; \
+	  else \
+	    mv $(DOMAIN).po $(srcdir)/$(DOMAIN).pot; \
+	  fi; \
+	}
+
+# This rule has no dependencies: we don't need to update $(DOMAIN).pot at
+# every "make" invocation, only create it when it is missing.
+# Only "make $(DOMAIN).pot-update" or "make dist" will force an update.
+$(srcdir)/$(DOMAIN).pot:
+	$(MAKE) $(DOMAIN).pot-update
+
+# This target rebuilds a PO file if $(DOMAIN).pot has changed.
+# Note that a PO file is not touched if it doesn't need to be changed.
+$(POFILES): $(POFILESDEPS)
+	@test -f $(srcdir)/$(DOMAIN).pot || $(MAKE) $(srcdir)/$(DOMAIN).pot
+	@lang=`echo $@ | sed -e 's,.*/,,' -e 's/\.po$$//'`; \
+	if test -f "$(srcdir)/$${lang}.po"; then \
+	  test "$(srcdir)" = . && cdcmd="" || cdcmd="cd $(srcdir) && "; \
+	  echo "$${cdcmd}$(MSGMERGE_UPDATE) $(MSGMERGE_OPTIONS) --lang=$${lang} --previous $${lang}.po $(DOMAIN).pot"; \
+	  cd $(srcdir) \
+	    && { case `$(MSGMERGE_UPDATE) --version | sed 1q | sed -e 's,^[^0-9]*,,'` in \
+	           '' | 0.[0-9] | 0.[0-9].* | 0.1[0-5] | 0.1[0-5].*) \
+	             $(MSGMERGE_UPDATE) $(MSGMERGE_OPTIONS) $${lang}.po $(DOMAIN).pot;; \
+	           0.1[6-7] | 0.1[6-7].*) \
+	             $(MSGMERGE_UPDATE) $(MSGMERGE_OPTIONS) --previous $${lang}.po $(DOMAIN).pot;; \
+	           *) \
+	             $(MSGMERGE_UPDATE) $(MSGMERGE_OPTIONS) --lang=$${lang} --previous $${lang}.po $(DOMAIN).pot;; \
+	         esac; \
+	       }; \
+	else \
+	  $(MAKE) $${lang}.po-create; \
+	fi
+
+
+install: install-exec install-data
+install-exec:
+install-data: install-data-@USE_NLS@
+	if test "$(PACKAGE)" = "gettext-tools"; then \
+	  $(mkdir_p) $(DESTDIR)$(gettextsrcdir); \
+	  for file in $(DISTFILES.common) Makevars.template; do \
+	    $(INSTALL_DATA) $(srcdir)/$$file \
+			    $(DESTDIR)$(gettextsrcdir)/$$file; \
+	  done; \
+	  for file in Makevars; do \
+	    rm -f $(DESTDIR)$(gettextsrcdir)/$$file; \
+	  done; \
+	else \
+	  : ; \
+	fi
+install-data-no: all
+install-data-yes: all
+	@catalogs='$(CATALOGS)'; \
+	for cat in $$catalogs; do \
+	  cat=`basename $$cat`; \
+	  lang=`echo $$cat | sed -e 's/\.gmo$$//'`; \
+	  dir=$(localedir)/$$lang/LC_MESSAGES; \
+	  $(mkdir_p) $(DESTDIR)$$dir; \
+	  if test -r $$cat; then realcat=$$cat; else realcat=$(srcdir)/$$cat; fi; \
+	  $(INSTALL_DATA) $$realcat $(DESTDIR)$$dir/$(DOMAIN).mo; \
+	  echo "installing $$realcat as $(DESTDIR)$$dir/$(DOMAIN).mo"; \
+	  for lc in '' $(EXTRA_LOCALE_CATEGORIES); do \
+	    if test -n "$$lc"; then \
+	      if (cd $(DESTDIR)$(localedir)/$$lang && LC_ALL=C ls -l -d $$lc 2>/dev/null) | grep ' -> ' >/dev/null; then \
+	        link=`cd $(DESTDIR)$(localedir)/$$lang && LC_ALL=C ls -l -d $$lc | sed -e 's/^.* -> //'`; \
+	        mv $(DESTDIR)$(localedir)/$$lang/$$lc $(DESTDIR)$(localedir)/$$lang/$$lc.old; \
+	        mkdir $(DESTDIR)$(localedir)/$$lang/$$lc; \
+	        (cd $(DESTDIR)$(localedir)/$$lang/$$lc.old && \
+	         for file in *; do \
+	           if test -f $$file; then \
+	             ln -s ../$$link/$$file $(DESTDIR)$(localedir)/$$lang/$$lc/$$file; \
+	           fi; \
+	         done); \
+	        rm -f $(DESTDIR)$(localedir)/$$lang/$$lc.old; \
+	      else \
+	        if test -d $(DESTDIR)$(localedir)/$$lang/$$lc; then \
+	          :; \
+	        else \
+	          rm -f $(DESTDIR)$(localedir)/$$lang/$$lc; \
+	          mkdir $(DESTDIR)$(localedir)/$$lang/$$lc; \
+	        fi; \
+	      fi; \
+	      rm -f $(DESTDIR)$(localedir)/$$lang/$$lc/$(DOMAIN).mo; \
+	      ln -s ../LC_MESSAGES/$(DOMAIN).mo $(DESTDIR)$(localedir)/$$lang/$$lc/$(DOMAIN).mo 2>/dev/null || \
+	      ln $(DESTDIR)$(localedir)/$$lang/LC_MESSAGES/$(DOMAIN).mo $(DESTDIR)$(localedir)/$$lang/$$lc/$(DOMAIN).mo 2>/dev/null || \
+	      cp -p $(DESTDIR)$(localedir)/$$lang/LC_MESSAGES/$(DOMAIN).mo $(DESTDIR)$(localedir)/$$lang/$$lc/$(DOMAIN).mo; \
+	      echo "installing $$realcat link as $(DESTDIR)$(localedir)/$$lang/$$lc/$(DOMAIN).mo"; \
+	    fi; \
+	  done; \
+	done
+
+install-strip: install
+
+installdirs: installdirs-exec installdirs-data
+installdirs-exec:
+installdirs-data: installdirs-data-@USE_NLS@
+	if test "$(PACKAGE)" = "gettext-tools"; then \
+	  $(mkdir_p) $(DESTDIR)$(gettextsrcdir); \
+	else \
+	  : ; \
+	fi
+installdirs-data-no:
+installdirs-data-yes:
+	@catalogs='$(CATALOGS)'; \
+	for cat in $$catalogs; do \
+	  cat=`basename $$cat`; \
+	  lang=`echo $$cat | sed -e 's/\.gmo$$//'`; \
+	  dir=$(localedir)/$$lang/LC_MESSAGES; \
+	  $(mkdir_p) $(DESTDIR)$$dir; \
+	  for lc in '' $(EXTRA_LOCALE_CATEGORIES); do \
+	    if test -n "$$lc"; then \
+	      if (cd $(DESTDIR)$(localedir)/$$lang && LC_ALL=C ls -l -d $$lc 2>/dev/null) | grep ' -> ' >/dev/null; then \
+	        link=`cd $(DESTDIR)$(localedir)/$$lang && LC_ALL=C ls -l -d $$lc | sed -e 's/^.* -> //'`; \
+	        mv $(DESTDIR)$(localedir)/$$lang/$$lc $(DESTDIR)$(localedir)/$$lang/$$lc.old; \
+	        mkdir $(DESTDIR)$(localedir)/$$lang/$$lc; \
+	        (cd $(DESTDIR)$(localedir)/$$lang/$$lc.old && \
+	         for file in *; do \
+	           if test -f $$file; then \
+	             ln -s ../$$link/$$file $(DESTDIR)$(localedir)/$$lang/$$lc/$$file; \
+	           fi; \
+	         done); \
+	        rm -f $(DESTDIR)$(localedir)/$$lang/$$lc.old; \
+	      else \
+	        if test -d $(DESTDIR)$(localedir)/$$lang/$$lc; then \
+	          :; \
+	        else \
+	          rm -f $(DESTDIR)$(localedir)/$$lang/$$lc; \
+	          mkdir $(DESTDIR)$(localedir)/$$lang/$$lc; \
+	        fi; \
+	      fi; \
+	    fi; \
+	  done; \
+	done
+
+# Define this as empty until I found a useful application.
+installcheck:
+
+uninstall: uninstall-exec uninstall-data
+uninstall-exec:
+uninstall-data: uninstall-data-@USE_NLS@
+	if test "$(PACKAGE)" = "gettext-tools"; then \
+	  for file in $(DISTFILES.common) Makevars.template; do \
+	    rm -f $(DESTDIR)$(gettextsrcdir)/$$file; \
+	  done; \
+	else \
+	  : ; \
+	fi
+uninstall-data-no:
+uninstall-data-yes:
+	catalogs='$(CATALOGS)'; \
+	for cat in $$catalogs; do \
+	  cat=`basename $$cat`; \
+	  lang=`echo $$cat | sed -e 's/\.gmo$$//'`; \
+	  for lc in LC_MESSAGES $(EXTRA_LOCALE_CATEGORIES); do \
+	    rm -f $(DESTDIR)$(localedir)/$$lang/$$lc/$(DOMAIN).mo; \
+	  done; \
+	done
+
+check: all
+
+info dvi ps pdf html tags TAGS ctags CTAGS ID:
+
+install-dvi install-ps install-pdf install-html:
+
+mostlyclean:
+	rm -f remove-potcdate.sed
+	rm -f $(srcdir)/stamp-poT
+	rm -f core core.* $(DOMAIN).po $(DOMAIN).1po $(DOMAIN).2po *.new.po
+	rm -fr *.o
+
+clean: mostlyclean
+
+distclean: clean
+	rm -f Makefile Makefile.in POTFILES
+
+maintainer-clean: distclean
+	@echo "This command is intended for maintainers to use;"
+	@echo "it deletes files that may require special tools to rebuild."
+	rm -f $(srcdir)/$(DOMAIN).pot $(srcdir)/stamp-po $(GMOFILES)
+
+distdir = $(top_builddir)/$(PACKAGE)-$(VERSION)/$(subdir)
+dist distdir:
+	test -z "$(DISTFILESDEPS)" || $(MAKE) $(DISTFILESDEPS)
+	@$(MAKE) dist2
+# This is a separate target because 'update-po' must be executed before.
+dist2: $(srcdir)/stamp-po $(DISTFILES)
+	@dists="$(DISTFILES)"; \
+	if test "$(PACKAGE)" = "gettext-tools"; then \
+	  dists="$$dists Makevars.template"; \
+	fi; \
+	if test -f $(srcdir)/$(DOMAIN).pot; then \
+	  dists="$$dists $(DOMAIN).pot stamp-po"; \
+	else \
+	  case $(XGETTEXT) in \
+	    :) echo "Warning: Creating a tarball without '$(DOMAIN).pot', because a suitable 'xgettext' program was not found in PATH." 1>&2;; \
+	    *) echo "Warning: Creating a tarball without '$(DOMAIN).pot', because 'xgettext' found no strings to extract. Check the contents of the POTFILES.in file and the XGETTEXT_OPTIONS in the Makevars file." 1>&2;; \
+	  esac; \
+	fi; \
+	if test -f $(srcdir)/ChangeLog; then \
+	  dists="$$dists ChangeLog"; \
+	fi; \
+	for i in 0 1 2 3 4 5 6 7 8 9; do \
+	  if test -f $(srcdir)/ChangeLog.$$i; then \
+	    dists="$$dists ChangeLog.$$i"; \
+	  fi; \
+	done; \
+	if test -f $(srcdir)/LINGUAS; then dists="$$dists LINGUAS"; fi; \
+	for file in $$dists; do \
+	  if test -f $$file; then \
+	    cp -p $$file $(distdir) || exit 1; \
+	  else \
+	    cp -p $(srcdir)/$$file $(distdir) || exit 1; \
+	  fi; \
+	done
+
+update-po: Makefile
+	$(MAKE) $(DOMAIN).pot-update
+	test -z "$(UPDATEPOFILES)" || $(MAKE) $(UPDATEPOFILES)
+	$(MAKE) update-gmo
+
+# General rule for creating PO files.
+
+.nop.po-create:
+	@lang=`echo $@ | sed -e 's/\.po-create$$//'`; \
+	echo "File $$lang.po does not exist. If you are a translator, you can create it through 'msginit'." 1>&2; \
+	exit 1
+
+# General rule for updating PO files.
+
+.nop.po-update:
+	@lang=`echo $@ | sed -e 's/\.po-update$$//'`; \
+	if test "$(PACKAGE)" = "gettext-tools" && test "$(CROSS_COMPILING)" != "yes"; then PATH=`pwd`/../src:$$PATH; fi; \
+	tmpdir=`pwd`; \
+	echo "$$lang:"; \
+	test "$(srcdir)" = . && cdcmd="" || cdcmd="cd $(srcdir) && "; \
+	echo "$${cdcmd}$(MSGMERGE) $(MSGMERGE_OPTIONS) --lang=$$lang --previous $$lang.po $(DOMAIN).pot -o $$lang.new.po"; \
+	cd $(srcdir); \
+	if { case `$(MSGMERGE) --version | sed 1q | sed -e 's,^[^0-9]*,,'` in \
+	       '' | 0.[0-9] | 0.[0-9].* | 0.1[0-5] | 0.1[0-5].*) \
+	         $(MSGMERGE) $(MSGMERGE_OPTIONS) -o $$tmpdir/$$lang.new.po $$lang.po $(DOMAIN).pot;; \
+	       0.1[6-7] | 0.1[6-7].*) \
+	         $(MSGMERGE) $(MSGMERGE_OPTIONS) --previous -o $$tmpdir/$$lang.new.po $$lang.po $(DOMAIN).pot;; \
+	       *) \
+	         $(MSGMERGE) $(MSGMERGE_OPTIONS) --lang=$$lang --previous -o $$tmpdir/$$lang.new.po $$lang.po $(DOMAIN).pot;; \
+	     esac; \
+	   }; then \
+	  if cmp $$lang.po $$tmpdir/$$lang.new.po >/dev/null 2>&1; then \
+	    rm -f $$tmpdir/$$lang.new.po; \
+	  else \
+	    if mv -f $$tmpdir/$$lang.new.po $$lang.po; then \
+	      :; \
+	    else \
+	      echo "msgmerge for $$lang.po failed: cannot move $$tmpdir/$$lang.new.po to $$lang.po" 1>&2; \
+	      exit 1; \
+	    fi; \
+	  fi; \
+	else \
+	  echo "msgmerge for $$lang.po failed!" 1>&2; \
+	  rm -f $$tmpdir/$$lang.new.po; \
+	fi
+
+$(DUMMYPOFILES):
+
+update-gmo: Makefile $(GMOFILES)
+	@:
+
+# Recreate Makefile by invoking config.status. Explicitly invoke the shell,
+# because execution permission bits may not work on the current file system.
+# Use @SHELL@, which is the shell determined by autoconf for the use by its
+# scripts, not $(SHELL) which is hardwired to /bin/sh and may be deficient.
+Makefile: Makefile.in.in Makevars $(top_builddir)/config.status @POMAKEFILEDEPS@
+	cd $(top_builddir) \
+	  && @SHELL@ ./config.status $(subdir)/$@.in po-directories
+
+force:
+
+# Tell versions [3.59,3.63) of GNU make not to export all variables.
+# Otherwise a system limit (for SysV at least) may be exceeded.
+.NOEXPORT:

po/Makevars

@@ -0,0 +1,82 @@
+# Makefile variables for PO directory in any package using GNU gettext.
+#
+# Copyright (C) 2003-2019 Free Software Foundation, Inc.
+# This file is free software; the Free Software Foundation gives
+# unlimited permission to use, copy, distribute, and modify it.
+
+# Usually the message domain is the same as the package name.
+DOMAIN = $(PACKAGE)
+
+# These two variables depend on the location of this directory.
+subdir = po
+top_builddir = ..
+
+# These options get passed to xgettext.
+XGETTEXT_OPTIONS = --keyword=_ --keyword=N_
+
+# This is the copyright holder that gets inserted into the header of the
+# $(DOMAIN).pot file.  Set this to the copyright holder of the surrounding
+# package.  (Note that the msgstr strings, extracted from the package's
+# sources, belong to the copyright holder of the package.)  Translators are
+# expected to transfer the copyright for their translations to this person
+# or entity, or to disclaim their copyright.  The empty string stands for
+# the public domain; in this case the translators are expected to disclaim
+# their copyright.
+COPYRIGHT_HOLDER = Andrew Wood
+
+# This tells whether or not to prepend "GNU " prefix to the package
+# name that gets inserted into the header of the $(DOMAIN).pot file.
+# Possible values are "yes", "no", or empty.  If it is empty, try to
+# detect it automatically by scanning the files in $(top_srcdir) for
+# "GNU packagename" string.
+PACKAGE_GNU =
+
+# This is the email address or URL to which the translators shall report
+# bugs in the untranslated strings:
+# - Strings which are not entire sentences, see the maintainer guidelines
+#   in the GNU gettext documentation, section 'Preparing Strings'.
+# - Strings which use unclear terms or require additional context to be
+#   understood.
+# - Strings which make invalid assumptions about notation of date, time or
+#   money.
+# - Pluralisation problems.
+# - Incorrect English spelling.
+# - Incorrect formatting.
+# It can be your email address, or a mailing list address where translators
+# can write to without being subscribed, or the URL of a web page through
+# which the translators can contact you.
+MSGID_BUGS_ADDRESS =
+
+# This is the list of locale categories, beyond LC_MESSAGES, for which the
+# message catalogs shall be used.  It is usually empty.
+EXTRA_LOCALE_CATEGORIES =
+
+# This tells whether the $(DOMAIN).pot file contains messages with an 'msgctxt'
+# context.  Possible values are "yes" and "no".  Set this to yes if the
+# package uses functions taking also a message context, like pgettext(), or
+# if in $(XGETTEXT_OPTIONS) you define keywords with a context argument.
+USE_MSGCTXT = no
+
+# These options get passed to msgmerge.
+# Useful options are in particular:
+#   --previous            to keep previous msgids of translated messages,
+#   --quiet               to reduce the verbosity.
+MSGMERGE_OPTIONS =
+
+# These options get passed to msginit.
+# If you want to disable line wrapping when writing PO files, add
+# --no-wrap to MSGMERGE_OPTIONS, XGETTEXT_OPTIONS, and
+# MSGINIT_OPTIONS.
+MSGINIT_OPTIONS =
+
+# This tells whether or not to regenerate a PO file when $(DOMAIN).pot
+# has changed.  Possible values are "yes" and "no".  Set this to no if
+# the POT file is checked in the repository and the version control
+# program ignores timestamps.
+PO_DEPENDS_ON_POT = yes
+
+# This tells whether or not to forcibly update $(DOMAIN).pot and
+# regenerate PO files on "make dist".  Possible values are "yes" and
+# "no".  Set this to no if the POT file and PO files are maintained
+# externally.
+DIST_DEPENDS_ON_UPDATE_PO = yes

po/POTFILES.in

@@ -0,0 +1,32 @@
+src/main/debug.c
+src/main/help.c
+src/main/main.c
+src/main/options.c
+src/main/version.c
+src/pv/calc.c
+src/pv/cursor.c
+src/pv/display.c
+src/pv/elapsedtime.c
+src/pv/file.c
+src/pv/format/averagerate.c
+src/pv/format/barstyle.c
+src/pv/format/bufferpercent.c
+src/pv/format/bytes.c
+src/pv/format/eta.c
+src/pv/format/fineta.c
+src/pv/format/lastwritten.c
+src/pv/format/name.c
+src/pv/format/previousline.c
+src/pv/format/progressbar.c
+src/pv/format/rate.c
+src/pv/format/sgr.c
+src/pv/format/timer.c
+src/pv/loop.c
+src/pv/number.c
+src/pv/proctitle.c
+src/pv/remote.c
+src/pv/signal.c
+src/pv/state.c
+src/pv/string.c
+src/pv/transfer.c
+src/pv/watchpid.c

po/cs.po

@@ -0,0 +1,596 @@
+msgid ""
+msgstr ""
+"Report-Msgid-Bugs-To: https://codeberg.org/ivarch/pv/issues\n"
+"POT-Creation-Date: 2025-10-31 19:47+0000\n"
+"PO-Revision-Date: 2024-10-13 20:43+0000\n"
+"Last-Translator: mmatous <mmatous@users.noreply.translate.codeberg.org>\n"
+"Language-Team: Czech <https://translate.codeberg.org/projects/pv/pv/cs/>\n"
+"Language: cs\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=3; plural=(n==1) ? 0 : (n>=2 && n<=4) ? 1 : 2;\n"
+"X-Generator: Weblate 5.7.2\n"
+
+#: src/main/help.c:236
+msgid "show progress bar"
+msgstr "ukaž indikátor průběhu"
+
+#: src/main/help.c:239
+msgid "show elapsed time"
+msgstr "ukaž uběhlý čas"
+
+#: src/main/help.c:242
+msgid "show estimated time of arrival (completion)"
+msgstr "ukaž přibližný zbývající čas"
+
+#: src/main/help.c:245
+msgid "show absolute estimated time of arrival (completion)"
+msgstr "ukaž přibližný čas dokončení"
+
+#: src/main/help.c:248
+msgid "show data transfer rate counter"
+msgstr "ukaž okamžitou rychlost přenosu dat"
+
+#: src/main/help.c:251
+msgid "show data transfer average rate counter"
+msgstr "ukaž průměrnou rychlost přenosu dat"
+
+#: src/main/help.c:254
+msgid "show number of bytes transferred"
+msgstr "ukaž počet přenesených bajtů"
+
+#: src/main/help.c:257
+msgid "show percentage of transfer buffer in use"
+msgstr "ukaž procento využité vyrovnávací paměti"
+
+#: src/main/help.c:259
+msgid "NUM"
+msgstr "ČÍS"
+
+#: src/main/help.c:260
+msgid "show NUM bytes last written"
+msgstr "zobraz ČÍS posledních zapsaných bajtů"
+
+#: src/main/help.c:262
+msgid "FORMAT"
+msgstr "FORMÁT"
+
+#: src/main/help.c:263
+msgid "set output format to FORMAT"
+msgstr "nastav formát výstupu na FORMÁT"
+
+#: src/main/help.c:266
+msgid "output percentages, not visual information"
+msgstr "vypisuj procenta, ne vizuální informace"
+
+#: src/main/help.c:269
+msgid "do not output any transfer information at all"
+msgstr "nevypisuj žádné informace o přenosu"
+
+#: src/main/help.c:273
+msgid "show number of bits transferred"
+msgstr "ukaž počet přenesených bitů"
+
+#: src/main/help.c:276
+msgid "treat suffixes as multiples of 1000 rather than 1024"
+msgstr "zacházej se suffixy jako s násobky 1000 namísto 1024"
+
+#: src/main/help.c:279
+msgid "display nothing until first byte transferred"
+msgstr "nic nevypisuj, dokud není přenesen první byte"
+
+#: src/main/help.c:281 src/main/help.c:296 src/main/help.c:299
+msgid "SEC"
+msgstr "SEK"
+
+#: src/main/help.c:282
+msgid "display nothing until SEC seconds have passed"
+msgstr "nic nevypisuj, dokud neuplyne SEK sekund"
+
+#: src/main/help.c:284
+msgid "SIZE"
+msgstr "VEL"
+
+#: src/main/help.c:285
+msgid "set estimated data size to SIZE bytes"
+msgstr "nastav očekávanou velikost dat na VEL bajtů"
+
+#: src/main/help.c:288
+msgid "if size unknown, show rate vs max rate"
+msgstr "pokud je velikost neznámá, ukaž rychlost vs maximální rychlost"
+
+#: src/main/help.c:291
+msgid "count lines instead of bytes"
+msgstr "počítej řádky místo bajtů"
+
+#: src/main/help.c:294
+msgid "lines are null-terminated"
+msgstr "řádky jsou zakončené nulovým znakem"
+
+#: src/main/help.c:297
+msgid "update every SEC seconds"
+msgstr "aktualizuj každých SEK sekund"
+
+#: src/main/help.c:300
+msgid "compute average rate over past SEC seconds (default 30s)"
+msgstr "počítej průměrnou rychlost za posledních SEK sekund (výchozí: 30)"
+
+#: src/main/help.c:302
+msgid "WIDTH"
+msgstr "ŠÍŘ"
+
+#: src/main/help.c:303
+msgid "assume terminal is WIDTH characters wide"
+msgstr "předpokládej šířku terminálu ŠÍŘ znaků"
+
+#: src/main/help.c:305
+msgid "HEIGHT"
+msgstr "VÝŠ"
+
+#: src/main/help.c:306
+msgid "assume terminal is HEIGHT rows high"
+msgstr "předpokládej výšku terminálu VÝŠ znaků"
+
+#: src/main/help.c:308
+msgid "NAME"
+msgstr "JMÉNO"
+
+#: src/main/help.c:309
+msgid "prefix visual information with NAME"
+msgstr "přidej JMÉNO před vizuální informace"
+
+#: src/main/help.c:311
+msgid "STYLE"
+msgstr ""
+
+#: src/main/help.c:312
+msgid "set default bar style to NAME"
+msgstr ""
+
+#: src/main/help.c:314
+msgid "SPEC"
+msgstr ""
+
+#: src/main/help.c:315
+msgid "also send progress to SPEC"
+msgstr ""
+
+#: src/main/help.c:318
+msgid "output transfer statistics at the end"
+msgstr "po dokončení vypiš údaje o přenosu"
+
+#: src/main/help.c:321
+msgid "output even if standard error is not a terminal"
+msgstr "vypisuj výstup i pokud standardní chybový výstup není terminál"
+
+#: src/main/help.c:324
+msgid "use cursor positioning escape sequences"
+msgstr "pozicuj kurzor pomocí řídících znaků"
+
+#: src/main/help.c:327 src/main/help.c:360 src/main/help.c:376
+#: src/main/help.c:386
+msgid "FILE"
+msgstr "SOUBOR"
+
+#: src/main/help.c:328
+msgid "write output to FILE instead of stdout"
+msgstr "zapiš výstup do SOUBORu namísto standardního výstupu"
+
+#: src/main/help.c:330
+msgid "RATE"
+msgstr "RYCH"
+
+#: src/main/help.c:331
+msgid "limit transfer to RATE bytes per second"
+msgstr "omez přenosovou rychlost na RYCH bajtů za sekundu"
+
+#: src/main/help.c:333 src/main/help.c:342
+msgid "BYTES"
+msgstr "BAJT"
+
+#: src/main/help.c:334
+msgid "use a buffer size of BYTES"
+msgstr "použij vyrovnávací pamět BAJT bajtů"
+
+#: src/main/help.c:337
+msgid "never use splice(), always use read/write"
+msgstr "nepoužívej splice(), vždy použij read/write"
+
+#: src/main/help.c:340
+msgid "skip read errors in input"
+msgstr "ignoruj chyby při čtení vstupu"
+
+#: src/main/help.c:343
+msgid "skip errors in BYTES blocks at a time"
+msgstr "přeskakuj chyby v blocích BAJTů naráz"
+
+#: src/main/help.c:346
+msgid "stop after --size bytes have been transferred"
+msgstr "zastav po přenosu --size bajtů"
+
+#: src/main/help.c:349
+msgid "flush cache to disk after every write"
+msgstr "po každém zápisu vyprázdni cache na disk"
+
+#: src/main/help.c:352
+msgid "use direct I/O to bypass cache"
+msgstr "použij přímý V/V k obejítí cache"
+
+#: src/main/help.c:355
+msgid "try to seek instead of writing null bytes"
+msgstr ""
+
+#: src/main/help.c:358
+msgid "discard input instead of writing to output"
+msgstr "zahoď vstup namísto zápisu na výstup"
+
+#: src/main/help.c:361
+msgid "write all input to FILE before writing to output"
+msgstr "zapiš veškerý vstup do SOUBORu před výpisem na výstup"
+
+#: src/main/help.c:364
+msgid "PID[:FD]|=NAME|@LISTFILE"
+msgstr ""
+
+#: src/main/help.c:365
+msgid "watch file FD opened by process PID"
+msgstr "sleduj soubor DS otevřený procesem PID"
+
+#: src/main/help.c:368 src/main/help.c:371
+msgid "PID"
+msgstr "PID"
+
+#: src/main/help.c:369
+msgid "update settings of process PID"
+msgstr "aktualizuj nastavení procesu PID"
+
+#: src/main/help.c:372
+msgid "show progress of process PID"
+msgstr ""
+
+#: src/main/help.c:377
+msgid "save process ID in FILE"
+msgstr "ulož id procesu do SOUBORu"
+
+#: src/main/help.c:380
+msgid "show this help and exit"
+msgstr "ukaž pomoc a skonči"
+
+#: src/main/help.c:383
+msgid "show version information and exit"
+msgstr "ukaž informace o verzi a skonči"
+
+#: src/main/help.c:387
+msgid "write debug logs to FILE"
+msgstr "zapiš ladící záznamy do SOUBORu"
+
+#: src/main/help.c:413
+#, c-format
+msgid "Usage: %s [OPTION] [FILE]..."
+msgstr "Použití: %s [VOLBY] [SOUBOR]..."
+
+#: src/main/help.c:424
+msgid ""
+"Concatenate FILE(s), or standard input, to standard output, with monitoring."
+msgstr ""
+"Spoj SOUBOR(y) nebo standardní vstup na standardního výstup, s monitoringem."
+
+#: src/main/help.c:562
+msgid "Supported format sequences:"
+msgstr ""
+
+#: src/main/help.c:576
+#, c-format
+msgid "Please report any bugs to: %s"
+msgstr "Prosím, hlašte veškeré chyby na: %s"
+
+#: src/main/main.c:228
+msgid "(input)"
+msgstr "(vstup)"
+
+#: src/main/main.c:330
+msgid "state allocation failed"
+msgstr "selhala alokace stavu"
+
+#: src/main/options.c:370
+msgid "list files may not contain @ lines"
+msgstr ""
+
+#: src/main/options.c:391 src/main/options.c:393 src/main/options.c:807
+msgid "process ID or pid:fd pair expected"
+msgstr "očekáváno ID procesu nebo dvojice PID:DS"
+
+#: src/main/options.c:403 src/main/options.c:405 src/main/options.c:814
+msgid "invalid process ID"
+msgstr "neplatné ID procesu"
+
+#: src/main/options.c:448 src/pv/file.c:342
+msgid "failed to stat file"
+msgstr "nebylo možné zjistit informace o souboru"
+
+#: src/main/options.c:462
+msgid "is a directory"
+msgstr "je adresář"
+
+#: src/main/options.c:491
+msgid "failed to generate sysfs filename"
+msgstr "selhalo vytváření jména pro soubor v sysfs"
+
+#: src/main/options.c:513
+msgid "failed to read sysfs size file"
+msgstr "selhalo čtení velikosti souboru v sysfs"
+
+#: src/main/options.c:533
+msgid "failed to open block device"
+msgstr "selhalo otevření blokového zařízení"
+
+#: src/main/options.c:543
+msgid "failed to determine size of block device"
+msgstr "selhalo zjištění velikosti blokového zařízení"
+
+#: src/main/options.c:652
+msgid "option structure allocation failed"
+msgstr "selhala alokace struktury pro volby"
+
+#: src/main/options.c:671
+msgid "option structure argv allocation failed"
+msgstr "selhala alokace struktury pro argv"
+
+#: src/main/options.c:723
+msgid "numeric value not understood"
+msgstr ""
+
+#: src/main/options.c:743
+msgid "integer argument expected"
+msgstr "očekáván celočíselný argument"
+
+#: src/main/options.c:755
+msgid "numeric argument expected"
+msgstr "očekáván číselný argument"
+
+#: src/main/options.c:767
+msgid "missing filename"
+msgstr ""
+
+#: src/main/options.c:795
+msgid "missing process name"
+msgstr ""
+
+#: src/main/options.c:1056
+#, c-format
+msgid "Try `%s --help' for more information."
+msgstr "Zkuste `%s --help' pro více informací."
+
+#: src/main/options.c:1058
+#, c-format
+msgid "Try `%s -h' for more information."
+msgstr "Zkuste `%s --h' pro více informací."
+
+#: src/main/options.c:1089
+msgid ""
+"cannot use line mode or transfer modifier options when watching file "
+"descriptors"
+msgstr ""
+"při sledování deskriptorů souborů nelze použít řádkový mód nebo volby pro "
+"modifikaci přenosu"
+
+#: src/main/options.c:1098
+msgid "cannot use cursor positioning when watching file descriptors"
+msgstr "při sledování deskriptorů souborů nelze pozicování kurzoru použít"
+
+#: src/main/options.c:1107
+msgid "cannot use remote control when watching file descriptors"
+msgstr "při sledování deskriptorů souborů nelze použít vzdálené ovládání"
+
+#: src/main/options.c:1116
+msgid "cannot use remote query when watching file descriptors"
+msgstr ""
+
+#: src/main/options.c:1125
+msgid "cannot transfer files when watching file descriptors"
+msgstr "při sledování deskriptorů souborů nelze použít přenos souborů"
+
+#: src/main/options.c:1150
+msgid "not available on systems without /proc/self/fdinfo"
+msgstr "není dostupné na systémech bez /proc/self/fdinfo"
+
+#: src/main/options.c:1162
+msgid "cannot use remote control and remote query together"
+msgstr ""
+
+#: src/main/options.c:1189
+msgid "files cannot be specified with this option"
+msgstr ""
+
+#: src/main/version.c:28
+msgid "License: GPLv3+ <https://www.gnu.org/licenses/gpl-3.0.html>"
+msgstr "Licence: GPLv3+ <https://jxself.org/translations/gpl-3.cz.shtml>"
+
+#: src/main/version.c:29
+msgid "This is free software: you are free to change and redistribute it."
+msgstr "Toto je svobodný software; můžete ho volně měnit a šířit."
+
+#: src/main/version.c:30
+msgid "There is NO WARRANTY, to the extent permitted by law."
+msgstr "Na program se nevztahuje ŽÁDNÁ ZÁRUKA, v míře povolené zákonem."
+
+#: src/main/version.c:32
+msgid "Project web site"
+msgstr "Stránka projektu"
+
+#: src/pv/cursor.c:61
+msgid "failed to get terminal name"
+msgstr "selhalo zjištění názvu terminálu"
+
+#: src/pv/cursor.c:106
+msgid "failed to open lock file"
+msgstr "selhalo otevření zámkového souboru"
+
+#: src/pv/cursor.c:139
+msgid "lock attempt failed"
+msgstr "selhal pokus o uzamčení"
+
+#: src/pv/cursor.c:400
+msgid "failed to open terminal"
+msgstr "selhalo otevření terminálu"
+
+#: src/pv/display.c:285
+msgid "yzafpnum kMGTPEZY"
+msgstr "yzafpnum kMGTPEZY"
+
+#: src/pv/display.c:303
+msgid "yzafpnum KMGTPEZY"
+msgstr "yzafpnum KMGTPEZY"
+
+#: src/pv/display.c:1053 src/pv/state.c:842 src/pv/transfer.c:1135
+msgid "buffer allocation failed"
+msgstr "selhala alokace vyrovnávací paměti"
+
+#: src/pv/file.c:153
+msgid "failed to seek to start of output"
+msgstr "selhalo posunutí za začátek výstupu"
+
+#: src/pv/file.c:303
+msgid "failed to close file"
+msgstr "selhalo zavření souboru"
+
+#: src/pv/file.c:335
+msgid "failed to read file"
+msgstr "selhalo čtení ze souboru"
+
+#: src/pv/file.c:350
+msgid "failed to stat output file"
+msgstr "selhalo zjištění informací o výstupním souboru"
+
+#: src/pv/file.c:372
+msgid "input file is output file"
+msgstr "vstupní soubor je výstupní soubor"
+
+#: src/pv/file.c:429
+msgid "(none)"
+msgstr "(žádný)"
+
+#: src/pv/file.c:431
+msgid "(stdin)"
+msgstr "(stdin)"
+
+#: src/pv/format/averagerate.c:34 src/pv/format/progressbar.c:92
+#: src/pv/format/rate.c:36 src/pv/loop.c:121
+msgid "b/s"
+msgstr "b/s"
+
+#: src/pv/format/averagerate.c:38 src/pv/format/progressbar.c:96
+#: src/pv/format/rate.c:40
+msgid "/s"
+msgstr "/s"
+
+#: src/pv/format/averagerate.c:38 src/pv/format/progressbar.c:96
+#: src/pv/format/rate.c:40 src/pv/loop.c:121
+msgid "B/s"
+msgstr "B/s"
+
+#: src/pv/format/bytes.c:35
+msgid "b"
+msgstr "b"
+
+#: src/pv/format/bytes.c:39 src/pv/transfer.c:620
+msgid "B"
+msgstr "B"
+
+#: src/pv/format/eta.c:52 src/pv/format/eta.c:56
+msgid "ETA"
+msgstr "ETA"
+
+#: src/pv/format/fineta.c:80
+msgid "FIN"
+msgstr "FIN"
+
+#: src/pv/loop.c:120
+msgid "rate min/avg/max/mdev"
+msgstr "rychlost min/avg/max/std"
+
+#: src/pv/loop.c:132
+msgid "rate not measured"
+msgstr "rychlost neměřena"
+
+#: src/pv/loop.c:802 src/pv/loop.c:818 src/pv/loop.c:836 src/pv/watchpid.c:101
+#: src/pv/watchpid.c:110 src/pv/watchpid.c:121 src/pv/watchpid.c:129
+#: src/pv/watchpid.c:166 src/pv/watchpid.c:185 src/pv/watchpid.c:193
+#: src/pv/watchpid.c:203 src/pv/watchpid.c:307 src/pv/watchpid.c:315
+#: src/pv/watchpid.c:447 src/pv/watchpid.c:470
+msgid "pid"
+msgstr "pid"
+
+#: src/pv/loop.c:836 src/pv/watchpid.c:110 src/pv/watchpid.c:122
+#: src/pv/watchpid.c:131 src/pv/watchpid.c:185 src/pv/watchpid.c:194
+#: src/pv/watchpid.c:205
+msgid "fd"
+msgstr "ds"
+
+#: src/pv/remote.c:237 src/pv/remote.c:622
+msgid "message not received"
+msgstr "zpráva nepřijata"
+
+#: src/pv/remote.c:644 src/pv/remote.c:662
+msgid "SA_SIGINFO not supported on this system"
+msgstr "SA_SIGINFO není na tomto systému podporováno"
+
+#: src/pv/state.c:42
+msgid "history structure allocation failed"
+msgstr "selhala alokace struktury historie"
+
+#: src/pv/state.c:794 src/pv/state.c:806
+msgid "file list allocation failed"
+msgstr "selhala alokace seznamu souborů"
+
+#: src/pv/transfer.c:490
+msgid "read failed"
+msgstr "čtení selhalo"
+
+#: src/pv/transfer.c:506
+msgid "warning: read errors detected"
+msgstr "varování: detekovány chyby při čtení"
+
+#: src/pv/transfer.c:522
+msgid "file is not seekable"
+msgstr "souborem nelze procházet"
+
+#: src/pv/transfer.c:599
+msgid "failed to seek past error"
+msgstr "selhal skok za chybu"
+
+#: src/pv/transfer.c:619
+msgid "skipped past read error"
+msgstr "chyba přeskočena"
+
+#: src/pv/transfer.c:663
+msgid "no transfer buffer allocated"
+msgstr "vyrovnávací paměť není alokována"
+
+#: src/pv/transfer.c:751
+msgid "failed to set interval timer"
+msgstr "selhalo nastavení intervalového časovače"
+
+#: src/pv/transfer.c:777
+msgid "failed to clear interval timer"
+msgstr "selhalo vynulování intervalového časovače"
+
+#: src/pv/transfer.c:822
+msgid "line position buffer allocation failed"
+msgstr "selhala alokace vyrovnávací paměti pro pozici v řádcích"
+
+#: src/pv/transfer.c:996
+msgid "write failed"
+msgstr "zápis selhal"
+
+#: src/pv/transfer.c:1237
+msgid "select call failed"
+msgstr "selhalo volání select"
+
+#: src/pv/watchpid.c:131 src/pv/watchpid.c:205
+msgid "not a regular file or block device"
+msgstr "není obyčejný soubor nebo blokové zařízení"
+
+#~ msgid "PID[:FD]"
+#~ msgstr "PID[:DS]"

po/de.po

@@ -0,0 +1,619 @@
+msgid ""
+msgstr ""
+"Report-Msgid-Bugs-To: https://codeberg.org/ivarch/pv/issues\n"
+"POT-Creation-Date: 2025-10-31 19:47+0000\n"
+"PO-Revision-Date: 2025-01-14 20:39+0000\n"
+"Last-Translator: Benny <benny@users.noreply.translate.codeberg.org>\n"
+"Language-Team: German <https://translate.codeberg.org/projects/pv/pv/de/>\n"
+"Language: de\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=2; plural=n != 1;\n"
+"X-Generator: Weblate 5.9.2\n"
+"Date: 1999-06-01 15:18:29+0100\n"
+"From: Andrew Wood <ivarch@ubik>\n"
+"Xgettext-Options: --default-domain=pkgbuild --directory=./.pkgdir --add-"
+"comments --keyword=_ --keyword=N_\n"
+"Files: src/getopt/getopt.c src/getopt/getopt1.c src/version.c src/main/init."
+"c src/main/help.c src/main/xpmptr.c src/guts/load.c src/guts/stop.c src/guts/"
+"configure.c src/guts/make.c src/guts/install.c src/guts/prefs.c src/ui/"
+"generate.c src/ui/main.c src/ui/xpm.c src/ui/status.c src/ui/activate.c src/"
+"ui/handlers/main.c src/ui/handlers/package.c src/ui/handlers/prefs.c src/ui/"
+"handlers/dirsel.c src/ui/handlers/popup.c src/ui/handlers/help.c src/ui/"
+"textout.c src/ui/report.c src/ui/callback.c src/nls/intl/bindtextdom.c src/"
+"nls/intl/dcgettext.c src/nls/intl/dgettext.c src/nls/intl/finddomain.c src/"
+"nls/intl/gettext.c src/nls/intl/loadmsgcat.c src/nls/intl/localealias.c src/"
+"nls/intl/textdomain.c src/nls/intl-cat/cat-compat.c src/nls/intl-gett/intl-"
+"compat.c\n"
+
+#: src/main/help.c:236
+msgid "show progress bar"
+msgstr "Fortschritts-Anzeige"
+
+#: src/main/help.c:239
+msgid "show elapsed time"
+msgstr "zeige die verstrichene Zeit an"
+
+#: src/main/help.c:242
+msgid "show estimated time of arrival (completion)"
+msgstr "zeige die erwartete Zeit bis zum Ende an"
+
+#: src/main/help.c:245
+msgid "show absolute estimated time of arrival (completion)"
+msgstr "zeige die absolute geschätzte Zeit bis zur Fertigstellung"
+
+#: src/main/help.c:248
+msgid "show data transfer rate counter"
+msgstr "zeige die Datentransferrate an"
+
+#: src/main/help.c:251
+msgid "show data transfer average rate counter"
+msgstr "zeige die durchschnittliche Übertragungsrate"
+
+#: src/main/help.c:254
+msgid "show number of bytes transferred"
+msgstr "zeige die Anzahl der übertragenen Bytes"
+
+#: src/main/help.c:257
+msgid "show percentage of transfer buffer in use"
+msgstr "zeige, wie viel Prozent des Übertragungsbuffers in Benutzung sind"
+
+#: src/main/help.c:259
+msgid "NUM"
+msgstr "NUM"
+
+#: src/main/help.c:260
+msgid "show NUM bytes last written"
+msgstr "NUM zeige die zuletzt geschriebenen NUM Bytes"
+
+#: src/main/help.c:262
+msgid "FORMAT"
+msgstr "FORMAT"
+
+#: src/main/help.c:263
+msgid "set output format to FORMAT"
+msgstr "setze das Ausgabeformat auf FORMAT"
+
+#: src/main/help.c:266
+msgid "output percentages, not visual information"
+msgstr "Ausgabe von Prozent-Angaben statt visueller Darstellung"
+
+#: src/main/help.c:269
+msgid "do not output any transfer information at all"
+msgstr "sämtliche Transferinformationen unterdrücken"
+
+#: src/main/help.c:273
+msgid "show number of bits transferred"
+msgstr "zeige die Anzahl der übertragenen Bits"
+
+#: src/main/help.c:276
+msgid "treat suffixes as multiples of 1000 rather than 1024"
+msgstr "behandle Endungen als Vielfache von 1000 statt von 1024"
+
+#: src/main/help.c:279
+msgid "display nothing until first byte transferred"
+msgstr "keine Ausgabe bevor das erste Byte übertragen wurde"
+
+#: src/main/help.c:281 src/main/help.c:296 src/main/help.c:299
+msgid "SEC"
+msgstr "SEK"
+
+#: src/main/help.c:282
+msgid "display nothing until SEC seconds have passed"
+msgstr "nichts anzeigen ehe SEK Sekunden vergangen sind"
+
+#: src/main/help.c:284
+msgid "SIZE"
+msgstr "GRÖẞE"
+
+#: src/main/help.c:285
+msgid "set estimated data size to SIZE bytes"
+msgstr "setze erwartete Datenlänge auf SIZE Byte"
+
+#: src/main/help.c:288
+msgid "if size unknown, show rate vs max rate"
+msgstr "zeige Rate vs maximale Rate, falls die größe unbekannt ist"
+
+#: src/main/help.c:291
+msgid "count lines instead of bytes"
+msgstr "zähle Zeilen anstelle von Bytes"
+
+#: src/main/help.c:294
+msgid "lines are null-terminated"
+msgstr "Zeilen sind nullterminiert"
+
+#: src/main/help.c:297
+msgid "update every SEC seconds"
+msgstr "aktualisiere Ausgabe nach SEK Sekunden Intervall"
+
+#: src/main/help.c:300
+msgid "compute average rate over past SEC seconds (default 30s)"
+msgstr ""
+"berechne die durchschnittliche Übertragungsrate über die letzten SEK "
+"Sekunden (Standard 30s)"
+
+#: src/main/help.c:302
+msgid "WIDTH"
+msgstr "BREITE"
+
+#: src/main/help.c:303
+msgid "assume terminal is WIDTH characters wide"
+msgstr "setze Terminal-Breite auf BREITE Zeichen"
+
+#: src/main/help.c:305
+msgid "HEIGHT"
+msgstr "HÖHE"
+
+#: src/main/help.c:306
+msgid "assume terminal is HEIGHT rows high"
+msgstr "setze Terminal-Höhe auf HÖHE Zeichen"
+
+#: src/main/help.c:308
+msgid "NAME"
+msgstr "NAME"
+
+#: src/main/help.c:309
+msgid "prefix visual information with NAME"
+msgstr "setze den NAMEn für visuelle Darstellung"
+
+#: src/main/help.c:311
+msgid "STYLE"
+msgstr "Stil"
+
+#: src/main/help.c:312
+msgid "set default bar style to NAME"
+msgstr "setze die voreingestellte Darstellung auf NAME"
+
+#: src/main/help.c:314
+msgid "SPEC"
+msgstr "STIL"
+
+#: src/main/help.c:315
+msgid "also send progress to SPEC"
+msgstr "Fortschritt auch an SPEC senden"
+
+#: src/main/help.c:318
+msgid "output transfer statistics at the end"
+msgstr "Übertragungsstatistiken am Ende ausgeben"
+
+#: src/main/help.c:321
+msgid "output even if standard error is not a terminal"
+msgstr ""
+"Ausgabe auch dann erzwingen, wenn der Fehlerausgabe-Kanal kein Terminal ist"
+
+#: src/main/help.c:324
+msgid "use cursor positioning escape sequences"
+msgstr "benutze Escape-Sequenzen zur Cursor-Positionierung"
+
+#: src/main/help.c:327 src/main/help.c:360 src/main/help.c:376
+#: src/main/help.c:386
+msgid "FILE"
+msgstr "DATEI"
+
+#: src/main/help.c:328
+msgid "write output to FILE instead of stdout"
+msgstr "schreibe die Ausgabe in DATEI statt in die Standardausgabe"
+
+#: src/main/help.c:330
+msgid "RATE"
+msgstr "RATE"
+
+#: src/main/help.c:331
+msgid "limit transfer to RATE bytes per second"
+msgstr "beschränke die Transferrate auf RATE Byte pro Sekunde"
+
+#: src/main/help.c:333 src/main/help.c:342
+msgid "BYTES"
+msgstr "BYTES"
+
+#: src/main/help.c:334
+msgid "use a buffer size of BYTES"
+msgstr "benutze einen Puffer in der Größe von BYTES"
+
+#: src/main/help.c:337
+msgid "never use splice(), always use read/write"
+msgstr "anstelle von splice() immer read/write benutzen"
+
+#: src/main/help.c:340
+msgid "skip read errors in input"
+msgstr "Lesefehler in der Eingabe nicht beachten"
+
+#: src/main/help.c:343
+msgid "skip errors in BYTES blocks at a time"
+msgstr "bei Fehlern BYTES am Stück überspringen"
+
+#: src/main/help.c:346
+msgid "stop after --size bytes have been transferred"
+msgstr "anhalten, nachdem --size Bytes übertragen wurden"
+
+#: src/main/help.c:349
+msgid "flush cache to disk after every write"
+msgstr "schreibe den Cache nach jedem Schreibvorgang auf die Festplatte"
+
+#: src/main/help.c:352
+msgid "use direct I/O to bypass cache"
+msgstr "verwende direkte E/A, um den Cache zu umgehen"
+
+#: src/main/help.c:355
+msgid "try to seek instead of writing null bytes"
+msgstr ""
+
+#: src/main/help.c:358
+msgid "discard input instead of writing to output"
+msgstr "verwirf die Eingabe anstatt in die Ausgabe zu schreiben"
+
+#: src/main/help.c:361
+msgid "write all input to FILE before writing to output"
+msgstr "Ausgabe nach FILE schrieben bevor sie ausgegeben wird"
+
+#: src/main/help.c:364
+msgid "PID[:FD]|=NAME|@LISTFILE"
+msgstr ""
+
+#: src/main/help.c:365
+msgid "watch file FD opened by process PID"
+msgstr "die vom Prozess PID geöffnete Datei FD beobachten"
+
+#: src/main/help.c:368 src/main/help.c:371
+msgid "PID"
+msgstr "PID"
+
+#: src/main/help.c:369
+msgid "update settings of process PID"
+msgstr "Einstellungen der Prozess-PID updaten"
+
+#: src/main/help.c:372
+msgid "show progress of process PID"
+msgstr ""
+
+#: src/main/help.c:377
+msgid "save process ID in FILE"
+msgstr "Prozess-ID in DATEI speichern"
+
+#: src/main/help.c:380
+msgid "show this help and exit"
+msgstr "zeige diese Hilfe und beende"
+
+#: src/main/help.c:383
+msgid "show version information and exit"
+msgstr "zeige Versionsinformationen und beende"
+
+#: src/main/help.c:387
+msgid "write debug logs to FILE"
+msgstr "schreibe Debug-Protokolle in DATEI"
+
+#: src/main/help.c:413
+#, c-format
+msgid "Usage: %s [OPTION] [FILE]..."
+msgstr "Aufruf: %s [OPTION] [DATEI]..."
+
+#: src/main/help.c:424
+msgid ""
+"Concatenate FILE(s), or standard input, to standard output, with monitoring."
+msgstr ""
+"Verbindet DATEI(en) oder den Standard-Eingabe-Kanal mit dem Standard-Ausgabe-"
+"Kanal und misst den Datenstrom."
+
+#: src/main/help.c:562
+msgid "Supported format sequences:"
+msgstr "unterstützte Formate:"
+
+#: src/main/help.c:576
+#, c-format
+msgid "Please report any bugs to: %s"
+msgstr "Bitte senden Sie Fehlerberichte an %s"
+
+#: src/main/main.c:228
+msgid "(input)"
+msgstr "(eingabe)"
+
+#: src/main/main.c:330
+msgid "state allocation failed"
+msgstr "Speicherzuweisung für `state' fehlgeschlagen"
+
+#: src/main/options.c:370
+msgid "list files may not contain @ lines"
+msgstr ""
+
+#: src/main/options.c:391 src/main/options.c:393 src/main/options.c:807
+msgid "process ID or pid:fd pair expected"
+msgstr "Prozess-ID oder PID:FD-Paar erwartet"
+
+#: src/main/options.c:403 src/main/options.c:405 src/main/options.c:814
+msgid "invalid process ID"
+msgstr "ungültige Prozess-ID"
+
+#: src/main/options.c:448 src/pv/file.c:342
+msgid "failed to stat file"
+msgstr "konnte Dateiinformationen nicht lesen"
+
+#: src/main/options.c:462
+msgid "is a directory"
+msgstr "ist ein Verzeichnis"
+
+#: src/main/options.c:491
+msgid "failed to generate sysfs filename"
+msgstr "konnte Sysfs-Dateinamen nicht erzeugen"
+
+#: src/main/options.c:513
+msgid "failed to read sysfs size file"
+msgstr "konnte Größe der Sysfs-Datei nicht lesen"
+
+#: src/main/options.c:533
+msgid "failed to open block device"
+msgstr "konnte Blockgerät nicht öffnen"
+
+#: src/main/options.c:543
+msgid "failed to determine size of block device"
+msgstr "konnte Größe des Blockgeräts nicht ermitteln"
+
+#: src/main/options.c:652
+msgid "option structure allocation failed"
+msgstr "Speicherzuweisung für `option' fehlgeschlagen"
+
+#: src/main/options.c:671
+msgid "option structure argv allocation failed"
+msgstr "Speicherzuweisung für `argv' der Option fehlgeschlagen"
+
+#: src/main/options.c:723
+msgid "numeric value not understood"
+msgstr "numerischen Wert nicht verstanden"
+
+#: src/main/options.c:743
+msgid "integer argument expected"
+msgstr "Ganzzahliges Argument erwartet"
+
+#: src/main/options.c:755
+msgid "numeric argument expected"
+msgstr "numerisches Argument erwartet"
+
+#: src/main/options.c:767
+msgid "missing filename"
+msgstr ""
+
+#: src/main/options.c:795
+msgid "missing process name"
+msgstr ""
+
+#: src/main/options.c:1056
+#, c-format
+msgid "Try `%s --help' for more information."
+msgstr "`%s --help' zeigt weitere Informationen an."
+
+#: src/main/options.c:1058
+#, c-format
+msgid "Try `%s -h' for more information."
+msgstr "`%s -h' zeigt weitere Informationen an."
+
+#: src/main/options.c:1089
+msgid ""
+"cannot use line mode or transfer modifier options when watching file "
+"descriptors"
+msgstr ""
+"Beim Beobachten von Dateideskriptoren können keine Optionen für den "
+"Zeilenmodus oder den Übertragungsmodifikator verwendet werden"
+
+#: src/main/options.c:1098
+msgid "cannot use cursor positioning when watching file descriptors"
+msgstr ""
+"Beim Beobachten von Dateideskriptoren kann Cursor-Positionierung nicht "
+"verwendet werden"
+
+#: src/main/options.c:1107
+msgid "cannot use remote control when watching file descriptors"
+msgstr ""
+"Beim Beobachten von Dateideskriptoren kann die Fernbedienung nicht verwenden "
+"werden"
+
+#: src/main/options.c:1116
+msgid "cannot use remote query when watching file descriptors"
+msgstr ""
+
+#: src/main/options.c:1125
+msgid "cannot transfer files when watching file descriptors"
+msgstr ""
+"Beim Beobachten von Dateideskriptoren können Dateien nicht übertragen werden"
+
+#: src/main/options.c:1150
+msgid "not available on systems without /proc/self/fdinfo"
+msgstr "Nicht verfügbar auf Systemen ohne /proc/self/fdinfo"
+
+#: src/main/options.c:1162
+msgid "cannot use remote control and remote query together"
+msgstr ""
+
+#: src/main/options.c:1189
+msgid "files cannot be specified with this option"
+msgstr ""
+
+#: src/main/version.c:28
+msgid "License: GPLv3+ <https://www.gnu.org/licenses/gpl-3.0.html>"
+msgstr "Lizenz: GPLv3+ <https://www.gnu.org/licenses/gpl-3.0.html>"
+
+#: src/main/version.c:29
+msgid "This is free software: you are free to change and redistribute it."
+msgstr "Dies ist freie Software: Sie dürfen sie verändern und weiterverteilen."
+
+#: src/main/version.c:30
+msgid "There is NO WARRANTY, to the extent permitted by law."
+msgstr "Es besteht KEINE GARANTIE, soweit dies gesetzlich zulässig ist."
+
+#: src/main/version.c:32
+msgid "Project web site"
+msgstr "Projekt-Website"
+
+#: src/pv/cursor.c:61
+msgid "failed to get terminal name"
+msgstr "konnte Terminalname nicht lesen"
+
+#: src/pv/cursor.c:106
+msgid "failed to open lock file"
+msgstr "konnte Sperrdatei nicht öffnen"
+
+#: src/pv/cursor.c:139
+msgid "lock attempt failed"
+msgstr "Sperrversuch fehlgeschlagen"
+
+#: src/pv/cursor.c:400
+msgid "failed to open terminal"
+msgstr "konnte Terminal nicht öffnen"
+
+#: src/pv/display.c:285
+msgid "yzafpnum kMGTPEZY"
+msgstr "yzafpnµm kMGTPEZY"
+
+#: src/pv/display.c:303
+msgid "yzafpnum KMGTPEZY"
+msgstr "yzafpnµm KMGTPEZY"
+
+#: src/pv/display.c:1053 src/pv/state.c:842 src/pv/transfer.c:1135
+msgid "buffer allocation failed"
+msgstr "Speicherzuweisung für den Puffer fehlgeschlagen"
+
+#: src/pv/file.c:153
+msgid "failed to seek to start of output"
+msgstr "Konnte nicht zum Anfang der Ausgabe springen"
+
+#: src/pv/file.c:303
+msgid "failed to close file"
+msgstr "konnte Datei nicht schließen"
+
+#: src/pv/file.c:335
+msgid "failed to read file"
+msgstr "konnte Datei nicht lesen"
+
+#: src/pv/file.c:350
+msgid "failed to stat output file"
+msgstr "konnte Dateiinformationen für Ausgabe-Datei nicht lesen"
+
+#: src/pv/file.c:372
+msgid "input file is output file"
+msgstr "Eingabe-Datei ist Ausgabe-Datei"
+
+#: src/pv/file.c:429
+msgid "(none)"
+msgstr "(keine)"
+
+#: src/pv/file.c:431
+msgid "(stdin)"
+msgstr "(stdin)"
+
+#: src/pv/format/averagerate.c:34 src/pv/format/progressbar.c:92
+#: src/pv/format/rate.c:36 src/pv/loop.c:121
+msgid "b/s"
+msgstr "b/s"
+
+#: src/pv/format/averagerate.c:38 src/pv/format/progressbar.c:96
+#: src/pv/format/rate.c:40
+msgid "/s"
+msgstr "/s"
+
+#: src/pv/format/averagerate.c:38 src/pv/format/progressbar.c:96
+#: src/pv/format/rate.c:40 src/pv/loop.c:121
+msgid "B/s"
+msgstr "B/s"
+
+#: src/pv/format/bytes.c:35
+msgid "b"
+msgstr "b"
+
+#: src/pv/format/bytes.c:39 src/pv/transfer.c:620
+msgid "B"
+msgstr "B"
+
+#: src/pv/format/eta.c:52 src/pv/format/eta.c:56
+msgid "ETA"
+msgstr "ETA"
+
+#: src/pv/format/fineta.c:80
+msgid "FIN"
+msgstr "Endzeit"
+
+#: src/pv/loop.c:120
+msgid "rate min/avg/max/mdev"
+msgstr "Rate min/mittel/max/abweichung"
+
+#: src/pv/loop.c:132
+msgid "rate not measured"
+msgstr "Übertragungsrate nicht gemessen"
+
+#: src/pv/loop.c:802 src/pv/loop.c:818 src/pv/loop.c:836 src/pv/watchpid.c:101
+#: src/pv/watchpid.c:110 src/pv/watchpid.c:121 src/pv/watchpid.c:129
+#: src/pv/watchpid.c:166 src/pv/watchpid.c:185 src/pv/watchpid.c:193
+#: src/pv/watchpid.c:203 src/pv/watchpid.c:307 src/pv/watchpid.c:315
+#: src/pv/watchpid.c:447 src/pv/watchpid.c:470
+msgid "pid"
+msgstr "pid"
+
+#: src/pv/loop.c:836 src/pv/watchpid.c:110 src/pv/watchpid.c:122
+#: src/pv/watchpid.c:131 src/pv/watchpid.c:185 src/pv/watchpid.c:194
+#: src/pv/watchpid.c:205
+msgid "fd"
+msgstr "fd"
+
+#: src/pv/remote.c:237 src/pv/remote.c:622
+msgid "message not received"
+msgstr "Nachricht nicht empfangen"
+
+#: src/pv/remote.c:644 src/pv/remote.c:662
+msgid "SA_SIGINFO not supported on this system"
+msgstr "SA_SIGINFO wird auf diesem System nicht unterstützt"
+
+#: src/pv/state.c:42
+msgid "history structure allocation failed"
+msgstr "Speicherzuweisung für `history' fehlgeschlagen"
+
+#: src/pv/state.c:794 src/pv/state.c:806
+msgid "file list allocation failed"
+msgstr "Speicherzuweisung für die Dateiliste fehlgeschlagen"
+
+#: src/pv/transfer.c:490
+msgid "read failed"
+msgstr "read-Aufruf fehlgeschlagen"
+
+#: src/pv/transfer.c:506
+msgid "warning: read errors detected"
+msgstr "warnung: lesefehler erkannt"
+
+#: src/pv/transfer.c:522
+msgid "file is not seekable"
+msgstr "Datei ist nicht durchsuchbar"
+
+#: src/pv/transfer.c:599
+msgid "failed to seek past error"
+msgstr "konnte den Fehler nicht überwinden"
+
+#: src/pv/transfer.c:619
+msgid "skipped past read error"
+msgstr "über den Lesefehler hinaus verschoben"
+
+#: src/pv/transfer.c:663
+msgid "no transfer buffer allocated"
+msgstr "Speicherzuweisung für den Transferpuffer fehlgeschlagen"
+
+#: src/pv/transfer.c:751
+msgid "failed to set interval timer"
+msgstr "konnte Intervall-Timer nicht setzen"
+
+#: src/pv/transfer.c:777
+msgid "failed to clear interval timer"
+msgstr "konnte Intervall-Timer nicht löschen"
+
+#: src/pv/transfer.c:822
+msgid "line position buffer allocation failed"
+msgstr "Zuweisung des Zeilenpuffers fehlgeschlagen"
+
+#: src/pv/transfer.c:996
+msgid "write failed"
+msgstr "write-Aufruf fehlgeschlagen"
+
+#: src/pv/transfer.c:1237
+msgid "select call failed"
+msgstr "select-Aufruf fehlgeschlagen"
+
+#: src/pv/watchpid.c:131 src/pv/watchpid.c:205
+msgid "not a regular file or block device"
+msgstr "ist weder eine normale Datei noch ein Blockgerät"
+
+#~ msgid "PID[:FD]"
+#~ msgstr "PID[:FD]"

po/es.po

@@ -0,0 +1,585 @@
+msgid ""
+msgstr ""
+"Report-Msgid-Bugs-To: https://codeberg.org/ivarch/pv/issues\n"
+"POT-Creation-Date: 2025-10-31 19:47+0000\n"
+"Language: es\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#: src/main/help.c:236
+msgid "show progress bar"
+msgstr ""
+
+#: src/main/help.c:239
+msgid "show elapsed time"
+msgstr ""
+
+#: src/main/help.c:242
+msgid "show estimated time of arrival (completion)"
+msgstr ""
+
+#: src/main/help.c:245
+msgid "show absolute estimated time of arrival (completion)"
+msgstr ""
+
+#: src/main/help.c:248
+msgid "show data transfer rate counter"
+msgstr ""
+
+#: src/main/help.c:251
+msgid "show data transfer average rate counter"
+msgstr ""
+
+#: src/main/help.c:254
+msgid "show number of bytes transferred"
+msgstr ""
+
+#: src/main/help.c:257
+msgid "show percentage of transfer buffer in use"
+msgstr ""
+
+#: src/main/help.c:259
+msgid "NUM"
+msgstr ""
+
+#: src/main/help.c:260
+msgid "show NUM bytes last written"
+msgstr ""
+
+#: src/main/help.c:262
+msgid "FORMAT"
+msgstr ""
+
+#: src/main/help.c:263
+msgid "set output format to FORMAT"
+msgstr ""
+
+#: src/main/help.c:266
+msgid "output percentages, not visual information"
+msgstr ""
+
+#: src/main/help.c:269
+msgid "do not output any transfer information at all"
+msgstr ""
+
+#: src/main/help.c:273
+msgid "show number of bits transferred"
+msgstr ""
+
+#: src/main/help.c:276
+msgid "treat suffixes as multiples of 1000 rather than 1024"
+msgstr ""
+
+#: src/main/help.c:279
+msgid "display nothing until first byte transferred"
+msgstr ""
+
+#: src/main/help.c:281 src/main/help.c:296 src/main/help.c:299
+msgid "SEC"
+msgstr ""
+
+#: src/main/help.c:282
+msgid "display nothing until SEC seconds have passed"
+msgstr ""
+
+#: src/main/help.c:284
+msgid "SIZE"
+msgstr ""
+
+#: src/main/help.c:285
+msgid "set estimated data size to SIZE bytes"
+msgstr ""
+
+#: src/main/help.c:288
+msgid "if size unknown, show rate vs max rate"
+msgstr ""
+
+#: src/main/help.c:291
+msgid "count lines instead of bytes"
+msgstr ""
+
+#: src/main/help.c:294
+msgid "lines are null-terminated"
+msgstr ""
+
+#: src/main/help.c:297
+msgid "update every SEC seconds"
+msgstr ""
+
+#: src/main/help.c:300
+msgid "compute average rate over past SEC seconds (default 30s)"
+msgstr ""
+
+#: src/main/help.c:302
+msgid "WIDTH"
+msgstr ""
+
+#: src/main/help.c:303
+msgid "assume terminal is WIDTH characters wide"
+msgstr ""
+
+#: src/main/help.c:305
+msgid "HEIGHT"
+msgstr ""
+
+#: src/main/help.c:306
+msgid "assume terminal is HEIGHT rows high"
+msgstr ""
+
+#: src/main/help.c:308
+msgid "NAME"
+msgstr ""
+
+#: src/main/help.c:309
+msgid "prefix visual information with NAME"
+msgstr ""
+
+#: src/main/help.c:311
+msgid "STYLE"
+msgstr ""
+
+#: src/main/help.c:312
+msgid "set default bar style to NAME"
+msgstr ""
+
+#: src/main/help.c:314
+msgid "SPEC"
+msgstr ""
+
+#: src/main/help.c:315
+msgid "also send progress to SPEC"
+msgstr ""
+
+#: src/main/help.c:318
+msgid "output transfer statistics at the end"
+msgstr ""
+
+#: src/main/help.c:321
+msgid "output even if standard error is not a terminal"
+msgstr ""
+
+#: src/main/help.c:324
+msgid "use cursor positioning escape sequences"
+msgstr ""
+
+#: src/main/help.c:327 src/main/help.c:360 src/main/help.c:376
+#: src/main/help.c:386
+msgid "FILE"
+msgstr ""
+
+#: src/main/help.c:328
+msgid "write output to FILE instead of stdout"
+msgstr ""
+
+#: src/main/help.c:330
+msgid "RATE"
+msgstr ""
+
+#: src/main/help.c:331
+msgid "limit transfer to RATE bytes per second"
+msgstr ""
+
+#: src/main/help.c:333 src/main/help.c:342
+msgid "BYTES"
+msgstr ""
+
+#: src/main/help.c:334
+msgid "use a buffer size of BYTES"
+msgstr ""
+
+#: src/main/help.c:337
+msgid "never use splice(), always use read/write"
+msgstr ""
+
+#: src/main/help.c:340
+msgid "skip read errors in input"
+msgstr ""
+
+#: src/main/help.c:343
+msgid "skip errors in BYTES blocks at a time"
+msgstr ""
+
+#: src/main/help.c:346
+msgid "stop after --size bytes have been transferred"
+msgstr ""
+
+#: src/main/help.c:349
+msgid "flush cache to disk after every write"
+msgstr ""
+
+#: src/main/help.c:352
+msgid "use direct I/O to bypass cache"
+msgstr ""
+
+#: src/main/help.c:355
+msgid "try to seek instead of writing null bytes"
+msgstr ""
+
+#: src/main/help.c:358
+msgid "discard input instead of writing to output"
+msgstr ""
+
+#: src/main/help.c:361
+msgid "write all input to FILE before writing to output"
+msgstr ""
+
+#: src/main/help.c:364
+msgid "PID[:FD]|=NAME|@LISTFILE"
+msgstr ""
+
+#: src/main/help.c:365
+msgid "watch file FD opened by process PID"
+msgstr ""
+
+#: src/main/help.c:368 src/main/help.c:371
+msgid "PID"
+msgstr ""
+
+#: src/main/help.c:369
+msgid "update settings of process PID"
+msgstr ""
+
+#: src/main/help.c:372
+msgid "show progress of process PID"
+msgstr ""
+
+#: src/main/help.c:377
+msgid "save process ID in FILE"
+msgstr ""
+
+#: src/main/help.c:380
+msgid "show this help and exit"
+msgstr ""
+
+#: src/main/help.c:383
+msgid "show version information and exit"
+msgstr ""
+
+#: src/main/help.c:387
+msgid "write debug logs to FILE"
+msgstr ""
+
+#: src/main/help.c:413
+#, c-format
+msgid "Usage: %s [OPTION] [FILE]..."
+msgstr ""
+
+#: src/main/help.c:424
+msgid ""
+"Concatenate FILE(s), or standard input, to standard output, with monitoring."
+msgstr ""
+
+#: src/main/help.c:562
+msgid "Supported format sequences:"
+msgstr ""
+
+#: src/main/help.c:576
+#, c-format
+msgid "Please report any bugs to: %s"
+msgstr ""
+
+#: src/main/main.c:228
+msgid "(input)"
+msgstr ""
+
+#: src/main/main.c:330
+msgid "state allocation failed"
+msgstr ""
+
+#: src/main/options.c:370
+msgid "list files may not contain @ lines"
+msgstr ""
+
+#: src/main/options.c:391 src/main/options.c:393 src/main/options.c:807
+msgid "process ID or pid:fd pair expected"
+msgstr ""
+
+#: src/main/options.c:403 src/main/options.c:405 src/main/options.c:814
+msgid "invalid process ID"
+msgstr ""
+
+#: src/main/options.c:448 src/pv/file.c:342
+msgid "failed to stat file"
+msgstr ""
+
+#: src/main/options.c:462
+msgid "is a directory"
+msgstr ""
+
+#: src/main/options.c:491
+msgid "failed to generate sysfs filename"
+msgstr ""
+
+#: src/main/options.c:513
+msgid "failed to read sysfs size file"
+msgstr ""
+
+#: src/main/options.c:533
+msgid "failed to open block device"
+msgstr ""
+
+#: src/main/options.c:543
+msgid "failed to determine size of block device"
+msgstr ""
+
+#: src/main/options.c:652
+msgid "option structure allocation failed"
+msgstr ""
+
+#: src/main/options.c:671
+msgid "option structure argv allocation failed"
+msgstr ""
+
+#: src/main/options.c:723
+msgid "numeric value not understood"
+msgstr ""
+
+#: src/main/options.c:743
+msgid "integer argument expected"
+msgstr ""
+
+#: src/main/options.c:755
+msgid "numeric argument expected"
+msgstr ""
+
+#: src/main/options.c:767
+msgid "missing filename"
+msgstr ""
+
+#: src/main/options.c:795
+msgid "missing process name"
+msgstr ""
+
+#: src/main/options.c:1056
+#, c-format
+msgid "Try `%s --help' for more information."
+msgstr ""
+
+#: src/main/options.c:1058
+#, c-format
+msgid "Try `%s -h' for more information."
+msgstr ""
+
+#: src/main/options.c:1089
+msgid ""
+"cannot use line mode or transfer modifier options when watching file "
+"descriptors"
+msgstr ""
+
+#: src/main/options.c:1098
+msgid "cannot use cursor positioning when watching file descriptors"
+msgstr ""
+
+#: src/main/options.c:1107
+msgid "cannot use remote control when watching file descriptors"
+msgstr ""
+
+#: src/main/options.c:1116
+msgid "cannot use remote query when watching file descriptors"
+msgstr ""
+
+#: src/main/options.c:1125
+msgid "cannot transfer files when watching file descriptors"
+msgstr ""
+
+#: src/main/options.c:1150
+msgid "not available on systems without /proc/self/fdinfo"
+msgstr ""
+
+#: src/main/options.c:1162
+msgid "cannot use remote control and remote query together"
+msgstr ""
+
+#: src/main/options.c:1189
+msgid "files cannot be specified with this option"
+msgstr ""
+
+#: src/main/version.c:28
+msgid "License: GPLv3+ <https://www.gnu.org/licenses/gpl-3.0.html>"
+msgstr ""
+
+#: src/main/version.c:29
+msgid "This is free software: you are free to change and redistribute it."
+msgstr ""
+
+#: src/main/version.c:30
+msgid "There is NO WARRANTY, to the extent permitted by law."
+msgstr ""
+
+#: src/main/version.c:32
+msgid "Project web site"
+msgstr ""
+
+#: src/pv/cursor.c:61
+msgid "failed to get terminal name"
+msgstr ""
+
+#: src/pv/cursor.c:106
+msgid "failed to open lock file"
+msgstr ""
+
+#: src/pv/cursor.c:139
+msgid "lock attempt failed"
+msgstr ""
+
+#: src/pv/cursor.c:400
+msgid "failed to open terminal"
+msgstr ""
+
+#: src/pv/display.c:285
+msgid "yzafpnum kMGTPEZY"
+msgstr ""
+
+#: src/pv/display.c:303
+msgid "yzafpnum KMGTPEZY"
+msgstr ""
+
+#: src/pv/display.c:1053 src/pv/state.c:842 src/pv/transfer.c:1135
+msgid "buffer allocation failed"
+msgstr ""
+
+#: src/pv/file.c:153
+msgid "failed to seek to start of output"
+msgstr ""
+
+#: src/pv/file.c:303
+msgid "failed to close file"
+msgstr ""
+
+#: src/pv/file.c:335
+msgid "failed to read file"
+msgstr ""
+
+#: src/pv/file.c:350
+msgid "failed to stat output file"
+msgstr ""
+
+#: src/pv/file.c:372
+msgid "input file is output file"
+msgstr ""
+
+#: src/pv/file.c:429
+msgid "(none)"
+msgstr ""
+
+#: src/pv/file.c:431
+msgid "(stdin)"
+msgstr ""
+
+#: src/pv/format/averagerate.c:34 src/pv/format/progressbar.c:92
+#: src/pv/format/rate.c:36 src/pv/loop.c:121
+msgid "b/s"
+msgstr ""
+
+#: src/pv/format/averagerate.c:38 src/pv/format/progressbar.c:96
+#: src/pv/format/rate.c:40
+msgid "/s"
+msgstr ""
+
+#: src/pv/format/averagerate.c:38 src/pv/format/progressbar.c:96
+#: src/pv/format/rate.c:40 src/pv/loop.c:121
+msgid "B/s"
+msgstr ""
+
+#: src/pv/format/bytes.c:35
+msgid "b"
+msgstr ""
+
+#: src/pv/format/bytes.c:39 src/pv/transfer.c:620
+msgid "B"
+msgstr ""
+
+#: src/pv/format/eta.c:52 src/pv/format/eta.c:56
+msgid "ETA"
+msgstr ""
+
+#: src/pv/format/fineta.c:80
+msgid "FIN"
+msgstr ""
+
+#: src/pv/loop.c:120
+msgid "rate min/avg/max/mdev"
+msgstr ""
+
+#: src/pv/loop.c:132
+msgid "rate not measured"
+msgstr ""
+
+#: src/pv/loop.c:802 src/pv/loop.c:818 src/pv/loop.c:836 src/pv/watchpid.c:101
+#: src/pv/watchpid.c:110 src/pv/watchpid.c:121 src/pv/watchpid.c:129
+#: src/pv/watchpid.c:166 src/pv/watchpid.c:185 src/pv/watchpid.c:193
+#: src/pv/watchpid.c:203 src/pv/watchpid.c:307 src/pv/watchpid.c:315
+#: src/pv/watchpid.c:447 src/pv/watchpid.c:470
+msgid "pid"
+msgstr ""
+
+#: src/pv/loop.c:836 src/pv/watchpid.c:110 src/pv/watchpid.c:122
+#: src/pv/watchpid.c:131 src/pv/watchpid.c:185 src/pv/watchpid.c:194
+#: src/pv/watchpid.c:205
+msgid "fd"
+msgstr ""
+
+#: src/pv/remote.c:237 src/pv/remote.c:622
+msgid "message not received"
+msgstr ""
+
+#: src/pv/remote.c:644 src/pv/remote.c:662
+msgid "SA_SIGINFO not supported on this system"
+msgstr ""
+
+#: src/pv/state.c:42
+msgid "history structure allocation failed"
+msgstr ""
+
+#: src/pv/state.c:794 src/pv/state.c:806
+msgid "file list allocation failed"
+msgstr ""
+
+#: src/pv/transfer.c:490
+msgid "read failed"
+msgstr ""
+
+#: src/pv/transfer.c:506
+msgid "warning: read errors detected"
+msgstr ""
+
+#: src/pv/transfer.c:522
+msgid "file is not seekable"
+msgstr ""
+
+#: src/pv/transfer.c:599
+msgid "failed to seek past error"
+msgstr ""
+
+#: src/pv/transfer.c:619
+msgid "skipped past read error"
+msgstr ""
+
+#: src/pv/transfer.c:663
+msgid "no transfer buffer allocated"
+msgstr ""
+
+#: src/pv/transfer.c:751
+msgid "failed to set interval timer"
+msgstr ""
+
+#: src/pv/transfer.c:777
+msgid "failed to clear interval timer"
+msgstr ""
+
+#: src/pv/transfer.c:822
+msgid "line position buffer allocation failed"
+msgstr ""
+
+#: src/pv/transfer.c:996
+msgid "write failed"
+msgstr ""
+
+#: src/pv/transfer.c:1237
+msgid "select call failed"
+msgstr ""
+
+#: src/pv/watchpid.c:131 src/pv/watchpid.c:205
+msgid "not a regular file or block device"
+msgstr ""

po/fi.po

@@ -0,0 +1,589 @@
+msgid ""
+msgstr ""
+"Project-Id-Version: pv 1.9.34\n"
+"Report-Msgid-Bugs-To: https://codeberg.org/ivarch/pv/issues\n"
+"POT-Creation-Date: 2025-10-31 19:47+0000\n"
+"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
+"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
+"Language-Team: LANGUAGE <LL@li.org>\n"
+"Language: fi\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+
+#: src/main/help.c:236
+msgid "show progress bar"
+msgstr ""
+
+#: src/main/help.c:239
+msgid "show elapsed time"
+msgstr ""
+
+#: src/main/help.c:242
+msgid "show estimated time of arrival (completion)"
+msgstr ""
+
+#: src/main/help.c:245
+msgid "show absolute estimated time of arrival (completion)"
+msgstr ""
+
+#: src/main/help.c:248
+msgid "show data transfer rate counter"
+msgstr ""
+
+#: src/main/help.c:251
+msgid "show data transfer average rate counter"
+msgstr ""
+
+#: src/main/help.c:254
+msgid "show number of bytes transferred"
+msgstr ""
+
+#: src/main/help.c:257
+msgid "show percentage of transfer buffer in use"
+msgstr ""
+
+#: src/main/help.c:259
+msgid "NUM"
+msgstr ""
+
+#: src/main/help.c:260
+msgid "show NUM bytes last written"
+msgstr ""
+
+#: src/main/help.c:262
+msgid "FORMAT"
+msgstr ""
+
+#: src/main/help.c:263
+msgid "set output format to FORMAT"
+msgstr ""
+
+#: src/main/help.c:266
+msgid "output percentages, not visual information"
+msgstr ""
+
+#: src/main/help.c:269
+msgid "do not output any transfer information at all"
+msgstr ""
+
+#: src/main/help.c:273
+msgid "show number of bits transferred"
+msgstr ""
+
+#: src/main/help.c:276
+msgid "treat suffixes as multiples of 1000 rather than 1024"
+msgstr ""
+
+#: src/main/help.c:279
+msgid "display nothing until first byte transferred"
+msgstr ""
+
+#: src/main/help.c:281 src/main/help.c:296 src/main/help.c:299
+msgid "SEC"
+msgstr ""
+
+#: src/main/help.c:282
+msgid "display nothing until SEC seconds have passed"
+msgstr ""
+
+#: src/main/help.c:284
+msgid "SIZE"
+msgstr ""
+
+#: src/main/help.c:285
+msgid "set estimated data size to SIZE bytes"
+msgstr ""
+
+#: src/main/help.c:288
+msgid "if size unknown, show rate vs max rate"
+msgstr ""
+
+#: src/main/help.c:291
+msgid "count lines instead of bytes"
+msgstr ""
+
+#: src/main/help.c:294
+msgid "lines are null-terminated"
+msgstr ""
+
+#: src/main/help.c:297
+msgid "update every SEC seconds"
+msgstr ""
+
+#: src/main/help.c:300
+msgid "compute average rate over past SEC seconds (default 30s)"
+msgstr ""
+
+#: src/main/help.c:302
+msgid "WIDTH"
+msgstr ""
+
+#: src/main/help.c:303
+msgid "assume terminal is WIDTH characters wide"
+msgstr ""
+
+#: src/main/help.c:305
+msgid "HEIGHT"
+msgstr ""
+
+#: src/main/help.c:306
+msgid "assume terminal is HEIGHT rows high"
+msgstr ""
+
+#: src/main/help.c:308
+msgid "NAME"
+msgstr ""
+
+#: src/main/help.c:309
+msgid "prefix visual information with NAME"
+msgstr ""
+
+#: src/main/help.c:311
+msgid "STYLE"
+msgstr ""
+
+#: src/main/help.c:312
+msgid "set default bar style to NAME"
+msgstr ""
+
+#: src/main/help.c:314
+msgid "SPEC"
+msgstr ""
+
+#: src/main/help.c:315
+msgid "also send progress to SPEC"
+msgstr ""
+
+#: src/main/help.c:318
+msgid "output transfer statistics at the end"
+msgstr ""
+
+#: src/main/help.c:321
+msgid "output even if standard error is not a terminal"
+msgstr ""
+
+#: src/main/help.c:324
+msgid "use cursor positioning escape sequences"
+msgstr ""
+
+#: src/main/help.c:327 src/main/help.c:360 src/main/help.c:376
+#: src/main/help.c:386
+msgid "FILE"
+msgstr ""
+
+#: src/main/help.c:328
+msgid "write output to FILE instead of stdout"
+msgstr ""
+
+#: src/main/help.c:330
+msgid "RATE"
+msgstr ""
+
+#: src/main/help.c:331
+msgid "limit transfer to RATE bytes per second"
+msgstr ""
+
+#: src/main/help.c:333 src/main/help.c:342
+msgid "BYTES"
+msgstr ""
+
+#: src/main/help.c:334
+msgid "use a buffer size of BYTES"
+msgstr ""
+
+#: src/main/help.c:337
+msgid "never use splice(), always use read/write"
+msgstr ""
+
+#: src/main/help.c:340
+msgid "skip read errors in input"
+msgstr ""
+
+#: src/main/help.c:343
+msgid "skip errors in BYTES blocks at a time"
+msgstr ""
+
+#: src/main/help.c:346
+msgid "stop after --size bytes have been transferred"
+msgstr ""
+
+#: src/main/help.c:349
+msgid "flush cache to disk after every write"
+msgstr ""
+
+#: src/main/help.c:352
+msgid "use direct I/O to bypass cache"
+msgstr ""
+
+#: src/main/help.c:355
+msgid "try to seek instead of writing null bytes"
+msgstr ""
+
+#: src/main/help.c:358
+msgid "discard input instead of writing to output"
+msgstr ""
+
+#: src/main/help.c:361
+msgid "write all input to FILE before writing to output"
+msgstr ""
+
+#: src/main/help.c:364
+msgid "PID[:FD]|=NAME|@LISTFILE"
+msgstr ""
+
+#: src/main/help.c:365
+msgid "watch file FD opened by process PID"
+msgstr ""
+
+#: src/main/help.c:368 src/main/help.c:371
+msgid "PID"
+msgstr ""
+
+#: src/main/help.c:369
+msgid "update settings of process PID"
+msgstr ""
+
+#: src/main/help.c:372
+msgid "show progress of process PID"
+msgstr ""
+
+#: src/main/help.c:377
+msgid "save process ID in FILE"
+msgstr ""
+
+#: src/main/help.c:380
+msgid "show this help and exit"
+msgstr ""
+
+#: src/main/help.c:383
+msgid "show version information and exit"
+msgstr ""
+
+#: src/main/help.c:387
+msgid "write debug logs to FILE"
+msgstr ""
+
+#: src/main/help.c:413
+#, c-format
+msgid "Usage: %s [OPTION] [FILE]..."
+msgstr ""
+
+#: src/main/help.c:424
+msgid ""
+"Concatenate FILE(s), or standard input, to standard output, with monitoring."
+msgstr ""
+
+#: src/main/help.c:562
+msgid "Supported format sequences:"
+msgstr ""
+
+#: src/main/help.c:576
+#, c-format
+msgid "Please report any bugs to: %s"
+msgstr ""
+
+#: src/main/main.c:228
+msgid "(input)"
+msgstr ""
+
+#: src/main/main.c:330
+msgid "state allocation failed"
+msgstr ""
+
+#: src/main/options.c:370
+msgid "list files may not contain @ lines"
+msgstr ""
+
+#: src/main/options.c:391 src/main/options.c:393 src/main/options.c:807
+msgid "process ID or pid:fd pair expected"
+msgstr ""
+
+#: src/main/options.c:403 src/main/options.c:405 src/main/options.c:814
+msgid "invalid process ID"
+msgstr ""
+
+#: src/main/options.c:448 src/pv/file.c:342
+msgid "failed to stat file"
+msgstr ""
+
+#: src/main/options.c:462
+msgid "is a directory"
+msgstr ""
+
+#: src/main/options.c:491
+msgid "failed to generate sysfs filename"
+msgstr ""
+
+#: src/main/options.c:513
+msgid "failed to read sysfs size file"
+msgstr ""
+
+#: src/main/options.c:533
+msgid "failed to open block device"
+msgstr ""
+
+#: src/main/options.c:543
+msgid "failed to determine size of block device"
+msgstr ""
+
+#: src/main/options.c:652
+msgid "option structure allocation failed"
+msgstr ""
+
+#: src/main/options.c:671
+msgid "option structure argv allocation failed"
+msgstr ""
+
+#: src/main/options.c:723
+msgid "numeric value not understood"
+msgstr ""
+
+#: src/main/options.c:743
+msgid "integer argument expected"
+msgstr ""
+
+#: src/main/options.c:755
+msgid "numeric argument expected"
+msgstr ""
+
+#: src/main/options.c:767
+msgid "missing filename"
+msgstr ""
+
+#: src/main/options.c:795
+msgid "missing process name"
+msgstr ""
+
+#: src/main/options.c:1056
+#, c-format
+msgid "Try `%s --help' for more information."
+msgstr ""
+
+#: src/main/options.c:1058
+#, c-format
+msgid "Try `%s -h' for more information."
+msgstr ""
+
+#: src/main/options.c:1089
+msgid ""
+"cannot use line mode or transfer modifier options when watching file "
+"descriptors"
+msgstr ""
+
+#: src/main/options.c:1098
+msgid "cannot use cursor positioning when watching file descriptors"
+msgstr ""
+
+#: src/main/options.c:1107
+msgid "cannot use remote control when watching file descriptors"
+msgstr ""
+
+#: src/main/options.c:1116
+msgid "cannot use remote query when watching file descriptors"
+msgstr ""
+
+#: src/main/options.c:1125
+msgid "cannot transfer files when watching file descriptors"
+msgstr ""
+
+#: src/main/options.c:1150
+msgid "not available on systems without /proc/self/fdinfo"
+msgstr ""
+
+#: src/main/options.c:1162
+msgid "cannot use remote control and remote query together"
+msgstr ""
+
+#: src/main/options.c:1189
+msgid "files cannot be specified with this option"
+msgstr ""
+
+#: src/main/version.c:28
+msgid "License: GPLv3+ <https://www.gnu.org/licenses/gpl-3.0.html>"
+msgstr ""
+
+#: src/main/version.c:29
+msgid "This is free software: you are free to change and redistribute it."
+msgstr ""
+
+#: src/main/version.c:30
+msgid "There is NO WARRANTY, to the extent permitted by law."
+msgstr ""
+
+#: src/main/version.c:32
+msgid "Project web site"
+msgstr ""
+
+#: src/pv/cursor.c:61
+msgid "failed to get terminal name"
+msgstr ""
+
+#: src/pv/cursor.c:106
+msgid "failed to open lock file"
+msgstr ""
+
+#: src/pv/cursor.c:139
+msgid "lock attempt failed"
+msgstr ""
+
+#: src/pv/cursor.c:400
+msgid "failed to open terminal"
+msgstr ""
+
+#: src/pv/display.c:285
+msgid "yzafpnum kMGTPEZY"
+msgstr ""
+
+#: src/pv/display.c:303
+msgid "yzafpnum KMGTPEZY"
+msgstr ""
+
+#: src/pv/display.c:1053 src/pv/state.c:842 src/pv/transfer.c:1135
+msgid "buffer allocation failed"
+msgstr ""
+
+#: src/pv/file.c:153
+msgid "failed to seek to start of output"
+msgstr ""
+
+#: src/pv/file.c:303
+msgid "failed to close file"
+msgstr ""
+
+#: src/pv/file.c:335
+msgid "failed to read file"
+msgstr ""
+
+#: src/pv/file.c:350
+msgid "failed to stat output file"
+msgstr ""
+
+#: src/pv/file.c:372
+msgid "input file is output file"
+msgstr ""
+
+#: src/pv/file.c:429
+msgid "(none)"
+msgstr ""
+
+#: src/pv/file.c:431
+msgid "(stdin)"
+msgstr ""
+
+#: src/pv/format/averagerate.c:34 src/pv/format/progressbar.c:92
+#: src/pv/format/rate.c:36 src/pv/loop.c:121
+msgid "b/s"
+msgstr ""
+
+#: src/pv/format/averagerate.c:38 src/pv/format/progressbar.c:96
+#: src/pv/format/rate.c:40
+msgid "/s"
+msgstr ""
+
+#: src/pv/format/averagerate.c:38 src/pv/format/progressbar.c:96
+#: src/pv/format/rate.c:40 src/pv/loop.c:121
+msgid "B/s"
+msgstr ""
+
+#: src/pv/format/bytes.c:35
+msgid "b"
+msgstr ""
+
+#: src/pv/format/bytes.c:39 src/pv/transfer.c:620
+msgid "B"
+msgstr ""
+
+#: src/pv/format/eta.c:52 src/pv/format/eta.c:56
+msgid "ETA"
+msgstr ""
+
+#: src/pv/format/fineta.c:80
+msgid "FIN"
+msgstr ""
+
+#: src/pv/loop.c:120
+msgid "rate min/avg/max/mdev"
+msgstr ""
+
+#: src/pv/loop.c:132
+msgid "rate not measured"
+msgstr ""
+
+#: src/pv/loop.c:802 src/pv/loop.c:818 src/pv/loop.c:836 src/pv/watchpid.c:101
+#: src/pv/watchpid.c:110 src/pv/watchpid.c:121 src/pv/watchpid.c:129
+#: src/pv/watchpid.c:166 src/pv/watchpid.c:185 src/pv/watchpid.c:193
+#: src/pv/watchpid.c:203 src/pv/watchpid.c:307 src/pv/watchpid.c:315
+#: src/pv/watchpid.c:447 src/pv/watchpid.c:470
+msgid "pid"
+msgstr ""
+
+#: src/pv/loop.c:836 src/pv/watchpid.c:110 src/pv/watchpid.c:122
+#: src/pv/watchpid.c:131 src/pv/watchpid.c:185 src/pv/watchpid.c:194
+#: src/pv/watchpid.c:205
+msgid "fd"
+msgstr ""
+
+#: src/pv/remote.c:237 src/pv/remote.c:622
+msgid "message not received"
+msgstr ""
+
+#: src/pv/remote.c:644 src/pv/remote.c:662
+msgid "SA_SIGINFO not supported on this system"
+msgstr ""
+
+#: src/pv/state.c:42
+msgid "history structure allocation failed"
+msgstr ""
+
+#: src/pv/state.c:794 src/pv/state.c:806
+msgid "file list allocation failed"
+msgstr ""
+
+#: src/pv/transfer.c:490
+msgid "read failed"
+msgstr ""
+
+#: src/pv/transfer.c:506
+msgid "warning: read errors detected"
+msgstr ""
+
+#: src/pv/transfer.c:522
+msgid "file is not seekable"
+msgstr ""
+
+#: src/pv/transfer.c:599
+msgid "failed to seek past error"
+msgstr ""
+
+#: src/pv/transfer.c:619
+msgid "skipped past read error"
+msgstr ""
+
+#: src/pv/transfer.c:663
+msgid "no transfer buffer allocated"
+msgstr ""
+
+#: src/pv/transfer.c:751
+msgid "failed to set interval timer"
+msgstr ""
+
+#: src/pv/transfer.c:777
+msgid "failed to clear interval timer"
+msgstr ""
+
+#: src/pv/transfer.c:822
+msgid "line position buffer allocation failed"
+msgstr ""
+
+#: src/pv/transfer.c:996
+msgid "write failed"
+msgstr ""
+
+#: src/pv/transfer.c:1237
+msgid "select call failed"
+msgstr ""
+
+#: src/pv/watchpid.c:131 src/pv/watchpid.c:205
+msgid "not a regular file or block device"
+msgstr ""

po/fr.po

@@ -0,0 +1,626 @@
+msgid ""
+msgstr ""
+"Report-Msgid-Bugs-To: https://codeberg.org/ivarch/pv/issues\n"
+"POT-Creation-Date: 2025-10-31 19:47+0000\n"
+"PO-Revision-Date: 2025-05-31 08:58+0000\n"
+"Last-Translator: milimarg <milimarg@noreply.codeberg.org>\n"
+"Language-Team: French <https://translate.codeberg.org/projects/pv/pv/fr/>\n"
+"Language: fr\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=2; plural=n > 1;\n"
+"X-Generator: Weblate 5.11.4\n"
+"Date: 1999-06-01 15:18:29+0100\n"
+"From: Andrew Wood <ivarch@ubik>\n"
+"Xgettext-Options: --default-domain=pkgbuild --directory=./.pkgdir --add-"
+"comments --keyword=_ --keyword=N_\n"
+"Files: src/getopt/getopt.c src/getopt/getopt1.c src/version.c src/main/init."
+"c src/main/help.c src/main/xpmptr.c src/guts/load.c src/guts/stop.c src/guts/"
+"configure.c src/guts/make.c src/guts/install.c src/guts/prefs.c src/ui/"
+"generate.c src/ui/main.c src/ui/xpm.c src/ui/status.c src/ui/activate.c src/"
+"ui/handlers/main.c src/ui/handlers/package.c src/ui/handlers/prefs.c src/ui/"
+"handlers/dirsel.c src/ui/handlers/popup.c src/ui/handlers/help.c src/ui/"
+"textout.c src/ui/report.c src/ui/callback.c src/nls/intl/bindtextdom.c src/"
+"nls/intl/dcgettext.c src/nls/intl/dgettext.c src/nls/intl/finddomain.c src/"
+"nls/intl/gettext.c src/nls/intl/loadmsgcat.c src/nls/intl/localealias.c src/"
+"nls/intl/textdomain.c src/nls/intl-cat/cat-compat.c src/nls/intl-gett/intl-"
+"compat.c\n"
+
+#: src/main/help.c:236
+msgid "show progress bar"
+msgstr "afficher la barre de progression"
+
+#: src/main/help.c:239
+msgid "show elapsed time"
+msgstr "afficher le temps écoulé"
+
+#: src/main/help.c:242
+msgid "show estimated time of arrival (completion)"
+msgstr "afficher l'heure approximative de l'achèvement de la tâche"
+
+#: src/main/help.c:245
+msgid "show absolute estimated time of arrival (completion)"
+msgstr "afficher l'heure absolute de l'achèvement de la tâche"
+
+#: src/main/help.c:248
+msgid "show data transfer rate counter"
+msgstr "afficher le taux de tranfert des données"
+
+#: src/main/help.c:251
+msgid "show data transfer average rate counter"
+msgstr "afficher le compteur de taux moyen de transfert de données"
+
+#: src/main/help.c:254
+msgid "show number of bytes transferred"
+msgstr "afficher le nombre d'octets transférés"
+
+#: src/main/help.c:257
+msgid "show percentage of transfer buffer in use"
+msgstr "afficher le pourcentage de tampon de transfert utilisé"
+
+#: src/main/help.c:259
+msgid "NUM"
+msgstr "NUM"
+
+#: src/main/help.c:260
+msgid "show NUM bytes last written"
+msgstr "afficher les derniers NUM octets écrits"
+
+#: src/main/help.c:262
+msgid "FORMAT"
+msgstr "FORMAT"
+
+#: src/main/help.c:263
+msgid "set output format to FORMAT"
+msgstr "définir le format de sortie sur FORMAT"
+
+#: src/main/help.c:266
+msgid "output percentages, not visual information"
+msgstr "imprimer en pourcentage plutôt que des informations visuelles"
+
+#: src/main/help.c:269
+msgid "do not output any transfer information at all"
+msgstr "n'afficher aucune information de transfert"
+
+#: src/main/help.c:273
+msgid "show number of bits transferred"
+msgstr "afficher le nombre de bits transférés"
+
+#: src/main/help.c:276
+msgid "treat suffixes as multiples of 1000 rather than 1024"
+msgstr "traiter les suffixes comme des multiples de 1000 au lieu de 1024"
+
+#: src/main/help.c:279
+msgid "display nothing until first byte transferred"
+msgstr "ne rien afficher avant qu'au moins un octet soit tranféré"
+
+#: src/main/help.c:281 src/main/help.c:296 src/main/help.c:299
+msgid "SEC"
+msgstr "SEC"
+
+#: src/main/help.c:282
+msgid "display nothing until SEC seconds have passed"
+msgstr "ne rien afficher jusqu'à ce que SEC secondes se soient écoulées"
+
+#: src/main/help.c:284
+msgid "SIZE"
+msgstr "TAILLE"
+
+#: src/main/help.c:285
+msgid "set estimated data size to SIZE bytes"
+msgstr "ajuster la taille estimée des données à TAILLE octets"
+
+#: src/main/help.c:288
+msgid "if size unknown, show rate vs max rate"
+msgstr ""
+"si la taille est inconnue, afficher le taux de transfert par rapport au taux "
+"de transfert max"
+
+#: src/main/help.c:291
+msgid "count lines instead of bytes"
+msgstr "compter les lignes au lieu des octets"
+
+#: src/main/help.c:294
+msgid "lines are null-terminated"
+msgstr "les lignes sont terminées par un caractère nul"
+
+#: src/main/help.c:297
+msgid "update every SEC seconds"
+msgstr "mettre à jour toutes les SEC secondes"
+
+#: src/main/help.c:300
+msgid "compute average rate over past SEC seconds (default 30s)"
+msgstr ""
+"calculer le taux moyen d'après les SEC dernières secondes (30s par défaut)"
+
+#: src/main/help.c:302
+msgid "WIDTH"
+msgstr "LARGEUR"
+
+#: src/main/help.c:303
+msgid "assume terminal is WIDTH characters wide"
+msgstr "présumer la largeur du terminal à LARGEUR caractères"
+
+#: src/main/help.c:305
+msgid "HEIGHT"
+msgstr "HAUTEUR"
+
+#: src/main/help.c:306
+msgid "assume terminal is HEIGHT rows high"
+msgstr "présumer la hauteur du terminal à HAUTEUR lignes"
+
+#: src/main/help.c:308
+msgid "NAME"
+msgstr "NOM"
+
+#: src/main/help.c:309
+msgid "prefix visual information with NAME"
+msgstr "préfixer les informations visuelles avec NOM"
+
+#: src/main/help.c:311
+msgid "STYLE"
+msgstr "STYLE"
+
+#: src/main/help.c:312
+msgid "set default bar style to NAME"
+msgstr "définir le style de barre par défaut à NOM"
+
+#: src/main/help.c:314
+msgid "SPEC"
+msgstr "SPÉCIFICATION"
+
+#: src/main/help.c:315
+msgid "also send progress to SPEC"
+msgstr "aussi envoyer la progression à SPÉCIFICATION"
+
+#: src/main/help.c:318
+msgid "output transfer statistics at the end"
+msgstr "afficher les statistiques de transfert à la fin"
+
+#: src/main/help.c:321
+msgid "output even if standard error is not a terminal"
+msgstr ""
+"imprimer vers la sortie d'erreur standard même si ce n'est pas un terminal"
+
+#: src/main/help.c:324
+msgid "use cursor positioning escape sequences"
+msgstr "utiliser les séquences d'échappements de positionnement de curseur"
+
+#: src/main/help.c:327 src/main/help.c:360 src/main/help.c:376
+#: src/main/help.c:386
+msgid "FILE"
+msgstr "FICHIER"
+
+#: src/main/help.c:328
+msgid "write output to FILE instead of stdout"
+msgstr "écrire la sortie dans FICHIER au lieu de la sortie standard"
+
+#: src/main/help.c:330
+msgid "RATE"
+msgstr "TAUX"
+
+#: src/main/help.c:331
+msgid "limit transfer to RATE bytes per second"
+msgstr "limite le taux de transfert à TAUX octets par seconde"
+
+#: src/main/help.c:333 src/main/help.c:342
+msgid "BYTES"
+msgstr "OCTETS"
+
+#: src/main/help.c:334
+msgid "use a buffer size of BYTES"
+msgstr "Utiliser une mémoire tampon de OCTETS octets"
+
+#: src/main/help.c:337
+msgid "never use splice(), always use read/write"
+msgstr "ne jamais utiliser splice(), toujours utiliser read/write"
+
+#: src/main/help.c:340
+msgid "skip read errors in input"
+msgstr "ignorer les erreurs de lecture dans l'entrée"
+
+#: src/main/help.c:343
+msgid "skip errors in BYTES blocks at a time"
+msgstr "ignorer les erreurs dans OCTETS blocs à la fois"
+
+#: src/main/help.c:346
+msgid "stop after --size bytes have been transferred"
+msgstr "arrêter après le transfert de --size octets"
+
+#: src/main/help.c:349
+msgid "flush cache to disk after every write"
+msgstr "vider le cache sur le disque après chaque écriture"
+
+#: src/main/help.c:352
+msgid "use direct I/O to bypass cache"
+msgstr "utiliser les E/S directes pour contourner le cache"
+
+#: src/main/help.c:355
+msgid "try to seek instead of writing null bytes"
+msgstr ""
+
+#: src/main/help.c:358
+msgid "discard input instead of writing to output"
+msgstr "rejeter l'entrée au lieu de l'écrire vers la sortie"
+
+#: src/main/help.c:361
+msgid "write all input to FILE before writing to output"
+msgstr "écrire toute l'entrée vers FICHIER avant de l'écrire vers la sortie"
+
+#: src/main/help.c:364
+msgid "PID[:FD]|=NAME|@LISTFILE"
+msgstr ""
+
+#: src/main/help.c:365
+msgid "watch file FD opened by process PID"
+msgstr "surveiller le fichier FD ouvert par le processus PID"
+
+#: src/main/help.c:368 src/main/help.c:371
+msgid "PID"
+msgstr "PID"
+
+#: src/main/help.c:369
+msgid "update settings of process PID"
+msgstr "mettre à jour la configuration du processus PID"
+
+#: src/main/help.c:372
+msgid "show progress of process PID"
+msgstr ""
+
+#: src/main/help.c:377
+msgid "save process ID in FILE"
+msgstr "enregistrer l'ID de processus dans FICHIER"
+
+#: src/main/help.c:380
+msgid "show this help and exit"
+msgstr "afficher cette aide puis quitter"
+
+#: src/main/help.c:383
+msgid "show version information and exit"
+msgstr "afficher la version puis quitter"
+
+#: src/main/help.c:387
+msgid "write debug logs to FILE"
+msgstr "écrire les journaux de déboggage vers FICHIER"
+
+#: src/main/help.c:413
+#, c-format
+msgid "Usage: %s [OPTION] [FILE]..."
+msgstr "Utilisation : %s [OPTIONS] [FICHIER]..."
+
+#: src/main/help.c:424
+msgid ""
+"Concatenate FILE(s), or standard input, to standard output, with monitoring."
+msgstr ""
+"Concaténer FICHIER(s), ou l'entrée standard, sur la sortie standard avec "
+"monitorage."
+
+#: src/main/help.c:562
+msgid "Supported format sequences:"
+msgstr "Séquences de formatage supportées :"
+
+#: src/main/help.c:576
+#, c-format
+msgid "Please report any bugs to: %s"
+msgstr "SVP rapporter tous bogues à %s"
+
+#: src/main/main.c:228
+msgid "(input)"
+msgstr "(entrée)"
+
+#: src/main/main.c:330
+msgid "state allocation failed"
+msgstr "échec de l'allocation de mémoire de condition"
+
+#: src/main/options.c:370
+msgid "list files may not contain @ lines"
+msgstr ""
+
+#: src/main/options.c:391 src/main/options.c:393 src/main/options.c:807
+msgid "process ID or pid:fd pair expected"
+msgstr "ID de processus ou paire pid:fd attendue"
+
+#: src/main/options.c:403 src/main/options.c:405 src/main/options.c:814
+msgid "invalid process ID"
+msgstr "ID de processus non valide"
+
+#: src/main/options.c:448 src/pv/file.c:342
+msgid "failed to stat file"
+msgstr "échec à statuer sur le fichier"
+
+#: src/main/options.c:462
+msgid "is a directory"
+msgstr "est un répertoire"
+
+#: src/main/options.c:491
+msgid "failed to generate sysfs filename"
+msgstr "échec de génération du nom de fichier sysfs"
+
+#: src/main/options.c:513
+msgid "failed to read sysfs size file"
+msgstr "échec de la lecture de la taille du fichier sysfs"
+
+#: src/main/options.c:533
+msgid "failed to open block device"
+msgstr "échec de l'ouverture du périphérique de bloc"
+
+#: src/main/options.c:543
+msgid "failed to determine size of block device"
+msgstr "échec de l'évaluation de la taille du périphérique de bloc"
+
+#: src/main/options.c:652
+msgid "option structure allocation failed"
+msgstr "l'allocation pour la structure d'une option a échoué"
+
+#: src/main/options.c:671
+msgid "option structure argv allocation failed"
+msgstr "l'allocation pour la structure de l'option argv a échoué"
+
+#: src/main/options.c:723
+msgid "numeric value not understood"
+msgstr "valeur numérique non comprise"
+
+#: src/main/options.c:743
+msgid "integer argument expected"
+msgstr "Valeur entière attendue"
+
+#: src/main/options.c:755
+msgid "numeric argument expected"
+msgstr "Valeur numérique attendue"
+
+#: src/main/options.c:767
+msgid "missing filename"
+msgstr ""
+
+#: src/main/options.c:795
+msgid "missing process name"
+msgstr ""
+
+#: src/main/options.c:1056
+#, c-format
+msgid "Try `%s --help' for more information."
+msgstr "Essayez `%s --help' pour plus d'informations."
+
+#: src/main/options.c:1058
+#, c-format
+msgid "Try `%s -h' for more information."
+msgstr "Essayez `%s -h' pour plus d'informations."
+
+#: src/main/options.c:1089
+msgid ""
+"cannot use line mode or transfer modifier options when watching file "
+"descriptors"
+msgstr ""
+"impossible d'utiliser le mode ligne ou les options de modificateur de "
+"transfert lors de la visualisation des descripteurs de fichiers"
+
+#: src/main/options.c:1098
+msgid "cannot use cursor positioning when watching file descriptors"
+msgstr ""
+"impossible d'utiliser le positionnement du curseur lors de la visualisation "
+"des descripteurs de fichier"
+
+#: src/main/options.c:1107
+msgid "cannot use remote control when watching file descriptors"
+msgstr ""
+"impossible d'utiliser la télécommande lors de la visualisation des "
+"descripteurs de fichiers"
+
+#: src/main/options.c:1116
+msgid "cannot use remote query when watching file descriptors"
+msgstr ""
+
+#: src/main/options.c:1125
+msgid "cannot transfer files when watching file descriptors"
+msgstr ""
+"impossible de transférer des fichiers lorsque vous regardez des descripteurs "
+"de fichiers"
+
+#: src/main/options.c:1150
+msgid "not available on systems without /proc/self/fdinfo"
+msgstr "non disponible sur les systèmes sans /proc/self/fdinfo"
+
+#: src/main/options.c:1162
+msgid "cannot use remote control and remote query together"
+msgstr ""
+
+#: src/main/options.c:1189
+msgid "files cannot be specified with this option"
+msgstr ""
+
+#: src/main/version.c:28
+msgid "License: GPLv3+ <https://www.gnu.org/licenses/gpl-3.0.html>"
+msgstr "License : GPLv3+ <https://www.gnu.org/licenses/gpl-3.0.html>"
+
+#: src/main/version.c:29
+msgid "This is free software: you are free to change and redistribute it."
+msgstr ""
+"Ceci est un logiciel libre : vous êtes libre de le modifier et de le "
+"redistribuer."
+
+#: src/main/version.c:30
+msgid "There is NO WARRANTY, to the extent permitted by law."
+msgstr "Il n'y a AUCUNE GARANTIE, dans la mesure permise par la loi."
+
+#: src/main/version.c:32
+msgid "Project web site"
+msgstr "Site web du projet"
+
+#: src/pv/cursor.c:61
+msgid "failed to get terminal name"
+msgstr "échec de lecture du nom du terminal"
+
+#: src/pv/cursor.c:106
+msgid "failed to open lock file"
+msgstr "échec de l'ouverture du fichier de verrouillage"
+
+#: src/pv/cursor.c:139
+msgid "lock attempt failed"
+msgstr "échec de la tentative de verrouillage"
+
+#: src/pv/cursor.c:400
+msgid "failed to open terminal"
+msgstr "échec de l'ouverture du terminal"
+
+#: src/pv/display.c:285
+msgid "yzafpnum kMGTPEZY"
+msgstr "yzafpnum kMGTPEZY"
+
+#: src/pv/display.c:303
+msgid "yzafpnum KMGTPEZY"
+msgstr "yzafpnum KMGTPEZY"
+
+#: src/pv/display.c:1053 src/pv/state.c:842 src/pv/transfer.c:1135
+msgid "buffer allocation failed"
+msgstr "échec de l'allocation de mémoire tampon"
+
+#: src/pv/file.c:153
+msgid "failed to seek to start of output"
+msgstr "ne peut pas passer au début de la sortie"
+
+#: src/pv/file.c:303
+msgid "failed to close file"
+msgstr "la fermeture du fichier a échoué"
+
+#: src/pv/file.c:335
+msgid "failed to read file"
+msgstr "la lecture du fichier a échoué"
+
+#: src/pv/file.c:350
+msgid "failed to stat output file"
+msgstr "échec à statuer sur le fichier de sortie"
+
+#: src/pv/file.c:372
+msgid "input file is output file"
+msgstr "fichiers d'entré et de sortie sont les mêmes"
+
+#: src/pv/file.c:429
+msgid "(none)"
+msgstr "(aucun)"
+
+#: src/pv/file.c:431
+msgid "(stdin)"
+msgstr "(stdin)"
+
+#: src/pv/format/averagerate.c:34 src/pv/format/progressbar.c:92
+#: src/pv/format/rate.c:36 src/pv/loop.c:121
+msgid "b/s"
+msgstr "b/s"
+
+#: src/pv/format/averagerate.c:38 src/pv/format/progressbar.c:96
+#: src/pv/format/rate.c:40
+msgid "/s"
+msgstr "/s"
+
+#: src/pv/format/averagerate.c:38 src/pv/format/progressbar.c:96
+#: src/pv/format/rate.c:40 src/pv/loop.c:121
+msgid "B/s"
+msgstr "O/s"
+
+#: src/pv/format/bytes.c:35
+msgid "b"
+msgstr "b"
+
+#: src/pv/format/bytes.c:39 src/pv/transfer.c:620
+msgid "B"
+msgstr "O"
+
+#: src/pv/format/eta.c:52 src/pv/format/eta.c:56
+msgid "ETA"
+msgstr "ETA"
+
+#: src/pv/format/fineta.c:80
+msgid "FIN"
+msgstr "FIN"
+
+#: src/pv/loop.c:120
+msgid "rate min/avg/max/mdev"
+msgstr "taux min/moy/max/écart-type"
+
+#: src/pv/loop.c:132
+msgid "rate not measured"
+msgstr "taux non mesuré"
+
+#: src/pv/loop.c:802 src/pv/loop.c:818 src/pv/loop.c:836 src/pv/watchpid.c:101
+#: src/pv/watchpid.c:110 src/pv/watchpid.c:121 src/pv/watchpid.c:129
+#: src/pv/watchpid.c:166 src/pv/watchpid.c:185 src/pv/watchpid.c:193
+#: src/pv/watchpid.c:203 src/pv/watchpid.c:307 src/pv/watchpid.c:315
+#: src/pv/watchpid.c:447 src/pv/watchpid.c:470
+msgid "pid"
+msgstr "pid"
+
+#: src/pv/loop.c:836 src/pv/watchpid.c:110 src/pv/watchpid.c:122
+#: src/pv/watchpid.c:131 src/pv/watchpid.c:185 src/pv/watchpid.c:194
+#: src/pv/watchpid.c:205
+msgid "fd"
+msgstr "fd"
+
+#: src/pv/remote.c:237 src/pv/remote.c:622
+msgid "message not received"
+msgstr "message non reçu"
+
+#: src/pv/remote.c:644 src/pv/remote.c:662
+msgid "SA_SIGINFO not supported on this system"
+msgstr "SA_SIGINFO non pris en charge sur ce système"
+
+#: src/pv/state.c:42
+msgid "history structure allocation failed"
+msgstr "l'allocation de la structure de l'historique a échoué"
+
+#: src/pv/state.c:794 src/pv/state.c:806
+msgid "file list allocation failed"
+msgstr "échec de l'allocation de la liste de fichiers"
+
+#: src/pv/transfer.c:490
+msgid "read failed"
+msgstr "la lecture a échoué"
+
+#: src/pv/transfer.c:506
+msgid "warning: read errors detected"
+msgstr "avertissement : erreurs de lecture détectées"
+
+#: src/pv/transfer.c:522
+msgid "file is not seekable"
+msgstr "ne peut pas se déplacer dans le fichier"
+
+#: src/pv/transfer.c:599
+msgid "failed to seek past error"
+msgstr "n'a pas réussi à dépasser l'erreur"
+
+#: src/pv/transfer.c:619
+msgid "skipped past read error"
+msgstr "erreur de lecture dépassée"
+
+#: src/pv/transfer.c:663
+msgid "no transfer buffer allocated"
+msgstr "aucun tampon de transfert alloué"
+
+#: src/pv/transfer.c:751
+msgid "failed to set interval timer"
+msgstr "La définition de l'intervalle du minuteur a échoué"
+
+#: src/pv/transfer.c:777
+msgid "failed to clear interval timer"
+msgstr "La réinitialisation des intervalles du minuteur a échoué"
+
+#: src/pv/transfer.c:822
+msgid "line position buffer allocation failed"
+msgstr "L'allocation de la position de la ligne de la mémoire tampon a échoué"
+
+#: src/pv/transfer.c:996
+msgid "write failed"
+msgstr "l'écriture a échoué"
+
+#: src/pv/transfer.c:1237
+msgid "select call failed"
+msgstr "l'appel de sélection a échoué"
+
+#: src/pv/watchpid.c:131 src/pv/watchpid.c:205
+msgid "not a regular file or block device"
+msgstr "pas un fichier ordinaire ou un périphérique de bloc"
+
+#~ msgid "PID[:FD]"
+#~ msgstr "PID[:FD]"
+
+#~ msgid "failed to set alarm signal handler"
+#~ msgstr "échec de la définition du gestionnaire de signal d'alarme"

po/pl.po

@@ -0,0 +1,622 @@
+# SOME DESCRIPTIVE TITLE.
+# Copyright (C) YEAR Free Software Foundation, Inc.
+# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
+#
+msgid ""
+msgstr ""
+"Project-Id-Version: PACKAGE VERSION\n"
+"Report-Msgid-Bugs-To: https://codeberg.org/ivarch/pv/issues\n"
+"POT-Creation-Date: 2025-10-31 19:47+0000\n"
+"PO-Revision-Date: 2025-10-02 13:23+0000\n"
+"Last-Translator: Coral Pink <coralpink@noreply.codeberg.org>\n"
+"Language-Team: Polish <https://translate.codeberg.org/projects/pv/pv/pl/>\n"
+"Language: pl\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=3; plural=n==1 ? 0 : n%10>=2 && n%10<=4 && (n%100<10 "
+"|| n%100>=20) ? 1 : 2;\n"
+"X-Generator: Weblate 5.13.2\n"
+
+#: src/main/help.c:236
+msgid "show progress bar"
+msgstr "pokaż pasek postępu"
+
+#: src/main/help.c:239
+msgid "show elapsed time"
+msgstr "pokaż upływający czas"
+
+#: src/main/help.c:242
+msgid "show estimated time of arrival (completion)"
+msgstr "pokaż szacowany czas ukończenia"
+
+#: src/main/help.c:245
+msgid "show absolute estimated time of arrival (completion)"
+msgstr "pokaż bezwzględny szacowany czas ukończenia"
+
+#: src/main/help.c:248
+msgid "show data transfer rate counter"
+msgstr "pokaż licznik prędkości przesyłania"
+
+#: src/main/help.c:251
+msgid "show data transfer average rate counter"
+msgstr "pokaż licznik uśrednionej prędkości przesyłania"
+
+#: src/main/help.c:254
+msgid "show number of bytes transferred"
+msgstr "pokaż ilość przesłanych bajtów"
+
+#: src/main/help.c:257
+msgid "show percentage of transfer buffer in use"
+msgstr "pokaż procentowe użycie bufora transferu"
+
+#: src/main/help.c:259
+msgid "NUM"
+msgstr "LICZBA"
+
+#: src/main/help.c:260
+msgid "show NUM bytes last written"
+msgstr "pokaż ostatnie LICZBA przesłanych bajtów"
+
+#: src/main/help.c:262
+msgid "FORMAT"
+msgstr "FORMAT"
+
+#: src/main/help.c:263
+msgid "set output format to FORMAT"
+msgstr "ustaw FORMAT jako format wyjściowy"
+
+#: src/main/help.c:266
+msgid "output percentages, not visual information"
+msgstr "wyświetl wyjście procentowo, bez graficznej prezentacji"
+
+#: src/main/help.c:269
+msgid "do not output any transfer information at all"
+msgstr "nie wyświetlaj żadnych informacji o przesyłaniu"
+
+#: src/main/help.c:273
+msgid "show number of bits transferred"
+msgstr "pokaż ilość przesłanych bitów"
+
+#: src/main/help.c:276
+msgid "treat suffixes as multiples of 1000 rather than 1024"
+msgstr "traktuj przyrostki jako wielokrotności 1000 zamiast 1024"
+
+#: src/main/help.c:279
+msgid "display nothing until first byte transferred"
+msgstr "nie wyświetlaj nic aż do pierwszego przesłanego bajtu"
+
+#: src/main/help.c:281 src/main/help.c:296 src/main/help.c:299
+msgid "SEC"
+msgstr "SEKUNDY"
+
+#: src/main/help.c:282
+msgid "display nothing until SEC seconds have passed"
+msgstr "nie wyświetlaj nic do momentu upłynięcia SEKUNDY sekund"
+
+#: src/main/help.c:284
+msgid "SIZE"
+msgstr "ROZMIAR"
+
+#: src/main/help.c:285
+msgid "set estimated data size to SIZE bytes"
+msgstr "ustaw oczekiwany rozmiar danych na ROZMIAR bajtów"
+
+#: src/main/help.c:288
+msgid "if size unknown, show rate vs max rate"
+msgstr ""
+"jeśli rozmiar nie jest znany, wyświetl zestawienie prędkości do maksymalnej "
+"prędkości"
+
+#: src/main/help.c:291
+msgid "count lines instead of bytes"
+msgstr "zliczaj linie zamiast bajty"
+
+#: src/main/help.c:294
+msgid "lines are null-terminated"
+msgstr "linie są zakończone znakiem NUL"
+
+#: src/main/help.c:297
+msgid "update every SEC seconds"
+msgstr "aktualizuj co każde SEKUNDY sekund"
+
+#: src/main/help.c:300
+msgid "compute average rate over past SEC seconds (default 30s)"
+msgstr ""
+"oblicz średnią prędkość transferu na podstawie poprzednich SEKUNDY sekund "
+"(domyślnie 30 s)"
+
+#: src/main/help.c:302
+msgid "WIDTH"
+msgstr "SZEROKOŚĆ"
+
+#: src/main/help.c:303
+msgid "assume terminal is WIDTH characters wide"
+msgstr "przyjmij, że terminal ma szerokość SZEROKOŚĆ znaków"
+
+#: src/main/help.c:305
+msgid "HEIGHT"
+msgstr "WYSOKOŚĆ"
+
+#: src/main/help.c:306
+msgid "assume terminal is HEIGHT rows high"
+msgstr "przyjmij, że terminal ma wysokość WYSOKOŚĆ linii"
+
+#: src/main/help.c:308
+msgid "NAME"
+msgstr "NAZWA"
+
+#: src/main/help.c:309
+msgid "prefix visual information with NAME"
+msgstr "poprzedź informacje prefiksem NAZWA"
+
+#: src/main/help.c:311
+msgid "STYLE"
+msgstr "STYL"
+
+#: src/main/help.c:312
+msgid "set default bar style to NAME"
+msgstr "ustaw domyślny styl paska postępu na STYL"
+
+#: src/main/help.c:314
+msgid "SPEC"
+msgstr "SPEC"
+
+#: src/main/help.c:315
+msgid "also send progress to SPEC"
+msgstr "wysyłaj postęp również do SPEC"
+
+#: src/main/help.c:318
+msgid "output transfer statistics at the end"
+msgstr "wyświetl na końcu statystyki transferu"
+
+#: src/main/help.c:321
+msgid "output even if standard error is not a terminal"
+msgstr "pokaż wyjście nawet standardowe wyjście błędu nie jest terminalem"
+
+#: src/main/help.c:324
+msgid "use cursor positioning escape sequences"
+msgstr "używaj znaków ucieczki do pozycjonowania kursora"
+
+#: src/main/help.c:327 src/main/help.c:360 src/main/help.c:376
+#: src/main/help.c:386
+msgid "FILE"
+msgstr "PLIK"
+
+#: src/main/help.c:328
+msgid "write output to FILE instead of stdout"
+msgstr "zapisz wyjście do PLIK zamiast do wyjścia standardowego"
+
+#: src/main/help.c:330
+msgid "RATE"
+msgstr "PRĘDKOŚĆ"
+
+#: src/main/help.c:331
+msgid "limit transfer to RATE bytes per second"
+msgstr "ogranicz przesyłane dane do PRĘDKOŚĆ bajtów na sekundę"
+
+#: src/main/help.c:333 src/main/help.c:342
+msgid "BYTES"
+msgstr "BAJTY"
+
+#: src/main/help.c:334
+msgid "use a buffer size of BYTES"
+msgstr "użyj bufora o rozmiarze BAJTY"
+
+#: src/main/help.c:337
+msgid "never use splice(), always use read/write"
+msgstr "nigdy nie używaj splice(), zawsze używaj read/write"
+
+#: src/main/help.c:340
+msgid "skip read errors in input"
+msgstr "pomijaj błędy odczytu wejścia"
+
+#: src/main/help.c:343
+msgid "skip errors in BYTES blocks at a time"
+msgstr "pomijaj błędy w blokach po BAJTY bajtów na raz"
+
+#: src/main/help.c:346
+msgid "stop after --size bytes have been transferred"
+msgstr "zakończ po przesłaniu --size bajtów"
+
+#: src/main/help.c:349
+msgid "flush cache to disk after every write"
+msgstr "wymuś zapis pamięci podręcznej na dysk po każdym zapisie"
+
+#: src/main/help.c:352
+msgid "use direct I/O to bypass cache"
+msgstr ""
+"użyj bezpośredniego wejścia/wyjścia celem pominięcia pamięci podręcznej"
+
+#: src/main/help.c:355
+msgid "try to seek instead of writing null bytes"
+msgstr ""
+
+#: src/main/help.c:358
+msgid "discard input instead of writing to output"
+msgstr "zignoruj dane wejściowe zamiast wyświetlić je na wyjściu standardowym"
+
+#: src/main/help.c:361
+msgid "write all input to FILE before writing to output"
+msgstr ""
+"zapisz wszystkie dane wejściowe do PLIK przed wyświetleniem ich na wyjściu"
+
+#: src/main/help.c:364
+msgid "PID[:FD]|=NAME|@LISTFILE"
+msgstr ""
+
+#: src/main/help.c:365
+msgid "watch file FD opened by process PID"
+msgstr "obserwuj plik FD otworzony przez proces PID"
+
+#: src/main/help.c:368 src/main/help.c:371
+msgid "PID"
+msgstr "PID"
+
+#: src/main/help.c:369
+msgid "update settings of process PID"
+msgstr "zaktualizuj ustawienia procesu PID"
+
+#: src/main/help.c:372
+msgid "show progress of process PID"
+msgstr ""
+
+#: src/main/help.c:377
+msgid "save process ID in FILE"
+msgstr "zapisz ID procesu do PLIK"
+
+#: src/main/help.c:380
+msgid "show this help and exit"
+msgstr "wyświetl te informacje z pomocą i wyjdź"
+
+#: src/main/help.c:383
+msgid "show version information and exit"
+msgstr "wyświetl informacje o wersji i wyjdź"
+
+#: src/main/help.c:387
+msgid "write debug logs to FILE"
+msgstr "zapisz logi debugujące do PLIK"
+
+#: src/main/help.c:413
+#, c-format
+msgid "Usage: %s [OPTION] [FILE]..."
+msgstr "Sposób użycia: %s [OPCJA] [PLIK]..."
+
+#: src/main/help.c:424
+msgid ""
+"Concatenate FILE(s), or standard input, to standard output, with monitoring."
+msgstr ""
+"Łączenie PLIK(ów) lub wejścia standardowego, do wyjścia standardowego z "
+"monitoringiem."
+
+#: src/main/help.c:562
+msgid "Supported format sequences:"
+msgstr "Wspierane sekwencje formatowania:"
+
+#: src/main/help.c:576
+#, c-format
+msgid "Please report any bugs to: %s"
+msgstr "Proszę przesyłać zgłoszenia błędów do %s"
+
+#: src/main/main.c:228
+msgid "(input)"
+msgstr "(wejście)"
+
+#: src/main/main.c:330
+msgid "state allocation failed"
+msgstr "alokacja stanu programu nie powiodła się"
+
+#: src/main/options.c:370
+msgid "list files may not contain @ lines"
+msgstr ""
+
+#: src/main/options.c:391 src/main/options.c:393 src/main/options.c:807
+msgid "process ID or pid:fd pair expected"
+msgstr "oczekiwany proces ID lub para PID:FD"
+
+#: src/main/options.c:403 src/main/options.c:405 src/main/options.c:814
+msgid "invalid process ID"
+msgstr "niepoprawne ID procesu"
+
+#: src/main/options.c:448 src/pv/file.c:342
+msgid "failed to stat file"
+msgstr "nie udało się wykonać operacji stat na pliku"
+
+#: src/main/options.c:462
+msgid "is a directory"
+msgstr "jest katalogiem"
+
+#: src/main/options.c:491
+msgid "failed to generate sysfs filename"
+msgstr "nie udało się wygenerować nazwy pliku dla sysfs"
+
+#: src/main/options.c:513
+msgid "failed to read sysfs size file"
+msgstr "nie udało się odczytać rozmiaru pliku sysfs"
+
+#: src/main/options.c:533
+msgid "failed to open block device"
+msgstr "nie udało się otworzyć urządzenia blokowego"
+
+#: src/main/options.c:543
+msgid "failed to determine size of block device"
+msgstr "nie udało się ustalić rozmiaru urządzenia blokowego"
+
+#: src/main/options.c:652
+msgid "option structure allocation failed"
+msgstr "nie udało się zaalokować struktur opcji"
+
+#: src/main/options.c:671
+msgid "option structure argv allocation failed"
+msgstr "nie udało się zaalokować struktur opcji argv"
+
+#: src/main/options.c:723
+msgid "numeric value not understood"
+msgstr "wartość liczbowa niezrozumiana"
+
+#: src/main/options.c:743
+msgid "integer argument expected"
+msgstr "oczekiwany argument typu liczby całkowitej"
+
+#: src/main/options.c:755
+msgid "numeric argument expected"
+msgstr "oczekiwany argument liczbowy"
+
+#: src/main/options.c:767
+msgid "missing filename"
+msgstr ""
+
+#: src/main/options.c:795
+msgid "missing process name"
+msgstr ""
+
+#: src/main/options.c:1056
+#, c-format
+msgid "Try `%s --help' for more information."
+msgstr "Spróbuj `%s --help' by uzyskać więcej informacji."
+
+#: src/main/options.c:1058
+#, c-format
+msgid "Try `%s -h' for more information."
+msgstr "Spróbuj `%s -h' by uzyskać więcej informacji."
+
+#: src/main/options.c:1089
+msgid ""
+"cannot use line mode or transfer modifier options when watching file "
+"descriptors"
+msgstr ""
+"nie można użyć trybu zliczania linii lub opcji modyfikujących przesył "
+"łącznie z opcją obserwowania deskryptorów plików"
+
+#: src/main/options.c:1098
+msgid "cannot use cursor positioning when watching file descriptors"
+msgstr ""
+"nie można użyć pozycjonowania kursora łącznie z opcją obserwowania "
+"deskryptorów plików"
+
+#: src/main/options.c:1107
+msgid "cannot use remote control when watching file descriptors"
+msgstr ""
+"nie można użyć opcji zaktualizowania ustawień procesu łącznie z opcją "
+"obserwowania deskryptorów plików"
+
+#: src/main/options.c:1116
+msgid "cannot use remote query when watching file descriptors"
+msgstr ""
+
+#: src/main/options.c:1125
+msgid "cannot transfer files when watching file descriptors"
+msgstr "nie można przesyłać plików z opcją obserwowania deskryptorów plików"
+
+#: src/main/options.c:1150
+msgid "not available on systems without /proc/self/fdinfo"
+msgstr "niedostępne na systemach bez /proc/self/fdinfo"
+
+#: src/main/options.c:1162
+msgid "cannot use remote control and remote query together"
+msgstr ""
+
+#: src/main/options.c:1189
+msgid "files cannot be specified with this option"
+msgstr ""
+
+#: src/main/version.c:28
+msgid "License: GPLv3+ <https://www.gnu.org/licenses/gpl-3.0.html>"
+msgstr "Licencja: GPLv3+ <https://www.gnu.org/licenses/gpl-3.0.html>"
+
+#: src/main/version.c:29
+msgid "This is free software: you are free to change and redistribute it."
+msgstr "To jest wolne oprogramowanie: masz prawo do zmian i redystrybucji."
+
+#: src/main/version.c:30
+msgid "There is NO WARRANTY, to the extent permitted by law."
+msgstr "Nie udziela się GWARANCJI w zakresie dozwolonym przez prawo."
+
+#: src/main/version.c:32
+msgid "Project web site"
+msgstr "Strona projektu"
+
+#: src/pv/cursor.c:61
+msgid "failed to get terminal name"
+msgstr "nie udało się uzyskać nazwy terminala"
+
+# "Przewidywany czas ukończenia" for ETA is too long
+#: src/pv/cursor.c:106
+msgid "failed to open lock file"
+msgstr "nie udało się otworzyć pliku blokowania zasobów"
+
+#: src/pv/cursor.c:139
+msgid "lock attempt failed"
+msgstr "blokada zasobów nie powiodła się"
+
+#: src/pv/cursor.c:400
+msgid "failed to open terminal"
+msgstr "nie udało się otworzyć terminala"
+
+#: src/pv/display.c:285
+msgid "yzafpnum kMGTPEZY"
+msgstr "yzafpnum kMGTPEZY"
+
+#: src/pv/display.c:303
+msgid "yzafpnum KMGTPEZY"
+msgstr "yzafpnum KMGTPEZY"
+
+#: src/pv/display.c:1053 src/pv/state.c:842 src/pv/transfer.c:1135
+msgid "buffer allocation failed"
+msgstr "nie udało się zaalokować bufora"
+
+#: src/pv/file.c:153
+msgid "failed to seek to start of output"
+msgstr "nie udało się przewinąć wyjścia do początku"
+
+# "Przewidywany czas ukończenia" for ETA is too long
+#: src/pv/file.c:303
+msgid "failed to close file"
+msgstr "nie udało się zamknąć pliku"
+
+#: src/pv/file.c:335
+msgid "failed to read file"
+msgstr "nie udało się odczytać pliku"
+
+#: src/pv/file.c:350
+msgid "failed to stat output file"
+msgstr "nie udało się wykonać operacji stat na pliku wyjściowym"
+
+#: src/pv/file.c:372
+msgid "input file is output file"
+msgstr "plik wejściowy jest zarazem plikiem wyjściowym"
+
+#: src/pv/file.c:429
+msgid "(none)"
+msgstr "(brak)"
+
+#: src/pv/file.c:431
+msgid "(stdin)"
+msgstr "(stdin)"
+
+#: src/pv/format/averagerate.c:34 src/pv/format/progressbar.c:92
+#: src/pv/format/rate.c:36 src/pv/loop.c:121
+msgid "b/s"
+msgstr "b/s"
+
+#: src/pv/format/averagerate.c:38 src/pv/format/progressbar.c:96
+#: src/pv/format/rate.c:40
+msgid "/s"
+msgstr "/s"
+
+#: src/pv/format/averagerate.c:38 src/pv/format/progressbar.c:96
+#: src/pv/format/rate.c:40 src/pv/loop.c:121
+msgid "B/s"
+msgstr "B/s"
+
+#: src/pv/format/bytes.c:35
+msgid "b"
+msgstr "b"
+
+#: src/pv/format/bytes.c:39 src/pv/transfer.c:620
+msgid "B"
+msgstr "B"
+
+#: src/pv/format/eta.c:52 src/pv/format/eta.c:56
+msgid "ETA"
+msgstr "ETA"
+
+#: src/pv/format/fineta.c:80
+msgid "FIN"
+msgstr "FIN"
+
+#: src/pv/loop.c:120
+msgid "rate min/avg/max/mdev"
+msgstr "prędkość min/śr/max/odch"
+
+#: src/pv/loop.c:132
+msgid "rate not measured"
+msgstr "prędkość niezmierzona"
+
+#: src/pv/loop.c:802 src/pv/loop.c:818 src/pv/loop.c:836 src/pv/watchpid.c:101
+#: src/pv/watchpid.c:110 src/pv/watchpid.c:121 src/pv/watchpid.c:129
+#: src/pv/watchpid.c:166 src/pv/watchpid.c:185 src/pv/watchpid.c:193
+#: src/pv/watchpid.c:203 src/pv/watchpid.c:307 src/pv/watchpid.c:315
+#: src/pv/watchpid.c:447 src/pv/watchpid.c:470
+msgid "pid"
+msgstr "pid"
+
+#: src/pv/loop.c:836 src/pv/watchpid.c:110 src/pv/watchpid.c:122
+#: src/pv/watchpid.c:131 src/pv/watchpid.c:185 src/pv/watchpid.c:194
+#: src/pv/watchpid.c:205
+msgid "fd"
+msgstr "fd"
+
+#: src/pv/remote.c:237 src/pv/remote.c:622
+msgid "message not received"
+msgstr "wiadomość nieodebrana"
+
+#: src/pv/remote.c:644 src/pv/remote.c:662
+msgid "SA_SIGINFO not supported on this system"
+msgstr "SA_SIGINFO nie jest wspierane na tym systemie"
+
+#: src/pv/state.c:42
+msgid "history structure allocation failed"
+msgstr "nie udało się zaalokować struktury historii"
+
+#: src/pv/state.c:794 src/pv/state.c:806
+msgid "file list allocation failed"
+msgstr "nie udało się zaalokować listy plików"
+
+#: src/pv/transfer.c:490
+msgid "read failed"
+msgstr "błąd odczytu"
+
+#: src/pv/transfer.c:506
+msgid "warning: read errors detected"
+msgstr "ostrzeżenie: błędy odczytu wykryte"
+
+#: src/pv/transfer.c:522
+msgid "file is not seekable"
+msgstr "pliku nie da się przewijać"
+
+#: src/pv/transfer.c:599
+msgid "failed to seek past error"
+msgstr "nie udało się przewinąć za błąd"
+
+#: src/pv/transfer.c:619
+msgid "skipped past read error"
+msgstr "pominięto błąd odczytu"
+
+#: src/pv/transfer.c:663
+msgid "no transfer buffer allocated"
+msgstr "brak zaalokowanego bufora transferu"
+
+#: src/pv/transfer.c:751
+msgid "failed to set interval timer"
+msgstr "nie udało się ustawić interwału czasowego"
+
+# "Przewidywany czas ukończenia" for ETA is too long
+#: src/pv/transfer.c:777
+msgid "failed to clear interval timer"
+msgstr "nie udało się wyczyścić interwału czasowego"
+
+#: src/pv/transfer.c:822
+msgid "line position buffer allocation failed"
+msgstr "alokacja buforu pozycji linii nie powiodła się"
+
+#: src/pv/transfer.c:996
+msgid "write failed"
+msgstr "błąd zapisu"
+
+#: src/pv/transfer.c:1237
+msgid "select call failed"
+msgstr "nie udało się wywołać funkcji select"
+
+#: src/pv/watchpid.c:131 src/pv/watchpid.c:205
+msgid "not a regular file or block device"
+msgstr "plik nie jest plikiem regularnym lub urządzeniem blokowym"
+
+#~ msgid "process list allocation failed"
+#~ msgstr "nie udało się zaalokować listy procesów"
+
+#~ msgid "file descriptor list allocation failed"
+#~ msgstr "nie udało się zaalokować listy deskryptorów plików"
+
+#~ msgid "PID[:FD]"
+#~ msgstr "PID[:FD]"

po/ru.po

@@ -0,0 +1,597 @@
+msgid ""
+msgstr ""
+"Report-Msgid-Bugs-To: https://codeberg.org/ivarch/pv/issues\n"
+"POT-Creation-Date: 2025-10-31 19:47+0000\n"
+"PO-Revision-Date: 2025-01-15 19:08+0000\n"
+"Last-Translator: 0ko <0ko@users.noreply.translate.codeberg.org>\n"
+"Language-Team: Russian <https://translate.codeberg.org/projects/pv/pv/ru/>\n"
+"Language: ru\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=3; plural=n%10==1 && n%100!=11 ? 0 : n%10>=2 && "
+"n%10<=4 && (n%100<10 || n%100>=20) ? 1 : 2;\n"
+"X-Generator: Weblate 5.9.2\n"
+
+#: src/main/help.c:236
+msgid "show progress bar"
+msgstr "показать полосу прогресса"
+
+#: src/main/help.c:239
+msgid "show elapsed time"
+msgstr "показать прошедшее время"
+
+#: src/main/help.c:242
+msgid "show estimated time of arrival (completion)"
+msgstr "показать примерное время завершения"
+
+#: src/main/help.c:245
+msgid "show absolute estimated time of arrival (completion)"
+msgstr "показать примерное абсолютное время завершения"
+
+#: src/main/help.c:248
+msgid "show data transfer rate counter"
+msgstr "показать скорость передачи данных"
+
+#: src/main/help.c:251
+msgid "show data transfer average rate counter"
+msgstr "показать среднюю скорость передачи данных"
+
+#: src/main/help.c:254
+msgid "show number of bytes transferred"
+msgstr "показать объём переданных данных в байтах"
+
+#: src/main/help.c:257
+msgid "show percentage of transfer buffer in use"
+msgstr "показать использование буфера передачи в процентах"
+
+#: src/main/help.c:259
+msgid "NUM"
+msgstr "КОЛ"
+
+#: src/main/help.c:260
+msgid "show NUM bytes last written"
+msgstr "показать КОЛ байт, переданных в последний раз"
+
+#: src/main/help.c:262
+msgid "FORMAT"
+msgstr "ФОРМАТ"
+
+#: src/main/help.c:263
+msgid "set output format to FORMAT"
+msgstr "указать формат вывода как ФОРМАТ"
+
+#: src/main/help.c:266
+msgid "output percentages, not visual information"
+msgstr "показать проценты вместо визуальной информации"
+
+#: src/main/help.c:269
+msgid "do not output any transfer information at all"
+msgstr "не отображать никакую информацию о передаче"
+
+#: src/main/help.c:273
+msgid "show number of bits transferred"
+msgstr "показать объём переданных данных в битах"
+
+#: src/main/help.c:276
+msgid "treat suffixes as multiples of 1000 rather than 1024"
+msgstr "считать суффиксы как умножители на 1000, а не на 1024"
+
+#: src/main/help.c:279
+msgid "display nothing until first byte transferred"
+msgstr "ничего не показывать, пока не будет передан первый байт"
+
+#: src/main/help.c:281 src/main/help.c:296 src/main/help.c:299
+msgid "SEC"
+msgstr "СЕК"
+
+#: src/main/help.c:282
+msgid "display nothing until SEC seconds have passed"
+msgstr "ничего не показывать, пока не пройдёт СЕК секунд"
+
+#: src/main/help.c:284
+msgid "SIZE"
+msgstr "РАЗМ"
+
+#: src/main/help.c:285
+msgid "set estimated data size to SIZE bytes"
+msgstr "указать ожидаемый объём данных как РАЗМ байт"
+
+#: src/main/help.c:288
+msgid "if size unknown, show rate vs max rate"
+msgstr "если объём неизвестен, показать скорость и макс. скорость"
+
+#: src/main/help.c:291
+msgid "count lines instead of bytes"
+msgstr "считать линии вместо байт"
+
+#: src/main/help.c:294
+msgid "lines are null-terminated"
+msgstr "строки прерываются нулями"
+
+#: src/main/help.c:297
+msgid "update every SEC seconds"
+msgstr "обновлять каждые СЕК секунд"
+
+#: src/main/help.c:300
+msgid "compute average rate over past SEC seconds (default 30s)"
+msgstr "вычислять среднюю скорость за последние СЕК секунд (по умолчанию 30)"
+
+#: src/main/help.c:302
+msgid "WIDTH"
+msgstr "ШИРИНА"
+
+#: src/main/help.c:303
+msgid "assume terminal is WIDTH characters wide"
+msgstr "считать, что в одной строке помещается ШИРИНА символов"
+
+#: src/main/help.c:305
+msgid "HEIGHT"
+msgstr "ВЫСОТА"
+
+#: src/main/help.c:306
+msgid "assume terminal is HEIGHT rows high"
+msgstr "считать, что на экране помещается ВЫСОТА строк"
+
+#: src/main/help.c:308
+msgid "NAME"
+msgstr "ИМЯ"
+
+#: src/main/help.c:309
+msgid "prefix visual information with NAME"
+msgstr "писать ИМЯ до визуальной информации"
+
+#: src/main/help.c:311
+msgid "STYLE"
+msgstr "СТИЛЬ"
+
+#: src/main/help.c:312
+msgid "set default bar style to NAME"
+msgstr "задать стиль полоски по умолчанию как НАЗВАНИЕ"
+
+#: src/main/help.c:314
+msgid "SPEC"
+msgstr ""
+
+#: src/main/help.c:315
+msgid "also send progress to SPEC"
+msgstr ""
+
+#: src/main/help.c:318
+msgid "output transfer statistics at the end"
+msgstr "после завершения показать статистику"
+
+#: src/main/help.c:321
+msgid "output even if standard error is not a terminal"
+msgstr "вевести, даже если стд. ошибка не является терминалом"
+
+#: src/main/help.c:324
+msgid "use cursor positioning escape sequences"
+msgstr ""
+"использовать символьные последовательности для позиционирования курсора"
+
+#: src/main/help.c:327 src/main/help.c:360 src/main/help.c:376
+#: src/main/help.c:386
+msgid "FILE"
+msgstr "ФАЙЛ"
+
+#: src/main/help.c:328
+msgid "write output to FILE instead of stdout"
+msgstr "направить вывод в ФАЙЛ вместо стд. вывода"
+
+#: src/main/help.c:330
+msgid "RATE"
+msgstr "СКОР"
+
+#: src/main/help.c:331
+msgid "limit transfer to RATE bytes per second"
+msgstr "ограничить скорость передачи до СКОР байт/сек"
+
+#: src/main/help.c:333 src/main/help.c:342
+msgid "BYTES"
+msgstr "БАЙТ"
+
+#: src/main/help.c:334
+msgid "use a buffer size of BYTES"
+msgstr "использовать буфер размера БАЙТ"
+
+#: src/main/help.c:337
+msgid "never use splice(), always use read/write"
+msgstr "использовать чтение/запись вместо splice()"
+
+#: src/main/help.c:340
+msgid "skip read errors in input"
+msgstr "пропустить ошибки чтения во вводе"
+
+#: src/main/help.c:343
+msgid "skip errors in BYTES blocks at a time"
+msgstr "пропускать ошибки в <БАЙТ> блоках за раз"
+
+#: src/main/help.c:346
+msgid "stop after --size bytes have been transferred"
+msgstr "остановить после передачи --size байт"
+
+#: src/main/help.c:349
+msgid "flush cache to disk after every write"
+msgstr "сбрасывать кеш на диск каждый раз"
+
+#: src/main/help.c:352
+msgid "use direct I/O to bypass cache"
+msgstr "использовать прямой ввод/вывод для обхода кеша"
+
+#: src/main/help.c:355
+msgid "try to seek instead of writing null bytes"
+msgstr ""
+
+#: src/main/help.c:358
+msgid "discard input instead of writing to output"
+msgstr "отбрасывать ввод вместо записи в вывод"
+
+#: src/main/help.c:361
+msgid "write all input to FILE before writing to output"
+msgstr "записывать весь ввод в ФАЙЛ прежде, чем отправлять на вывод"
+
+#: src/main/help.c:364
+msgid "PID[:FD]|=NAME|@LISTFILE"
+msgstr ""
+
+#: src/main/help.c:365
+msgid "watch file FD opened by process PID"
+msgstr "следить за FD файла, открытого процессом ИДпр"
+
+#: src/main/help.c:368 src/main/help.c:371
+msgid "PID"
+msgstr "ИДпр"
+
+#: src/main/help.c:369
+msgid "update settings of process PID"
+msgstr "обновить настройки ИДпр процесса"
+
+#: src/main/help.c:372
+msgid "show progress of process PID"
+msgstr ""
+
+#: src/main/help.c:377
+msgid "save process ID in FILE"
+msgstr "сохранить ИД процесса в ФАЙЛ"
+
+#: src/main/help.c:380
+msgid "show this help and exit"
+msgstr "показать справку и завершить работу"
+
+#: src/main/help.c:383
+msgid "show version information and exit"
+msgstr "показать версию программы и завершить работу"
+
+#: src/main/help.c:387
+msgid "write debug logs to FILE"
+msgstr "вести запись отладочного журнала в ФАЙЛ"
+
+#: src/main/help.c:413
+#, c-format
+msgid "Usage: %s [OPTION] [FILE]..."
+msgstr "Использование: %s [ОПЦИИ] [ФАЙЛ]..."
+
+#: src/main/help.c:424
+msgid ""
+"Concatenate FILE(s), or standard input, to standard output, with monitoring."
+msgstr ""
+
+#: src/main/help.c:562
+msgid "Supported format sequences:"
+msgstr "Поддерживаемые последовательности:"
+
+#: src/main/help.c:576
+#, c-format
+msgid "Please report any bugs to: %s"
+msgstr "Сообщайте о проблемах на: %s"
+
+#: src/main/main.c:228
+msgid "(input)"
+msgstr "(ввод)"
+
+#: src/main/main.c:330
+msgid "state allocation failed"
+msgstr ""
+
+#: src/main/options.c:370
+msgid "list files may not contain @ lines"
+msgstr ""
+
+#: src/main/options.c:391 src/main/options.c:393 src/main/options.c:807
+msgid "process ID or pid:fd pair expected"
+msgstr "ожидался ИД процесса или пара ИДпр:ДФ"
+
+#: src/main/options.c:403 src/main/options.c:405 src/main/options.c:814
+msgid "invalid process ID"
+msgstr "неправильный ИД процесса"
+
+#: src/main/options.c:448 src/pv/file.c:342
+msgid "failed to stat file"
+msgstr "не удалось получить информацию о файле"
+
+#: src/main/options.c:462
+msgid "is a directory"
+msgstr "является каталогом"
+
+#: src/main/options.c:491
+msgid "failed to generate sysfs filename"
+msgstr "не удалось создать имя файла sysfs"
+
+#: src/main/options.c:513
+msgid "failed to read sysfs size file"
+msgstr "не удалось узнать размер файла sysfs"
+
+#: src/main/options.c:533
+msgid "failed to open block device"
+msgstr "не удалось открыть блочное устройство"
+
+#: src/main/options.c:543
+msgid "failed to determine size of block device"
+msgstr "не удалось определить размер блочного устройства"
+
+#: src/main/options.c:652
+msgid "option structure allocation failed"
+msgstr "не удалось выделить память для структуры опций"
+
+#: src/main/options.c:671
+msgid "option structure argv allocation failed"
+msgstr "не удалось выделить память для структуры опций argv"
+
+#: src/main/options.c:723
+msgid "numeric value not understood"
+msgstr "число не распознано"
+
+#: src/main/options.c:743
+msgid "integer argument expected"
+msgstr "ожидалось целое число"
+
+#: src/main/options.c:755
+msgid "numeric argument expected"
+msgstr "ожидалось число"
+
+#: src/main/options.c:767
+msgid "missing filename"
+msgstr ""
+
+#: src/main/options.c:795
+msgid "missing process name"
+msgstr ""
+
+#: src/main/options.c:1056
+#, c-format
+msgid "Try `%s --help' for more information."
+msgstr "Выполните `%s --help' для получения подробностей."
+
+#: src/main/options.c:1058
+#, c-format
+msgid "Try `%s -h' for more information."
+msgstr "Выполните `%s -h' для получения подробностей."
+
+#: src/main/options.c:1089
+msgid ""
+"cannot use line mode or transfer modifier options when watching file "
+"descriptors"
+msgstr ""
+
+#: src/main/options.c:1098
+msgid "cannot use cursor positioning when watching file descriptors"
+msgstr ""
+
+#: src/main/options.c:1107
+msgid "cannot use remote control when watching file descriptors"
+msgstr "удалённое управление невозможно при отслеживании дескрипторов файлов"
+
+#: src/main/options.c:1116
+msgid "cannot use remote query when watching file descriptors"
+msgstr ""
+
+#: src/main/options.c:1125
+msgid "cannot transfer files when watching file descriptors"
+msgstr "передача файлов невозможна при отслеживании дескрипторов файлов"
+
+#: src/main/options.c:1150
+msgid "not available on systems without /proc/self/fdinfo"
+msgstr "невозможно на системах без /proc/self/fdinfo"
+
+#: src/main/options.c:1162
+msgid "cannot use remote control and remote query together"
+msgstr ""
+
+#: src/main/options.c:1189
+msgid "files cannot be specified with this option"
+msgstr ""
+
+#: src/main/version.c:28
+msgid "License: GPLv3+ <https://www.gnu.org/licenses/gpl-3.0.html>"
+msgstr "Лицензия: GPLv3+ <https://www.gnu.org/licenses/gpl-3.0.html>"
+
+#: src/main/version.c:29
+msgid "This is free software: you are free to change and redistribute it."
+msgstr "Это свободная программа. Вы можете изменять и распространять её."
+
+#: src/main/version.c:30
+msgid "There is NO WARRANTY, to the extent permitted by law."
+msgstr ""
+"Разработчики не дают никаких гарантий, связанных с работой этой программы, "
+"насколько это юридически возможно."
+
+#: src/main/version.c:32
+msgid "Project web site"
+msgstr "Веб-сайт проекта"
+
+#: src/pv/cursor.c:61
+msgid "failed to get terminal name"
+msgstr "не удалось получить имя терминала"
+
+#: src/pv/cursor.c:106
+msgid "failed to open lock file"
+msgstr "не удалось открыть блокирующий файл"
+
+#: src/pv/cursor.c:139
+msgid "lock attempt failed"
+msgstr "попытка блокировки не удалась"
+
+#: src/pv/cursor.c:400
+msgid "failed to open terminal"
+msgstr "не удалось открыть терминал"
+
+#: src/pv/display.c:285
+msgid "yzafpnum kMGTPEZY"
+msgstr ""
+
+#: src/pv/display.c:303
+msgid "yzafpnum KMGTPEZY"
+msgstr ""
+
+#: src/pv/display.c:1053 src/pv/state.c:842 src/pv/transfer.c:1135
+msgid "buffer allocation failed"
+msgstr "не удалось выделить память для буфера"
+
+#: src/pv/file.c:153
+msgid "failed to seek to start of output"
+msgstr ""
+
+#: src/pv/file.c:303
+msgid "failed to close file"
+msgstr "не удалось закрыть файл"
+
+#: src/pv/file.c:335
+msgid "failed to read file"
+msgstr "не удалось прочесть файл"
+
+#: src/pv/file.c:350
+msgid "failed to stat output file"
+msgstr "не удалось получить информацию о выходном файле"
+
+#: src/pv/file.c:372
+msgid "input file is output file"
+msgstr "пути исходного и выходного файлов одинаковы"
+
+#: src/pv/file.c:429
+msgid "(none)"
+msgstr "(нет)"
+
+#: src/pv/file.c:431
+msgid "(stdin)"
+msgstr "(стд. ввод)"
+
+#: src/pv/format/averagerate.c:34 src/pv/format/progressbar.c:92
+#: src/pv/format/rate.c:36 src/pv/loop.c:121
+msgid "b/s"
+msgstr "бит/с"
+
+#: src/pv/format/averagerate.c:38 src/pv/format/progressbar.c:96
+#: src/pv/format/rate.c:40
+msgid "/s"
+msgstr "/с"
+
+#: src/pv/format/averagerate.c:38 src/pv/format/progressbar.c:96
+#: src/pv/format/rate.c:40 src/pv/loop.c:121
+msgid "B/s"
+msgstr "байт/с"
+
+#: src/pv/format/bytes.c:35
+msgid "b"
+msgstr "бит"
+
+#: src/pv/format/bytes.c:39 src/pv/transfer.c:620
+msgid "B"
+msgstr "байт"
+
+#: src/pv/format/eta.c:52 src/pv/format/eta.c:56
+msgid "ETA"
+msgstr "ОЖИД"
+
+#: src/pv/format/fineta.c:80
+msgid "FIN"
+msgstr "ЗАВЕРШ"
+
+#: src/pv/loop.c:120
+msgid "rate min/avg/max/mdev"
+msgstr "скор. мин/сред/макс/дев"
+
+#: src/pv/loop.c:132
+msgid "rate not measured"
+msgstr "скорость не изменяется"
+
+#: src/pv/loop.c:802 src/pv/loop.c:818 src/pv/loop.c:836 src/pv/watchpid.c:101
+#: src/pv/watchpid.c:110 src/pv/watchpid.c:121 src/pv/watchpid.c:129
+#: src/pv/watchpid.c:166 src/pv/watchpid.c:185 src/pv/watchpid.c:193
+#: src/pv/watchpid.c:203 src/pv/watchpid.c:307 src/pv/watchpid.c:315
+#: src/pv/watchpid.c:447 src/pv/watchpid.c:470
+msgid "pid"
+msgstr "ИДпр"
+
+#: src/pv/loop.c:836 src/pv/watchpid.c:110 src/pv/watchpid.c:122
+#: src/pv/watchpid.c:131 src/pv/watchpid.c:185 src/pv/watchpid.c:194
+#: src/pv/watchpid.c:205
+msgid "fd"
+msgstr "дф"
+
+#: src/pv/remote.c:237 src/pv/remote.c:622
+msgid "message not received"
+msgstr "сообщение не получено"
+
+#: src/pv/remote.c:644 src/pv/remote.c:662
+msgid "SA_SIGINFO not supported on this system"
+msgstr "Этой системой не поддерживается SA_SIGINFO"
+
+#: src/pv/state.c:42
+msgid "history structure allocation failed"
+msgstr "не удалось выделить память для структуры истории"
+
+#: src/pv/state.c:794 src/pv/state.c:806
+msgid "file list allocation failed"
+msgstr "не удалось выделить память для списка файлов"
+
+#: src/pv/transfer.c:490
+msgid "read failed"
+msgstr "чтение не удалось"
+
+#: src/pv/transfer.c:506
+msgid "warning: read errors detected"
+msgstr "внимание: замечены ошибки чтения"
+
+#: src/pv/transfer.c:522
+msgid "file is not seekable"
+msgstr ""
+
+#: src/pv/transfer.c:599
+msgid "failed to seek past error"
+msgstr ""
+
+#: src/pv/transfer.c:619
+msgid "skipped past read error"
+msgstr ""
+
+#: src/pv/transfer.c:663
+msgid "no transfer buffer allocated"
+msgstr "не выделена память для буфера передачи"
+
+#: src/pv/transfer.c:751
+msgid "failed to set interval timer"
+msgstr "не удалось задать измеритель временного промежутка"
+
+#: src/pv/transfer.c:777
+msgid "failed to clear interval timer"
+msgstr "не удалось очистить измеритель временного промежутка"
+
+#: src/pv/transfer.c:822
+msgid "line position buffer allocation failed"
+msgstr ""
+
+#: src/pv/transfer.c:996
+msgid "write failed"
+msgstr "запись не удалась"
+
+#: src/pv/transfer.c:1237
+msgid "select call failed"
+msgstr "запрос выборки не удался"
+
+#: src/pv/watchpid.c:131 src/pv/watchpid.c:205
+msgid "not a regular file or block device"
+msgstr "не является обычным файлом или блочным устройством"
+
+#~ msgid "PID[:FD]"
+#~ msgstr "ИДпр[:FD]"

po/tr.po

@@ -0,0 +1,604 @@
+msgid ""
+msgstr ""
+"Project-Id-Version: pv 1.8.14\n"
+"Report-Msgid-Bugs-To: https://codeberg.org/ivarch/pv/issues\n"
+"POT-Creation-Date: 2025-10-31 19:47+0000\n"
+"PO-Revision-Date: 2025-10-05 20:09+0000\n"
+"Last-Translator: Oğuz Ersen <ersen@noreply.codeberg.org>\n"
+"Language-Team: Turkish <https://translate.codeberg.org/projects/pv/pv/tr/>\n"
+"Language: tr\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=2; plural=n != 1;\n"
+"X-Generator: Weblate 5.13.2\n"
+
+#: src/main/help.c:236
+msgid "show progress bar"
+msgstr "ilerleme çubuğunu göster"
+
+#: src/main/help.c:239
+msgid "show elapsed time"
+msgstr "geçen süreyi göster"
+
+#: src/main/help.c:242
+msgid "show estimated time of arrival (completion)"
+msgstr "tahmini varış (tamamlanma) zamanını göster"
+
+#: src/main/help.c:245
+msgid "show absolute estimated time of arrival (completion)"
+msgstr "mutlak tahmini varış (tamamlanma) zamanını göster"
+
+#: src/main/help.c:248
+msgid "show data transfer rate counter"
+msgstr "veri aktarım oranı sayacını göster"
+
+#: src/main/help.c:251
+msgid "show data transfer average rate counter"
+msgstr "veri aktarımı ortalama hız sayacını göster"
+
+#: src/main/help.c:254
+msgid "show number of bytes transferred"
+msgstr "aktarılan bayt sayısını göster"
+
+#: src/main/help.c:257
+msgid "show percentage of transfer buffer in use"
+msgstr "aktarım tamponunun kullanım yüzdesini göster"
+
+#: src/main/help.c:259
+msgid "NUM"
+msgstr "NUM"
+
+#: src/main/help.c:260
+msgid "show NUM bytes last written"
+msgstr "son yazılan NUM baytlarını göster"
+
+#: src/main/help.c:262
+msgid "FORMAT"
+msgstr "FORMAT"
+
+#: src/main/help.c:263
+msgid "set output format to FORMAT"
+msgstr "çıktı formatını FORMAT olarak ayarlayın"
+
+#: src/main/help.c:266
+msgid "output percentages, not visual information"
+msgstr "görsel bilgileri değil, yüzdeleri çıktı olarak yazdır"
+
+#: src/main/help.c:269
+msgid "do not output any transfer information at all"
+msgstr "hiçbir transfer bilgisini yazdırma"
+
+#: src/main/help.c:273
+msgid "show number of bits transferred"
+msgstr "aktarılan bit sayısını göster"
+
+#: src/main/help.c:276
+msgid "treat suffixes as multiples of 1000 rather than 1024"
+msgstr "ekleri 1024 yerine 1000'in katları olarak değerlendir"
+
+#: src/main/help.c:279
+msgid "display nothing until first byte transferred"
+msgstr "ilk bayt aktarılana kadar hiçbir şey gösterme"
+
+#: src/main/help.c:281 src/main/help.c:296 src/main/help.c:299
+msgid "SEC"
+msgstr "SEC"
+
+#: src/main/help.c:282
+msgid "display nothing until SEC seconds have passed"
+msgstr "SEC saniye geçene kadar hiçbir şey gösterme"
+
+#: src/main/help.c:284
+msgid "SIZE"
+msgstr "BOYUT"
+
+#: src/main/help.c:285
+msgid "set estimated data size to SIZE bytes"
+msgstr "tahmini veri boyutunu BOYUT bayt olarak ayarlayın"
+
+#: src/main/help.c:288
+msgid "if size unknown, show rate vs max rate"
+msgstr "boyut bilinmiyorsa, oranı maksimum oranla göster"
+
+#: src/main/help.c:291
+msgid "count lines instead of bytes"
+msgstr "bayt yerine satır say"
+
+#: src/main/help.c:294
+msgid "lines are null-terminated"
+msgstr "satırlar boş sonlandırılır"
+
+#: src/main/help.c:297
+msgid "update every SEC seconds"
+msgstr "her SEC saniyede bir güncelleme"
+
+#: src/main/help.c:300
+msgid "compute average rate over past SEC seconds (default 30s)"
+msgstr "geçmiş SEC saniyeleri üzerinden ortalama hızı hesapla (varsayılan 30s)"
+
+#: src/main/help.c:302
+msgid "WIDTH"
+msgstr "GENİŞLİK"
+
+#: src/main/help.c:303
+msgid "assume terminal is WIDTH characters wide"
+msgstr "terminalin GENİŞLİK karakter genişliğinde olduğunu varsayalım"
+
+#: src/main/help.c:305
+msgid "HEIGHT"
+msgstr "YÜKSEKLİK"
+
+#: src/main/help.c:306
+msgid "assume terminal is HEIGHT rows high"
+msgstr "terminalin YÜKSEKLİK sıraları yüksekliğinde olduğunu varsayalım"
+
+#: src/main/help.c:308
+msgid "NAME"
+msgstr "İSİM"
+
+#: src/main/help.c:309
+msgid "prefix visual information with NAME"
+msgstr "görsel bilgiyi İSİM ile öne ekle"
+
+#: src/main/help.c:311
+msgid "STYLE"
+msgstr "BİÇİM"
+
+#: src/main/help.c:312
+msgid "set default bar style to NAME"
+msgstr "öntanımlı çubuk biçimini İSİM olarak ayarla"
+
+#: src/main/help.c:314
+msgid "SPEC"
+msgstr "BELİRT"
+
+#: src/main/help.c:315
+msgid "also send progress to SPEC"
+msgstr "ilerlemeyi BELİRT ögesine de gönder"
+
+#: src/main/help.c:318
+msgid "output transfer statistics at the end"
+msgstr "transfer istatistiklerini sonda göster"
+
+#: src/main/help.c:321
+msgid "output even if standard error is not a terminal"
+msgstr "standart hata bir terminal olmasa bile çıktı yazdır"
+
+#: src/main/help.c:324
+msgid "use cursor positioning escape sequences"
+msgstr "imleç konumlandırma kaçış dizilerini kullan"
+
+#: src/main/help.c:327 src/main/help.c:360 src/main/help.c:376
+#: src/main/help.c:386
+msgid "FILE"
+msgstr "DOSYA"
+
+#: src/main/help.c:328
+msgid "write output to FILE instead of stdout"
+msgstr "çıktıyı stdout yerine DOSYA'ya yaz"
+
+#: src/main/help.c:330
+msgid "RATE"
+msgstr "ORAN"
+
+#: src/main/help.c:331
+msgid "limit transfer to RATE bytes per second"
+msgstr "aktarımı saniye başına ORAN bayt ile sınırlandırın"
+
+#: src/main/help.c:333 src/main/help.c:342
+msgid "BYTES"
+msgstr "BAYTLAR"
+
+#: src/main/help.c:334
+msgid "use a buffer size of BYTES"
+msgstr "BAYTLAR tampon boyutu kullanın"
+
+#: src/main/help.c:337
+msgid "never use splice(), always use read/write"
+msgstr "splice() kullanma, her zaman read/write kullan"
+
+#: src/main/help.c:340
+msgid "skip read errors in input"
+msgstr "girdideki okuma hatalarını atla"
+
+#: src/main/help.c:343
+msgid "skip errors in BYTES blocks at a time"
+msgstr "BAYTLAR blokları halinde hataları atla"
+
+#: src/main/help.c:346
+msgid "stop after --size bytes have been transferred"
+msgstr "--size bayt transfer edildikten sonra dur"
+
+#: src/main/help.c:349
+msgid "flush cache to disk after every write"
+msgstr "her yazmadan sonra önbelleği diske boşalt"
+
+#: src/main/help.c:352
+msgid "use direct I/O to bypass cache"
+msgstr "Önbelleği atlamak için doğrudan I/O kullan"
+
+#: src/main/help.c:355
+msgid "try to seek instead of writing null bytes"
+msgstr ""
+
+#: src/main/help.c:358
+msgid "discard input instead of writing to output"
+msgstr "Girdiyi çıktıya yazmak yerine yok say"
+
+#: src/main/help.c:361
+msgid "write all input to FILE before writing to output"
+msgstr "çıktıya yazmadan önce tüm girdiyi DOSYA'ya yaz"
+
+#: src/main/help.c:364
+msgid "PID[:FD]|=NAME|@LISTFILE"
+msgstr ""
+
+#: src/main/help.c:365
+msgid "watch file FD opened by process PID"
+msgstr "FD izleme dosyası PID işlemi tarafından açıldı"
+
+#: src/main/help.c:368 src/main/help.c:371
+msgid "PID"
+msgstr "PID"
+
+#: src/main/help.c:369
+msgid "update settings of process PID"
+msgstr "süreç PID ayarlarını güncelle"
+
+#: src/main/help.c:372
+msgid "show progress of process PID"
+msgstr ""
+
+#: src/main/help.c:377
+msgid "save process ID in FILE"
+msgstr "FILE'da işlem kimliğini (ID) kaydet"
+
+#: src/main/help.c:380
+msgid "show this help and exit"
+msgstr "bu yardımı göster ve çık"
+
+#: src/main/help.c:383
+msgid "show version information and exit"
+msgstr "sürüm bilgilerini göster ve çık"
+
+#: src/main/help.c:387
+msgid "write debug logs to FILE"
+msgstr "Hata ayıklama kayıtlarını DOSYA'ya yaz"
+
+#: src/main/help.c:413
+#, c-format
+msgid "Usage: %s [OPTION] [FILE]..."
+msgstr "Kullanım şekli: %s [AYAR] [DOSYA]..."
+
+#: src/main/help.c:424
+msgid ""
+"Concatenate FILE(s), or standard input, to standard output, with monitoring."
+msgstr ""
+"İzleme ile DOSYA(lar)ı veya standart girdiyi standart çıktı ile birleştirin."
+
+#: src/main/help.c:562
+msgid "Supported format sequences:"
+msgstr "Desteklenen biçim dizileri:"
+
+#: src/main/help.c:576
+#, c-format
+msgid "Please report any bugs to: %s"
+msgstr "Lütfen hataları şu adrese bildirin: %s"
+
+#: src/main/main.c:228
+msgid "(input)"
+msgstr "(giriş)"
+
+#: src/main/main.c:330
+msgid "state allocation failed"
+msgstr "durum tahsisi başarısız oldu"
+
+#: src/main/options.c:370
+msgid "list files may not contain @ lines"
+msgstr ""
+
+#: src/main/options.c:391 src/main/options.c:393 src/main/options.c:807
+msgid "process ID or pid:fd pair expected"
+msgstr "süreç kimliği (ID) veya pid:fd çifti bekleniyor"
+
+#: src/main/options.c:403 src/main/options.c:405 src/main/options.c:814
+msgid "invalid process ID"
+msgstr "geçersiz süreç kimliği (ID)"
+
+#: src/main/options.c:448 src/pv/file.c:342
+msgid "failed to stat file"
+msgstr "dosya statüsünde başarısız oldu"
+
+#: src/main/options.c:462
+msgid "is a directory"
+msgstr "bir dizindir"
+
+#: src/main/options.c:491
+msgid "failed to generate sysfs filename"
+msgstr "sysfs dosya adı oluşturulamadı"
+
+#: src/main/options.c:513
+msgid "failed to read sysfs size file"
+msgstr "sysfs boyut dosyası okunamadı"
+
+#: src/main/options.c:533
+msgid "failed to open block device"
+msgstr "blok aygıtı açılamadı"
+
+#: src/main/options.c:543
+msgid "failed to determine size of block device"
+msgstr "blok aygıtının boyutu belirlenemedi"
+
+#: src/main/options.c:652
+msgid "option structure allocation failed"
+msgstr "seçenek yapısı tahsisi başarısız oldu"
+
+#: src/main/options.c:671
+msgid "option structure argv allocation failed"
+msgstr "seçenek yapısı argv tahsisi başarısız oldu"
+
+#: src/main/options.c:723
+msgid "numeric value not understood"
+msgstr "sayısal değer anlaşılmadı"
+
+#: src/main/options.c:743
+msgid "integer argument expected"
+msgstr "tamsayı bağımsız değişkeni bekleniyor"
+
+#: src/main/options.c:755
+msgid "numeric argument expected"
+msgstr "sayısal bağımsız değişken bekleniyor"
+
+#: src/main/options.c:767
+msgid "missing filename"
+msgstr ""
+
+#: src/main/options.c:795
+msgid "missing process name"
+msgstr ""
+
+#: src/main/options.c:1056
+#, c-format
+msgid "Try `%s --help' for more information."
+msgstr "Daha fazla bilgi için `%s --help' seçeneğini deneyin."
+
+#: src/main/options.c:1058
+#, c-format
+msgid "Try `%s -h' for more information."
+msgstr "Daha fazla bilgi için `%s -h' seçeneğini deneyin."
+
+#: src/main/options.c:1089
+msgid ""
+"cannot use line mode or transfer modifier options when watching file "
+"descriptors"
+msgstr ""
+"dosya tanımlayıcılarını izlerken satır modu veya aktarım değiştirici "
+"seçeneklerini kullanamaz"
+
+#: src/main/options.c:1098
+msgid "cannot use cursor positioning when watching file descriptors"
+msgstr "dosya tanımlayıcılarını izlerken imleç konumlandırmayı kullanamaz"
+
+#: src/main/options.c:1107
+msgid "cannot use remote control when watching file descriptors"
+msgstr "dosya tanımlayıcılarını izlerken uzaktan kumandayı kullanamaz"
+
+#: src/main/options.c:1116
+msgid "cannot use remote query when watching file descriptors"
+msgstr ""
+
+#: src/main/options.c:1125
+msgid "cannot transfer files when watching file descriptors"
+msgstr "dosya tanımlayıcıları izlenirken dosya aktarılamıyor"
+
+#: src/main/options.c:1150
+msgid "not available on systems without /proc/self/fdinfo"
+msgstr "/proc/self/fdinfo olmayan sistemlerde kullanılamaz"
+
+#: src/main/options.c:1162
+msgid "cannot use remote control and remote query together"
+msgstr ""
+
+#: src/main/options.c:1189
+msgid "files cannot be specified with this option"
+msgstr ""
+
+#: src/main/version.c:28
+msgid "License: GPLv3+ <https://www.gnu.org/licenses/gpl-3.0.html>"
+msgstr "Lisans: GPLv3+ <https://www.gnu.org/licenses/gpl-3.0.html>"
+
+#: src/main/version.c:29
+msgid "This is free software: you are free to change and redistribute it."
+msgstr ""
+"Bu özgür bir yazılımdır: değiştirmekte ve yeniden dağıtmakta özgürsünüz."
+
+#: src/main/version.c:30
+msgid "There is NO WARRANTY, to the extent permitted by law."
+msgstr "Yasaların izin verdiği ölçüde GARANTİ YOKTUR."
+
+#: src/main/version.c:32
+msgid "Project web site"
+msgstr "Proje web sitesi"
+
+#: src/pv/cursor.c:61
+msgid "failed to get terminal name"
+msgstr "terminal adı alınamadı"
+
+#: src/pv/cursor.c:106
+msgid "failed to open lock file"
+msgstr "lock dosyası açılamadı"
+
+#: src/pv/cursor.c:139
+msgid "lock attempt failed"
+msgstr "kilit denemesi başarısız oldu"
+
+#: src/pv/cursor.c:400
+msgid "failed to open terminal"
+msgstr "terminal açılamadı"
+
+#: src/pv/display.c:285
+msgid "yzafpnum kMGTPEZY"
+msgstr "yzafpnum kMGTPEZY"
+
+#: src/pv/display.c:303
+msgid "yzafpnum KMGTPEZY"
+msgstr "yzafpnum KMGTPEZY"
+
+#: src/pv/display.c:1053 src/pv/state.c:842 src/pv/transfer.c:1135
+msgid "buffer allocation failed"
+msgstr "arabellek tahsisi başarısız oldu"
+
+#: src/pv/file.c:153
+msgid "failed to seek to start of output"
+msgstr "çıktının başlangıcına ulaşılamadı"
+
+#: src/pv/file.c:303
+msgid "failed to close file"
+msgstr "dosya kapatılamadı"
+
+#: src/pv/file.c:335
+msgid "failed to read file"
+msgstr "dosya okunamadı"
+
+#: src/pv/file.c:350
+msgid "failed to stat output file"
+msgstr "çıktı dosyası stat edilemedi"
+
+#: src/pv/file.c:372
+msgid "input file is output file"
+msgstr "girdi dosyası çıktı dosyasıdır"
+
+#: src/pv/file.c:429
+msgid "(none)"
+msgstr "(yok)"
+
+#: src/pv/file.c:431
+msgid "(stdin)"
+msgstr "(stdin)"
+
+#: src/pv/format/averagerate.c:34 src/pv/format/progressbar.c:92
+#: src/pv/format/rate.c:36 src/pv/loop.c:121
+msgid "b/s"
+msgstr "b/s"
+
+#: src/pv/format/averagerate.c:38 src/pv/format/progressbar.c:96
+#: src/pv/format/rate.c:40
+msgid "/s"
+msgstr "/s"
+
+#: src/pv/format/averagerate.c:38 src/pv/format/progressbar.c:96
+#: src/pv/format/rate.c:40 src/pv/loop.c:121
+msgid "B/s"
+msgstr "B/s"
+
+#: src/pv/format/bytes.c:35
+msgid "b"
+msgstr "b"
+
+#: src/pv/format/bytes.c:39 src/pv/transfer.c:620
+msgid "B"
+msgstr "B"
+
+#: src/pv/format/eta.c:52 src/pv/format/eta.c:56
+msgid "ETA"
+msgstr "ETA"
+
+#: src/pv/format/fineta.c:80
+msgid "FIN"
+msgstr "FIN"
+
+#: src/pv/loop.c:120
+msgid "rate min/avg/max/mdev"
+msgstr "oran min/ortalama/maks/standart sapma"
+
+#: src/pv/loop.c:132
+msgid "rate not measured"
+msgstr "oran ölçülmedi"
+
+#: src/pv/loop.c:802 src/pv/loop.c:818 src/pv/loop.c:836 src/pv/watchpid.c:101
+#: src/pv/watchpid.c:110 src/pv/watchpid.c:121 src/pv/watchpid.c:129
+#: src/pv/watchpid.c:166 src/pv/watchpid.c:185 src/pv/watchpid.c:193
+#: src/pv/watchpid.c:203 src/pv/watchpid.c:307 src/pv/watchpid.c:315
+#: src/pv/watchpid.c:447 src/pv/watchpid.c:470
+msgid "pid"
+msgstr "pid"
+
+#: src/pv/loop.c:836 src/pv/watchpid.c:110 src/pv/watchpid.c:122
+#: src/pv/watchpid.c:131 src/pv/watchpid.c:185 src/pv/watchpid.c:194
+#: src/pv/watchpid.c:205
+msgid "fd"
+msgstr "fd"
+
+#: src/pv/remote.c:237 src/pv/remote.c:622
+msgid "message not received"
+msgstr "mesaj alınamadı"
+
+#: src/pv/remote.c:644 src/pv/remote.c:662
+msgid "SA_SIGINFO not supported on this system"
+msgstr "SA_SIGINFO bu sistemde desteklenmiyor"
+
+#: src/pv/state.c:42
+msgid "history structure allocation failed"
+msgstr "geçmiş yapısı tahsisi başarısız oldu"
+
+#: src/pv/state.c:794 src/pv/state.c:806
+msgid "file list allocation failed"
+msgstr "dosya listesi tahsisi başarısız oldu"
+
+#: src/pv/transfer.c:490
+msgid "read failed"
+msgstr "okuma başarısız"
+
+#: src/pv/transfer.c:506
+msgid "warning: read errors detected"
+msgstr "uyarı: okuma hataları tespit edildi"
+
+#: src/pv/transfer.c:522
+msgid "file is not seekable"
+msgstr "dosya aranabilir değil"
+
+#: src/pv/transfer.c:599
+msgid "failed to seek past error"
+msgstr "geçmiş hatayı aramakta başarısız oldu"
+
+#: src/pv/transfer.c:619
+msgid "skipped past read error"
+msgstr "geçmiş okuma hatası atlandı"
+
+#: src/pv/transfer.c:663
+msgid "no transfer buffer allocated"
+msgstr "aktarım arabelleği ayrılmamış"
+
+#: src/pv/transfer.c:751
+msgid "failed to set interval timer"
+msgstr "aralık zamanlayıcısı ayarlanamadı"
+
+#: src/pv/transfer.c:777
+msgid "failed to clear interval timer"
+msgstr "aralık zamanlayıcısı temizlenemedi"
+
+#: src/pv/transfer.c:822
+msgid "line position buffer allocation failed"
+msgstr "satır konumu arabellek tahsisi başarısız oldu"
+
+#: src/pv/transfer.c:996
+msgid "write failed"
+msgstr "yazma başarısız"
+
+#: src/pv/transfer.c:1237
+msgid "select call failed"
+msgstr "seçme çağrısı başarısız oldu"
+
+#: src/pv/watchpid.c:131 src/pv/watchpid.c:205
+msgid "not a regular file or block device"
+msgstr "normal bir dosya veya blok aygıtı değil"
+
+#~ msgid "process list allocation failed"
+#~ msgstr "işlem listesi tahsisi başarısız oldu"
+
+#~ msgid "file descriptor list allocation failed"
+#~ msgstr "dosya tanımlayıcı listesi tahsisi başarısız oldu"
+
+#~ msgid "PID[:FD]"
+#~ msgstr "PID[:FD]"

src/include/config-aux.h

@@ -3,23 +3,25 @@
  * `configure' script.  Include this after config.h and before anything
  * else.
  *
- * Copyright 2002-2008, 2010, 2012-2015, 2017, 2021, 2023 Andrew Wood
+ * Copyright 2002-2008, 2010, 2012-2015, 2017, 2021, 2023-2025 Andrew Wood
  *
- * Distributed under the Artistic License v2.0; see `doc/COPYING'.
+ * License GPLv3+: GNU GPL version 3 or later; see `docs/COPYING'.
  */
  
-#ifdef ENABLE_NLS
-# include "library/gettext.h"
+#if ENABLE_NLS
+# ifdef HAVE_LIBINTL_H
+#  include <libintl.h>
+# endif
+# ifdef HAVE_LOCALE_H
+#  include <locale.h>
+# endif
+# define _(String)	gettext (String)
+# define N_(String)	(String)
 #else
 # define _(String) (String)
 # define N_(String) (String)
 #endif
 
-#undef HAVE_IPC
-#ifdef HAVE_SYS_IPC_H
-#define HAVE_IPC 1
-#endif
-
 #undef CURSOR_ANSWERBACK_BYTE_BY_BYTE
 #ifndef _AIX
 #define CURSOR_ANSWERBACK_BYTE_BY_BYTE 1
@@ -42,4 +44,10 @@ typedef bool _Bool;
 # define __bool_true_false_are_defined 1
 #endif
 
-/* EOF */
+/* Whether "--remote" and "--query" should be available. */
+#undef PV_REMOTE_CONTROL
+#if HAVE_DECL_SA_SIGINFO
+# if SIGINFO_PROVIDES_PID
+#define PV_REMOTE_CONTROL 1
+# endif
+#endif

src/include/config.h.in

@@ -1,34 +1,57 @@
-/* autoconf/header.in.  Generated from autoconf/configure.in by autoheader.  */
-
-/* Bug reporting email address */
-#undef BUG_REPORTS_TO
-
-/* Copyright holder */
-#undef COPYRIGHT_HOLDER
-
-/* Copyright year */
-#undef COPYRIGHT_YEAR
+/* src/include/config.h.in.  Generated from configure.ac by autoheader.  */
 
 /* Debugging support enabled */
 #undef ENABLE_DEBUGGING
 
-/* Enable native language support */
+/* Build with ncurses support */
+#undef ENABLE_NCURSES
+
+/* Define to 1 if translation of program messages to the user's native
+   language is requested. */
 #undef ENABLE_NLS
 
-/* Define to 1 if `TIOCGWINSZ' requires <sys/ioctl.h>. */
-#undef GWINSZ_IN_SYS_IOCTL
+/* Define to 1 if you have the `alarm' function. */
+#undef HAVE_ALARM
 
 /* Define to 1 if you have the `basename' function. */
 #undef HAVE_BASENAME
 
+/* Define to 1 if you have the Mac OS X function
+   CFLocaleCopyPreferredLanguages in the CoreFoundation framework. */
+#undef HAVE_CFLOCALECOPYPREFERREDLANGUAGES
+
+/* Define to 1 if you have the Mac OS X function CFPreferencesCopyAppValue in
+   the CoreFoundation framework. */
+#undef HAVE_CFPREFERENCESCOPYAPPVALUE
+
+/* Define to 1 if you have the `clock_gettime' function. */
+#undef HAVE_CLOCK_GETTIME
+
+/* Define if the GNU dcgettext() function is already present or preinstalled.
+   */
+#undef HAVE_DCGETTEXT
+
+/* Define to 1 if you have the declaration of `SA_SIGINFO', and to 0 if you
+   don't. */
+#undef HAVE_DECL_SA_SIGINFO
+
+/* Define to 1 if you have the `dup2' function. */
+#undef HAVE_DUP2
+
+/* Define to 1 if you have the <fcntl.h> header file. */
+#undef HAVE_FCNTL_H
+
 /* Define to 1 if you have the `fdatasync' function. */
 #undef HAVE_FDATASYNC
 
+/* Define to 1 if you have the `fmod' function. */
+#undef HAVE_FMOD
+
 /* Define to 1 if you have the `fpathconf' function. */
 #undef HAVE_FPATHCONF
 
-/* Define to 1 if you have the `getopt' function. */
-#undef HAVE_GETOPT
+/* Define to 1 if you have the `getcwd' function. */
+#undef HAVE_GETCWD
 
 /* Define to 1 if you have the <getopt.h> header file. */
 #undef HAVE_GETOPT_H
@@ -36,21 +59,24 @@
 /* Define to 1 if you have the `getopt_long' function. */
 #undef HAVE_GETOPT_LONG
 
-/* The gettext function is available */
+/* Define if the GNU gettext() function is already present or preinstalled. */
 #undef HAVE_GETTEXT
 
+/* Define if you have the iconv() function and it works. */
+#undef HAVE_ICONV
+
 /* Define to 1 if you have the <inttypes.h> header file. */
 #undef HAVE_INTTYPES_H
 
+/* IPC support enabled */
+#undef HAVE_IPC
+
+/* Define to 1 if you have the <langinfo.h> header file. */
+#undef HAVE_LANGINFO_H
+
 /* Define to 1 if you have the <libgen.h> header file. */
 #undef HAVE_LIBGEN_H
 
-/* Define to 1 if you have the `i' library (-li). */
-#undef HAVE_LIBI
-
-/* Define to 1 if you have the `intl' library (-lintl). */
-#undef HAVE_LIBINTL
-
 /* Define to 1 if you have the <libintl.h> header file. */
 #undef HAVE_LIBINTL_H
 
@@ -60,18 +86,57 @@
 /* Define to 1 if you have the <locale.h> header file. */
 #undef HAVE_LOCALE_H
 
+/* Define to 1 if you have the <math.h> header file. */
+#undef HAVE_MATH_H
+
 /* Define to 1 if you have the `memcpy' function. */
 #undef HAVE_MEMCPY
 
+/* Define to 1 if you have the `memmove' function. */
+#undef HAVE_MEMMOVE
+
+/* Define to 1 if you have the `memrchr' function. */
+#undef HAVE_MEMRCHR
+
+/* Define to 1 if you have the `memset' function. */
+#undef HAVE_MEMSET
+
 /* Define to 1 if you have the <minix/config.h> header file. */
 #undef HAVE_MINIX_CONFIG_H
 
+/* Define to 1 if you have the `mkdir' function. */
+#undef HAVE_MKDIR
+
+/* Define to 1 if you have the `nanosleep' function. */
+#undef HAVE_NANOSLEEP
+
+/* Define to 1 if you have the `posix_fadvise' function. */
+#undef HAVE_POSIX_FADVISE
+
 /* Define to 1 if you have the `posix_memalign' function. */
 #undef HAVE_POSIX_MEMALIGN
 
+/* Define to 1 if you have the `select' function. */
+#undef HAVE_SELECT
+
+/* Define to 1 if you have the `setitimer' function. */
+#undef HAVE_SETITIMER
+
+/* Define to 1 if you have the `setlocale' function. */
+#undef HAVE_SETLOCALE
+
+/* Define to 1 if you have the `setproctitle' function. */
+#undef HAVE_SETPROCTITLE
+
+/* Define to 1 if you have the `shmget' function. */
+#undef HAVE_SHMGET
+
 /* Define to 1 if you have the `splice' function. */
 #undef HAVE_SPLICE
 
+/* Define to 1 if you have the `sqrtl' function. */
+#undef HAVE_SQRTL
+
 /* Define to 1 if stdbool.h conforms to C99. */
 #undef HAVE_STDBOOL_H
 
@@ -84,6 +149,12 @@
 /* Define to 1 if you have the <stdlib.h> header file. */
 #undef HAVE_STDLIB_H
 
+/* Define to 1 if you have the `strchr' function. */
+#undef HAVE_STRCHR
+
+/* Define to 1 if you have the `strerror' function. */
+#undef HAVE_STRERROR
+
 /* Define to 1 if you have the <strings.h> header file. */
 #undef HAVE_STRINGS_H
 
@@ -93,24 +164,57 @@
 /* Define to 1 if you have the `strlcat' function. */
 #undef HAVE_STRLCAT
 
+/* Define to 1 if you have the `strrchr' function. */
+#undef HAVE_STRRCHR
+
+/* Define to 1 if you have the `strstr' function. */
+#undef HAVE_STRSTR
+
+/* Define to 1 if you have the `strtoul' function. */
+#undef HAVE_STRTOUL
+
+/* Define to 1 if `st_blksize' is a member of `struct stat'. */
+#undef HAVE_STRUCT_STAT_ST_BLKSIZE
+
+/* Define to 1 if `st_rdev' is a member of `struct stat'. */
+#undef HAVE_STRUCT_STAT_ST_RDEV
+
 /* Define to 1 if you have the `sysconf' function. */
 #undef HAVE_SYSCONF
 
+/* Define to 1 if you have the <sys/file.h> header file. */
+#undef HAVE_SYS_FILE_H
+
+/* Define to 1 if you have the <sys/ioctl.h> header file. */
+#undef HAVE_SYS_IOCTL_H
+
 /* Define to 1 if you have the <sys/ipc.h> header file. */
 #undef HAVE_SYS_IPC_H
 
 /* Define to 1 if you have the <sys/param.h> header file. */
 #undef HAVE_SYS_PARAM_H
 
+/* Define to 1 if you have the <sys/shm.h> header file. */
+#undef HAVE_SYS_SHM_H
+
 /* Define to 1 if you have the <sys/stat.h> header file. */
 #undef HAVE_SYS_STAT_H
 
+/* Define to 1 if you have the <sys/sysmacros.h> header file. */
+#undef HAVE_SYS_SYSMACROS_H
+
+/* Define to 1 if you have the <sys/time.h> header file. */
+#undef HAVE_SYS_TIME_H
+
 /* Define to 1 if you have the <sys/types.h> header file. */
 #undef HAVE_SYS_TYPES_H
 
 /* Define to 1 if you have the <termios.h> header file. */
 #undef HAVE_TERMIOS_H
 
+/* Define to 1 if you have the <term.h> header file. */
+#undef HAVE_TERM_H
+
 /* Define to 1 if you have the <unistd.h> header file. */
 #undef HAVE_UNISTD_H
 
@@ -126,7 +230,7 @@
 /* Define to 1 if the system has the type `_Bool'. */
 #undef HAVE__BOOL
 
-/* Package name */
+/* Name of package */
 #undef PACKAGE
 
 /* Define to the address where bug reports for this package should be sent. */
@@ -147,11 +251,8 @@
 /* Define to the version of this package. */
 #undef PACKAGE_VERSION
 
-/* Name of this program */
-#undef PROGRAM_NAME
-
-/* Project homepage */
-#undef PROJECT_HOMEPAGE
+/* Signal handlers can determine the sending PID */
+#undef SIGINFO_PROVIDES_PID
 
 /* Define to 1 if all of the C90 standard headers exist (not just the ones
    required in a freestanding environment). This macro is provided for
@@ -246,7 +347,7 @@
 #endif
 
 
-/* Version of this program */
+/* Version number of package */
 #undef VERSION
 
 /* Number of bits in a file offset, on hosts where this is settable. */
@@ -258,4 +359,29 @@
 /* Define to empty if `const' does not conform to ANSI C. */
 #undef const
 
+/* Define to `int' if <sys/types.h> doesn't define. */
+#undef gid_t
+
+/* Define to the type of a signed integer type of width exactly 32 bits if
+   such a type exists and the standard includes do not define it. */
+#undef int32_t
+
+/* Define to `int' if <sys/types.h> does not define. */
+#undef mode_t
+
+/* Define to `long int' if <sys/types.h> does not define. */
+#undef off_t
+
+/* Define as a signed integer type capable of holding a process identifier. */
+#undef pid_t
+
+/* Define to `unsigned int' if <sys/types.h> does not define. */
+#undef size_t
+
+/* Define to `int' if <sys/types.h> does not define. */
+#undef ssize_t
+
+/* Define to `int' if <sys/types.h> doesn't define. */
+#undef uid_t
+
 #include "config-aux.h"

src/include/library/getopt.h

@@ -1,40 +0,0 @@
-/*
- * Replacement getopt function's header file. Include this AFTER config.h.
- *
- * Copyright 2002-2008, 2010, 2012-2015, 2017, 2021, 2023 Andrew Wood
- *
- * Distributed under the Artistic License v2.0; see `doc/COPYING'.
- */
-
-#ifndef _LIBRARY_GETOPT_H
-#define _LIBRARY_GETOPT_H 1
-
-#ifdef HAVE_GETOPT_H
-#include <getopt.h>
-#endif
-
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-#ifndef HAVE_GETOPT
-
-int minigetopt(int, char **, char *);
-extern char *minioptarg;
-extern int minioptind, miniopterr, minioptopt;
-
-#define getopt minigetopt	/* Flawfinder: ignore */
-#define optarg minioptarg
-#define optind minioptind
-#define opterr miniopterr
-#define optopt minioptopt
-
-#endif				/* !HAVE_GETOPT */
-
-#ifdef __cplusplus
-}
-#endif
-
-#endif /* _LIBRARY_GETOPT_H */
-
-/* EOF */

src/include/library/gettext.h

@@ -1,59 +0,0 @@
-/*
- * Replacement gettext library header file. Include this within config.h,
- * like this:
- *
- *   #ifdef ENABLE_NLS
- *   # include "library/gettext.h"
- *   #else
- *   # define _(String) (String)
- *   # define N_(String) (String)
- *   #endif
- *
- * Copyright 2002-2008, 2010, 2012-2015, 2017, 2021, 2023 Andrew Wood
- *
- * Distributed under the Artistic License v2.0; see `doc/COPYING'.
- */
-
-#ifndef _LIBRARY_GETTEXT_H
-#define _LIBRARY_GETTEXT_H 1
-
-#ifdef HAVE_GETTEXT
-# ifdef HAVE_LIBINTL_H
-#  include <libintl.h>
-# endif
-# ifdef HAVE_LOCALE_H
-#  include <locale.h>
-# endif
-# define _(String)	gettext (String)
-# define N_(String)	(String)
-#else
-# define _(String)	minigettext (String)
-# define N_(String)	(String)
-# ifdef HAVE_LOCALE_H
-#  include <locale.h>
-# else
-#  define setlocale	minisetlocale
-#  ifndef LC_ALL
-#   define LC_ALL	""
-#  endif
-# endif
-# define bindtextdomain	minibindtextdomain
-# define textdomain	minitextdomain
-#endif
-
-#ifdef __cplusplus
-extern "C" {
-#endif
-
-char *minisetlocale(const char *, const char *);
-char *minibindtextdomain(const char *, const char *);
-char *minitextdomain(const char *);
-char *minigettext(const char *);
-
-#ifdef __cplusplus
-}
-#endif
-
-#endif /* _LIBRARY_GETTEXT_H */
-
-/* EOF */

src/include/options.h

@@ -1,14 +1,21 @@
 /*
  * Global program option structure and the parsing function prototype.
  *
- * Copyright 2002-2008, 2010, 2012-2015, 2017, 2021, 2023 Andrew Wood
+ * Copyright 2002-2008, 2010, 2012-2015, 2017, 2021, 2023-2025 Andrew Wood
  *
- * Distributed under the Artistic License v2.0; see `doc/COPYING'.
+ * License GPLv3+: GNU GPL version 3 or later; see `docs/COPYING'.
  */
 
 #ifndef _OPTIONS_H
 #define _OPTIONS_H 1
 
+#if HAVE_CONFIG_H
+#include "config.h"
+#endif
+
+#include <stdlib.h>
+#include <sys/types.h>
+
 #ifdef __cplusplus
 extern "C" {
 #endif
@@ -16,9 +23,53 @@ extern "C" {
 struct opts_s;
 typedef struct opts_s *opts_t;
 
-struct opts_s {           /* structure describing run-time options */
-	char *program_name;            /* name the program is running as */
-	bool do_nothing;               /* exit-without-doing-anything flag */
+/*
+ * Overall program actions to select.
+ */
+typedef enum {
+	PV_ACTION_NOTHING,		/* do nothing, and exit */
+	PV_ACTION_TRANSFER,		/* transfer data */
+	PV_ACTION_STORE_AND_FORWARD,	/* store to file, then output from it */
+	PV_ACTION_WATCHFD,		/* watch process file descriptors */
+	PV_ACTION_REMOTE_CONTROL,	/* remotely control another pv */
+	PV_ACTION_QUERY			/* watch the state of another pv */
+} pvaction_t;
+
+/*
+ * Structure describing run-time options.
+ *
+ * Members are ordered by size to minimise padding.
+ */
+struct opts_s {
+	double interval;               /* interval between updates */
+	double delay_start;            /* delay before first display */
+	/*@keep@*/ const char *program_name; /* name the program is running as */
+	/*@keep@*/ /*@null@*/ char *output; /* fd to write output to */
+	/*@keep@*/ /*@null@*/ char *name;    /* display name, if any */
+	/*@keep@*/ /*@null@*/ char *default_bar_style; /* default bar style */
+	/*@keep@*/ /*@null@*/ char *format;  /* output format, if any */
+	/*@keep@*/ /*@null@*/ char *pidfile; /* PID file, if any */
+	/*@keep@*/ /*@null@*/ char *store_and_forward_file; /* store and forward file, if any */
+	/*@keep@*/ /*@null@*/ char *extra_display; /* extra display specifier, if any */
+	/*@keep@*/ /*@null@*/ pid_t *watchfd_pid;  /* array of processes to watch fds of */
+	/*@keep@*/ /*@null@*/ int *watchfd_fd;  /* array of fds to watch in each one (0=all) */
+	/*@keep@*/ /*@null@*/ const char **argv;   /* array of non-option arguments */
+	size_t lastwritten;            /* show N bytes last written */
+	off_t rate_limit;              /* rate limit, in bytes per second */
+	size_t buffer_size;            /* buffer size, in bytes (0=default) */
+	off_t size;                    /* total size of data */
+	off_t error_skip_block;        /* skip block size, 0 for adaptive */
+	pid_t remote;                  /* PID of pv to update settings of */
+	pid_t query;                   /* PID of pv to query progress of */
+	unsigned int skip_errors;      /* skip read errors counter */
+	unsigned int average_rate_window; /* time window in seconds for average rate calculations */
+	unsigned int width;            /* screen width */
+	unsigned int height;           /* screen height */
+	unsigned int argc;             /* number of non-option arguments */
+	unsigned int argv_length;      /* allocated array size */
+	unsigned int watchfd_count;	       /* number of watchfd items */
+	unsigned int watchfd_length;	       /* allocated array size */
+	pvaction_t action;	       /* the program action to perform */
 	bool progress;                 /* progress bar flag */
 	bool timer;                    /* timer flag */
 	bool eta;                      /* ETA flag */
@@ -27,46 +78,36 @@ struct opts_s {           /* structure describing run-time options */
 	bool average_rate;             /* average rate counter flag */
 	bool bytes;                    /* bytes transferred flag */
 	bool bits;                     /* report transfer size in bits */
+	bool decimal_units;            /* decimal prefix flag */
 	bool bufpercent;               /* transfer buffer percentage flag */
-	unsigned int lastwritten;      /* show N bytes last written */
 	bool force;                    /* force-if-not-terminal flag */
 	bool cursor;                   /* whether to use cursor positioning */
 	bool numeric;                  /* numeric output only */
 	bool wait;                     /* wait for transfer before display */
+	bool rate_gauge;               /* if size unknown, show rate vs max rate */
 	bool linemode;                 /* count lines instead of bytes */
-	bool null;                     /* lines are null-terminated */
-	bool no_op;                    /* do nothing other than pipe data */
-	unsigned long long rate_limit; /* rate limit, in bytes per second */
-	unsigned long long buffer_size;/* buffer size, in bytes (0=default) */
-	unsigned int remote;           /* PID of pv to update settings of */
-	unsigned long long size;       /* total size of data */
+	bool null_terminated_lines;    /* lines are null-terminated */
+	bool no_display;               /* do nothing other than pipe data */
 	bool no_splice;                /* flag set if never to use splice */
-	unsigned int skip_errors;      /* skip read errors counter */
 	bool stop_at_size;             /* set if we stop at "size" bytes */
 	bool sync_after_write;         /* set if we sync after every write */
 	bool direct_io;                /* set if O_DIRECT is to be used */
-	double interval;               /* interval between updates */
-	double delay_start;            /* delay before first display */
-	unsigned int watch_pid;	       /* process to watch fds of */
-	int watch_fd;		       /* fd to watch */
-	unsigned int average_rate_window; /* time window in seconds for average rate calculations */
-	unsigned int width;            /* screen width */
-	unsigned int height;           /* screen height */
-	char *name;                    /* process name, if any */
-	char *format;                  /* output format, if any */
-	char *pidfile;                 /* PID file, if any */
-	int argc;                      /* number of non-option arguments */
-	char **argv;                   /* array of non-option arguments */
+	bool sparse_output;            /* set if we leave holes in the output */
+	bool discard_input;            /* set to write nothing to output */
+	bool show_stats;	       /* set to write statistics at the end */
+	bool width_set_manually;       /* width was set manually, not detected */
+	bool height_set_manually;      /* height was set manually, not detected */
 };
 
-extern opts_t opts_parse(int, char **);
-extern void opts_free(opts_t);
+/*@-exportlocal@*/
+/* splint thinks opts_free is exported but not used - it is used. */
 
+extern /*@null@*/ /*@only@*/ opts_t opts_parse(unsigned int, char **);
+extern void opts_free(/*@only@*/ opts_t);
+extern bool opts_add_file(opts_t, const char *);
 
 #ifdef __cplusplus
 }
 #endif
 
 #endif /* _OPTIONS_H */
-
-/* EOF */

src/include/pv-internal.h

@@ -1,16 +1,20 @@
 /*
  * Functions internal to the PV library.  Include "config.h" first.
  *
- * Copyright 2002-2008, 2010, 2012-2015, 2017, 2021, 2023 Andrew Wood
+ * Copyright 2002-2008, 2010, 2012-2015, 2017, 2021, 2023-2025 Andrew Wood
  *
- * Distributed under the Artistic License v2.0; see `doc/COPYING'.
+ * License GPLv3+: GNU GPL version 3 or later; see `docs/COPYING'.
  */
 
 #ifndef _PV_INTERNAL_H
 #define _PV_INTERNAL_H 1
 
+#ifdef HAVE_STDINT_H
+#include <stdint.h>
+#endif
 #include <stdlib.h>
 #include <signal.h>
+#include <time.h>
 #include <sys/types.h>
 #include <sys/time.h>
 #include <sys/stat.h>
@@ -19,49 +23,25 @@
 extern "C" {
 #endif
 
-#define PV_DISPLAY_PROGRESS	1
-#define PV_DISPLAY_TIMER	2
-#define PV_DISPLAY_ETA		4
-#define PV_DISPLAY_RATE		8
-#define PV_DISPLAY_AVERAGERATE	16
-#define PV_DISPLAY_BYTES	32
-#define PV_DISPLAY_NAME		64
-#define PV_DISPLAY_BUFPERCENT	128
-#define PV_DISPLAY_OUTPUTBUF	256
-#define PV_DISPLAY_FINETA	512
-
-#define RATE_GRANULARITY	100000	 /* usec between -L rate chunks */
-#define RATE_BURST_WINDOW	5	 /* rate burst window (multiples of rate) */
-#define REMOTE_INTERVAL		100000	 /* usec between checks for -R */
-#define BUFFER_SIZE		409600	 /* default transfer buffer size */
-#define BUFFER_SIZE_MAX		524288	 /* max auto transfer buffer size */
-#define MAX_READ_AT_ONCE	524288	 /* max to read() in one go */
-#define MAX_WRITE_AT_ONCE	524288	 /* max to write() in one go */
-#define TRANSFER_READ_TIMEOUT	90000	 /* usec to time reads out at */
-#define TRANSFER_WRITE_TIMEOUT	900000	 /* usec to time writes out at */
+#define RATE_GRANULARITY	100000000	 /* nsec between -L rate chunks */
+#define RATE_BURST_WINDOW	5	 	 /* rate burst window (multiples of rate) */
+#define REMOTE_INTERVAL		100000000	 /* nsec between checks for -R and -Q */
+#define BUFFER_SIZE		(size_t) 409600	 /* default transfer buffer size */
+#define BUFFER_SIZE_MAX		(size_t) 524288	 /* max auto transfer buffer size */
+#define MAX_READ_AT_ONCE	(size_t) 524288	 /* max to read() in one go */
+#define MAX_WRITE_AT_ONCE	(size_t) 524288	 /* max to write() in one go */
+#define TRANSFER_READ_TIMEOUT	0.09L		 /* seconds to time reads out at */
+#define TRANSFER_WRITE_TIMEOUT	0.9L		 /* seconds to time writes out at */
+#define MAX_LINE_POSITIONS	100000		 /* number of lines to remember positions of */
 
 #define MAXIMISE_BUFFER_FILL	1
 
-
-typedef struct pvhistory {
-	long long   total_bytes;
-	long double elapsed_sec;
-} pvhistory_t;
-
 #define PV_SIZEOF_DEFAULT_FORMAT	512
 #define PV_SIZEOF_CWD			4096
-#define PV_SIZEOF_LASTOUTPUT_BUFFER	256
-#define PV_SIZEOF_STR_NAME		512
-#define PV_SIZEOF_STR_TRANSFERRED	128
-#define PV_SIZEOF_STR_BUFPERCENT	128
-#define PV_SIZEOF_STR_TIMER		128
-#define PV_SIZEOF_STR_RATE		128
-#define PV_SIZEOF_STR_AVERAGE_RATE	128
-#define PV_SIZEOF_STR_PROGRESS		1024
-#define PV_SIZEOF_STR_LASTOUTPUT	512
-#define PV_SIZEOF_STR_ETA		128
-#define PV_SIZEOF_STR_FINETA		128
+#define PV_SIZEOF_LASTWRITTEN_BUFFER	256
+#define PV_SIZEOF_PREVLINE_BUFFER	1024
 #define PV_FORMAT_ARRAY_MAX		100
+#define PV_SIZEOF_FORMAT_SEGMENTS_BUF	4096
 #define PV_SIZEOF_CRS_LOCK_FILE		1024
 
 #define PV_SIZEOF_FILE_FDINFO		4096
@@ -69,129 +49,349 @@ typedef struct pvhistory {
 #define PV_SIZEOF_FILE_FDPATH		4096
 #define PV_SIZEOF_DISPLAY_NAME		512
 
+#define PV_BARSTYLE_MAX			4	/* number of different styles allowed in a format */
+#define PV_BARSTYLE_SIZEOF_STRING	10	/* max length of a bar constituent component in bytes */
+#define PV_BARSTYLE_MAX_FILLERS		10	/* max number of bar filler strings */
+
+#define PV_DISPLAY_WINDOWTITLE		1
+#define PV_DISPLAY_PROCESSTITLE		2
+
+
+/*
+ * Structure for data shared between multiple "pv -c" instances.
+ */
+struct pvipccursorstate_s {
+	int y_topmost;		/* terminal row of topmost "pv" instance */
+	bool tty_tostop_added;	/* whether any instance had to set TOSTOP on the terminal */
+};
+
+/*
+ * Types of transfer count - bytes, decimal bytes or lines.
+ */
+typedef enum {
+	PV_TRANSFERCOUNT_BYTES,
+	PV_TRANSFERCOUNT_DECBYTES,
+	PV_TRANSFERCOUNT_LINES
+} pvtransfercount_t;
+
+
+/*
+ * Structure describing a short string used as part of a progress bar, whose
+ * width in display characters may not be the same as its length in bytes.
+ */
+struct pvbarstring_spec_s {
+	char string[PV_BARSTYLE_SIZEOF_STRING];
+	uint8_t width;
+	uint8_t bytes;
+};
+
+/*
+ * Structure describing a style of progress bar.
+ *
+ * The part that moves back and forth when the size isn't known, such as
+ * "<=>", is "indicator".
+ *
+ * The string used to populate the rest of the bar is one of "filler", which
+ * contains "filler_entries" array items.  The first item "filler[0]" is
+ * used for an empty part such as " ".  The last item
+ * "filler[filler_entries-1]" is used for a 100% full part, such as "=".
+ *
+ * If there are more than the minimum of 2 entries, then the intervening
+ * entries are used for partial fills.
+ *
+ * When there are only 2 entries and the bar isn't completely empty or full,
+ * the last filled portion of the bar is filled with "tip" instead of the
+ * last filler item to indicate the tip of the bar, such as ">".
+ *
+ * Note that only the indicator is expected to ever be wider than 1 display
+ * character.  All other items are expected to have a width of 0 or 1.
+ *
+ * The "style_id" is an opaque identifier that should only be used to
+ * determine whether two styles are the same.  It is always nonzero.
+ */
+struct pvbarstyle_s {
+	uint8_t style_id;
+	uint8_t filler_entries;
+	struct pvbarstring_spec_s indicator;
+	struct pvbarstring_spec_s tip;
+	struct pvbarstring_spec_s filler[PV_BARSTYLE_MAX_FILLERS];
+};
+typedef struct pvbarstyle_s *pvbarstyle_t;
+
+
+/* Display format component type, -1 for static string. */
+typedef int8_t pvdisplay_component_t;
+#define PVDISPLAY_COMPONENT_MAX (127)	/* INT8_MAX */
+
+/* Byte count of a part of the display. */
+typedef uint16_t pvdisplay_bytecount_t;
+#define PVDISPLAY_BYTECOUNT_MAX (65535)	/* UINT16_MAX */
+
+/* Width of a part of the display. */
+typedef uint16_t pvdisplay_width_t;
+#define PVDISPLAY_WIDTH_MAX (65535)	/* UINT16_MAX */
+
+/*
+ * Structure defining the current state of a single watched file descriptor.
+ */
+struct pvwatchfd_s;
+typedef /*@null@*/ struct pvwatchfd_s *pvwatchfd_t;
+
+/* String pointer, that is the only pointer to this resource, that can be null. */
+typedef /*@only@*/ /*@null@*/ char * nullable_string_t;
 
 /*
  * Structure for holding PV internal state. Opaque outside the PV library.
+ *
+ * In general, members are ordered by size, to minimise padding.
  */
 struct pvstate_s {
+	/******************
+	 * Program status *
+	 ******************/
+	struct pvprogramstatus_s {
+		char cwd[PV_SIZEOF_CWD];	 /* current working directory for relative path */
+		int current_input_file;		 /* index of current file being read */
+		int exit_status; 		 /* exit status to give (0=OK) */
+		bool terminal_supports_utf8;	 /* whether the terminal supports UTF-8 */
+		bool terminal_supports_colour;	 /* whether the terminal supports colour */
+		bool checked_colour_support;	 /* whether we have checked colour support yet */
+	} status;
+
 	/***************
 	 * Input files *
 	 ***************/
-	int input_file_count;		 /* number of input files */
-	const char **input_files;	 /* input files (0=first) */
+	struct pvinputfiles_s {
+		/*@only@*/ /*@null@*/ nullable_string_t *filename; /* input filenames */
+		unsigned int file_count;	 /* number of input files */
+	} files;
+
+	/*********************************
+	 * Items to watch with --watchfd *
+	 *********************************/
+	struct {
+		/*@only@*/ /*@null@*/
+		struct pvwatcheditem_s {	/* array of PID or PID:FD items */
+			pid_t pid;		 /* watched PID */
+			int fd;			 /* watched fd, or -1 for all */
+			pvwatchfd_t info_array;	 /* watch information for each fd */
+			int array_length;	 /* length of watch info array */
+			bool finished;		 /* "PID:FD": fd closed; or PID gone */
+		} *watching;
+		unsigned int count;	/* number of items in these arrays */
+		bool multiple_pids;	/* true if more than one distinct PID */
+	} watchfd;
 
 	/*******************
 	 * Program control *
 	 *******************/
-	bool force;                      /* display even if not on terminal */
-	bool cursor;                     /* use cursor positioning */
-	bool numeric;                    /* numeric output only */
-	bool wait;                       /* wait for data before display */
-	bool linemode;                   /* count lines instead of bytes */
-	bool bits;			 /* report bits instead of bytes */
-	bool null;                       /* lines are null-terminated */
-	bool no_op;                      /* do nothing other than pipe data */
-	unsigned int skip_errors;        /* skip read errors counter */
-	bool stop_at_size;               /* set if we stop at "size" bytes */
-	bool sync_after_write;           /* set if we sync after every write */
-	bool direct_io;                  /* set if O_DIRECT is to be used */
-	bool direct_io_changed;          /* set when direct_io is changed */
-	bool no_splice;                  /* never use splice() */
-	unsigned long long rate_limit;   /* rate limit, in bytes per second */
-	unsigned long long target_buffer_size;  /* buffer size (0=default) */
-	unsigned long long size;         /* total size of data */
-	double interval;                 /* interval between updates */
-	double delay_start;              /* delay before first display */
-	unsigned int watch_pid;		 /* process to watch fds of */
-	int watch_fd;			 /* fd to watch */
-	unsigned int width;              /* screen width */
-	unsigned int height;             /* screen height */
-	const char *name;		 /* display name */
-	char default_format[PV_SIZEOF_DEFAULT_FORMAT];	 /* default format string */
-	const char *format_string;	 /* output format string */
-
-	/******************
-	 * Program status *
-	 ******************/
-	const char *program_name;	 /* program name for error reporting */
-	char cwd[PV_SIZEOF_CWD];	 /* current working directory for relative path */
-	const char *current_file;	 /* current file being read */
-	int exit_status; 		 /* exit status to give (0=OK) */
+	struct pvcontrol_s {
+		char default_format[PV_SIZEOF_DEFAULT_FORMAT];	 /* default format string */
+		double interval;                 /* interval between updates */
+		double delay_start;              /* delay before first display */
+		/*@only@*/ /*@null@*/ char *name;		 /* display name */
+		/*@only@*/ /*@null@*/ char *format_string;	 /* output format string */
+		/*@only@*/ /*@null@*/ char *extra_display_spec;  /* full spec for extra displays */
+		/*@only@*/ /*@null@*/ char *extra_format_string; /* extra format string alone */
+		/*@null@*/ char *output_name;    /* name of the output, for diagnostics */
+		/*@null@*/ char *default_bar_style; /* which bar style to use by default */
+		off_t error_skip_block;          /* skip block size, 0 for adaptive */
+		off_t rate_limit;                /* rate limit, in bytes per second */
+		size_t target_buffer_size;       /* buffer size (0=default) */
+		off_t size;                      /* total size of data */
+		unsigned int skip_errors;        /* skip read errors counter */
+		int output_fd;                   /* fd to write output to */
+		unsigned int average_rate_window; /* time window in seconds for average rate calculations */
+		unsigned int history_interval;	 /* seconds between each average rate calc history entry */
+		pvdisplay_width_t width;         /* screen width */
+		unsigned int height;             /* screen height */
+		unsigned int extra_displays;	 /* bitmask of extra display destinations */
+		struct {			 /* old-style format options (used by -R) */
+			size_t lastwritten;	  /* --last-written (amount) */
+			bool progress;		  /* --progress */
+			bool timer;		  /* --timer */
+			bool eta;		  /* --eta */
+			bool fineta;		  /* --fineta */
+			bool rate;		  /* --rate */
+			bool average_rate;	  /* --average-rate */
+			bool bytes;		  /* --bytes */
+			bool bufpercent;	  /* --buffer-percent */
+		} format_option;
+		bool force;                      /* display even if not on terminal */
+		bool cursor;                     /* use cursor positioning */
+		bool numeric;                    /* numeric output only */
+		bool wait;                       /* wait for data before display */
+		bool rate_gauge;                 /* if size unknown, show rate vs max rate */
+		bool linemode;                   /* count lines instead of bytes */
+		bool bits;			 /* report bits instead of bytes */
+		bool decimal_units;		 /* use decimal prefixes */
+		bool null_terminated_lines;      /* lines are null-terminated */
+		bool no_display;                 /* do nothing other than pipe data */
+		bool no_splice;                  /* never use splice() */
+		bool stop_at_size;               /* set if we stop at "size" bytes */
+		bool sync_after_write;           /* set if we sync after every write */
+		bool direct_io;                  /* set if O_DIRECT is to be used */
+		bool direct_io_changed;          /* set when direct_io is changed */
+		bool sparse_output;		 /* set if we leave holes in the output */
+		bool discard_input;              /* write nothing to stdout */
+		bool show_stats;		 /* show statistics on exit */
+		bool width_set_manually;	 /* width was set manually, not detected */
+		bool height_set_manually;	 /* height was set manually, not detected */
+	} control;
 
 	/*******************
 	 * Signal handling *
 	 *******************/
-	int pv_sig_old_stderr;		 /* see pv_sig_ttou() */
-	struct timeval pv_sig_tstp_time; /* see pv_sig_tstp() / __cont() */
-	struct timeval pv_sig_toffset;		 /* total time spent stopped */
-	volatile sig_atomic_t pv_sig_newsize;	 /* whether we need to get term size again */
-	volatile sig_atomic_t pv_sig_abort;	 /* whether we need to abort right now */
-	volatile sig_atomic_t reparse_display;	 /* whether to re-check format string */
-	struct sigaction pv_sig_old_sigpipe;
-	struct sigaction pv_sig_old_sigttou;
-	struct sigaction pv_sig_old_sigtstp;
-	struct sigaction pv_sig_old_sigcont;
-	struct sigaction pv_sig_old_sigwinch;
-	struct sigaction pv_sig_old_sigint;
-	struct sigaction pv_sig_old_sighup;
-	struct sigaction pv_sig_old_sigterm;
+	struct pvsignal_s {
+		/* old signal handlers to restore in pv_sig_fini(). */
+		struct sigaction old_sigpipe;
+		struct sigaction old_sigttou;
+		struct sigaction old_sigtstp;
+		struct sigaction old_sigcont;
+		struct sigaction old_sigwinch;
+		struct sigaction old_sigint;
+		struct sigaction old_sighup;
+		struct sigaction old_sigterm;
+#ifdef PV_REMOTE_CONTROL
+		struct sigaction old_sigusr2;
+		struct sigaction old_sigusr1;
+#endif
+		struct sigaction old_sigalrm;
+		struct timespec when_tstp_arrived;	 /* see pv_sig_tstp() / __cont() */
+		struct timespec total_stoppage_time;	 /* total time spent stopped */
+#ifdef PV_REMOTE_CONTROL
+		volatile sig_atomic_t rxusr2;	 /* whether SIGUSR2 was received */
+		volatile pid_t sender_usr2;	 /* PID of sending process for SIGUSR2 */
+		volatile sig_atomic_t rxusr1;	 /* whether SIGUSR1 was received */
+		volatile pid_t sender_usr1;	 /* PID of sending process for SIGUSR1 */
+#endif
+	} signal;
+
+	/*******************
+	 * Transient flags *
+	 *******************/
+	struct pvtransientflags_s {
+		volatile sig_atomic_t reparse_display;	 /* whether to re-check format string */
+		volatile sig_atomic_t terminal_resized;	 /* whether we need to get term size again */
+		volatile sig_atomic_t trigger_exit;	 /* whether we need to abort right now */
+		volatile sig_atomic_t clear_tty_tostop_on_exit;	/* whether to clear tty TOSTOP on exit */
+		volatile sig_atomic_t suspend_stderr;	 /* whether writing to stderr is suspended */
+		volatile sig_atomic_t skip_next_sigcont; /* whether to ignore the next SIGCONT */
+		volatile sig_atomic_t pipe_closed;	 /* whether the output pipe was closed */
+	} flags;
 
 	/*****************
 	 * Display state *
 	 *****************/
-	long percentage;
-	long double prev_elapsed_sec;
-	long double prev_rate;
-	long double prev_trans;
+	struct pvdisplay_s {
 
-	/* Keep track of progress over last intervals to compute current average rate. */
-	pvhistory_t *history;            /* state at previous intervals (circular buffer) */
-	int history_len;		 /* total size */
-	int history_interval;		 /* seconds between each history entry */
-	int history_first;
-	int history_last;
-	long double current_avg_rate;    /* current average rate over last history intervals */
-	
-	unsigned long long initial_offset;
-	char *display_buffer;
-	long display_buffer_size;
-	int lastoutput_length;		 /* number of last-output bytes to show */
-	unsigned char lastoutput_buffer[PV_SIZEOF_LASTOUTPUT_BUFFER];
-	int prev_width;			 /* screen width last time we were called */
-	int prev_length;		 /* length of last string we output */
-	char str_name[PV_SIZEOF_STR_NAME];
-	char str_transferred[PV_SIZEOF_STR_TRANSFERRED];
-	char str_bufpercent[PV_SIZEOF_STR_BUFPERCENT];
-	char str_timer[PV_SIZEOF_STR_TIMER];
-	char str_rate[PV_SIZEOF_STR_RATE];
-	char str_average_rate[PV_SIZEOF_STR_AVERAGE_RATE];
-	char str_progress[PV_SIZEOF_STR_PROGRESS];
-	char str_lastoutput[PV_SIZEOF_STR_LASTOUTPUT];
-	char str_eta[PV_SIZEOF_STR_ETA];
-	char str_fineta[PV_SIZEOF_STR_FINETA];
-	unsigned long components_used;	 /* bitmask of components used */
-	struct {
-		const char *string;
-		int length;
-	} format[PV_FORMAT_ARRAY_MAX];
-	bool display_visible;		 /* set once anything written to terminal */
+		struct pvdisplay_segment_s {	/* format string broken into segments */
+			/* See pv__format_init() for more details. */
+			/*@dependent@*/ /*@null@*/ const char *string_parameter; /* parameter after colon in %{x:} */
+			pvdisplay_bytecount_t string_parameter_bytes;	/* number of bytes in string_parameter */
+			pvdisplay_component_t type;	/* component type, -1 for static string */
+			int8_t parameter;		/* component parameter, such as bar style index */
+			pvdisplay_width_t chosen_size;	/* "n" from %<n>A, or 0 */
+			pvdisplay_bytecount_t offset;	/* start offset of this segment in the build buffer */
+			pvdisplay_bytecount_t bytes;	/* length of segment in bytes in the build buffer */
+			pvdisplay_width_t width;	/* displayed width of segment */
+		} format[PV_FORMAT_ARRAY_MAX];
+
+		struct pvbarstyle_s barstyle[PV_BARSTYLE_MAX];
+
+		/* The last-written "n" bytes. */
+		char lastwritten_buffer[PV_SIZEOF_LASTWRITTEN_BUFFER];
+
+		/* The most recently output complete line. */
+		char previous_line[PV_SIZEOF_PREVLINE_BUFFER];
+		/* The line being received now. */
+		char next_line[PV_SIZEOF_PREVLINE_BUFFER];
+
+		/*@only@*/ /*@null@*/ char *display_buffer;	/* buffer for display string */
+		off_t initial_offset;			 /* offset when first opened (when watching fds) */
+		size_t next_line_len;				 /* length of currently receiving line so far */
+
+		size_t format_segment_count;	 /* number of format string segments */
+
+		pvtransfercount_t count_type;	 /* type of count for transfer, rate, etc */
+
+		pvdisplay_width_t prev_screen_width;	 /* screen width last time we were called */
+
+		pvdisplay_bytecount_t display_buffer_size;	/* size allocated to display buffer */
+		pvdisplay_bytecount_t display_string_bytes;	/* byte length of string in display buffer */
+		pvdisplay_width_t display_string_width;		/* displayed width of string in display buffer */
+		pvdisplay_bytecount_t lastwritten_bytes;	 /* largest number of last-written bytes to show */
+
+		bool showing_timer;		 /* set if showing timer */
+		bool showing_bytes;		 /* set if showing byte/line count */
+		bool showing_rate;		 /* set if showing transfer rate */
+		bool showing_last_written;	 /* set if displaying the last few bytes written */
+		bool showing_previous_line;	 /* set if displaying the previously output line */
+
+		bool format_uses_colour;	 /* set if the format string uses colours */
+		bool colour_permitted;		 /* whether colour is permitted for this display */
+		bool sgr_code_active;		 /* set while SGR code is active in a display line */
+		bool final_update;		 /* set internally on the final update */
+		bool output_produced;		 /* set once anything written to terminal */
+
+	} display;
+
+	/* Extra display for alternate outputs like a window title. */
+	struct pvdisplay_s extra_display;
+
+	/************************************
+	 * Calculated state of the transfer *
+	 ************************************/
+	struct pvtransfercalc_s {
+		long double transfer_rate;	 /* calculated transfer rate */
+		long double average_rate;	 /* calculated average transfer rate */
+
+		long double prev_elapsed_sec;	 /* elapsed sec at which rate last calculated */
+		long double prev_rate;		 /* last calculated instantaneous transfer rate */
+		long double prev_trans;		 /* amount transferred since last rate calculation */
+		long double current_avg_rate;    /* current average rate over last history intervals */
+
+		long double rate_min;		 /* minimum measured transfer rate */
+		long double rate_max;		 /* maximum measured transfer rate */
+		long double rate_sum;		 /* sum of all measured transfer rates */
+		long double ratesquared_sum;	 /* sum of the squares of each transfer rate */
+		unsigned long measurements_taken; /* how many times the rate was measured */
+
+		/* Keep track of progress over last intervals to compute current average rate. */
+		/*@null@*/ struct {	 /* state at previous intervals (circular buffer) */
+			long double elapsed_sec;	/* time since start of transfer */
+			off_t transferred;		/* amount transferred by that time */
+		} *history;
+		size_t history_len;		 /* total size of history array */
+		size_t history_first;		 /* index of oldest entry */
+		size_t history_last;		 /* index of newest entry */
+
+		off_t prev_transferred;		 /* total amount transferred when called last time */
+
+		double percentage;		 /* transfer percentage completion */
+	} calc;
 
 	/********************
 	 * Cursor/IPC state *
 	 ********************/
+	struct pvcursorstate_s {
+		char lock_file[PV_SIZEOF_CRS_LOCK_FILE];
 #ifdef HAVE_IPC
-	int crs_shmid;			 /* ID of our shared memory segment */
-	int crs_pvcount;		 /* number of `pv' processes in total */
-	int crs_pvmax;			 /* highest number of `pv's seen */
-	int *crs_y_top;			 /* pointer to Y coord of topmost `pv' */
-	int crs_y_lastread;		 /* last value of _y_top seen */
-	int crs_y_offset;		 /* our Y offset from this top position */
-	int crs_needreinit;		 /* counter if we need to reinit cursor pos */
-	bool crs_noipc;			 /* set if we can't use IPC */
+		/*@keep@*/ /*@null@*/ struct pvipccursorstate_s *shared; /* data shared between instances */
+		int shmid;		 /* ID of our shared memory segment */
+		int pvcount;		 /* number of `pv' processes in total */
+		int pvmax;		 /* highest number of `pv's seen */
+		int y_lastread;		 /* last value of _y_top seen */
+		int y_offset;		 /* our Y offset from this top position */
+		int needreinit;		 /* counter if we need to reinit cursor pos */
 #endif				/* HAVE_IPC */
-	int crs_lock_fd;		 /* fd of lockfile, -1 if none open */
-	char crs_lock_file[PV_SIZEOF_CRS_LOCK_FILE];
-	int crs_y_start;		 /* our initial Y coordinate */
+		int lock_fd;		 /* fd of lockfile, -1 if none open */
+		int y_start;		 /* our initial Y coordinate */
+#ifdef HAVE_IPC
+		bool noipc;		 /* set if we can't use IPC */
+#endif				/* HAVE_IPC */
+		bool disable;		 /* set if cursor positioning can't be used */
+	} cursor;
 
 	/*******************
 	 * Transfer state  *
@@ -200,9 +400,9 @@ struct pvstate_s {
 	 * The transfer buffer is used for moving data from the input files
 	 * to the output when splice() is not available.
 	 *
-	 * If buffer_size is smaller than pv__target_bufsize, then
-	 * pv_transfer will try to reallocate transfer_buffer to make
-	 * buffer_size equal to pv__target_bufsize.
+	 * If buffer_size is smaller than control.target_buffer_size, then
+	 * pv_transfer() will try to reallocate transfer_buffer to make
+	 * buffer_size equal to control.target_buffer_size.
 	 *
 	 * Data from the input files is read into the buffer; read_position
 	 * is the offset in the buffer that we've read data up to.
@@ -211,91 +411,250 @@ struct pvstate_s {
 	 * is the offset in the buffer that we've written data up to.  It
 	 * will always be less than or equal to read_position.
 	 */
-	unsigned char *transfer_buffer;	 /* data transfer buffer */
-	unsigned long long buffer_size;	 /* size of buffer */
-	unsigned long read_position;	 /* amount of data in buffer */
-	unsigned long write_position;	 /* buffered data written */
+	struct pvtransferstate_s {
+		long double elapsed_seconds;	 /* how long we have been transferring data for */
+		/*@only@*/ /*@null@*/ char *transfer_buffer;	 /* data transfer buffer */
+		size_t buffer_size;		 /* size of buffer */
+		size_t read_position;		 /* amount of data in buffer */
+		size_t write_position;		 /* buffered data written */
 
-	/*
-	 * While reading from a file descriptor we keep track of how many
-	 * times in a row we've seen errors (read_errors_in_a_row), and
-	 * whether or not we have put a warning on stderr about read errors
-	 * on this fd (read_error_warning_shown).
-	 *
-	 * Whenever the active file descriptor changes from
-	 * last_read_skip_fd, we reset read_errors_in_a_row and
-	 * read_error_warning_shown to 0 for the new file descriptor and set
-	 * last_read_skip_fd to the new fd number.
-	 *
-	 * This way, we're treating each input file separately.
-	 */
-	int last_read_skip_fd;
-	unsigned long read_errors_in_a_row;
-	int read_error_warning_shown;
+		ssize_t to_write;		 /* max to write this time around */
+		ssize_t written;		 /* bytes sent to stdout this time */
+
+		size_t written_but_not_consumed; /* bytes in the output pipe, unread */
+
+		off_t total_bytes_read;		 /* total bytes read */
+		off_t total_written;		 /* total bytes or lines written */
+		off_t transferred;		 /* amount transferred (written - unconsumed) */
+
+		/* Keep track of line positions to backtrack written_but_not_consumed. */
+		/*@only@*/ /*@null@*/ off_t *line_positions; /* line separator write positions (circular buffer) */
+		size_t line_positions_capacity;	 /* total size of line position array */
+		size_t line_positions_length;	 /* number of positions stored in array */
+		size_t line_positions_head;	 /* index to use for next position */
+		off_t last_output_position;	 /* write position last sent to output */
+
+		/*
+		 * While reading from a file descriptor we keep track of how
+		 * many times in a row we've seen errors
+		 * (read_errors_in_a_row), and whether or not we have put a
+		 * warning on stderr about read errors on this fd
+		 * (read_error_warning_shown).
+		 *
+		 * Whenever the active file descriptor changes from
+		 * last_read_skip_fd, we reset read_errors_in_a_row to 0 and
+		 * read_error_warning_shown to false for the new file
+		 * descriptor and set last_read_skip_fd to the new fd
+		 * number.
+		 *
+		 * This way, we're treating each input file separately.
+		 */
+		off_t read_errors_in_a_row;
+		int last_read_skip_fd;
+		/* read_error_warning_shown is defined below. */
 #ifdef HAVE_SPLICE
-	/*
-	 * These variables are used to keep track of whether splice() was
-	 * used; splice_failed_fd is the file descriptor that splice() last
-	 * failed on, so that we don't keep trying to use it on an fd that
-	 * doesn't support it, and splice_used is set to 1 if splice() was
-	 * used this time within pv_transfer().
-	 */
-	int splice_failed_fd;
-	int splice_used;
+		/*
+		 * These variables are used to keep track of whether
+		 * splice() was used; splice_failed_fd is the file
+		 * descriptor that splice() last failed on, so that we don't
+		 * keep trying to use it on an fd that doesn't support it,
+		 * and splice_used is set to true if splice() was used this
+		 * time within pv_transfer().
+		 */
+		int splice_failed_fd;
+		bool splice_used;
 #endif
-	long to_write;			 /* max to write this time around */
-	long written;			 /* bytes sent to stdout this time */
+		bool read_error_warning_shown;
+		bool output_not_seekable;	/* set if lseek() fails on output */
+	} transfer;
 };
 
+typedef struct pvprogramstatus_s *pvprogramstatus_t;
+typedef struct pvinputfiles_s *pvinputfiles_t;
+typedef struct pvcontrol_s *pvcontrol_t;
+typedef struct pvsignal_s *pvsignal_t;
+typedef struct pvtransientflags_s *pvtransientflags_t;
+typedef struct pvdisplay_s *pvdisplay_t;
+typedef struct pvdisplay_segment_s *pvdisplay_segment_t;
+typedef struct pvtransfercalc_s *pvtransfercalc_t;
+typedef struct pvcursorstate_s *pvcursorstate_t;
+typedef struct pvtransferstate_s *pvtransferstate_t;
 
+/*
+ * Structure defining the current state of a single watched file descriptor.
+ * The full definition needs to go here as it refers to sub-structures of
+ * the main state, defined above.
+ */
 struct pvwatchfd_s {
-	unsigned int watch_pid;		 /* PID to watch */
-	int watch_fd;			 /* fd to watch, -1 = not displayed */
+	struct pvtransientflags_s flags;	/* transient flags */
+	struct pvtransferstate_s transfer;	/* transfer state */
+	struct pvtransfercalc_s calc;	 /* calculated transfer state */
+	struct pvdisplay_s display;	 /* display data */
 #ifdef __APPLE__
 #else
 	char file_fdinfo[PV_SIZEOF_FILE_FDINFO]; /* path to /proc fdinfo file */
 	char file_fd[PV_SIZEOF_FILE_FD];	 /* path to /proc fd symlink  */
 #endif
 	char file_fdpath[PV_SIZEOF_FILE_FDPATH]; /* path to file that was opened */
-	char display_name[PV_SIZEOF_DISPLAY_NAME]; /* name to show on progress bar */
+	/*@keep@ */ char display_name[PV_SIZEOF_DISPLAY_NAME]; /* name to show on progress bar */
 	struct stat sb_fd;		 /* stat of fd symlink */
 	struct stat sb_fd_link;		 /* lstat of fd symlink */
-	unsigned long long size;	 /* size of whole file, 0 if unknown */
-	long long position;		 /* position last seen at */
-	struct timeval start_time;	 /* time we started watching the fd */
+	off_t size;			 /* size of whole file, 0 if unknown */
+	off_t position;			 /* position last seen at */
+	struct timespec start_time;	 /* time we started watching the fd */
+	struct timespec end_time;	 /* time the fd was marked as closed */
+	struct timespec total_stoppage_time;	 /* total time spent stopped */
+	pid_t watch_pid;		 /* PID the fd belongs to */
+	int watch_fd;			 /* fd to watch */
+	bool closed;			 /* true once the fd is closed */
+	bool displayable;		 /* false if not displayable */
+	bool unused;			 /* true if free for re-use */
 };
-typedef struct pvwatchfd_s *pvwatchfd_t;
 
-void pv_error(pvstate_t, char *, ...);
+/*
+ * Read-only counterparts to the above structure pointers, to be used in
+ * function declarations where the function definitely shouldn't be altering
+ * the contents of the structure.
+ */
+typedef const struct pvprogramstatus_s * readonly_pvprogramstatus_t;
+typedef const struct pvinputfiles_s * readonly_pvinputfiles_t;
+typedef const struct pvcontrol_s * readonly_pvcontrol_t;
+typedef const struct pvsignal_s * readonly_pvsignal_t;
+typedef const struct pvtransientflags_s * readonly_pvtransientflags_t;
+typedef const struct pvdisplay_s * readonly_pvdisplay_t;
+typedef const struct pvdisplay_segment_s * readonly_pvdisplay_segment_t;
+typedef const struct pvtransfercalc_s * readonly_pvtransfercalc_t;
+typedef const struct pvcursorstate_s * readonly_pvcursorstate_t;
+typedef const struct pvtransferstate_s * readonly_pvtransferstate_t;
+
+/*
+ * Structure containing the parameters used by formatters.
+ */
+struct pvformatter_args_s {
+	/*@dependent@*/ pvdisplay_t display;		/* the display being updated */
+	/*@dependent@*/ pvdisplay_segment_t segment;	/* the segment of the display */
+	/*@dependent@*/ readonly_pvprogramstatus_t status;	/* program status */
+	/*@dependent@*/ readonly_pvcontrol_t control;		/* control settings */
+	/*@dependent@*/ readonly_pvtransferstate_t transfer;	/* transfer state */
+	/*@dependent@*/ readonly_pvtransfercalc_t calc;		/* calculated transfer state */
+	/*@dependent@*/ char *buffer;			/* buffer to write formatted segments into */
+	pvdisplay_bytecount_t buffer_size;		/* size of the buffer */
+	pvdisplay_bytecount_t offset;			/* current write position in the buffer */
+};
+typedef struct pvformatter_args_s *pvformatter_args_t;
+
+
+/* Pointer to a formatter function. */
+typedef pvdisplay_bytecount_t (*pvdisplay_formatter_t)(pvformatter_args_t);
+
+
+/*
+ * Structure defining a format string sequence following a %.
+ */
+struct pvdisplay_component_s {
+	/*@null@ */ const char *match;			/* string to match */
+	/*@null@ */ pvdisplay_formatter_t function;	/* function to call */
+	bool dynamic;			 /* whether it can scale with screen size */
+};
+
+void pv_error(char *, ...);
 
 int pv_main_loop(pvstate_t);
-void pv_display(pvstate_t, long double, long long, long long);
-long pv_transfer(pvstate_t, int, int *, int *, unsigned long long, long *);
-void pv_set_buffer_size(unsigned long long, int);
-int pv_next_file(pvstate_t, int, int);
+void pv_calculate_transfer_rate(pvtransfercalc_t, readonly_pvtransferstate_t, readonly_pvcontrol_t, readonly_pvdisplay_t, bool);
+
+long pv_bound_long(long, long, long);
+long pv_seconds_remaining(const off_t, const off_t, const long double);
+void pv_si_prefix(long double *, char *, const long double, pvtransfercount_t);
+void pv_describe_amount(char *, size_t, char *, long double, char *, char *, pvtransfercount_t);
+
+int8_t pv_display_barstyle_index(pvformatter_args_t, const char *);
+
+pvdisplay_bytecount_t pv_formatter_segmentcontent(char *, pvformatter_args_t);
+
+/*
+ * Formatting functions.
+ *
+ * Each formatting function takes a state, the current display, and the
+ * segment it's for; it also takes a buffer, with a particular size, and an
+ * offset at which to start writing to the buffer.
+ *
+ * If the component is dynamically sized (such as a progress bar with no
+ * chosen_size constraint), the segment's "width" is expected to have
+ * already been populated by the caller, with the target width.
+ *
+ * The function writes the appropriate string to the buffer at the offset,
+ * and updates the segment's "offset" and "bytes".  The number of bytes
+ * written ("bytes") is also returned; it will be 0 if the string would not
+ * fit into the buffer.
+ *
+ * The caller is expected to update the segment's "width".
+ *
+ * If called with a buffer size of 0, only the side effects occur (such as
+ * setting flags like display->showing_timer).
+ */
+pvdisplay_bytecount_t pv_formatter_progress(pvformatter_args_t);
+pvdisplay_bytecount_t pv_formatter_progress_bar_only(pvformatter_args_t);
+pvdisplay_bytecount_t pv_formatter_progress_amount_only(pvformatter_args_t);
+pvdisplay_bytecount_t pv_formatter_bar_default(pvformatter_args_t);
+pvdisplay_bytecount_t pv_formatter_bar_plain(pvformatter_args_t);
+pvdisplay_bytecount_t pv_formatter_bar_block(pvformatter_args_t);
+pvdisplay_bytecount_t pv_formatter_bar_granular(pvformatter_args_t);
+pvdisplay_bytecount_t pv_formatter_bar_shaded(pvformatter_args_t);
+pvdisplay_bytecount_t pv_formatter_timer(pvformatter_args_t);
+pvdisplay_bytecount_t pv_formatter_eta(pvformatter_args_t);
+pvdisplay_bytecount_t pv_formatter_fineta(pvformatter_args_t);
+pvdisplay_bytecount_t pv_formatter_rate(pvformatter_args_t);
+pvdisplay_bytecount_t pv_formatter_average_rate(pvformatter_args_t);
+pvdisplay_bytecount_t pv_formatter_bytes(pvformatter_args_t);
+pvdisplay_bytecount_t pv_formatter_buffer_percent(pvformatter_args_t);
+pvdisplay_bytecount_t pv_formatter_last_written(pvformatter_args_t);
+pvdisplay_bytecount_t pv_formatter_previous_line(pvformatter_args_t);
+pvdisplay_bytecount_t pv_formatter_name(pvformatter_args_t);
+pvdisplay_bytecount_t pv_formatter_sgr(pvformatter_args_t);
+
+bool pv_format (pvprogramstatus_t, readonly_pvcontrol_t,
+		readonly_pvtransferstate_t, readonly_pvtransfercalc_t,
+		/*@null@ */ const char *, pvdisplay_t, bool, bool);
+void pv_display (pvprogramstatus_t, readonly_pvcontrol_t, pvtransientflags_t,
+		 readonly_pvtransferstate_t, pvtransfercalc_t,
+		 pvcursorstate_t, pvdisplay_t, /*@null@ */ pvdisplay_t, bool);
+
+ssize_t pv_transfer(pvstate_t, int, bool *, bool *, off_t, long *);
+int pv_next_file(pvstate_t, unsigned int, int);
+/*@keep@*/ const char *pv_current_file_name(pvstate_t);
+
+unsigned int pv_update_calc_average_rate_window(pvtransfercalc_t, unsigned int);
+void pv_reset_calc(pvtransfercalc_t);
+void pv_reset_transfer(pvtransferstate_t);
+void pv_reset_flags(pvtransientflags_t);
+void pv_reset_display(pvdisplay_t);
+void pv_reset_watchfd(pvwatchfd_t);
+void pv_freecontents_display(pvdisplay_t);
+void pv_freecontents_transfer(pvtransferstate_t);
+void pv_freecontents_calc(pvtransfercalc_t);
+void pv_freecontents_watchfd(pvwatchfd_t);
+void pv_freecontents_watchfd_items(struct pvwatcheditem_s *, unsigned int);
 
 void pv_write_retry(int, const char *, size_t);
+void pv_tty_write(readonly_pvtransientflags_t, const char *, size_t);
 
-void pv_crs_fini(pvstate_t);
-void pv_crs_init(pvstate_t);
-void pv_crs_update(pvstate_t, const char *);
+void pv_crs_fini(pvcursorstate_t, readonly_pvcontrol_t, pvtransientflags_t);
+void pv_crs_init(pvcursorstate_t, readonly_pvcontrol_t, pvtransientflags_t);
+void pv_crs_update(pvcursorstate_t, readonly_pvcontrol_t, pvtransientflags_t, const char *);
 #ifdef HAVE_IPC
-void pv_crs_needreinit(pvstate_t);
+void pv_crs_needreinit(pvcursorstate_t);
 #endif
 
 void pv_sig_allowpause(void);
 void pv_sig_checkbg(void);
 void pv_sig_nopause(void);
 
-void pv_remote_init(pvstate_t);
-void pv_remote_check(pvstate_t);
-void pv_remote_fini(pvstate_t);
-int pv_remote_set(pvstate_t);
+bool pv_remote_check(pvstate_t);
 
-int pv_watchfd_info(pvstate_t, pvwatchfd_t, int);
-int pv_watchfd_changed(pvwatchfd_t);
-long long pv_watchfd_position(pvwatchfd_t);
-int pv_watchpid_scanfds(pvstate_t, pvstate_t, unsigned int, int *, pvwatchfd_t *, pvstate_t *, int *);
+int pv_watchfd_info(pvstate_t, pvwatchfd_t, bool);
+bool pv_watchfd_changed(pvwatchfd_t);
+off_t pv_watchfd_position(pvwatchfd_t);
+int pv_watchpid_scanfds(pvstate_t, pid_t, int, int *, pvwatchfd_t *);
 void pv_watchpid_setname(pvstate_t, pvwatchfd_t);
 
 #ifdef __cplusplus
@@ -303,5 +662,3 @@ void pv_watchpid_setname(pvstate_t, pvwatchfd_t);
 #endif
 
 #endif /* _PV_INTERNAL_H */
-
-/* EOF */

src/include/pv.h

@@ -1,20 +1,41 @@
 /*
- * Functions used across the program.  Include "config.h" first.
+ * Functions used across the program.
  *
- * Copyright 2002-2008, 2010, 2012-2015, 2017, 2021, 2023 Andrew Wood
+ * Copyright 2002-2008, 2010, 2012-2015, 2017, 2021, 2023-2025 Andrew Wood
  *
- * Distributed under the Artistic License v2.0; see `doc/COPYING'.
+ * License GPLv3+: GNU GPL version 3 or later; see `docs/COPYING'.
  */
 
 #ifndef _PV_H
 #define _PV_H 1
 
+#if HAVE_CONFIG_H
+#include "config.h"
+#endif
+
+#include <stdio.h>
 #include <stdlib.h>
+#include <stdbool.h>
+#include <signal.h>
+#include <time.h>
+#include <sys/types.h>
 
 #ifdef __cplusplus
 extern "C" {
 #endif
 
+/*
+ * Exit status bitmask values.
+ */
+#define PV_ERROREXIT_REMOTE_OR_PID 1
+#define PV_ERROREXIT_SAF	   1	/* store and forward error */
+#define PV_ERROREXIT_ACCESS        2
+#define PV_ERROREXIT_OUROBOROS     4
+#define PV_ERROREXIT_TRANSITION    8
+#define PV_ERROREXIT_TRANSFER      16
+#define PV_ERROREXIT_SIGNAL        32
+#define PV_ERROREXIT_MEMORY        64
+
 /*
  * Opaque structure for PV internal state.
  */
@@ -25,9 +46,10 @@ typedef struct pvstate_s *pvstate_t;
  * Valid number types for pv_getnum_check().
  */
 typedef enum {
-  PV_NUMTYPE_INTEGER,
-  PV_NUMTYPE_DOUBLE
-} pv_numtype_t;
+  PV_NUMTYPE_ANY_WITH_SUFFIX,
+  PV_NUMTYPE_BARE_INTEGER,
+  PV_NUMTYPE_BARE_DOUBLE
+} pv_numtype;
 
 
 /*
@@ -35,25 +57,41 @@ typedef enum {
  */
 
 /*
- * Return the given string converted to a double.
+ * Return true if the character is an ASCII digit.
  */
-extern double pv_getnum_d(const char *);
+extern bool pv_isdigit(char);
 
 /*
- * Return the given string converted to an unsigned integer.
+ * Return the given string converted to a double, for use as a time
+ * interval.
  */
-extern unsigned int pv_getnum_ui(const char *);
+extern double pv_getnum_interval(const char *);
 
 /*
- * Return the given string converted to an unsigned long long.
+ * Return the given string converted to an off_t, for use as a size,
+ * optionally interpreting suffixes in decimal units (multiples of 1000)
+ * instead of multiples of 1024.
  */
-extern unsigned long long pv_getnum_ull(const char *);
+extern off_t pv_getnum_size(const char *, bool);
 
 /*
- * Return zero if the given string is a number of the given type. NB an
+ * Return the given string converted to an unsigned integer, for use as a
+ * count such as screen width.
+ */
+extern unsigned int pv_getnum_count(const char *, bool);
+
+/*
+ * Return true if the given string is a number of the given type.  NB an
  * integer is both a valid integer and a valid double.
  */
-extern int pv_getnum_check(const char *, pv_numtype_t);
+extern bool pv_getnum_check(const char *, pv_numtype);
+
+/*
+ * Return a value representing the first amount as a percentage of the
+ * second total, i.e. 100*amount/total.  If the second value, the total, is
+ * zero or less, return 0.
+ */
+extern double pv_percentage(off_t, const off_t);
 
 /*
  * String handling wrappers.
@@ -71,15 +109,87 @@ extern int pv_snprintf(char *, size_t, const char *, ...);
  * termination with '\0'.
  */
 extern size_t pv_strlcat(char *, const char *, size_t);
+
+/*
+ * Allocate and return a duplicate of a \0-terminated string, ensuring that
+ * the duplicate is also \0-terminated.  Returns NULL on error.
+ */
+/*@null@ */ /*@only@ */ extern char *pv_strdup(const char *);
+
+/*
+ * Return a pointer to the last matching character in the buffer, or NULL if
+ * not found.
+ */
+/*@null@ */ /*@temp@ */ extern void *pv_memrchr(const void *, int, size_t);
+
+/*
+ * Return the displayed width of a string.
+ */
+extern size_t pv_strwidth(const char *, size_t);
+
+/*
+ * Return true if the character is printable.
+ */
+extern bool pv_isprint(char);
+
+/*
+ * Functions relating to elapsed time.
+ */
+
+/*
+ * Read the current elapsed time, relative to an unspecified point in the
+ * past, and store it in the given timespec buffer.  The time is guaranteed
+ * to not go backwards and does not count time when the system was
+ * suspended.  See clock_gettime(2) with CLOCK_MONOTONIC.
+ */
+void pv_elapsedtime_read(struct timespec *);
+
+/* Set the time in the given timespec to zero. */
+void pv_elapsedtime_zero(struct timespec *);
+
+/* Copy the second timespec into the first.  Analogous to strcpy(3). */
+void pv_elapsedtime_copy(struct timespec *, const struct timespec *);
+
+/*
+ * Return -1, 0, or 1 depending on whether the first time is earlier than,
+ * equal to, or later than the second time.  Analogous to strcmp(3).
+ */
+int pv_elapsedtime_compare(const struct timespec *, const struct timespec *);
+
+/* Add the latter two timespecs and store them in the first timespec. */
+void pv_elapsedtime_add(struct timespec *, const struct timespec *, const struct timespec *);
+
+/* Add a number of nanoseconds to the given timespec. */
+void pv_elapsedtime_add_nsec(struct timespec *, long long);
+
+/* Set the first timespec to the second minus the third. */
+void pv_elapsedtime_subtract(struct timespec *, const struct timespec *, const struct timespec *);
+
+/* Convert a timespec to seconds. */
+long double pv_elapsedtime_seconds(const struct timespec *);
+
+/* Sleep for a number of nanoseconds. */
+void pv_nanosleep(long long);
+
           
 /*
  * Main PV functions.
  */
 
+/*
+ * Set the prefix (program name) for any PV error messages.
+ */
+extern void pv_set_error_prefix(/*@unique@ */ const char *);
+
 /*
  * Create a new state structure, and return it, or 0 (NULL) on error.
  */
-extern pvstate_t pv_state_alloc(const char *);
+extern /*@null@*/ /*@only@*/ pvstate_t pv_state_alloc(void);
+
+/*
+ * Clear the calculated parts of a state structure.
+ */
+extern void pv_state_reset(pvstate_t state);
 
 /*
  * Set the formatting string, given a set of old-style formatting options.
@@ -89,39 +199,48 @@ extern void pv_state_set_format(pvstate_t state, bool progress,
 				bool fineta, bool rate,
 				bool average_rate, bool bytes,
 				bool bufpercent,
-				unsigned int lastwritten,
-				const char *name);
+				size_t lastwritten,
+				/*@null@*/ const char *name);
 
 /*
  * Set the various options.
  */
 extern void pv_state_force_set(pvstate_t, bool);
 extern void pv_state_cursor_set(pvstate_t, bool);
+extern void pv_state_show_stats_set(pvstate_t, bool);
 extern void pv_state_numeric_set(pvstate_t, bool);
 extern void pv_state_wait_set(pvstate_t, bool);
 extern void pv_state_delay_start_set(pvstate_t, double);
+extern void pv_state_rate_gauge_set(pvstate_t, bool);
 extern void pv_state_linemode_set(pvstate_t, bool);
 extern void pv_state_bits_set(pvstate_t, bool);
-extern void pv_state_null_set(pvstate_t, bool);
-extern void pv_state_no_op_set(pvstate_t, bool);
+extern void pv_state_decimal_units_set(pvstate_t, bool);
+extern void pv_state_null_terminated_lines_set(pvstate_t, bool);
+extern void pv_state_no_display_set(pvstate_t, bool);
 extern void pv_state_skip_errors_set(pvstate_t, unsigned int);
+extern void pv_state_error_skip_block_set(pvstate_t, off_t);
 extern void pv_state_stop_at_size_set(pvstate_t, bool);
 extern void pv_state_sync_after_write_set(pvstate_t, bool);
 extern void pv_state_direct_io_set(pvstate_t, bool);
-extern void pv_state_rate_limit_set(pvstate_t, unsigned long long);
-extern void pv_state_target_buffer_size_set(pvstate_t, unsigned long long);
+extern void pv_state_sparse_output_set(pvstate_t, bool);
+extern void pv_state_rate_limit_set(pvstate_t, off_t);
+extern void pv_state_target_buffer_size_set(pvstate_t, size_t);
 extern void pv_state_no_splice_set(pvstate_t, bool);
-extern void pv_state_size_set(pvstate_t, unsigned long long);
+extern void pv_state_discard_input_set(pvstate_t, bool);
+extern void pv_state_size_set(pvstate_t, off_t);
 extern void pv_state_interval_set(pvstate_t, double);
-extern void pv_state_width_set(pvstate_t, unsigned int);
-extern void pv_state_height_set(pvstate_t, unsigned int);
-extern void pv_state_name_set(pvstate_t, const char *);
-extern void pv_state_format_string_set(pvstate_t, const char *);
-extern void pv_state_watch_pid_set(pvstate_t, unsigned int);
-extern void pv_state_watch_fd_set(pvstate_t, int);
-extern void pv_state_average_rate_window_set(pvstate_t, int);
+extern void pv_state_width_set(pvstate_t, unsigned int, bool);
+extern void pv_state_height_set(pvstate_t, unsigned int, bool);
+extern void pv_state_name_set(pvstate_t, /*@null@*/ const char *);
+extern void pv_state_default_bar_style_set(pvstate_t, /*@null@ */ const char *);
+extern void pv_state_format_string_set(pvstate_t, /*@null@*/ const char *);
+extern void pv_state_extra_display_set(pvstate_t, /*@null@*/ const char *);
+extern void pv_state_output_set(pvstate_t, int, const char *);
+extern void pv_state_average_rate_window_set(pvstate_t, unsigned int);
+extern void pv_state_set_terminal_supports_utf8(pvstate_t, bool);
 
-extern void pv_state_inputfiles(pvstate_t, int, const char **);
+extern void pv_state_inputfiles(pvstate_t, unsigned int, const char **);
+extern void pv_state_watchfds(pvstate_t, unsigned int, const pid_t *, const int *);
 
 /*
  * Work out whether we are in the foreground.
@@ -136,27 +255,60 @@ extern void pv_screensize(unsigned int *width, unsigned int *height);
 /*
  * Calculate the total size of all input files.
  */
-extern unsigned long long pv_calc_total_size(pvstate_t);
+extern off_t pv_calc_total_size(pvstate_t);
 
 /*
  * Set up signal handlers ready for running the main loop.
  */
 extern void pv_sig_init(pvstate_t);
 
+#ifdef PV_REMOTE_CONTROL
+/*
+ * Return true if SIGUSR2 has been received, and indicate the sender.
+ */
+extern bool pv_sigusr2_received(pvstate_t, pid_t *);
+
+/*
+ * Return true if SIGUSR1 has been received, and indicate the sender.
+ */
+extern bool pv_sigusr1_received(pvstate_t, pid_t *);
+#endif
+
+/*
+ * Return a stream pointer for a control file associated with a particular
+ * process ID and signal.
+ */
+/*@null@ */
+/*@dependent@ */
+extern FILE *pv_open_controlfile(char *, size_t, pid_t, int, bool);
+
 /*
  * Enter the main transfer loop, transferring all input files to the output.
  */
 extern int pv_main_loop(pvstate_t);
 
 /*
- * Watch the selected file descriptor of the selected process.
+ * Watch the selected file descriptors of the selected processes.
  */
 extern int pv_watchfd_loop(pvstate_t);
 
 /*
- * Watch the selected process.
+ * Watch the progress of another pv process.
  */
-extern int pv_watchpid_loop(pvstate_t);
+extern int pv_query_loop(pvstate_t, pid_t);
+
+/*
+ * Set the options of another pv process.
+ */
+int pv_remote_set(pvstate_t, pid_t);
+
+/*
+ * Query another pv process for its elapsed transfer time, amount
+ * transferred, and total size, and update the local state with those
+ * values.  Optionally also return the total size separately.  Reports
+ * errors unless "silent" is true.
+ */
+int pv_remote_transferstate_fetch(pvstate_t state, pid_t query, /*@null@ */ off_t *sizeptr, bool silent);
 
 /*
  * Shut down signal handlers after running the main loop.
@@ -166,8 +318,17 @@ extern void pv_sig_fini(pvstate_t);
 /*
  * Free a state structure, after which it can no longer be used.
  */
-extern void pv_state_free(pvstate_t);
+extern void pv_state_free(/*@only@*/ pvstate_t);
 
+/*
+ * Return a string listing all supported format sequences.
+ */
+/*@null@*/ char *pv_format_sequences(void);
+
+#if ! HAVE_SETPROCTITLE
+void initproctitle(int, char **);
+void setproctitle(const char *, ...);
+#endif
 
 #ifdef ENABLE_DEBUGGING
 # if __STDC_VERSION__ < 199901L && !defined(__func__)
@@ -179,7 +340,7 @@ extern void pv_state_free(pvstate_t);
 # endif
 # define debug(x,...) debugging_output(__func__, __FILE__, __LINE__, x, __VA_ARGS__)
 #else
-# define debug(x,...) do { } while (0)
+# define debug(x,...) /*@-noeffect@*/ do { } while (0) /*@+noeffect@*/
 #endif
 
 /*
@@ -198,5 +359,3 @@ void debugging_output(const char *, const char *, int, const char *, ...);
 #endif
 
 #endif /* _PV_H */
-
-/* EOF */

src/library/getopt.c

@@ -1,115 +0,0 @@
-/*
- * Small reimplementation of getopt().
- *
- * Copyright 2002-2008, 2010, 2012-2015, 2017, 2021, 2023 Andrew Wood
- *
- * Distributed under the Artistic License v2.0; see `doc/COPYING'.
- */
-
-#include "config.h"
-#include <stdio.h>
-#include <stdlib.h>
-#include <string.h>
-
-#ifndef HAVE_GETOPT
-
-char *minioptarg = NULL;
-int minioptind = 0;
-int miniopterr = 1;
-int minioptopt = 0;
-
-
-/*
- * Minimalist getopt() clone, which handles short options only and doesn't
- * permute argv[].
- */
-int minigetopt(int argc, char **argv, char *optstring)
-{
-	static int nextchar = 0;
-	int optchar;
-	int i;
-
-	if ((0 == minioptind) && (argc > 0))
-		minioptind++;
-
-	if ((nextchar > 0) && (0 == argv[minioptind][nextchar])) {
-		minioptind++;
-		nextchar = 0;
-	}
-
-	if (minioptind >= argc)
-		return -1;
-
-	/*
-	 * End of options if arg doesn't start with "-"
-	 */
-	if (argv[minioptind][0] != '-')
-		return -1;
-
-	/*
-	 * End of options if arg is just "-"
-	 */
-	if (0 == argv[minioptind][1])
-		return -1;
-
-	/*
-	 * End of options if arg is "--", but don't include the "--" in the
-	 * non-option arguments
-	 */
-	if (('-' == argv[minioptind][1]) && (0 == argv[minioptind][2])) {
-		minioptind++;
-		return -1;
-	}
-
-	if (0 == nextchar)
-		nextchar = 1;
-
-	optchar = argv[minioptind][nextchar++];
-
-	for (i = 0; optstring[i] != 0 && optstring[i] != optchar; i++) {
-	}
-
-	if (0 == optstring[i]) {
-		minioptopt = optchar;
-		if (miniopterr)
-			fprintf(stderr, "%s: invalid option -- %c\n", argv[0], optchar);
-		return '?';
-	}
-
-	if (optstring[i + 1] != ':') {
-		minioptarg = NULL;
-		return optchar;
-	}
-
-	/*
-	 * At this point we've got an option that takes an argument.
-	 */
-
-	/*
-	 * Next character isn't 0, so the argument is within this array
-	 * element (i.e. "-dFOO").
-	 */
-	if (argv[minioptind][nextchar] != 0) {
-		minioptarg = &(argv[minioptind][nextchar]);
-		nextchar = 0;
-		minioptind++;
-		return optchar;
-	}
-
-	/*
-	 * Argument is in the next array element (i.e. "-d FOO").
-	 */
-	nextchar = 0;
-	minioptind++;
-	if (minioptind >= argc) {
-		fprintf(stderr, "%s: option `-%c' requires an argument\n", argv[0], optchar);
-		return ':';
-	}
-	minioptarg = argv[minioptind++];
-
-	return optchar;
-}
-
-#endif				/* HAVE_GETOPT */
-
-/* EOF */

src/library/gettext.c

@@ -1,113 +0,0 @@
-/*
- * Very minimal (and stupid) implementation of gettext, with a fixed lookup
- * table.
- *
- * This library ONLY handles gettext(), and that only for the basic form (it
- * translates strings to other strings with no other modification, so %2$d
- * style constructs are not dealt with). The setlocale(), bindtextdomain(),
- * and textdomain() functions are ignored.
- *
- * To use this library, create a function that, given a language string,
- * returns a struct msg_table_s[] of msgid and msgstr pairs, with the end
- * of the table being marked by a NULL msgid. The po2table.sh script will do
- * this.
- *
- * Copyright 2002-2008, 2010, 2012-2015, 2017, 2021, 2023 Andrew Wood
- *
- * Distributed under the Artistic License v2.0; see `doc/COPYING'.
- */
-
-#include "config.h"
-#include <stdio.h>
-#include <stdlib.h>
-#include <string.h>
-
-#ifndef HAVE_GETTEXT
-
-struct msgtable_s {
-	char *msgid;
-	char *msgstr;
-};
-
-#if ENABLE_NLS
-struct msgtable_s *minigettext__gettable(char *);
-#else				/* ENABLE_NLS */
-struct msgtable_s *minigettext__gettable(char *a)
-{
-	return NULL;
-}
-#endif				/* ENABLE_NLS */
-
-char *minisetlocale(const char *a, const char *b)
-{
-	return NULL;
-}
-
-
-char *minibindtextdomain(const char *a, const char *b)
-{
-	return NULL;
-}
-
-
-char *minitextdomain(const char *a)
-{
-	return NULL;
-}
-
-
-char *minigettext(const char *msgid)
-{
-	static struct msgtable_s *table = NULL;
-	static int tried_lang = 0;
-	char *lang;
-	int i;
-
-	if (NULL == msgid)
-		return NULL;
-
-	if (0 == tried_lang) {
-		lang = getenv("LANGUAGE");
-		if (lang)
-			table = minigettext__gettable(lang);
-
-		if (NULL == table) {
-			lang = getenv("LANG");
-			if (lang)
-				table = minigettext__gettable(lang);
-		}
-
-		if (NULL == table) {
-			lang = getenv("LC_ALL");
-			if (lang)
-				table = minigettext__gettable(lang);
-		}
-
-		if (NULL == table) {
-			lang = getenv("LC_MESSAGES");
-			if (lang)
-				table = minigettext__gettable(lang);
-		}
-
-		tried_lang = 1;
-	}
-
-	if (NULL == table)
-		return (char *) msgid;
-
-	for (i = 0; table[i].msgid; i++) {
-		if (0 == strcmp(table[i].msgid, msgid)) {
-			if (0 == table[i].msgstr)
-				return (char *) msgid;
-			if (0 == table[i].msgstr[0])
-				return (char *) msgid;
-			return table[i].msgstr;
-		}
-	}
-
-	return (char *) msgid;
-}
-
-#endif				/* HAVE_GETTEXT */
-
-/* EOF */

src/main/debug.c

@@ -1,9 +1,9 @@
 /*
  * Output debugging information.
  *
- * Copyright 2002-2008, 2010, 2012-2015, 2017, 2021, 2023 Andrew Wood
+ * Copyright 2002-2008, 2010, 2012-2015, 2017, 2021, 2023-2025 Andrew Wood
  *
- * Distributed under the Artistic License v2.0; see `doc/COPYING'.
+ * License GPLv3+: GNU GPL version 3 or later; see `docs/COPYING'.
  */
 
 #include "config.h"
@@ -63,8 +63,18 @@ void debugging_output(const char *function, const char *file, int line, const ch
 		return;
 	}
 
+	/*
+	 * Note that here we use gmtime() rather than localtime(), otherwise
+	 * we can get stuck in signal handlers - testing with "strace"
+	 * showed many cases where "pv </dev/zero | cat >/dev/null" being
+	 * paused and backgrounded would cause pv to be stuck in
+	 * futex_wait() inside a pv_sig_alrm() inside a pv_sig_cont().  The
+	 * backtrace mentioned many time zone conversion steps, and all of
+	 * that goes away with gmtime().
+	 */
+
 	(void) time(&t);
-	tm = localtime(&t);
+	tm = gmtime(&t);
 	tbuf[0] = '\0';
 	if (0 == strftime(tbuf, sizeof(tbuf), "%Y-%m-%d %H:%M:%S", tm)) {
 		tbuf[0] = '\0';
@@ -91,7 +101,7 @@ void debugging_output(const char *function, const char *file, int line, const ch
 /*
  * Stub debugging destination function.
  */
-void debugging_output_destination( __attribute__((unused))
+void debugging_output_destination( /*@unused@ */  __attribute__((unused))
 				  const char *filename)
 {
 }
@@ -99,14 +109,12 @@ void debugging_output_destination( __attribute__((unused))
 /*
  * Stub debugging output function.
  */
-void debugging_output( __attribute__((unused))
-		      const char *function, __attribute__((unused))
-		      const char *file, __attribute__((unused))
-		      int line, __attribute__((unused))
+void debugging_output( /*@unused@ */  __attribute__((unused))
+		      const char *function, /*@unused@ */  __attribute__((unused))
+		      const char *file, /*@unused@ */  __attribute__((unused))
+		      int line, /*@unused@ */  __attribute__((unused))
 		      const char *format, ...)
 {
 }
 
 #endif				/* ENABLE_DEBUGGING */
-
-/* EOF */

src/main/help.c

@@ -1,14 +1,15 @@
 /*
  * Output command-line help to stdout.
  *
- * Copyright 2002-2008, 2010, 2012-2015, 2017, 2021, 2023 Andrew Wood
+ * Copyright 2002-2008, 2010, 2012-2015, 2017, 2021, 2023-2025 Andrew Wood
  *
- * Distributed under the Artistic License v2.0; see `doc/COPYING'.
+ * License GPLv3+: GNU GPL version 3 or later; see `docs/COPYING'.
  */
 
 #include "config.h"
 #include "pv.h"
 #include <stdio.h>
+#include <signal.h>
 #include <stdlib.h>
 #include <string.h>
 #include <errno.h>
@@ -21,77 +22,27 @@
 
 
 /*
- * Return the number of display columns needed to show the given string.
- *
- * To do this, we convert it to a wide character string, and use the wide
- * character display width function "wcswidth()" on it.
+ * Return the number of display columns needed to show the given
+ * null-terminated string.
  *
  * If NLS is disabled, or the string cannot be converted, this is just the
  * same as "strlen()".
  */
 static size_t display_width(const char *string)
 {
-	size_t width;
-
-#if defined(ENABLE_NLS) && defined(HAVE_WCHAR_H)
-	size_t wide_char_count;
-	size_t wide_string_buffer_size;
-	wchar_t *wide_string;
+	size_t bytes;
 
 	if (NULL == string)
 		return 0;
 
-	/*@-nullpass@ */
+	bytes = strlen(string);		    /* flawfinder: ignore */
 	/*
-	 * splint note: mbstowcs() manual page on Linux explicitly says it
-	 * takes NULL.
+	 * flawfinder rationale: we have already checked for NULL, and it is
+	 * explicitly required of the caller to provide a null-terminated
+	 * string.
 	 */
-	wide_char_count = mbstowcs(NULL, string, 0);
-	/*@+nullpass@ */
-	if (wide_char_count == (size_t) -1) {
-		debug("%s: %s: %s", "mbstowcs", string, strerror(errno));
-		return strlen(string);	    /* flawfinder: ignore */
-		/*
-		 * flawfinder rationale: we have already checked for NULL,
-		 * and we don't know the size of the originating buffer so
-		 * can't use strnlen(); it is up to the caller to provide a
-		 * terminated string.
-		 */
-	}
 
-	wide_string_buffer_size = sizeof(*wide_string) * (1 + wide_char_count);
-	wide_string = malloc(wide_string_buffer_size);
-	if (NULL == wide_string) {
-		perror("malloc");
-		return strlen(string);	    /* flawfinder: ignore */
-		/* flawfinder rationale: see above. */
-	}
-	memset(wide_string, 0, wide_string_buffer_size);
-
-	if (mbstowcs(wide_string, string, 1 + wide_char_count) == (size_t) -1) {
-		debug("%s: %s: %s", "mbstowcs", string, strerror(errno));
-		width = strlen(string);	    /* flawfinder: ignore */
-		/* flawfinder rationale: see above. */
-	} else if (NULL != wide_string) {
-		/*@-unrecog @ */
-		/* splint seems unable to see the prototype. */
-		width = wcswidth(wide_string, wide_char_count);
-		/*@+unrecog @ */
-	} else {
-		width = 0;
-	}
-
-	free(wide_string);
-
-#else				/* ! defined(ENABLE_NLS) && defined(HAVE_WCHAR_H) */
-	if (NULL == string)
-		return 0;
-
-	width = strlen(string);		    /* flawfinder: ignore */
-	/* flawfinder rationale: see above. */
-#endif				/* defined(ENABLE_NLS) && defined(HAVE_WCHAR_H) */
-
-	return width;
+	return pv_strwidth(string, bytes);
 }
 
 
@@ -133,9 +84,9 @@ static void display_word_wrap_7bit(const char *string, size_t display_width, siz
 
 
 /*
- * Output a string to standard output, word wrapping to "display_width"
- * display character positions, and left-padding any new lines after the
- * first one with "left_margin" spaces.
+ * Output a null-terminated string to standard output, word wrapping to
+ * "display_width" display character positions, and left-padding any new
+ * lines after the first one with "left_margin" spaces.
  *
  * Wide characters are handled if NLS is enabled, but if they can't be, this
  * falls back to a version which just counts bytes as characters.
@@ -152,7 +103,7 @@ static void display_word_wrap(const char *string, size_t display_width, size_t l
 		return;
 
 	/*@-nullpass@ */
-	/* splint note: see earlier mbstowcs() call. */
+	/* splint note: see mbstowcs() call in pv_strwidth(). */
 	wide_char_count = mbstowcs(NULL, string, 0);
 	/*@+nullpass@ */
 	if (wide_char_count == (size_t) -1) {
@@ -180,7 +131,9 @@ static void display_word_wrap(const char *string, size_t display_width, size_t l
 	start_idx = 0;
 	chars_remaining = wide_char_count;
 
+	/*@-unrecog@ *//* splint seems unable to see the prototype for wcswidth(). */
 	while (chars_remaining > 0 && wcswidth(&(wide_string[start_idx]), chars_remaining) > display_width) {
+		/*@+unrecog@ */
 		size_t next_idx;
 
 		end_idx = start_idx + display_width;
@@ -297,15 +250,9 @@ void display_help(void)
 		{ "-a", "--average-rate", NULL,
 		 N_("show data transfer average rate counter"),
 		 { 0, 0, 0, 0} },
-		{ "-m", "--average-rate-window", N_("SEC"),
-		 N_("compute average rate over past SEC seconds (default 30s)"),
-		 { 0, 0, 0, 0} },
 		{ "-b", "--bytes", NULL,
 		 N_("show number of bytes transferred"),
 		 { 0, 0, 0, 0} },
-		{ "-8", "--bits", NULL,
-		 N_("show number of bits transferred"),
-		 { 0, 0, 0, 0} },
 		{ "-T", "--buffer-percent", NULL,
 		 N_("show percentage of transfer buffer in use"),
 		 { 0, 0, 0, 0} },
@@ -322,6 +269,12 @@ void display_help(void)
 		 N_("do not output any transfer information at all"),
 		 { 0, 0, 0, 0} },
 		{ "", NULL, NULL, NULL, { 0, 0, 0, 0} },
+		{ "-8", "--bits", NULL,
+		 N_("show number of bits transferred"),
+		 { 0, 0, 0, 0} },
+		{ "-k", "--si", NULL,
+		 N_("treat suffixes as multiples of 1000 rather than 1024"),
+		 { 0, 0, 0, 0} },
 		{ "-W", "--wait", NULL,
 		 N_("display nothing until first byte transferred"),
 		 { 0, 0, 0, 0} },
@@ -331,6 +284,9 @@ void display_help(void)
 		{ "-s", "--size", N_("SIZE"),
 		 N_("set estimated data size to SIZE bytes"),
 		 { 0, 0, 0, 0} },
+		{ "-g", "--gauge", NULL,
+		 N_("if size unknown, show rate vs max rate"),
+		 { 0, 0, 0, 0} },
 		{ "-l", "--line-mode", NULL,
 		 N_("count lines instead of bytes"),
 		 { 0, 0, 0, 0} },
@@ -340,6 +296,9 @@ void display_help(void)
 		{ "-i", "--interval", N_("SEC"),
 		 N_("update every SEC seconds"),
 		 { 0, 0, 0, 0} },
+		{ "-m", "--average-rate-window", N_("SEC"),
+		 N_("compute average rate over past SEC seconds (default 30s)"),
+		 { 0, 0, 0, 0} },
 		{ "-w", "--width", N_("WIDTH"),
 		 N_("assume terminal is WIDTH characters wide"),
 		 { 0, 0, 0, 0} },
@@ -349,6 +308,15 @@ void display_help(void)
 		{ "-N", "--name", N_("NAME"),
 		 N_("prefix visual information with NAME"),
 		 { 0, 0, 0, 0} },
+		{ "-u", "--bar-style", N_("STYLE"),
+		 N_("set default bar style to NAME"),
+		 { 0, 0, 0, 0} },
+		{ "-x", "--extra-display", N_("SPEC"),
+		 N_("also send progress to SPEC"),
+		 { 0, 0, 0, 0} },
+		{ "-v", "--stats", NULL,
+		 N_("output transfer statistics at the end"),
+		 { 0, 0, 0, 0} },
 		{ "-f", "--force", NULL,
 		 N_("output even if standard error is not a terminal"),
 		 { 0, 0, 0, 0} },
@@ -356,6 +324,9 @@ void display_help(void)
 		 N_("use cursor positioning escape sequences"),
 		 { 0, 0, 0, 0} },
 		{ "", NULL, NULL, NULL, { 0, 0, 0, 0} },
+		{ "-o", "--output", N_("FILE"),
+		 N_("write output to FILE instead of stdout"),
+		 { 0, 0, 0, 0} },
 		{ "-L", "--rate-limit", N_("RATE"),
 		 N_("limit transfer to RATE bytes per second"),
 		 { 0, 0, 0, 0} },
@@ -368,6 +339,9 @@ void display_help(void)
 		{ "-E", "--skip-errors", NULL,
 		 N_("skip read errors in input"),
 		 { 0, 0, 0, 0} },
+		{ "-Z", "--error-skip-block", N_("BYTES"),
+		 N_("skip errors in BYTES blocks at a time"),
+		 { 0, 0, 0, 0} },
 		{ "-S", "--stop-at-size", NULL,
 		 N_("stop after --size bytes have been transferred"),
 		 { 0, 0, 0, 0} },
@@ -377,20 +351,31 @@ void display_help(void)
 		{ "-K", "--direct-io", NULL,
 		 N_("use direct I/O to bypass cache"),
 		 { 0, 0, 0, 0} },
-#ifdef HAVE_IPC
+		{ "-O", "--sparse", NULL,
+		 N_("try to seek instead of writing null bytes"),
+		 { 0, 0, 0, 0} },
+		{ "-X", "--discard", NULL,
+		 N_("discard input instead of writing to output"),
+		 { 0, 0, 0, 0} },
+		{ "-U", "--store-and-forward", N_("FILE"),
+		 N_("write all input to FILE before writing to output"),
+		 { 0, 0, 0, 0} },
+		{ "", NULL, NULL, NULL, { 0, 0, 0, 0} },
+		{ "-d", "--watchfd", N_("PID[:FD]|=NAME|@LISTFILE"),
+		 N_("watch file FD opened by process PID"),
+		 { 0, 0, 0, 0} },
+#ifdef PV_REMOTE_CONTROL
 		{ "-R", "--remote", N_("PID"),
 		 N_("update settings of process PID"),
 		 { 0, 0, 0, 0} },
-#endif				/* HAVE_IPC */
+		{ "-Q", "--query", N_("PID"),
+		 N_("show progress of process PID"),
+		 { 0, 0, 0, 0} },
+#endif				/* PV_REMOTE_CONTROL */
 		{ "", NULL, NULL, NULL, { 0, 0, 0, 0} },
 		{ "-P", "--pidfile", N_("FILE"),
 		 N_("save process ID in FILE"),
 		 { 0, 0, 0, 0} },
-		{ "", NULL, NULL, NULL, { 0, 0, 0, 0} },
-		{ "-d", "--watchfd", N_("PID[:FD]"),
-		 N_("watch file FD opened by process PID"),
-		 { 0, 0, 0, 0} },
-		{ "", NULL, NULL, NULL, { 0, 0, 0, 0} },
 		{ "-h", "--help", NULL,
 		 N_("show this help and exit"),
 		 { 0, 0, 0, 0} },
@@ -411,6 +396,7 @@ void display_help(void)
 	size_t right_margin = 77;
 	const char *program_description;
 	const char *bug_report_note;
+	char *format_sequences = NULL;
 	unsigned int terminal_width = 0, terminal_height = 0;
 
 	pv_screensize(&terminal_width, &terminal_height);
@@ -424,7 +410,7 @@ void display_help(void)
 	 * be hard to exploit - the message catalogue would have to be
 	 * replaced or forced to load from another location.
 	 */
-	printf(_("Usage: %s [OPTION] [FILE]..."), PROGRAM_NAME);
+	printf(_("Usage: %s [OPTION] [FILE]..."), PACKAGE_NAME);
 	/*@+formatconst@ */
 
 	printf("\n");
@@ -570,20 +556,33 @@ void display_help(void)
 		printf("\n");
 	}
 
+	format_sequences = pv_format_sequences();
+	if (NULL != format_sequences) {
+		const char *format_sequence_header;
+		format_sequence_header = _("Supported format sequences:");
+		if (NULL != format_sequence_header) {
+			printf("\n");
+			display_word_wrap(format_sequence_header, right_margin, 0);
+			printf("\n");
+		}
+		printf("\n  ");
+		display_word_wrap(format_sequences, right_margin, 2);
+		free(format_sequences);
+		printf("\n");
+	}
+
 	printf("\n");
 
-	bug_report_note = _("Please report any bugs to %s.");
+	bug_report_note = _("Please report any bugs to: %s");
 	if (NULL != bug_report_note) {
 		/*@-formatconst@ */
 		/*
 		 * splint note: see earlier "formatconst" note.
 		 * flawfinder: same reason.
 		 */
-		printf(bug_report_note, BUG_REPORTS_TO);	/* flawfinder: ignore */
+		printf(bug_report_note, PACKAGE_BUGREPORT);	/* flawfinder: ignore */
 		/*@+formatconst@ */
 	}
 
 	printf("\n");
 }
-
-/* EOF */

src/main/main.c

@@ -2,30 +2,269 @@
  * Main program entry point - read the command line options, then perform
  * the appropriate actions.
  *
- * Copyright 2002-2008, 2010, 2012-2015, 2017, 2021, 2023 Andrew Wood
+ * Copyright 2002-2008, 2010, 2012-2015, 2017, 2021, 2023-2025 Andrew Wood
  *
- * Distributed under the Artistic License v2.0; see `doc/COPYING'.
+ * License GPLv3+: GNU GPL version 3 or later; see `docs/COPYING'.
  */
 
 #include "config.h"
 #include "options.h"
 #include "pv.h"
 
-/* #undef MAKE_STDOUT_NONBLOCKING */
-
 #include <stdio.h>
 #include <string.h>
 #include <errno.h>
 #include <unistd.h>
 #include <fcntl.h>
-#include <termios.h>
 #include <sys/ioctl.h>
 #include <sys/types.h>
+#include <sys/stat.h>
+#ifdef HAVE_LANGINFO_H
+#include <langinfo.h>
+#endif
+
+/*
+ * Write a PID file, returning nonzero on error.  Write it atomically, such
+ * that the file either exists and contains the PID, or is not updated at
+ * all.  This is done by writing to a temporary file in the same directory
+ * first, and then renaming the temporary file to the target name.
+ */
+static int pv__write_pidfile(opts_t opts)
+{
+	char *pidfile_tmp_name;
+	size_t pidfile_tmp_bufsize;
+	int pidfile_tmp_fd;
+	FILE *pidfile_tmp_fptr;
+	mode_t prev_umask;
+	const char *pidfile_template = "%s.XXXXXX";
+
+	if (NULL == opts->pidfile)
+		return 0;
+
+	/*
+	 * The buffer needs to be long enough to hold the pidfile with the
+	 * mkstemp template ".XXXXXX" after it.  The "%s" of our
+	 * pidfile_template adds 2 extra bytes to the length, of which we
+	 * need 1 byte for the terminating \0, so we subtract 1 byte more to
+	 * get the exact amount of space we need.
+	 */
+	pidfile_tmp_bufsize = strlen(pidfile_template) + strlen(opts->pidfile) - 1;	/* flawfinder: ignore */
+
+	/*
+	 * flawfinder rationale: flawfinder never likes strlen() in case
+	 * it's called on a string that isn't \0 terminated.  We have to use
+	 * strlen() to find the length of opts->pidfile, so have to trust
+	 * that the arguments in argv[] were \0 terminated.  We can be sure
+	 * that pidfile_template is \0 terminated because we've set it to a
+	 * constant value.  So we tell flawfinder to skip this check here.
+	 */
+	pidfile_tmp_name = malloc(pidfile_tmp_bufsize);
+	if (NULL == pidfile_tmp_name) {
+		fprintf(stderr, "%s: %s\n", opts->program_name, strerror(errno));
+		return PV_ERROREXIT_REMOTE_OR_PID;
+	}
+	memset(pidfile_tmp_name, 0, pidfile_tmp_bufsize);
+	(void) pv_snprintf(pidfile_tmp_name, pidfile_tmp_bufsize, pidfile_template, opts->pidfile);
+
+	/*@-type@ *//* splint doesn't like mode_t */
+	prev_umask = umask(0000);	    /* flawfinder: ignore */
+	(void) umask(prev_umask | 0133);    /* flawfinder: ignore */
+
+	/*@-unrecog@ *//* splint doesn't know mkstemp() */
+	pidfile_tmp_fd = mkstemp(pidfile_tmp_name);	/* flawfinder: ignore */
+	/*@+unrecog@ */
+	if (pidfile_tmp_fd < 0) {
+		fprintf(stderr, "%s: %s: %s\n", opts->program_name, pidfile_tmp_name, strerror(errno));
+		(void) umask(prev_umask);   /* flawfinder: ignore */
+		free(pidfile_tmp_name);
+		return PV_ERROREXIT_REMOTE_OR_PID;
+	}
+
+	(void) umask(prev_umask);	    /* flawfinder: ignore */
+
+	/*
+	 * flawfinder rationale (umask, mkstemp) - flawfinder
+	 * recommends setting the most restrictive umask possible
+	 * when calling mkstemp(), so this is what we have done.
+	 *
+	 * We get the original umask and OR it with 0133 to make
+	 * sure new files will be at least chmod 644.  Then we put
+	 * the umask back to what it was, after creating the
+	 * temporary file.
+	 */
+
+	/*@+type@ */
+
+	pidfile_tmp_fptr = fdopen(pidfile_tmp_fd, "w");
+	if (NULL == pidfile_tmp_fptr) {
+		fprintf(stderr, "%s: %s: %s\n", opts->program_name, pidfile_tmp_name, strerror(errno));
+		(void) close(pidfile_tmp_fd);
+		(void) remove(pidfile_tmp_name);
+		free(pidfile_tmp_name);
+		return PV_ERROREXIT_REMOTE_OR_PID;
+	}
+
+	fprintf(pidfile_tmp_fptr, "%d\n", getpid());
+	if (0 != fclose(pidfile_tmp_fptr)) {
+		fprintf(stderr, "%s: %s: %s\n", opts->program_name, opts->pidfile, strerror(errno));
+	}
+
+	if (rename(pidfile_tmp_name, opts->pidfile) < 0) {
+		fprintf(stderr, "%s: %s: %s\n", opts->program_name, opts->pidfile, strerror(errno));
+		(void) remove(pidfile_tmp_name);
+	}
+
+	free(pidfile_tmp_name);
+
+	return 0;
+}
 
 
-int pv_remote_set(opts_t);
-void pv_remote_init(void);
-void pv_remote_fini(void);
+/*
+ * Set the output file, if applicable.  Returns nonzero on error.
+ */
+static int pv__set_output(pvstate_t state, opts_t opts, /*@null@ */ const char *output_file)
+{
+	int output_fd;
+
+	if ((NULL == state) || (NULL == opts))
+		return 0;
+
+	if (NULL == output_file || 0 == strcmp(output_file, "-")) {
+		pv_state_output_set(state, STDOUT_FILENO, "(stdout)");
+		return 0;
+	}
+
+	output_fd = open(output_file, O_WRONLY | O_CREAT | O_TRUNC, 0600);	/* flawfinder: ignore */
+	/*
+	 * flawfinder rationale: the output filename has been
+	 * explicitly provided, and in many cases the operator will
+	 * want to write to device files and other special
+	 * destinations, so there is no sense-checking we can do to
+	 * make this safer.
+	 */
+	if (output_fd < 0) {
+		fprintf(stderr, "%s: %s: %s\n", opts->program_name, output_file, strerror(errno));
+		return PV_ERROREXIT_ACCESS;
+	}
+
+	pv_state_output_set(state, output_fd, output_file);
+	return 0;
+}
+
+
+/*
+ * Run in store-and-forward mode: run the main loop once with the output
+ * forced to the store-and-forward file (taking care of creation and removal
+ * of a temporary file if "-" was specified); then run the main loop again
+ * with the input file list forced to be just the store-and-forward file. 
+ * Returns nonzero on error.
+ */
+static int pv__store_and_forward(pvstate_t state, opts_t opts, bool can_have_eta)
+{
+	char tmp_filename[4096];	 /* flawfinder: ignore */
+	bool use_temporary_file;
+	char *real_store_and_forward_file;
+	int retcode;
+
+	/* flawfinder: zeroed with memset and bounded by pv_snprintf. */
+
+	if ((NULL == state) || (NULL == opts) || (NULL == opts->store_and_forward_file))
+		return 0;
+
+	memset(tmp_filename, 0, sizeof(tmp_filename));
+
+	use_temporary_file = false;
+	if (0 == strcmp(opts->store_and_forward_file, "-"))
+		use_temporary_file = true;
+
+	/*
+	 * Create a temporary file if the specified file was "-".
+	 */
+	if (use_temporary_file) {
+		char *tmpdir;
+		int tmp_fd;
+
+		tmpdir = (char *) getenv("TMPDIR");	/* flawfinder: ignore */
+		if ((NULL == tmpdir) || ('\0' == tmpdir[0]))
+			tmpdir = (char *) getenv("TMP");	/* flawfinder: ignore */
+		if ((NULL == tmpdir) || ('\0' == tmpdir[0]))
+			tmpdir = "/tmp";
+
+		/*
+		 * flawfinder rationale: null and zero-size values of $TMPDIR and
+		 * $TMP are rejected, and the destination buffer is bounded.
+		 */
+
+		(void) pv_snprintf(tmp_filename, sizeof(tmp_filename), "%s/pv.XXXXXX", tmpdir);
+		/*@-unrecog@ *//* splint doesn't know mkstemp() */
+		tmp_fd = mkstemp(tmp_filename);	/* flawfinder: ignore */
+		/*@+unrecog@ */
+		if (tmp_fd < 0) {
+			fprintf(stderr, "%s: %s: %s\n", opts->program_name, tmp_filename, strerror(errno));
+			return PV_ERROREXIT_SAF;
+		}
+		(void) close(tmp_fd);
+	}
+
+	/*
+	 * Real store-and-forward file: either the one we were given, or the
+	 * temporary file we created if we were given "-".
+	 */
+	real_store_and_forward_file = use_temporary_file ? tmp_filename : opts->store_and_forward_file;
+
+	/*
+	 * First, set the output file to the store-and-forward file.
+	 */
+	debug("%s: %s", "setting output to store-and-forward file", real_store_and_forward_file);
+	retcode = pv__set_output(state, opts, real_store_and_forward_file);
+	if (0 != retcode)
+		goto end_store_and_forward;
+
+	/* Reset the formatting to set the displayed name to "(input)". */
+	/*@-mustfreefresh@ */
+	pv_state_set_format(state, opts->progress, opts->timer, can_have_eta ? opts->eta : false,
+			    can_have_eta ? opts->fineta : false, opts->rate, opts->average_rate,
+			    opts->bytes, opts->bufpercent, opts->lastwritten, _("(input)"));
+	/*@+mustfreefresh@ *//* see below about gettext _() calls. */
+
+	/* Run the main loop as normal. */
+	debug("%s", "running store-and-forward receiver");
+	retcode = pv_main_loop(state);
+	if (0 != retcode)
+		goto end_store_and_forward;
+
+	/* Set the output file back to what it originally was. */
+	debug("%s: %s", "setting output to original value", NULL == opts->output ? "(null)" : opts->output);
+	retcode = pv__set_output(state, opts, opts->output);
+	if (0 != retcode)
+		goto end_store_and_forward;
+
+	/* Replace the list of input files with the store-and-forward file. */
+	debug("%s", "resetting input file list");
+	pv_state_inputfiles(state, 1, (const char **) &real_store_and_forward_file);
+
+	/* Recalculate the input size. */
+	pv_state_size_set(state, pv_calc_total_size(state));
+
+	/* Reset the format, since we might have been asked to show ETA. */
+	pv_state_set_format(state, opts->progress, opts->timer, opts->eta,
+			    opts->fineta, opts->rate, opts->average_rate,
+			    opts->bytes, opts->bufpercent, opts->lastwritten, opts->name);
+
+	/* Reset calculated values in the state. */
+	pv_state_reset(state);
+
+	/* Run the main loop again. */
+	debug("%s", "running store-and-forward transmitter");
+	retcode = pv_main_loop(state);
+
+      end_store_and_forward:
+	if (use_temporary_file)
+		(void) remove(tmp_filename);
+
+	return retcode;
+}
 
 
 /*
@@ -34,65 +273,77 @@ void pv_remote_fini(void);
  */
 int main(int argc, char **argv)
 {
-	struct termios t, t_save;
-	opts_t opts;
-	pvstate_t state;
-	bool t_saved, t_needs_reset;
+	/*@only@ */ opts_t opts = NULL;
+	/*@only@ */ pvstate_t state = NULL;
 	int retcode = 0;
+	bool can_have_eta = true;
+	bool terminal_supports_utf8 = false;
+
+#if ! HAVE_SETPROCTITLE
+	initproctitle(argc, argv);
+#endif
 
 #ifdef ENABLE_NLS
+	/* Initialise language translation. */
 	(void) setlocale(LC_ALL, "");
 	(void) bindtextdomain(PACKAGE, LOCALEDIR);
 	(void) textdomain(PACKAGE);
+#ifdef HAVE_LANGINFO_H
+	/*@-mustfreefresh@ *//* splint thinks nl_langinfo() leaks memory */
+	if (0 == strcmp(nl_langinfo(CODESET), "UTF-8"))
+		terminal_supports_utf8 = true;
+	/*@+mustfreefresh@ */
+#endif
 #endif
 
-	opts = opts_parse(argc, argv);
+	/* Parse the command line arguments. */
+	opts = opts_parse(argc >= 0 ? (unsigned int) argc : 0, argv);
 	if (NULL == opts) {
-		debug("%s: %d", "exiting with status", 64);
-		return 64;
+		debug("%s: %d", "exiting with status", PV_ERROREXIT_MEMORY);
+		return PV_ERROREXIT_MEMORY;
 	}
 
-	if (opts->do_nothing) {
+	/* Early exit if necessary, such as with "-h". */
+	if (PV_ACTION_NOTHING == opts->action) {
 		debug("%s", "nothing to do - exiting with status 0");
 		opts_free(opts);
 		return 0;
 	}
 
-	/*
-	 * -R specified - send the message, then exit.
-	 */
-	if (opts->remote > 0) {
-		retcode = pv_remote_set(opts);
-		opts_free(opts);
-		return retcode;
-	}
+	/* Set the error message prefix. */
+	/*@-keeptrans@ */
+	pv_set_error_prefix(opts->program_name);
+	/* splint - this function doesn't add an alias or release it. */
+	/*@+keeptrans@ */
 
 	/*
 	 * Allocate our internal state buffer.
 	 */
-	state = pv_state_alloc(opts->program_name);
+	state = pv_state_alloc();
 	if (NULL == state) {
+		/*@-mustfreefresh@ */
+		/*
+		 * splint note: the gettext calls made by _() cause memory
+		 * leak warnings, but in this case it's unavoidable, and
+		 * mitigated by the fact we only translate each string once.
+		 */
 		fprintf(stderr, "%s: %s: %s\n", opts->program_name, _("state allocation failed"), strerror(errno));
 		opts_free(opts);
-		debug("%s: %d", "exiting with status", 64);
-		return 64;
+		debug("%s: %d", "exiting with status", PV_ERROREXIT_MEMORY);
+		return PV_ERROREXIT_MEMORY;
+		/*@+mustfreefresh@ */
 	}
 
 	/*
 	 * Write a PID file if -P was specified.
 	 */
 	if (opts->pidfile != NULL) {
-		FILE *pidfptr;
-		pidfptr = fopen(opts->pidfile, "w");
-		if (NULL == pidfptr) {
-			fprintf(stderr, "%s: %s: %s\n", opts->program_name, opts->pidfile, strerror(errno));
+		int pidfile_rc;
+		pidfile_rc = pv__write_pidfile(opts);
+		if (0 != pidfile_rc) {
 			pv_state_free(state);
 			opts_free(opts);
-			return 1;
-		}
-		fprintf(pidfptr, "%d\n", getpid());
-		if (0 != fclose(pidfptr)) {
-			fprintf(stderr, "%s: %s: %s\n", opts->program_name, opts->pidfile, strerror(errno));
+			return pidfile_rc;
 		}
 	}
 
@@ -101,31 +352,25 @@ int main(int argc, char **argv)
 	 */
 	if (0 == opts->argc) {
 		debug("%s", "no files given - adding fake argument `-'");
-		opts->argv[opts->argc++] = "-";
+		if (!opts_add_file(opts, "-")) {
+			pv_state_free(state);
+			opts_free(opts);
+			return PV_ERROREXIT_MEMORY;
+		}
 	}
 
 	/*
-	 * Put our list of files into the PV internal state.
+	 * Put our list of input files into the PV internal state.
 	 */
-	pv_state_inputfiles(state, opts->argc, (const char **) (opts->argv));
+	if (NULL != opts->argv) {
+		pv_state_inputfiles(state, opts->argc, (const char **) (opts->argv));
+	}
 
-	if (0 == opts->watch_pid) {
-		/*
-		 * If no size was given, and we're not in line mode, try to
-		 * calculate the total size.
-		 */
-		if ((0 == opts->size) && (false == opts->linemode)) {
-			opts->size = pv_calc_total_size(state);
-			debug("%s: %llu", "no size given - calculated", opts->size);
-		}
-
-		/*
-		 * If the size is unknown, we cannot have an ETA.
-		 */
-		if (opts->size < 1) {
-			opts->eta = false;
-			debug("%s", "size unknown - ETA disabled");
-		}
+	/*
+	 * Put the list of watchfd items into the PV internal state.
+	 */
+	if ((opts->watchfd_count > 0) && (NULL != opts->watchfd_pid) && (NULL != opts->watchfd_fd)) {
+		pv_state_watchfds(state, opts->watchfd_count, opts->watchfd_pid, opts->watchfd_fd);
 	}
 
 	/*
@@ -135,8 +380,8 @@ int main(int argc, char **argv)
 	if ((0 == isatty(STDERR_FILENO))
 	    && (false == opts->force)
 	    && (false == opts->numeric)) {
-		opts->no_op = true;
-		debug("%s", "nothing to display - setting no_op");
+		opts->no_display = true;
+		debug("%s", "nothing to display - setting no_display");
 	}
 
 	/*
@@ -178,130 +423,162 @@ int main(int argc, char **argv)
 		opts->interval = 600;
 
 	/*
-	 * Copy parameters from options into main state.
+	 * Set output file, treating no output or "-" as stdout; we have to
+	 * do this before looking at setting the size, as the size
+	 * calculation looks at the output file if the input size can't be
+	 * calculated (issue #91).
+	 *
+	 * We have to set the sparse output flag before doing this, so that
+	 * in sparse mode the lseek() on O_APPEND can be done (issue #45);
+	 * see the comments in pv_state_output_set() in src/pv/state.c.
 	 */
+	pv_state_sparse_output_set(state, opts->sparse_output);
+	retcode = pv__set_output(state, opts, opts->output);
+	if (0 != retcode) {
+		pv_state_free(state);
+		opts_free(opts);
+		return retcode;
+	}
+
+	/*
+	 * Copy the "stop at size" option before checking the total size,
+	 * since calculating the size from the output block device size
+	 * after this may want to force this setting on, and if we set it
+	 * afterwards, we undo the override.
+	 */
+	pv_state_stop_at_size_set(state, opts->stop_at_size);
+
+	/* Total size calculation, in normal transfer mode. */
+	if (PV_ACTION_TRANSFER == opts->action) {
+		/*
+		 * If no size was given, try to calculate the total size.
+		 */
+		if (0 == opts->size) {
+			pv_state_linemode_set(state, opts->linemode);
+			pv_state_null_terminated_lines_set(state, opts->null_terminated_lines);
+			opts->size = pv_calc_total_size(state);
+			debug("%s: %llu", "no size given - calculated", opts->size);
+		}
+
+		/*
+		 * If the size is unknown, we cannot have an ETA.
+		 */
+		if (opts->size < 1) {
+			can_have_eta = false;
+			debug("%s", "size unknown - ETA disabled");
+		}
+	}
+
+	/* Initialise the signal handling. */
+	pv_sig_init(state);
+
+	/*
+	 * Get the total size, in query mode.
+	 *
+	 * Note that this uses signals, so signal handling has to have been
+	 * set up first.
+	 */
+	if (PV_ACTION_QUERY == opts->action) {
+		opts->size = 0;
+		retcode = pv_remote_transferstate_fetch(state, opts->query, &(opts->size), false);
+		if (0 != retcode) {
+			pv_sig_fini(state);
+			pv_state_free(state);
+			opts_free(opts);
+			return retcode;
+		}
+		/* As above - no ETA if the size is unknown. */
+		if (opts->size < 1) {
+			can_have_eta = false;
+			debug("%s", "size unknown - ETA disabled");
+		}
+	}
+
+	/*
+	 * Copy the remaining parameters from the options into the main
+	 * state.
+	 */
+
 	pv_state_interval_set(state, opts->interval);
-	pv_state_width_set(state, opts->width);
-	pv_state_height_set(state, opts->height);
-	pv_state_no_op_set(state, opts->no_op);
+	pv_state_width_set(state, opts->width, opts->width_set_manually);
+	pv_state_height_set(state, opts->height, opts->height_set_manually);
+	pv_state_no_display_set(state, opts->no_display);
 	pv_state_force_set(state, opts->force);
 	pv_state_cursor_set(state, opts->cursor);
+	pv_state_show_stats_set(state, opts->show_stats);
 	pv_state_numeric_set(state, opts->numeric);
 	pv_state_wait_set(state, opts->wait);
 	pv_state_delay_start_set(state, opts->delay_start);
+	pv_state_rate_gauge_set(state, opts->rate_gauge);
 	pv_state_linemode_set(state, opts->linemode);
 	pv_state_bits_set(state, opts->bits);
-	pv_state_null_set(state, opts->null);
+	pv_state_decimal_units_set(state, opts->decimal_units);
+	pv_state_null_terminated_lines_set(state, opts->null_terminated_lines);
 	pv_state_skip_errors_set(state, opts->skip_errors);
-	pv_state_stop_at_size_set(state, opts->stop_at_size);
+	pv_state_error_skip_block_set(state, opts->error_skip_block);
 	pv_state_sync_after_write_set(state, opts->sync_after_write);
 	pv_state_direct_io_set(state, opts->direct_io);
+	pv_state_discard_input_set(state, opts->discard_input);
 	pv_state_rate_limit_set(state, opts->rate_limit);
 	pv_state_target_buffer_size_set(state, opts->buffer_size);
 	pv_state_no_splice_set(state, opts->no_splice);
 	pv_state_size_set(state, opts->size);
 	pv_state_name_set(state, opts->name);
+	pv_state_default_bar_style_set(state, opts->default_bar_style);
 	pv_state_format_string_set(state, opts->format);
-	pv_state_watch_pid_set(state, opts->watch_pid);
-	pv_state_watch_fd_set(state, opts->watch_fd);
+	pv_state_extra_display_set(state, opts->extra_display);
 	pv_state_average_rate_window_set(state, opts->average_rate_window);
 
-	pv_state_set_format(state, opts->progress, opts->timer, opts->eta,
-			    opts->fineta, opts->rate, opts->average_rate,
+	pv_state_set_format(state, opts->progress, opts->timer, can_have_eta ? opts->eta : false,
+			    can_have_eta ? opts->fineta : false, opts->rate, opts->average_rate,
 			    opts->bytes, opts->bufpercent, opts->lastwritten, opts->name);
 
-#ifdef MAKE_STDOUT_NONBLOCKING
-	/*
-	 * Try and make standard output use non-blocking I/O.
-	 *
-	 * Note that this can cause problems with (broken) applications
-	 * such as dd.
-	 */
-	fcntl(STDOUT_FILENO, F_SETFL, O_NONBLOCK | fcntl(STDOUT_FILENO, F_GETFL));
-#endif				/* MAKE_STDOUT_NONBLOCKING */
+	debug("%s: %s", "terminal_supports_utf8", terminal_supports_utf8 ? "true" : "false");
+	pv_state_set_terminal_supports_utf8(state, terminal_supports_utf8);
 
-	/*
-	 * Keep track of whether we've saved the terminal attributes and
-	 * whether we need to reset them at the end.
-	 */
-	t_saved = false;
-	t_needs_reset = false;
-
-	/*
-	 * Set terminal option TOSTOP so we get signal SIGTTOU if we try to
-	 * write to the terminal while backgrounded.
-	 *
-	 * Also, save the current terminal attributes for later restoration.
-	 */
-	memset(&t, 0, sizeof(t));
-	if (0 != isatty(STDERR_FILENO)) {
-		if (0 == tcgetattr(STDERR_FILENO, &t)) {
-			debug("%s", "saved terminal attributes");
-			t_saved = true;
-		} else {
-			fprintf(stderr, "%s: %s: %s\n", opts->program_name,
-				_("failed to read terminal attributes"), strerror(errno));
-		}
-	}
-	t_save = t;
-	if (t_saved && pv_in_foreground()) {
-		t.c_lflag |= TOSTOP;
-		(void) tcsetattr(STDERR_FILENO, TCSANOW, &t);
-		t_needs_reset = true;
-		debug("%s", "set terminal TOSTOP attribute");
-	}
-
-	if (0 != opts->watch_pid) {
-		if (0 <= opts->watch_fd) {
-			pv_sig_init(state);
-			retcode = pv_watchfd_loop(state);
-			if (t_needs_reset && pv_in_foreground()) {
-				(void) tcsetattr(STDERR_FILENO, TCSANOW, &t_save);
-			}
-			if (opts->pidfile != NULL) {
-				if (0 != remove(opts->pidfile)) {
-					fprintf(stderr, "%s: %s: %s\n",
-						opts->program_name, opts->pidfile, strerror(errno));
-				}
-			}
-			pv_sig_fini(state);
-		} else {
-			pv_sig_init(state);
-			retcode = pv_watchpid_loop(state);
-			if (t_needs_reset && pv_in_foreground()) {
-				(void) tcsetattr(STDERR_FILENO, TCSANOW, &t_save);
-			}
-			if (opts->pidfile != NULL) {
-				if (0 != remove(opts->pidfile)) {
-					fprintf(stderr, "%s: %s: %s\n",
-						opts->program_name, opts->pidfile, strerror(errno));
-				}
-			}
-			pv_sig_fini(state);
-		}
-	} else {
-		pv_sig_init(state);
-		pv_remote_init();
+	/* Run the appropriate main loop. */
+	switch (opts->action) {
+	case PV_ACTION_NOTHING:
+		break;
+	case PV_ACTION_TRANSFER:
+		/* Normal "transfer data" mode. */
 		retcode = pv_main_loop(state);
-		pv_remote_fini();
-		if (t_needs_reset && pv_in_foreground()) {
-			(void) tcsetattr(STDERR_FILENO, TCSANOW, &t_save);
-		}
-		if (opts->pidfile != NULL) {
-			if (0 != remove(opts->pidfile)) {
-				fprintf(stderr, "%s: %s: %s\n", opts->program_name, opts->pidfile, strerror(errno));
-			}
-		}
-		pv_sig_fini(state);
+		break;
+	case PV_ACTION_STORE_AND_FORWARD:
+		/* Store-and-forward transfer mode. */
+		retcode = pv__store_and_forward(state, opts, can_have_eta);
+		break;
+	case PV_ACTION_WATCHFD:
+		/* "Watch file descriptor(s) of another process" mode. */
+		retcode = pv_watchfd_loop(state);
+		break;
+	case PV_ACTION_REMOTE_CONTROL:
+		/* Change the options of another running pv. */
+		retcode = pv_remote_set(state, opts->remote);
+		break;
+	case PV_ACTION_QUERY:
+		/* Query the progress of another running pv. */
+		retcode = pv_query_loop(state, opts->query);
+		break;
 	}
 
+	/* Clear up the PID file, if one was written. */
+	if (opts->pidfile != NULL) {
+		if (0 != remove(opts->pidfile)) {
+			fprintf(stderr, "%s: %s: %s\n", opts->program_name, opts->pidfile, strerror(errno));
+		}
+	}
+
+	/* Close down the signal handling. */
+	pv_sig_fini(state);
+
+	/* Free the internal PV state. */
 	pv_state_free(state);
 
+	/* Free the data from parsing the command-line arguments. */
 	opts_free(opts);
 
 	debug("%s: %d", "exiting with status", retcode);
 
 	return retcode;
 }
-
-/* EOF */

src/main/remote.c

@@ -1,324 +0,0 @@
-/*
- * Remote-control functions.
- *
- * Copyright 2002-2008, 2010, 2012-2015, 2017, 2021, 2023 Andrew Wood
- *
- * Distributed under the Artistic License v2.0; see `doc/COPYING'.
- */
-
-#include "config.h"
-#include "options.h"
-#include "pv.h"
-
-#include <stdio.h>
-#include <string.h>
-#include <errno.h>
-#include <signal.h>
-#include <unistd.h>
-#include <sys/types.h>
-#include <sys/time.h>
-
-#ifdef HAVE_IPC
-#include <sys/ipc.h>
-#include <sys/msg.h>
-#endif				/* HAVE_IPC */
-
-
-#ifdef HAVE_IPC
-struct remote_msg {
-	long mtype;
-	bool progress;			 /* progress bar flag */
-	bool timer;			 /* timer flag */
-	bool eta;			 /* ETA flag */
-	bool fineta;			 /* absolute ETA flag */
-	bool rate;			 /* rate counter flag */
-	bool average_rate;		 /* average rate counter flag */
-	bool bytes;			 /* bytes transferred flag */
-	bool bufpercent;		 /* transfer buffer percentage flag */
-	unsigned int lastwritten;	 /* last-written bytes count */
-	unsigned long long rate_limit;	 /* rate limit, in bytes per second */
-	unsigned long long buffer_size;	 /* buffer size, in bytes (0=default) */
-	unsigned long long size;	 /* total size of data */
-	double interval;		 /* interval between updates */
-	unsigned int width;		 /* screen width */
-	unsigned int height;		 /* screen height */
-	char name[256];
-	char format[256];
-};
-
-
-static int remote__msgid = -1;
-
-
-/*
- * Return a key for use with msgget() which will be unique to the current
- * user.
- *
- * We can't just use ftok() because the queue needs to be user-specific
- * so that a user cannot send messages to another user's process, and we
- * can't easily find out the terminal a given process is connected to in a
- * cross-platform way.
- */
-static key_t remote__genkey(void)
-{
-	uid_t uid;
-	key_t key;
-
-	uid = geteuid();
-
-	key = ftok("/tmp", (int) 'P') | uid;
-
-	return key;
-}
-
-
-/*
- * Return a message queue ID that is unique to the current user and the
- * given process ID, or -1 on error.
- */
-static int remote__msgget(void)
-{
-	/* Catch SIGSYS in case msgget() raises it, so we get ENOSYS */
-	(void) signal(SIGSYS, SIG_IGN);
-	return msgget(remote__genkey(), IPC_CREAT | 0600);
-}
-
-
-/*
- * Set the options of a remote process by setting up an IPC message queue,
- * sending a message containing the new options, and then waiting for the
- * message to be consumed by the remote process.
- *
- * Returns nonzero on error.
- */
-int pv_remote_set(opts_t opts)
-{
-	struct remote_msg msgbuf;
-	struct msqid_ds qbuf;
-	long timeout;
-	int msgid;
-	unsigned long initial_qnum;
-
-	/*
-	 * Check that the remote process exists.
-	 */
-	if (kill((pid_t) (opts->remote), 0) != 0) {
-		fprintf(stderr, "%s: %u: %s\n", opts->program_name, opts->remote, strerror(errno));
-		return 1;
-	}
-
-	/*
-	 * Make sure parameters are within sensible bounds.
-	 */
-	if (opts->width < 1)
-		opts->width = 80;
-	if (opts->height < 1)
-		opts->height = 25;
-	if (opts->width > 999999)
-		opts->width = 999999;
-	if (opts->height > 999999)
-		opts->height = 999999;
-	if ((opts->interval > 0) && (opts->interval < 0.1))
-		opts->interval = 0.1;
-	if (opts->interval > 600)
-		opts->interval = 600;
-
-	/*
-	 * Copy parameters into message buffer.
-	 */
-	memset(&msgbuf, 0, sizeof(msgbuf));
-	msgbuf.mtype = (long) (opts->remote);
-	msgbuf.progress = opts->progress;
-	msgbuf.timer = opts->timer;
-	msgbuf.eta = opts->eta;
-	msgbuf.fineta = opts->fineta;
-	msgbuf.rate = opts->rate;
-	msgbuf.average_rate = opts->average_rate;
-	msgbuf.bytes = opts->bytes;
-	msgbuf.bufpercent = opts->bufpercent;
-	msgbuf.lastwritten = opts->lastwritten;
-	msgbuf.rate_limit = opts->rate_limit;
-	msgbuf.buffer_size = opts->buffer_size;
-	msgbuf.size = opts->size;
-	msgbuf.interval = opts->interval;
-	msgbuf.width = opts->width;
-	msgbuf.height = opts->height;
-	if (opts->name != NULL) {
-		strncpy(msgbuf.name, opts->name, sizeof(msgbuf.name) - 1);
-	}
-	if (opts->format != NULL) {
-		strncpy(msgbuf.format, opts->format, sizeof(msgbuf.format) - 1);
-	}
-
-	msgid = remote__msgget();
-	if (msgid < 0) {
-		fprintf(stderr, "%s: %s\n", opts->program_name, strerror(errno));
-		return 1;
-	}
-
-	memset(&qbuf, 0, sizeof(qbuf));
-	if (msgctl(msgid, IPC_STAT, &qbuf) < 0) {
-		fprintf(stderr, "%s: %s\n", opts->program_name, strerror(errno));
-		return 1;
-	}
-
-	initial_qnum = qbuf.msg_qnum;
-
-	if (msgsnd(msgid, &msgbuf, sizeof(msgbuf) - sizeof(long), 0) != 0) {
-		fprintf(stderr, "%s: %s\n", opts->program_name, strerror(errno));
-		return 1;
-	}
-
-	timeout = 1100000;
-
-	while (timeout > 10000) {
-		struct timeval tv;
-
-		memset(&tv, 0, sizeof(tv));
-		tv.tv_sec = 0;
-		tv.tv_usec = 10000;
-		(void) select(0, NULL, NULL, NULL, &tv);
-		timeout -= 10000;
-
-		/*
-		 * If we can't stat the queue, it must have been deleted.
-		 */
-		memset(&qbuf, 0, sizeof(qbuf));
-		if (msgctl(msgid, IPC_STAT, &qbuf) < 0)
-			break;
-
-		/*
-		 * If the message count is at or below the message count
-		 * before we sent our message, assume it was received.
-		 */
-		if (qbuf.msg_qnum <= initial_qnum) {
-			return 0;
-		}
-	}
-
-	/*
-	 * Message not received - delete it.
-	 */
-	memset(&qbuf, 0, sizeof(qbuf));
-	if (msgctl(msgid, IPC_STAT, &qbuf) >= 0) {
-		(void) msgrcv(msgid, &msgbuf, sizeof(msgbuf) - sizeof(long), (long) (opts->remote), IPC_NOWAIT);
-		/*
-		 * If this leaves nothing on the queue, remove the
-		 * queue, in case we created one for no reason.
-		 */
-		if (msgctl(msgid, IPC_STAT, &qbuf) >= 0) {
-			if (qbuf.msg_qnum < 1)
-				(void) msgctl(msgid, IPC_RMID, &qbuf);
-		}
-	}
-
-	fprintf(stderr, "%s: %u: %s\n", opts->program_name, opts->remote, _("message not received"));
-	return 1;
-}
-
-
-/*
- * Check for an IPC remote handling message and, if there is one, replace
- * the current process's options with those being passed in.
- *
- * NB relies on pv_state_set_format() causing the output format to be
- * reparsed.
- */
-void pv_remote_check(pvstate_t state)
-{
-	struct remote_msg msgbuf;
-	ssize_t got;
-
-	if (remote__msgid < 0)
-		return;
-
-	memset(&msgbuf, 0, sizeof(msgbuf));
-
-	got = msgrcv(remote__msgid, &msgbuf, sizeof(msgbuf) - sizeof(long), getpid(), IPC_NOWAIT);
-	if (got < 0) {
-		/*
-		 * If our queue had been deleted, re-create it.
-		 */
-		if (errno != EAGAIN && errno != ENOMSG) {
-			remote__msgid = remote__msgget();
-		}
-	}
-	if (got < 1)
-		return;
-
-	debug("%s", "received remote message");
-
-	pv_state_format_string_set(state, NULL);
-	pv_state_name_set(state, NULL);
-
-	pv_state_set_format(state, msgbuf.progress, msgbuf.timer,
-			    msgbuf.eta, msgbuf.fineta, msgbuf.rate,
-			    msgbuf.average_rate,
-			    msgbuf.bytes, msgbuf.bufpercent,
-			    msgbuf.lastwritten, '\0' == msgbuf.name[0] ? NULL : strdup(msgbuf.name));
-
-	if (msgbuf.rate_limit > 0)
-		pv_state_rate_limit_set(state, msgbuf.rate_limit);
-	if (msgbuf.buffer_size > 0) {
-		pv_state_target_buffer_size_set(state, msgbuf.buffer_size);
-	}
-	if (msgbuf.size > 0)
-		pv_state_size_set(state, msgbuf.size);
-	if (msgbuf.interval > 0)
-		pv_state_interval_set(state, msgbuf.interval);
-	if (msgbuf.width > 0)
-		pv_state_width_set(state, msgbuf.width);
-	if (msgbuf.height > 0)
-		pv_state_height_set(state, msgbuf.height);
-	if (msgbuf.format[0] != '\0')
-		pv_state_format_string_set(state, strdup(msgbuf.format));
-}
-
-
-/*
- * Initialise remote message reception handling.
- */
-void pv_remote_init(void)
-{
-	remote__msgid = remote__msgget();
-}
-
-
-/*
- * Clean up after remote message reception handling.
- */
-void pv_remote_fini(void)
-{
-	if (remote__msgid >= 0) {
-		struct msqid_ds qbuf;
-		memset(&qbuf, 0, sizeof(qbuf));
-		(void) msgctl(remote__msgid, IPC_RMID, &qbuf);
-	}
-}
-
-#else				/* !HAVE_IPC */
-
-/*
- * Dummy stubs for remote control when we don't have IPC.
- */
-void pv_remote_init(void)
-{
-}
-
-void pv_remote_check(pvstate_t state)
-{
-}
-
-void pv_remote_fini(void)
-{
-}
-
-int pv_remote_set(pvstate_t state)
-{
-	fprintf(stderr, "%s\n", _("IPC not supported on this system"));
-	return 1;
-}
-
-#endif				/* HAVE_IPC */
-
-/* EOF */

src/main/version.c

@@ -1,9 +1,9 @@
 /*
  * Output version information to stdout.
  *
- * Copyright 2002-2008, 2010, 2012-2015, 2017, 2021, 2023 Andrew Wood
+ * Copyright 2002-2008, 2010, 2012-2015, 2017, 2021, 2023-2025 Andrew Wood
  *
- * Distributed under the Artistic License v2.0; see `doc/COPYING'.
+ * License GPLv3+: GNU GPL version 3 or later; see `docs/COPYING'.
  */
 
 #include "config.h"
@@ -21,15 +21,13 @@ void display_version(void)
 	 * fact we only translate each string once.
 	 */
 	/* GNU standard first line format: program and version only */
-	printf("%s %s\n", PROGRAM_NAME, VERSION);
+	printf("%s %s\n", PACKAGE_NAME, PACKAGE_VERSION);
 	/* GNU standard second line format - "Copyright" always in English */
-	printf("Copyright %s %s\n", COPYRIGHT_YEAR, COPYRIGHT_HOLDER);
+	printf("Copyright %s %s\n", "2025", "Andrew Wood");
 	/* GNU standard license line and free software notice */
-	printf("%s\n", _("License: Artistic v2.0 <https://opensource.org/license/artistic-2-0/>"));
+	printf("%s\n", _("License: GPLv3+ <https://www.gnu.org/licenses/gpl-3.0.html>"));
 	printf("%s\n", _("This is free software: you are free to change and redistribute it."));
 	printf("%s\n", _("There is NO WARRANTY, to the extent permitted by law."));
 	/* Project web site link */
-	printf("\n%s: <%s>\n", _("Project web site"), PROJECT_HOMEPAGE);
+	printf("\n%s: <%s>\n", _("Project web site"), PACKAGE_URL);
 }
-
-/* EOF */

src/nls/de.po

@@ -1,509 +0,0 @@
-msgid ""
-msgstr ""
-"Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2023-07-30 19:07+0100\n"
-"Content-Type: text/plain; charset=UTF-8\n"
-"Date: 1999-06-01 15:18:29+0100\n"
-"From: Andrew Wood <ivarch@ubik>\n"
-"Xgettext-Options: --default-domain=pkgbuild --directory=./.pkgdir --add-"
-"comments --keyword=_ --keyword=N_\n"
-"Files: src/getopt/getopt.c src/getopt/getopt1.c src/version.c src/main/init."
-"c src/main/help.c src/main/xpmptr.c src/guts/load.c src/guts/stop.c src/guts/"
-"configure.c src/guts/make.c src/guts/install.c src/guts/prefs.c src/ui/"
-"generate.c src/ui/main.c src/ui/xpm.c src/ui/status.c src/ui/activate.c src/"
-"ui/handlers/main.c src/ui/handlers/package.c src/ui/handlers/prefs.c src/ui/"
-"handlers/dirsel.c src/ui/handlers/popup.c src/ui/handlers/help.c src/ui/"
-"textout.c src/ui/report.c src/ui/callback.c src/nls/intl/bindtextdom.c src/"
-"nls/intl/dcgettext.c src/nls/intl/dgettext.c src/nls/intl/finddomain.c src/"
-"nls/intl/gettext.c src/nls/intl/loadmsgcat.c src/nls/intl/localealias.c src/"
-"nls/intl/textdomain.c src/nls/intl-cat/cat-compat.c src/nls/intl-gett/intl-"
-"compat.c\n"
-
-#: src/pv/cursor.c:85
-msgid "failed to get terminal name"
-msgstr "Terminalname konnte nicht gelesen werden"
-
-#: src/pv/cursor.c:117
-msgid "failed to open lock file"
-msgstr "Sperrdatei konnte nicht geöffnet werden"
-
-#: src/pv/cursor.c:150
-msgid "lock attempt failed"
-msgstr "Sperrversuch fehlgeschlagen"
-
-#: src/pv/cursor.c:391
-msgid "failed to open terminal"
-msgstr "Terminal konnte nicht geöffnet werden"
-
-#: src/pv/file.c:119
-msgid "failed to seek to start of output"
-msgstr "Konnte nicht versuchen, die Ausgabe zu starten"
-
-#: src/pv/file.c:210
-msgid "failed to close file"
-msgstr "Datei konnte nicht geschlossen werden"
-
-#: src/pv/file.c:232
-msgid "failed to read file"
-msgstr "Datei konnte nicht gelesen werden"
-
-#: src/pv/file.c:239 src/main/options.c:284
-msgid "failed to stat file"
-msgstr "Dateiinformationen konnten nicht gelesen werden"
-
-#: src/pv/file.c:246
-msgid "failed to stat output file"
-msgstr "Dateiinformationen für Ausgabe-Datei konnten nicht gelesen werden"
-
-#: src/pv/file.c:268
-msgid "input file is output file"
-msgstr "Eingabe-Datei ist Ausgabe-Datei"
-
-#: src/pv/transfer.c:359
-msgid "read failed"
-msgstr "read-Aufruf fehlgeschlagen"
-
-#: src/pv/transfer.c:374
-msgid "warning: read errors detected"
-msgstr "warnung: lesefehler erkannt"
-
-#: src/pv/transfer.c:386
-msgid "file is not seekable"
-msgstr "datei ist nicht durchsuchbar"
-
-#: src/pv/transfer.c:445
-msgid "failed to seek past error"
-msgstr "konnte den Fehler nicht überwinden"
-
-#: src/pv/transfer.c:461
-msgid "skipped past read error"
-msgstr "über den Lesefehler hinaus verschoben"
-
-#: src/pv/transfer.c:461 src/pv/display.c:660
-msgid "B"
-msgstr "B"
-
-#: src/pv/transfer.c:617
-msgid "write failed"
-msgstr "write-Aufruf fehlgeschlagen"
-
-#: src/pv/transfer.c:736 src/pv/display.c:594
-msgid "buffer allocation failed"
-msgstr "Puffer konnte nicht allokiert werden"
-
-#.
-#. * Any other error is a problem and we must report back.
-#.
-#: src/pv/transfer.c:833
-msgid "select call failed"
-msgstr "select-Aufruf fehlgeschlagen"
-
-#: src/pv/watchpid.c:73 src/pv/watchpid.c:83 src/pv/watchpid.c:94
-#: src/pv/watchpid.c:102 src/pv/watchpid.c:139 src/pv/watchpid.c:150
-#: src/pv/watchpid.c:158 src/pv/watchpid.c:169 src/pv/watchpid.c:253
-#: src/pv/watchpid.c:261 src/pv/watchpid.c:292 src/pv/watchpid.c:312
-#: src/pv/loop.c:506 src/pv/loop.c:558 src/pv/loop.c:602
-msgid "pid"
-msgstr ""
-
-#: src/pv/watchpid.c:83 src/pv/watchpid.c:95 src/pv/watchpid.c:104
-#: src/pv/watchpid.c:150 src/pv/watchpid.c:159 src/pv/watchpid.c:171
-msgid "fd"
-msgstr ""
-
-#: src/pv/watchpid.c:104 src/pv/watchpid.c:171
-msgid "not a regular file or block device"
-msgstr "keine normale Datei oder Blockgerät"
-
-#: src/pv/state.c:30
-msgid "history structure allocation failed"
-msgstr ""
-
-#: src/pv/state.c:59
-msgid "none"
-msgstr ""
-
-#: src/pv/display.c:159
-msgid "yzafpnum kMGTPEZY"
-msgstr ""
-
-#: src/pv/display.c:164
-msgid "yzafpnum KMGTPEZY"
-msgstr ""
-
-#: src/pv/display.c:656
-msgid "b"
-msgstr ""
-
-#: src/pv/display.c:711 src/pv/display.c:722
-msgid "b/s"
-msgstr ""
-
-#: src/pv/display.c:714 src/pv/display.c:726
-msgid "/s"
-msgstr ""
-
-#: src/pv/display.c:714 src/pv/display.c:726
-msgid "B/s"
-msgstr ""
-
-#: src/pv/display.c:762 src/pv/display.c:766 src/pv/display.c:825
-msgid "ETA"
-msgstr "ETA"
-
-#. GNU standard license line and free software notice
-#: src/main/version.c:28
-msgid "License: Artistic v2.0 <https://opensource.org/license/artistic-2-0/>"
-msgstr ""
-
-#: src/main/version.c:29
-msgid "This is free software: you are free to change and redistribute it."
-msgstr ""
-
-#: src/main/version.c:30
-msgid "There is NO WARRANTY, to the extent permitted by law."
-msgstr ""
-
-#. Project web site link
-#: src/main/version.c:32
-msgid "Project web site"
-msgstr ""
-
-#: src/main/remote.c:215
-msgid "message not received"
-msgstr "Nachricht nicht empfangen"
-
-#: src/main/remote.c:318
-msgid "IPC not supported on this system"
-msgstr "IPC wird auf diesem System nicht unterstützt"
-
-#: src/main/help.c:283
-msgid "show progress bar"
-msgstr "Fortschritts-Anzeige"
-
-#: src/main/help.c:286
-msgid "show elapsed time"
-msgstr "zeige die verstrichene Zeit an"
-
-#: src/main/help.c:289
-msgid "show estimated time of arrival (completion)"
-msgstr "zeige die erwartete Zeit bis zum Ende an"
-
-#: src/main/help.c:292
-msgid "show absolute estimated time of arrival (completion)"
-msgstr "zeige die absolute geschätzte Zeit bis zur Fertigstellung"
-
-#: src/main/help.c:295
-msgid "show data transfer rate counter"
-msgstr "zeige die Datentransferrate an"
-
-#: src/main/help.c:298
-msgid "show data transfer average rate counter"
-msgstr ""
-
-#: src/main/help.c:300 src/main/help.c:328 src/main/help.c:340
-msgid "SEC"
-msgstr ""
-
-#: src/main/help.c:301
-msgid "compute average rate over past SEC seconds (default 30s)"
-msgstr ""
-
-#: src/main/help.c:304
-msgid "show number of bytes transferred"
-msgstr "zeige die Anzahl von Bytes, die transferiert worden sind"
-
-#: src/main/help.c:307
-msgid "show number of bits transferred"
-msgstr ""
-
-#: src/main/help.c:310
-msgid "show percentage of transfer buffer in use"
-msgstr "zeige, wie viel Prozent des Übertragungsbuffers in Benutzung sind"
-
-#: src/main/help.c:312
-msgid "NUM"
-msgstr ""
-
-#: src/main/help.c:313
-msgid "show NUM bytes last written"
-msgstr "NUM zeige die zuletzt geschriebenen NUM Bytes"
-
-#: src/main/help.c:315
-msgid "FORMAT"
-msgstr ""
-
-#: src/main/help.c:316
-msgid "set output format to FORMAT"
-msgstr "setze das Ausgabeformat auf FORMAT"
-
-#: src/main/help.c:319
-msgid "output percentages, not visual information"
-msgstr "Ausgabe von Prozent-Angaben statt visueller Darstellung"
-
-#: src/main/help.c:322
-msgid "do not output any transfer information at all"
-msgstr "sämtliche Transferinformationen unterdrücken"
-
-#: src/main/help.c:326
-msgid "display nothing until first byte transferred"
-msgstr "keine Ausgabe bevor das erste Byte übertragen wurde"
-
-#: src/main/help.c:329
-msgid "display nothing until SEC seconds have passed"
-msgstr "SEC nichts anzeigen, bis SEC Sekunden vergangen sind"
-
-#: src/main/help.c:331
-msgid "SIZE"
-msgstr ""
-
-#: src/main/help.c:332
-msgid "set estimated data size to SIZE bytes"
-msgstr "setze erwartete Datenlänge auf SIZE Byte"
-
-#: src/main/help.c:335
-msgid "count lines instead of bytes"
-msgstr "zähle Zeilen anstelle von Bytes"
-
-#: src/main/help.c:338
-msgid "lines are null-terminated"
-msgstr "Zeilen sind nullterminiert"
-
-#: src/main/help.c:341
-msgid "update every SEC seconds"
-msgstr "aktualisiere Ausgabe nach SEC Sekunden Intervall"
-
-#: src/main/help.c:343
-msgid "WIDTH"
-msgstr ""
-
-#: src/main/help.c:344
-msgid "assume terminal is WIDTH characters wide"
-msgstr "setze Terminal-Breite auf WIDTH Zeichen"
-
-#: src/main/help.c:346
-msgid "HEIGHT"
-msgstr ""
-
-#: src/main/help.c:347
-msgid "assume terminal is HEIGHT rows high"
-msgstr "setze Terminal-Höhe auf HEIGHT Zeichen"
-
-#: src/main/help.c:349
-msgid "NAME"
-msgstr ""
-
-#: src/main/help.c:350
-msgid "prefix visual information with NAME"
-msgstr "setze den NAMEn für visuelle Darstellung"
-
-#: src/main/help.c:353
-msgid "output even if standard error is not a terminal"
-msgstr ""
-"Ausgabe auch dann erzwingen, wenn der Fehlerausgabe-Kanal kein Terminal ist"
-
-#: src/main/help.c:356
-msgid "use cursor positioning escape sequences"
-msgstr "benutze Escape-Sequenzen zur Cursor-Positionierung"
-
-#: src/main/help.c:359
-msgid "RATE"
-msgstr ""
-
-#: src/main/help.c:360
-msgid "limit transfer to RATE bytes per second"
-msgstr "beschränke die Transferrate auf RATE Byte pro Sekunde"
-
-#: src/main/help.c:362
-msgid "BYTES"
-msgstr ""
-
-#: src/main/help.c:363
-msgid "use a buffer size of BYTES"
-msgstr "BYTES benutze einen Puffer in der Größe von BYTES"
-
-#: src/main/help.c:366
-msgid "never use splice(), always use read/write"
-msgstr "anstelle von splice() immer read/write benutzen"
-
-#: src/main/help.c:369
-msgid "skip read errors in input"
-msgstr "Lesefehler in der Eingabe nicht beachten"
-
-#: src/main/help.c:372
-msgid "stop after --size bytes have been transferred"
-msgstr "anhalten, nachdem --size Bytes übertragen wurden"
-
-#: src/main/help.c:375
-msgid "flush cache to disk after every write"
-msgstr ""
-
-#: src/main/help.c:378
-msgid "use direct I/O to bypass cache"
-msgstr ""
-
-#: src/main/help.c:381
-msgid "PID"
-msgstr ""
-
-#: src/main/help.c:382
-msgid "update settings of process PID"
-msgstr "Einstellungen der Prozess-PID updaten"
-
-#: src/main/help.c:386 src/main/help.c:401
-msgid "FILE"
-msgstr ""
-
-#: src/main/help.c:387
-msgid "save process ID in FILE"
-msgstr "Prozess-ID in FILE speichern"
-
-#: src/main/help.c:390
-msgid "PID[:FD]"
-msgstr ""
-
-#: src/main/help.c:391
-msgid "watch file FD opened by process PID"
-msgstr "die vom Prozess PID geöffnete Datei FD beobachten"
-
-#: src/main/help.c:395
-msgid "show this help and exit"
-msgstr "zeige diese Hilfe und beende"
-
-#: src/main/help.c:398
-msgid "show version information and exit"
-msgstr "zeige Versionsinformationen und beende"
-
-#: src/main/help.c:402
-msgid "write debug logs to FILE"
-msgstr ""
-
-#. @-formatconst@
-#.
-#. * splint note: unavoidable use of %s in translated string.  Should
-#. * be hard to exploit - the message catalogue would have to be
-#. * replaced or forced to load from another location.
-#.
-#: src/main/help.c:427
-#, c-format
-msgid "Usage: %s [OPTION] [FILE]..."
-msgstr "Syntax: %s [OPTION] [DATEI]..."
-
-#. @-mustfreefresh@
-#.
-#. * splint note: the gettext calls made by _() cause memory leak
-#. * warnings, but in this case it's unavoidable, and mitigated by the
-#. * fact we only translate each string once.
-#.
-#: src/main/help.c:438
-msgid ""
-"Concatenate FILE(s), or standard input, to standard output, with monitoring."
-msgstr ""
-"Verbindet DATEI(en) oder den Standard-Eingabe-Kanal mit dem Standard-Ausgabe-"
-"Kanal und misst den Datenstrom."
-
-#: src/main/help.c:575
-#, c-format
-msgid "Please report any bugs to %s."
-msgstr "Bitte senden Sie Fehlerberichte an %s."
-
-#: src/main/main.c:75
-msgid "state allocation failed"
-msgstr "Zustandszuweisung fehlgeschlagen"
-
-#: src/main/main.c:243
-msgid "failed to read terminal attributes"
-msgstr ""
-
-#: src/main/options.c:111
-msgid "option structure allocation failed"
-msgstr "`option' konnte nicht allokiert werden"
-
-#: src/main/options.c:124
-msgid "option structure argv allocation failed"
-msgstr "`option' (argv) konnte nicht allokiert werden"
-
-#: src/main/options.c:163
-msgid "integer argument expected"
-msgstr "Ganzzahliges Argument erwartet"
-
-#: src/main/options.c:171
-msgid "numeric argument expected"
-msgstr "numerisches Argument erwartet"
-
-#: src/main/options.c:180
-msgid "process ID or pid:fd pair expected"
-msgstr "Prozess-ID oder PID:FD-Paar erwartet"
-
-#: src/main/options.c:185
-msgid "invalid process ID"
-msgstr "ungültige Prozess-ID"
-
-#: src/main/options.c:358
-#, c-format
-msgid "Try `%s --help' for more information."
-msgstr "`%s --help' zeigt weitere Informationen an."
-
-#: src/main/options.c:360
-#, c-format
-msgid "Try `%s -h' for more information."
-msgstr "`%s -h' zeigt weitere Informationen an."
-
-#: src/main/options.c:374
-msgid ""
-"cannot use line mode or transfer modifier options when watching file "
-"descriptors"
-msgstr ""
-"Beim Anzeigen von Dateideskriptoren können keine Optionen für den "
-"Zeilenmodus oder den Übertragungsmodifikator verwendet werden"
-
-#: src/main/options.c:381
-msgid "cannot use cursor positioning when watching file descriptors"
-msgstr ""
-"Beim Anzeigen von Dateideskriptoren können keine Zeilenmodus- oder "
-"Übertragungsmodifikatoroptionen verwendet werden."
-
-#: src/main/options.c:388
-msgid "cannot use remote control when watching file descriptors"
-msgstr ""
-"kann keine Fernbedienung verwenden, wenn Dateideskriptoren angezeigt werden"
-
-#: src/main/options.c:395
-msgid "cannot transfer files when watching file descriptors"
-msgstr ""
-"Dateien können beim Betrachten von Dateideskriptoren nicht übertragen werden"
-
-#: src/main/options.c:402
-msgid "not available on systems without /proc/self/fdinfo"
-msgstr "Nicht verfügbar auf Systemen ohne /proc/self/fdinfo"
-
-#~ msgid ""
-#~ "Debugging is enabled; export the DEBUG environment variable to define "
-#~ "the\n"
-#~ "output filename.\n"
-#~ msgstr ""
-#~ "Das Debuggen ist aktiviert. Exportieren Sie die Umgebungsvariable DEBUG,\n"
-#~ "um den Ausgabedateinamen zu definieren.\n"
-
-#~ msgid "%s %s - Copyright %s %s"
-#~ msgstr "%s %s - Copyright(C) %s %s"
-
-#~ msgid "Web site: %s"
-#~ msgstr "Web-Site: %s"
-
-#~ msgid ""
-#~ "This program is free software, and is being distributed under the\n"
-#~ "terms of the Artistic License 2.0."
-#~ msgstr ""
-#~ "Dieses Programm ist freie Software und wird unter den Bedingungen\n"
-#~ "der Artistic License verbreitet."
-
-#~ msgid ""
-#~ "This program is distributed in the hope that it will be useful,\n"
-#~ "but WITHOUT ANY WARRANTY; without even the implied warranty of\n"
-#~ "MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE."
-#~ msgstr ""
-#~ "Dieses Programm wird in der Hoffnung verbreitet, dass es nützlich sein "
-#~ "wird,\n"
-#~ "aber OHNE JEGLICHE GARANTIE; ohne die implizite Garantie von\n"
-#~ "MARKTGÄNGIGKEIT oder EIGNUNG FÜR EINEN BESTIMMTEN ZWECK."

src/nls/fr.po

@@ -1,510 +0,0 @@
-msgid ""
-msgstr ""
-"Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2023-07-30 19:07+0100\n"
-"Content-Type: text/plain; charset=UTF-8\n"
-"Date: 1999-06-01 15:18:29+0100\n"
-"From: Andrew Wood <ivarch@ubik>\n"
-"Xgettext-Options: --default-domain=pkgbuild --directory=./.pkgdir --add-"
-"comments --keyword=_ --keyword=N_\n"
-"Files: src/getopt/getopt.c src/getopt/getopt1.c src/version.c src/main/init."
-"c src/main/help.c src/main/xpmptr.c src/guts/load.c src/guts/stop.c src/guts/"
-"configure.c src/guts/make.c src/guts/install.c src/guts/prefs.c src/ui/"
-"generate.c src/ui/main.c src/ui/xpm.c src/ui/status.c src/ui/activate.c src/"
-"ui/handlers/main.c src/ui/handlers/package.c src/ui/handlers/prefs.c src/ui/"
-"handlers/dirsel.c src/ui/handlers/popup.c src/ui/handlers/help.c src/ui/"
-"textout.c src/ui/report.c src/ui/callback.c src/nls/intl/bindtextdom.c src/"
-"nls/intl/dcgettext.c src/nls/intl/dgettext.c src/nls/intl/finddomain.c src/"
-"nls/intl/gettext.c src/nls/intl/loadmsgcat.c src/nls/intl/localealias.c src/"
-"nls/intl/textdomain.c src/nls/intl-cat/cat-compat.c src/nls/intl-gett/intl-"
-"compat.c\n"
-
-#: src/pv/cursor.c:85
-msgid "failed to get terminal name"
-msgstr "échec de lecture du nom du terminal"
-
-#: src/pv/cursor.c:117
-msgid "failed to open lock file"
-msgstr "échec de l'ouverture du fichier de verrouillage"
-
-#: src/pv/cursor.c:150
-msgid "lock attempt failed"
-msgstr "tentative de verrouillage échoué"
-
-#: src/pv/cursor.c:391
-msgid "failed to open terminal"
-msgstr "l'ouverture du terminal a échoué"
-
-#: src/pv/file.c:119
-msgid "failed to seek to start of output"
-msgstr "ne peut pas passer au début de la sortie"
-
-#: src/pv/file.c:210
-msgid "failed to close file"
-msgstr "la fermeture du fichier a échoué"
-
-#: src/pv/file.c:232
-msgid "failed to read file"
-msgstr "la lecture du fichier a échoué"
-
-#: src/pv/file.c:239 src/main/options.c:284
-msgid "failed to stat file"
-msgstr "échec à statuer sur le fichier"
-
-#: src/pv/file.c:246
-msgid "failed to stat output file"
-msgstr "échec à statuer sur le fichier de sortie"
-
-#: src/pv/file.c:268
-msgid "input file is output file"
-msgstr "fichiers d'entré et de sortie sont les mêmes"
-
-#: src/pv/transfer.c:359
-msgid "read failed"
-msgstr "la lecture a échoué"
-
-#: src/pv/transfer.c:374
-msgid "warning: read errors detected"
-msgstr "avertissement: erreurs de lecture détectées"
-
-#: src/pv/transfer.c:386
-msgid "file is not seekable"
-msgstr "ne peut pas se déplacer dans le fichier"
-
-#: src/pv/transfer.c:445
-msgid "failed to seek past error"
-msgstr "n'a pas réussi à dépasser l'erreur"
-
-#: src/pv/transfer.c:461
-msgid "skipped past read error"
-msgstr "erreur de lecture dépassée"
-
-#: src/pv/transfer.c:461 src/pv/display.c:660
-msgid "B"
-msgstr "O"
-
-#: src/pv/transfer.c:617
-msgid "write failed"
-msgstr "l'écriture a échoué"
-
-#: src/pv/transfer.c:736 src/pv/display.c:594
-msgid "buffer allocation failed"
-msgstr "l'allocation de mémoire tampon a échoué"
-
-#.
-#. * Any other error is a problem and we must report back.
-#.
-#: src/pv/transfer.c:833
-msgid "select call failed"
-msgstr "appel de sélection a échoué"
-
-#: src/pv/watchpid.c:73 src/pv/watchpid.c:83 src/pv/watchpid.c:94
-#: src/pv/watchpid.c:102 src/pv/watchpid.c:139 src/pv/watchpid.c:150
-#: src/pv/watchpid.c:158 src/pv/watchpid.c:169 src/pv/watchpid.c:253
-#: src/pv/watchpid.c:261 src/pv/watchpid.c:292 src/pv/watchpid.c:312
-#: src/pv/loop.c:506 src/pv/loop.c:558 src/pv/loop.c:602
-msgid "pid"
-msgstr ""
-
-#: src/pv/watchpid.c:83 src/pv/watchpid.c:95 src/pv/watchpid.c:104
-#: src/pv/watchpid.c:150 src/pv/watchpid.c:159 src/pv/watchpid.c:171
-msgid "fd"
-msgstr ""
-
-#: src/pv/watchpid.c:104 src/pv/watchpid.c:171
-msgid "not a regular file or block device"
-msgstr "pas un fichier ordinaire ou un périphérique de bloc"
-
-#: src/pv/state.c:30
-msgid "history structure allocation failed"
-msgstr ""
-
-#: src/pv/state.c:59
-msgid "none"
-msgstr ""
-
-#: src/pv/display.c:159
-msgid "yzafpnum kMGTPEZY"
-msgstr ""
-
-#: src/pv/display.c:164
-msgid "yzafpnum KMGTPEZY"
-msgstr ""
-
-#: src/pv/display.c:656
-msgid "b"
-msgstr ""
-
-#: src/pv/display.c:711 src/pv/display.c:722
-msgid "b/s"
-msgstr ""
-
-#: src/pv/display.c:714 src/pv/display.c:726
-msgid "/s"
-msgstr "/s"
-
-#: src/pv/display.c:714 src/pv/display.c:726
-msgid "B/s"
-msgstr "O/s"
-
-#: src/pv/display.c:762 src/pv/display.c:766 src/pv/display.c:825
-msgid "ETA"
-msgstr "ETA"
-
-#. GNU standard license line and free software notice
-#: src/main/version.c:28
-msgid "License: Artistic v2.0 <https://opensource.org/license/artistic-2-0/>"
-msgstr ""
-
-#: src/main/version.c:29
-msgid "This is free software: you are free to change and redistribute it."
-msgstr ""
-
-#: src/main/version.c:30
-msgid "There is NO WARRANTY, to the extent permitted by law."
-msgstr ""
-
-#. Project web site link
-#: src/main/version.c:32
-msgid "Project web site"
-msgstr ""
-
-#: src/main/remote.c:215
-msgid "message not received"
-msgstr "message non reçu"
-
-#: src/main/remote.c:318
-msgid "IPC not supported on this system"
-msgstr "IPC non pris en charge sur ce système"
-
-#: src/main/help.c:283
-msgid "show progress bar"
-msgstr "affiche la barre de progression"
-
-#: src/main/help.c:286
-msgid "show elapsed time"
-msgstr "affiche le temps écoulé"
-
-#: src/main/help.c:289
-msgid "show estimated time of arrival (completion)"
-msgstr "affiche l'heure approximative de l'achèvement de la tâche"
-
-#: src/main/help.c:292
-msgid "show absolute estimated time of arrival (completion)"
-msgstr "affiche l'heure absolute de l'achèvement de la tâche"
-
-#: src/main/help.c:295
-msgid "show data transfer rate counter"
-msgstr "affiche le taux de tranfert des données"
-
-#: src/main/help.c:298
-msgid "show data transfer average rate counter"
-msgstr "afficher le compteur de taux moyen de transfert de données"
-
-#: src/main/help.c:300 src/main/help.c:328 src/main/help.c:340
-msgid "SEC"
-msgstr "SEC"
-
-#: src/main/help.c:301
-msgid "compute average rate over past SEC seconds (default 30s)"
-msgstr ""
-
-#: src/main/help.c:304
-msgid "show number of bytes transferred"
-msgstr "affiche le nombre d'octets transférés"
-
-#: src/main/help.c:307
-msgid "show number of bits transferred"
-msgstr ""
-
-#: src/main/help.c:310
-msgid "show percentage of transfer buffer in use"
-msgstr "afficher le pourcentage de tampon de transfert utilisé"
-
-#: src/main/help.c:312
-msgid "NUM"
-msgstr ""
-
-#: src/main/help.c:313
-msgid "show NUM bytes last written"
-msgstr "affiche NUM octets pour la dernière fois écrits"
-
-#: src/main/help.c:315
-msgid "FORMAT"
-msgstr ""
-
-#: src/main/help.c:316
-msgid "set output format to FORMAT"
-msgstr "définir le format de sortie sur FORMAT"
-
-#: src/main/help.c:319
-msgid "output percentages, not visual information"
-msgstr "imprime en pourcentage, pas les informations visuelles"
-
-#: src/main/help.c:322
-msgid "do not output any transfer information at all"
-msgstr "n'afficher aucune information de transfert"
-
-#: src/main/help.c:326
-msgid "display nothing until first byte transferred"
-msgstr "ne rien afficher avant qu'au moins un octet soit tranféré"
-
-#: src/main/help.c:329
-msgid "display nothing until SEC seconds have passed"
-msgstr "n'afficher rien jusqu'à ce que SEC secondes se soient écoulées"
-
-#: src/main/help.c:331
-msgid "SIZE"
-msgstr "TAILLE"
-
-#: src/main/help.c:332
-msgid "set estimated data size to SIZE bytes"
-msgstr "ajuste la taille estimée des données à TAILLE octets"
-
-#: src/main/help.c:335
-msgid "count lines instead of bytes"
-msgstr "compte les lignes au lieu des octets"
-
-#: src/main/help.c:338
-msgid "lines are null-terminated"
-msgstr "les lignes sont terminées par un nul"
-
-#: src/main/help.c:341
-msgid "update every SEC seconds"
-msgstr "mise-à-jour toute les SEC secondes"
-
-#: src/main/help.c:343
-msgid "WIDTH"
-msgstr "LARGEUR"
-
-#: src/main/help.c:344
-msgid "assume terminal is WIDTH characters wide"
-msgstr "présumer la largeur du terminal à LARGEUR caractères"
-
-#: src/main/help.c:346
-msgid "HEIGHT"
-msgstr "HAUTEUR"
-
-#: src/main/help.c:347
-msgid "assume terminal is HEIGHT rows high"
-msgstr "présumer la hauteur du terminal à HAUTEUR lignes"
-
-#: src/main/help.c:349
-msgid "NAME"
-msgstr "NOM"
-
-#: src/main/help.c:350
-msgid "prefix visual information with NAME"
-msgstr "préfixer les informations visuelles avec NOM"
-
-#: src/main/help.c:353
-msgid "output even if standard error is not a terminal"
-msgstr "imprime vers la sortie d'erreur même si ce n'est pas un terminal"
-
-#: src/main/help.c:356
-msgid "use cursor positioning escape sequences"
-msgstr "utiliser les séquences d'échappements de positionnement de curseur"
-
-#: src/main/help.c:359
-msgid "RATE"
-msgstr "TAUX"
-
-#: src/main/help.c:360
-msgid "limit transfer to RATE bytes per second"
-msgstr "limite le taux de transfer à TAUX octets par seconde"
-
-#: src/main/help.c:362
-msgid "BYTES"
-msgstr "OCTETS"
-
-#: src/main/help.c:363
-msgid "use a buffer size of BYTES"
-msgstr "Utiliser une mémoire tampon de OCTETS octets"
-
-#: src/main/help.c:366
-msgid "never use splice(), always use read/write"
-msgstr "n'utilisez jamais splice(), utilisez toujours read/write"
-
-#: src/main/help.c:369
-msgid "skip read errors in input"
-msgstr "ignorer les erreurs de lecture dans l'entrée"
-
-#: src/main/help.c:372
-msgid "stop after --size bytes have been transferred"
-msgstr "arrêter après le transfert de --size octets"
-
-#: src/main/help.c:375
-msgid "flush cache to disk after every write"
-msgstr ""
-
-#: src/main/help.c:378
-msgid "use direct I/O to bypass cache"
-msgstr ""
-
-#: src/main/help.c:381
-msgid "PID"
-msgstr "PID"
-
-#: src/main/help.c:382
-msgid "update settings of process PID"
-msgstr "mettre-à-jour la configuration du processus PID"
-
-#: src/main/help.c:386 src/main/help.c:401
-msgid "FILE"
-msgstr ""
-
-#: src/main/help.c:387
-msgid "save process ID in FILE"
-msgstr "enregistrer l'ID de processus dans FILE"
-
-#: src/main/help.c:390
-msgid "PID[:FD]"
-msgstr ""
-
-#: src/main/help.c:391
-msgid "watch file FD opened by process PID"
-msgstr "regarder le fichier FD ouvert par le processus PID"
-
-#: src/main/help.c:395
-msgid "show this help and exit"
-msgstr "afficher cette aide puis quitter"
-
-#: src/main/help.c:398
-msgid "show version information and exit"
-msgstr "afficher la version puis quitter"
-
-#: src/main/help.c:402
-msgid "write debug logs to FILE"
-msgstr ""
-
-#. @-formatconst@
-#.
-#. * splint note: unavoidable use of %s in translated string.  Should
-#. * be hard to exploit - the message catalogue would have to be
-#. * replaced or forced to load from another location.
-#.
-#: src/main/help.c:427
-#, c-format
-msgid "Usage: %s [OPTION] [FILE]..."
-msgstr "Utilisation : %s [OPTIONS] [FICHIER]..."
-
-#. @-mustfreefresh@
-#.
-#. * splint note: the gettext calls made by _() cause memory leak
-#. * warnings, but in this case it's unavoidable, and mitigated by the
-#. * fact we only translate each string once.
-#.
-#: src/main/help.c:438
-msgid ""
-"Concatenate FILE(s), or standard input, to standard output, with monitoring."
-msgstr ""
-"Concatène FICHIER(s), ou l'entrée standard, sur la sortie standard avec "
-"monitorage."
-
-#: src/main/help.c:575
-#, c-format
-msgid "Please report any bugs to %s."
-msgstr "SVP rapporter touts bogues à %s."
-
-#: src/main/main.c:75
-msgid "state allocation failed"
-msgstr "échec de l'allocation de mémoire de condition"
-
-#: src/main/main.c:243
-msgid "failed to read terminal attributes"
-msgstr ""
-
-#: src/main/options.c:111
-msgid "option structure allocation failed"
-msgstr "l'allocation pour la structure d'une option a echoué"
-
-#: src/main/options.c:124
-msgid "option structure argv allocation failed"
-msgstr "l'allocation pour la structure de l'option argv a echoué"
-
-#: src/main/options.c:163
-msgid "integer argument expected"
-msgstr "Valeur entière attendue"
-
-#: src/main/options.c:171
-msgid "numeric argument expected"
-msgstr "Valeur numérique attendue"
-
-#: src/main/options.c:180
-msgid "process ID or pid:fd pair expected"
-msgstr "ID de processus ou paire pid:fd attendue"
-
-#: src/main/options.c:185
-msgid "invalid process ID"
-msgstr "ID de processus non valide"
-
-#: src/main/options.c:358
-#, c-format
-msgid "Try `%s --help' for more information."
-msgstr "Essayez `%s --help' pour plus d'information."
-
-#: src/main/options.c:360
-#, c-format
-msgid "Try `%s -h' for more information."
-msgstr "Essayez `%s -h' pour plus d'information."
-
-#: src/main/options.c:374
-msgid ""
-"cannot use line mode or transfer modifier options when watching file "
-"descriptors"
-msgstr ""
-"impossible d'utiliser le mode ligne ou les options de modificateur de "
-"transfert lors de la visualisation des descripteurs de fichiers"
-
-#: src/main/options.c:381
-msgid "cannot use cursor positioning when watching file descriptors"
-msgstr ""
-"impossible d'utiliser le positionnement du curseur lors de la visualisation "
-"des descripteurs de fichier"
-
-#: src/main/options.c:388
-msgid "cannot use remote control when watching file descriptors"
-msgstr ""
-"impossible d'utiliser la télécommande lors de la visualisation des "
-"descripteurs de fichiers"
-
-#: src/main/options.c:395
-msgid "cannot transfer files when watching file descriptors"
-msgstr ""
-"impossible de transférer des fichiers lorsque vous regardez des descripteurs "
-"de fichiers"
-
-#: src/main/options.c:402
-msgid "not available on systems without /proc/self/fdinfo"
-msgstr "non disponible sur les systèmes sans /proc/self/fdinfo"
-
-#~ msgid ""
-#~ "Debugging is enabled; export the DEBUG environment variable to define "
-#~ "the\n"
-#~ "output filename.\n"
-#~ msgstr ""
-#~ "Le débogage est activé; exportez la variable d'environnement DEBUG pour\n"
-#~ "définir le nom du fichier de sortie.\n"
-
-#~ msgid "%s %s - Copyright %s %s"
-#~ msgstr "%s %s - Copyright(C) %s %s"
-
-#~ msgid "Web site: %s"
-#~ msgstr "Site Web: %s"
-
-#~ msgid ""
-#~ "This program is free software, and is being distributed under the\n"
-#~ "terms of the Artistic License 2.0."
-#~ msgstr ""
-#~ "Ce programme est un logiciel libre et est distribué sous les termes\n"
-#~ "anglophone de la Licence Artistique 2.0 (Artistic License 2.0)."
-
-#~ msgid ""
-#~ "This program is distributed in the hope that it will be useful,\n"
-#~ "but WITHOUT ANY WARRANTY; without even the implied warranty of\n"
-#~ "MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE."
-#~ msgstr ""
-#~ "Ce programme est distribué dans l'espoir qu'il sera utile, mais\n"
-#~ "SANS GARANTIE AUCUNE; ni même de garantie sous-entendu que le\n"
-#~ "programme soit COMMERCIALISABLE ou APPLICABLE À UNE TÂCHE\n"
-#~ "PARTICULIÈRE."

src/nls/pl.po

@@ -1,472 +0,0 @@
-# SOME DESCRIPTIVE TITLE.
-# Copyright (C) YEAR Free Software Foundation, Inc.
-# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
-#
-msgid ""
-msgstr ""
-"Project-Id-Version: PACKAGE VERSION\n"
-"Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2023-07-30 19:07+0100\n"
-"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
-"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
-"Language-Team: LANGUAGE <LL@li.org>\n"
-"Language: \n"
-"MIME-Version: 1.0\n"
-"Content-Type: text/plain; charset=UTF-8\n"
-"Content-Transfer-Encoding: 8bit\n"
-
-#: src/pv/cursor.c:85
-msgid "failed to get terminal name"
-msgstr ""
-
-# "Przewidywany czas ukończenia" for ETA is too long
-#: src/pv/cursor.c:117
-msgid "failed to open lock file"
-msgstr ""
-
-#: src/pv/cursor.c:150
-msgid "lock attempt failed"
-msgstr ""
-
-#: src/pv/cursor.c:391
-msgid "failed to open terminal"
-msgstr "nie udało się otworzyć terminala"
-
-#: src/pv/file.c:119
-msgid "failed to seek to start of output"
-msgstr ""
-
-# "Przewidywany czas ukończenia" for ETA is too long
-#: src/pv/file.c:210
-msgid "failed to close file"
-msgstr "nie udało się zamknąć pliku"
-
-#: src/pv/file.c:232
-msgid "failed to read file"
-msgstr "nie udało się odczytać pliku"
-
-#: src/pv/file.c:239 src/main/options.c:284
-msgid "failed to stat file"
-msgstr "nie udało się wykonać operacji stat na pliku"
-
-#: src/pv/file.c:246
-msgid "failed to stat output file"
-msgstr "nie udało się wykonać operacji stat na pliku wyjściowym"
-
-#: src/pv/file.c:268
-msgid "input file is output file"
-msgstr "plik wejściowy jest zarazem plikiem wyjściowym"
-
-#: src/pv/transfer.c:359
-msgid "read failed"
-msgstr "błąd odczytu"
-
-#: src/pv/transfer.c:374
-msgid "warning: read errors detected"
-msgstr ""
-
-#: src/pv/transfer.c:386
-msgid "file is not seekable"
-msgstr ""
-
-#: src/pv/transfer.c:445
-msgid "failed to seek past error"
-msgstr ""
-
-#: src/pv/transfer.c:461
-msgid "skipped past read error"
-msgstr ""
-
-#: src/pv/transfer.c:461 src/pv/display.c:660
-msgid "B"
-msgstr "B"
-
-#: src/pv/transfer.c:617
-msgid "write failed"
-msgstr "błąd zapisu"
-
-#: src/pv/transfer.c:736 src/pv/display.c:594
-msgid "buffer allocation failed"
-msgstr "nie udało się zaalokować bufora"
-
-#.
-#. * Any other error is a problem and we must report back.
-#.
-#: src/pv/transfer.c:833
-msgid "select call failed"
-msgstr "nie udało się wywołać funkcji select"
-
-#: src/pv/watchpid.c:73 src/pv/watchpid.c:83 src/pv/watchpid.c:94
-#: src/pv/watchpid.c:102 src/pv/watchpid.c:139 src/pv/watchpid.c:150
-#: src/pv/watchpid.c:158 src/pv/watchpid.c:169 src/pv/watchpid.c:253
-#: src/pv/watchpid.c:261 src/pv/watchpid.c:292 src/pv/watchpid.c:312
-#: src/pv/loop.c:506 src/pv/loop.c:558 src/pv/loop.c:602
-msgid "pid"
-msgstr ""
-
-#: src/pv/watchpid.c:83 src/pv/watchpid.c:95 src/pv/watchpid.c:104
-#: src/pv/watchpid.c:150 src/pv/watchpid.c:159 src/pv/watchpid.c:171
-msgid "fd"
-msgstr ""
-
-#: src/pv/watchpid.c:104 src/pv/watchpid.c:171
-msgid "not a regular file or block device"
-msgstr ""
-
-#: src/pv/state.c:30
-msgid "history structure allocation failed"
-msgstr ""
-
-#: src/pv/state.c:59
-msgid "none"
-msgstr ""
-
-#: src/pv/display.c:159
-msgid "yzafpnum kMGTPEZY"
-msgstr ""
-
-#: src/pv/display.c:164
-msgid "yzafpnum KMGTPEZY"
-msgstr ""
-
-#: src/pv/display.c:656
-msgid "b"
-msgstr ""
-
-#: src/pv/display.c:711 src/pv/display.c:722
-msgid "b/s"
-msgstr ""
-
-#: src/pv/display.c:714 src/pv/display.c:726
-msgid "/s"
-msgstr "/s"
-
-#: src/pv/display.c:714 src/pv/display.c:726
-msgid "B/s"
-msgstr "B/s"
-
-#: src/pv/display.c:762 src/pv/display.c:766 src/pv/display.c:825
-msgid "ETA"
-msgstr "ETA"
-
-#. GNU standard license line and free software notice
-#: src/main/version.c:28
-msgid "License: Artistic v2.0 <https://opensource.org/license/artistic-2-0/>"
-msgstr ""
-
-#: src/main/version.c:29
-msgid "This is free software: you are free to change and redistribute it."
-msgstr ""
-
-#: src/main/version.c:30
-msgid "There is NO WARRANTY, to the extent permitted by law."
-msgstr ""
-
-#. Project web site link
-#: src/main/version.c:32
-msgid "Project web site"
-msgstr ""
-
-#: src/main/remote.c:215
-msgid "message not received"
-msgstr ""
-
-#: src/main/remote.c:318
-msgid "IPC not supported on this system"
-msgstr ""
-
-#: src/main/help.c:283
-msgid "show progress bar"
-msgstr "pokaż pasek postępu"
-
-#: src/main/help.c:286
-msgid "show elapsed time"
-msgstr "pokaż upływający czas"
-
-#: src/main/help.c:289
-msgid "show estimated time of arrival (completion)"
-msgstr "pokaż szacowany czas ukończenia"
-
-#: src/main/help.c:292
-msgid "show absolute estimated time of arrival (completion)"
-msgstr ""
-
-#: src/main/help.c:295
-msgid "show data transfer rate counter"
-msgstr "pokaż licznik prędkości przesyłania"
-
-#: src/main/help.c:298
-msgid "show data transfer average rate counter"
-msgstr ""
-
-#: src/main/help.c:300 src/main/help.c:328 src/main/help.c:340
-msgid "SEC"
-msgstr "WARTOŚĆ"
-
-#: src/main/help.c:301
-msgid "compute average rate over past SEC seconds (default 30s)"
-msgstr ""
-
-#: src/main/help.c:304
-msgid "show number of bytes transferred"
-msgstr "pokaż ilość przesłanych bajtów"
-
-#: src/main/help.c:307
-msgid "show number of bits transferred"
-msgstr ""
-
-#: src/main/help.c:310
-msgid "show percentage of transfer buffer in use"
-msgstr ""
-
-#: src/main/help.c:312
-msgid "NUM"
-msgstr ""
-
-#: src/main/help.c:313
-msgid "show NUM bytes last written"
-msgstr ""
-
-#: src/main/help.c:315
-msgid "FORMAT"
-msgstr ""
-
-#: src/main/help.c:316
-msgid "set output format to FORMAT"
-msgstr ""
-
-#: src/main/help.c:319
-msgid "output percentages, not visual information"
-msgstr "wświetl wyjście procentowo, bez graficznej prezentacji"
-
-#: src/main/help.c:322
-msgid "do not output any transfer information at all"
-msgstr "nie wyświetlaj żadnych informacji o przesyłaniu"
-
-#: src/main/help.c:326
-msgid "display nothing until first byte transferred"
-msgstr "nie wyświetlaj nic aż do pierwszego przesłanego bajtu"
-
-#: src/main/help.c:329
-msgid "display nothing until SEC seconds have passed"
-msgstr ""
-
-#: src/main/help.c:331
-msgid "SIZE"
-msgstr "WARTOŚĆ"
-
-#: src/main/help.c:332
-msgid "set estimated data size to SIZE bytes"
-msgstr "ustaw oczekiwany rozmiar danych na WARTOŚĆ bajtów"
-
-#: src/main/help.c:335
-msgid "count lines instead of bytes"
-msgstr ""
-
-#: src/main/help.c:338
-msgid "lines are null-terminated"
-msgstr ""
-
-#: src/main/help.c:341
-msgid "update every SEC seconds"
-msgstr "aktualizuj co każde WARTOŚĆ sekund"
-
-#: src/main/help.c:343
-msgid "WIDTH"
-msgstr "WARTOŚĆ"
-
-#: src/main/help.c:344
-msgid "assume terminal is WIDTH characters wide"
-msgstr "przyjmij, że terminal ma szerokość WARTOŚĆ znaków"
-
-#: src/main/help.c:346
-msgid "HEIGHT"
-msgstr ""
-
-#: src/main/help.c:347
-msgid "assume terminal is HEIGHT rows high"
-msgstr "przyjmij, że terminal ma szerokość WARTOŚĆ znaków"
-
-#: src/main/help.c:349
-msgid "NAME"
-msgstr "NAZWA"
-
-#: src/main/help.c:350
-msgid "prefix visual information with NAME"
-msgstr "poprzedź informacje prefiksem NAZWA"
-
-#: src/main/help.c:353
-msgid "output even if standard error is not a terminal"
-msgstr "pokaż wyjście nawet gdy błędy nie są typu terminal"
-
-#: src/main/help.c:356
-msgid "use cursor positioning escape sequences"
-msgstr "używaj sekwencji escape do pozycjonowania"
-
-#: src/main/help.c:359
-msgid "RATE"
-msgstr ""
-
-#: src/main/help.c:360
-msgid "limit transfer to RATE bytes per second"
-msgstr "ogranicz przesyłane dane do RATE bajtów na sekundę"
-
-#: src/main/help.c:362
-msgid "BYTES"
-msgstr ""
-
-#: src/main/help.c:363
-msgid "use a buffer size of BYTES"
-msgstr ""
-
-#: src/main/help.c:366
-msgid "never use splice(), always use read/write"
-msgstr ""
-
-#: src/main/help.c:369
-msgid "skip read errors in input"
-msgstr ""
-
-#: src/main/help.c:372
-msgid "stop after --size bytes have been transferred"
-msgstr ""
-
-#: src/main/help.c:375
-msgid "flush cache to disk after every write"
-msgstr ""
-
-#: src/main/help.c:378
-msgid "use direct I/O to bypass cache"
-msgstr ""
-
-#: src/main/help.c:381
-msgid "PID"
-msgstr ""
-
-#: src/main/help.c:382
-msgid "update settings of process PID"
-msgstr ""
-
-#: src/main/help.c:386 src/main/help.c:401
-msgid "FILE"
-msgstr ""
-
-#: src/main/help.c:387
-msgid "save process ID in FILE"
-msgstr ""
-
-#: src/main/help.c:390
-msgid "PID[:FD]"
-msgstr ""
-
-#: src/main/help.c:391
-msgid "watch file FD opened by process PID"
-msgstr ""
-
-#: src/main/help.c:395
-msgid "show this help and exit"
-msgstr "wyświetl te informacje z pomocą i wyjdź"
-
-#: src/main/help.c:398
-msgid "show version information and exit"
-msgstr "wyświetl informacje o wersji i wyjdź"
-
-#: src/main/help.c:402
-msgid "write debug logs to FILE"
-msgstr ""
-
-#. @-formatconst@
-#.
-#. * splint note: unavoidable use of %s in translated string.  Should
-#. * be hard to exploit - the message catalogue would have to be
-#. * replaced or forced to load from another location.
-#.
-#: src/main/help.c:427
-#, c-format
-msgid "Usage: %s [OPTION] [FILE]..."
-msgstr "Sposób użycia: %s [OPCJA] [PLIK]..."
-
-#. @-mustfreefresh@
-#.
-#. * splint note: the gettext calls made by _() cause memory leak
-#. * warnings, but in this case it's unavoidable, and mitigated by the
-#. * fact we only translate each string once.
-#.
-#: src/main/help.c:438
-msgid ""
-"Concatenate FILE(s), or standard input, to standard output, with monitoring."
-msgstr ""
-"Łączenie PLIK(ów) lub wejścia standardowego, do wyjścia standardowego z "
-"monitoringiem."
-
-#: src/main/help.c:575
-#, c-format
-msgid "Please report any bugs to %s."
-msgstr "Proszę przesyłać zgłoszenia błędów do %s."
-
-#: src/main/main.c:75
-msgid "state allocation failed"
-msgstr ""
-
-#: src/main/main.c:243
-msgid "failed to read terminal attributes"
-msgstr ""
-
-#: src/main/options.c:111
-msgid "option structure allocation failed"
-msgstr "nie udało się zaalokować struktur opcji"
-
-#: src/main/options.c:124
-msgid "option structure argv allocation failed"
-msgstr "nie udało się zaalokować struktur opcji argv"
-
-#: src/main/options.c:163
-msgid "integer argument expected"
-msgstr ""
-
-#: src/main/options.c:171
-msgid "numeric argument expected"
-msgstr ""
-
-#: src/main/options.c:180
-msgid "process ID or pid:fd pair expected"
-msgstr ""
-
-#: src/main/options.c:185
-msgid "invalid process ID"
-msgstr ""
-
-#: src/main/options.c:358
-#, c-format
-msgid "Try `%s --help' for more information."
-msgstr "Spróbuj `%s --help' by uzyskać więcej informacji"
-
-#: src/main/options.c:360
-#, c-format
-msgid "Try `%s -h' for more information."
-msgstr "Spróbuj `%s -h' by uzyskać więcej informacji"
-
-#: src/main/options.c:374
-msgid ""
-"cannot use line mode or transfer modifier options when watching file "
-"descriptors"
-msgstr ""
-
-#: src/main/options.c:381
-msgid "cannot use cursor positioning when watching file descriptors"
-msgstr ""
-
-#: src/main/options.c:388
-msgid "cannot use remote control when watching file descriptors"
-msgstr ""
-
-#: src/main/options.c:395
-msgid "cannot transfer files when watching file descriptors"
-msgstr ""
-
-#: src/main/options.c:402
-msgid "not available on systems without /proc/self/fdinfo"
-msgstr ""
-
-#~ msgid "Web site: %s"
-#~ msgstr "Strona WWW: %s"

src/nls/pv.pot

@@ -1,467 +0,0 @@
-# SOME DESCRIPTIVE TITLE.
-# Copyright (C) YEAR THE PACKAGE'S COPYRIGHT HOLDER
-# This file is distributed under the same license as the PACKAGE package.
-# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
-#
-#, fuzzy
-msgid ""
-msgstr ""
-"Project-Id-Version: PACKAGE VERSION\n"
-"Report-Msgid-Bugs-To: \n"
-"POT-Creation-Date: 2023-07-30 19:07+0100\n"
-"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
-"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
-"Language-Team: LANGUAGE <LL@li.org>\n"
-"Language: \n"
-"MIME-Version: 1.0\n"
-"Content-Type: text/plain; charset=CHARSET\n"
-"Content-Transfer-Encoding: 8bit\n"
-
-#: src/pv/cursor.c:85
-msgid "failed to get terminal name"
-msgstr ""
-
-#: src/pv/cursor.c:117
-msgid "failed to open lock file"
-msgstr ""
-
-#: src/pv/cursor.c:150
-msgid "lock attempt failed"
-msgstr ""
-
-#: src/pv/cursor.c:391
-msgid "failed to open terminal"
-msgstr ""
-
-#: src/pv/file.c:119
-msgid "failed to seek to start of output"
-msgstr ""
-
-#: src/pv/file.c:210
-msgid "failed to close file"
-msgstr ""
-
-#: src/pv/file.c:232
-msgid "failed to read file"
-msgstr ""
-
-#: src/pv/file.c:239 src/main/options.c:284
-msgid "failed to stat file"
-msgstr ""
-
-#: src/pv/file.c:246
-msgid "failed to stat output file"
-msgstr ""
-
-#: src/pv/file.c:268
-msgid "input file is output file"
-msgstr ""
-
-#: src/pv/transfer.c:359
-msgid "read failed"
-msgstr ""
-
-#: src/pv/transfer.c:374
-msgid "warning: read errors detected"
-msgstr ""
-
-#: src/pv/transfer.c:386
-msgid "file is not seekable"
-msgstr ""
-
-#: src/pv/transfer.c:445
-msgid "failed to seek past error"
-msgstr ""
-
-#: src/pv/transfer.c:461
-msgid "skipped past read error"
-msgstr ""
-
-#: src/pv/transfer.c:461 src/pv/display.c:660
-msgid "B"
-msgstr ""
-
-#: src/pv/transfer.c:617
-msgid "write failed"
-msgstr ""
-
-#: src/pv/transfer.c:736 src/pv/display.c:594
-msgid "buffer allocation failed"
-msgstr ""
-
-#.
-#. * Any other error is a problem and we must report back.
-#.
-#: src/pv/transfer.c:833
-msgid "select call failed"
-msgstr ""
-
-#: src/pv/watchpid.c:73 src/pv/watchpid.c:83 src/pv/watchpid.c:94
-#: src/pv/watchpid.c:102 src/pv/watchpid.c:139 src/pv/watchpid.c:150
-#: src/pv/watchpid.c:158 src/pv/watchpid.c:169 src/pv/watchpid.c:253
-#: src/pv/watchpid.c:261 src/pv/watchpid.c:292 src/pv/watchpid.c:312
-#: src/pv/loop.c:506 src/pv/loop.c:558 src/pv/loop.c:602
-msgid "pid"
-msgstr ""
-
-#: src/pv/watchpid.c:83 src/pv/watchpid.c:95 src/pv/watchpid.c:104
-#: src/pv/watchpid.c:150 src/pv/watchpid.c:159 src/pv/watchpid.c:171
-msgid "fd"
-msgstr ""
-
-#: src/pv/watchpid.c:104 src/pv/watchpid.c:171
-msgid "not a regular file or block device"
-msgstr ""
-
-#: src/pv/state.c:30
-msgid "history structure allocation failed"
-msgstr ""
-
-#: src/pv/state.c:59
-msgid "none"
-msgstr ""
-
-#: src/pv/display.c:159
-msgid "yzafpnum kMGTPEZY"
-msgstr ""
-
-#: src/pv/display.c:164
-msgid "yzafpnum KMGTPEZY"
-msgstr ""
-
-#: src/pv/display.c:656
-msgid "b"
-msgstr ""
-
-#: src/pv/display.c:711 src/pv/display.c:722
-msgid "b/s"
-msgstr ""
-
-#: src/pv/display.c:714 src/pv/display.c:726
-msgid "/s"
-msgstr ""
-
-#: src/pv/display.c:714 src/pv/display.c:726
-msgid "B/s"
-msgstr ""
-
-#: src/pv/display.c:762 src/pv/display.c:766 src/pv/display.c:825
-msgid "ETA"
-msgstr ""
-
-#. GNU standard license line and free software notice
-#: src/main/version.c:28
-msgid "License: Artistic v2.0 <https://opensource.org/license/artistic-2-0/>"
-msgstr ""
-
-#: src/main/version.c:29
-msgid "This is free software: you are free to change and redistribute it."
-msgstr ""
-
-#: src/main/version.c:30
-msgid "There is NO WARRANTY, to the extent permitted by law."
-msgstr ""
-
-#. Project web site link
-#: src/main/version.c:32
-msgid "Project web site"
-msgstr ""
-
-#: src/main/remote.c:215
-msgid "message not received"
-msgstr ""
-
-#: src/main/remote.c:318
-msgid "IPC not supported on this system"
-msgstr ""
-
-#: src/main/help.c:283
-msgid "show progress bar"
-msgstr ""
-
-#: src/main/help.c:286
-msgid "show elapsed time"
-msgstr ""
-
-#: src/main/help.c:289
-msgid "show estimated time of arrival (completion)"
-msgstr ""
-
-#: src/main/help.c:292
-msgid "show absolute estimated time of arrival (completion)"
-msgstr ""
-
-#: src/main/help.c:295
-msgid "show data transfer rate counter"
-msgstr ""
-
-#: src/main/help.c:298
-msgid "show data transfer average rate counter"
-msgstr ""
-
-#: src/main/help.c:300 src/main/help.c:328 src/main/help.c:340
-msgid "SEC"
-msgstr ""
-
-#: src/main/help.c:301
-msgid "compute average rate over past SEC seconds (default 30s)"
-msgstr ""
-
-#: src/main/help.c:304
-msgid "show number of bytes transferred"
-msgstr ""
-
-#: src/main/help.c:307
-msgid "show number of bits transferred"
-msgstr ""
-
-#: src/main/help.c:310
-msgid "show percentage of transfer buffer in use"
-msgstr ""
-
-#: src/main/help.c:312
-msgid "NUM"
-msgstr ""
-
-#: src/main/help.c:313
-msgid "show NUM bytes last written"
-msgstr ""
-
-#: src/main/help.c:315
-msgid "FORMAT"
-msgstr ""
-
-#: src/main/help.c:316
-msgid "set output format to FORMAT"
-msgstr ""
-
-#: src/main/help.c:319
-msgid "output percentages, not visual information"
-msgstr ""
-
-#: src/main/help.c:322
-msgid "do not output any transfer information at all"
-msgstr ""
-
-#: src/main/help.c:326
-msgid "display nothing until first byte transferred"
-msgstr ""
-
-#: src/main/help.c:329
-msgid "display nothing until SEC seconds have passed"
-msgstr ""
-
-#: src/main/help.c:331
-msgid "SIZE"
-msgstr ""
-
-#: src/main/help.c:332
-msgid "set estimated data size to SIZE bytes"
-msgstr ""
-
-#: src/main/help.c:335
-msgid "count lines instead of bytes"
-msgstr ""
-
-#: src/main/help.c:338
-msgid "lines are null-terminated"
-msgstr ""
-
-#: src/main/help.c:341
-msgid "update every SEC seconds"
-msgstr ""
-
-#: src/main/help.c:343
-msgid "WIDTH"
-msgstr ""
-
-#: src/main/help.c:344
-msgid "assume terminal is WIDTH characters wide"
-msgstr ""
-
-#: src/main/help.c:346
-msgid "HEIGHT"
-msgstr ""
-
-#: src/main/help.c:347
-msgid "assume terminal is HEIGHT rows high"
-msgstr ""
-
-#: src/main/help.c:349
-msgid "NAME"
-msgstr ""
-
-#: src/main/help.c:350
-msgid "prefix visual information with NAME"
-msgstr ""
-
-#: src/main/help.c:353
-msgid "output even if standard error is not a terminal"
-msgstr ""
-
-#: src/main/help.c:356
-msgid "use cursor positioning escape sequences"
-msgstr ""
-
-#: src/main/help.c:359
-msgid "RATE"
-msgstr ""
-
-#: src/main/help.c:360
-msgid "limit transfer to RATE bytes per second"
-msgstr ""
-
-#: src/main/help.c:362
-msgid "BYTES"
-msgstr ""
-
-#: src/main/help.c:363
-msgid "use a buffer size of BYTES"
-msgstr ""
-
-#: src/main/help.c:366
-msgid "never use splice(), always use read/write"
-msgstr ""
-
-#: src/main/help.c:369
-msgid "skip read errors in input"
-msgstr ""
-
-#: src/main/help.c:372
-msgid "stop after --size bytes have been transferred"
-msgstr ""
-
-#: src/main/help.c:375
-msgid "flush cache to disk after every write"
-msgstr ""
-
-#: src/main/help.c:378
-msgid "use direct I/O to bypass cache"
-msgstr ""
-
-#: src/main/help.c:381
-msgid "PID"
-msgstr ""
-
-#: src/main/help.c:382
-msgid "update settings of process PID"
-msgstr ""
-
-#: src/main/help.c:386 src/main/help.c:401
-msgid "FILE"
-msgstr ""
-
-#: src/main/help.c:387
-msgid "save process ID in FILE"
-msgstr ""
-
-#: src/main/help.c:390
-msgid "PID[:FD]"
-msgstr ""
-
-#: src/main/help.c:391
-msgid "watch file FD opened by process PID"
-msgstr ""
-
-#: src/main/help.c:395
-msgid "show this help and exit"
-msgstr ""
-
-#: src/main/help.c:398
-msgid "show version information and exit"
-msgstr ""
-
-#: src/main/help.c:402
-msgid "write debug logs to FILE"
-msgstr ""
-
-#. @-formatconst@
-#.
-#. * splint note: unavoidable use of %s in translated string.  Should
-#. * be hard to exploit - the message catalogue would have to be
-#. * replaced or forced to load from another location.
-#.
-#: src/main/help.c:427
-#, c-format
-msgid "Usage: %s [OPTION] [FILE]..."
-msgstr ""
-
-#. @-mustfreefresh@
-#.
-#. * splint note: the gettext calls made by _() cause memory leak
-#. * warnings, but in this case it's unavoidable, and mitigated by the
-#. * fact we only translate each string once.
-#.
-#: src/main/help.c:438
-msgid ""
-"Concatenate FILE(s), or standard input, to standard output, with monitoring."
-msgstr ""
-
-#: src/main/help.c:575
-#, c-format
-msgid "Please report any bugs to %s."
-msgstr ""
-
-#: src/main/main.c:75
-msgid "state allocation failed"
-msgstr ""
-
-#: src/main/main.c:243
-msgid "failed to read terminal attributes"
-msgstr ""
-
-#: src/main/options.c:111
-msgid "option structure allocation failed"
-msgstr ""
-
-#: src/main/options.c:124
-msgid "option structure argv allocation failed"
-msgstr ""
-
-#: src/main/options.c:163
-msgid "integer argument expected"
-msgstr ""
-
-#: src/main/options.c:171
-msgid "numeric argument expected"
-msgstr ""
-
-#: src/main/options.c:180
-msgid "process ID or pid:fd pair expected"
-msgstr ""
-
-#: src/main/options.c:185
-msgid "invalid process ID"
-msgstr ""
-
-#: src/main/options.c:358
-#, c-format
-msgid "Try `%s --help' for more information."
-msgstr ""
-
-#: src/main/options.c:360
-#, c-format
-msgid "Try `%s -h' for more information."
-msgstr ""
-
-#: src/main/options.c:374
-msgid ""
-"cannot use line mode or transfer modifier options when watching file "
-"descriptors"
-msgstr ""
-
-#: src/main/options.c:381
-msgid "cannot use cursor positioning when watching file descriptors"
-msgstr ""
-
-#: src/main/options.c:388
-msgid "cannot use remote control when watching file descriptors"
-msgstr ""
-
-#: src/main/options.c:395
-msgid "cannot transfer files when watching file descriptors"
-msgstr ""
-
-#: src/main/options.c:402
-msgid "not available on systems without /proc/self/fdinfo"
-msgstr ""

src/pv/calc.c

@@ -0,0 +1,182 @@
+/*
+ * Functions for updating the calculated state of the transfer.
+ *
+ * Copyright 2024-2025 Andrew Wood
+ *
+ * License GPLv3+: GNU GPL version 3 or later; see `docs/COPYING'.
+ */
+
+#include "config.h"
+#include "pv.h"
+#include "pv-internal.h"
+
+
+/*
+ * Update the current average rate, using a ring buffer of past transfer
+ * positions - if this is the first entry, use the provided instantaneous
+ * rate, otherwise calulate the average rate from the difference between the
+ * current position + elapsed time pair, and the oldest pair in the buffer.
+ */
+static void pv__update_average_rate_history(pvtransfercalc_t calc, readonly_pvtransferstate_t transfer,
+					    unsigned int history_interval, long double rate)
+{
+	size_t first = calc->history_first;
+	size_t last = calc->history_last;
+	long double last_elapsed;
+
+	if (NULL == calc->history)
+		return;
+
+	last_elapsed = calc->history[last].elapsed_sec;
+
+	/*
+	 * Do nothing if this is not the first call but not enough time has
+	 * elapsed since the previous call yet.
+	 */
+	if ((last_elapsed > 0.0)
+	    && (transfer->elapsed_seconds < (last_elapsed + history_interval)))
+		return;
+
+	/*
+	 * If this is not the first call, add a new entry to the circular
+	 * buffer.
+	 */
+	if (last_elapsed > 0.0) {
+		size_t len = calc->history_len;
+		last = (last + 1) % len;
+		calc->history_last = last;
+		if (last == first) {
+			first = (first + 1) % len;
+			calc->history_first = first;
+		}
+	}
+
+	calc->history[last].elapsed_sec = transfer->elapsed_seconds;
+	calc->history[last].transferred = transfer->transferred;
+
+	if (first == last) {
+		calc->current_avg_rate = rate;
+	} else {
+		off_t bytes = (calc->history[last].transferred - calc->history[first].transferred);
+		long double sec = (calc->history[last].elapsed_sec - calc->history[first].elapsed_sec);
+		/* Safety check to avoid division by zero. */
+		if (sec < 0.000001 && sec > -0.000001)
+			sec = 0.000001;
+		calc->current_avg_rate = (long double) bytes / sec;
+	}
+}
+
+
+/*
+ * Update all calculated transfer state in calc (usually from state->calc).
+ *
+ * If "final" is true, this is the final update, so calc->transfer_rate and
+ * calc->average_rate are given as an average over the whole transfer;
+ * otherwise they are the current transfer rate and current average rate.
+ *
+ * The value of calc->percentage will reflect the percentage completion if
+ * control->size is greater than zero, otherwise it will increase by 2 each
+ * call and wrap at 200.
+ */
+void pv_calculate_transfer_rate(pvtransfercalc_t calc, readonly_pvtransferstate_t transfer,
+				readonly_pvcontrol_t control, readonly_pvdisplay_t display, bool final)
+{
+	off_t bytes_since_last;
+	long double time_since_last, transfer_rate, average_rate;
+
+	/* Quick safety checks for null pointers. */
+	if (NULL == calc)
+		return;
+	if (NULL == transfer)
+		return;
+	if (NULL == control)
+		return;
+	if (NULL == display)
+		return;
+
+	bytes_since_last = 0;
+	if (transfer->transferred >= 0) {
+		bytes_since_last = transfer->transferred - calc->prev_transferred;
+		calc->prev_transferred = transfer->transferred;
+	}
+
+	/*
+	 * In case the time since the last update is very small, we keep
+	 * track of amount transferred since the last update, and just keep
+	 * adding to that until a reasonable amount of time has passed to
+	 * avoid rate spikes or division by zero.
+	 */
+	time_since_last = transfer->elapsed_seconds - calc->prev_elapsed_sec;
+	if (time_since_last <= 0.01) {
+		transfer_rate = calc->prev_rate;
+		calc->prev_trans += bytes_since_last;
+	} else {
+		long double measured_rate;
+
+		transfer_rate = ((long double) bytes_since_last + calc->prev_trans) / time_since_last;
+		measured_rate = transfer_rate;
+
+		calc->prev_elapsed_sec = transfer->elapsed_seconds;
+		calc->prev_trans = 0;
+
+		if (control->bits)
+			measured_rate = 8.0 * measured_rate;
+
+		if ((calc->measurements_taken < 1) || (measured_rate < calc->rate_min)) {
+			calc->rate_min = measured_rate;
+		}
+		if (measured_rate > calc->rate_max) {
+			calc->rate_max = measured_rate;
+		}
+		calc->rate_sum += measured_rate;
+		calc->ratesquared_sum += (measured_rate * measured_rate);
+		calc->measurements_taken++;
+	}
+	calc->prev_rate = transfer_rate;
+
+	/* Update history and current average rate for ETA. */
+	pv__update_average_rate_history(calc, transfer, control->history_interval, transfer_rate);
+	average_rate = calc->current_avg_rate;
+
+	/*
+	 * If this is the final update at the end of the transfer, we
+	 * recalculate the rate - and the average rate - across the whole
+	 * period of the transfer.
+	 */
+	if (final) {
+		long double total_elapsed_seconds = (long double) (transfer->elapsed_seconds);
+		/* Safety check to avoid division by zero. */
+		if (total_elapsed_seconds < 0.000001)
+			total_elapsed_seconds = 0.000001;
+		average_rate =
+		    (((long double) (transfer->transferred)) -
+		     ((long double) display->initial_offset)) / total_elapsed_seconds;
+		transfer_rate = average_rate;
+	}
+
+	calc->transfer_rate = transfer_rate;
+	calc->average_rate = average_rate;
+
+	if (control->size <= 0) {
+		/*
+		 * If we don't know the total size of the incoming data,
+		 * then for a percentage, we gradually increase the
+		 * percentage completion as data arrives, to a maximum of
+		 * 200, then reset it - we use this if we can't calculate
+		 * it, so that the numeric percentage output will go
+		 * 0%-100%, 100%-0%, 0%-100%, and so on.
+		 */
+		if (transfer_rate > 0)
+			calc->percentage += 2;
+		if (calc->percentage > 199)
+			calc->percentage = 0;
+	} else {
+		calc->percentage = pv_percentage(transfer->transferred, control->size);
+	}
+
+	/* Ensure the percentage is never negative or huge. */
+	if (calc->percentage < 0.0)
+		calc->percentage = 0.0;
+	if (calc->percentage > 100000.0)
+		calc->percentage = 100000.0;
+}

src/pv/cursor.c

@@ -10,9 +10,9 @@
  * terminal, so we try to use a lockfile if terminal locking doesn't work,
  * and finally abort if even that is unavailable.
  *
- * Copyright 2002-2008, 2010, 2012-2015, 2017, 2021, 2023 Andrew Wood
+ * Copyright 2002-2008, 2010, 2012-2015, 2017, 2021, 2023-2025 Andrew Wood
  *
- * Distributed under the Artistic License v2.0; see `doc/COPYING'.
+ * License GPLv3+: GNU GPL version 3 or later; see `docs/COPYING'.
  */
 
 #include "config.h"
@@ -35,76 +35,57 @@
 #ifdef HAVE_SYS_PARAM_H
 #include <sys/param.h>
 #endif
+#endif				/* HAVE_IPC */
+
+/* for basename() */
 #ifdef HAVE_LIBGEN_H
 #include <libgen.h>
 #endif
-#endif				/* HAVE_IPC */
-
-
-/*
- * Write the given buffer to the given file descriptor, retrying until all
- * bytes have been written or an error has occurred.
- */
-void pv_write_retry(int fd, const char *buf, size_t count)
-{
-	while (count > 0) {
-		ssize_t nwritten;
-
-		nwritten = write(fd, buf, count);
-
-		if (nwritten < 0) {
-			if ((EINTR == errno) || (EAGAIN == errno)) {
-				continue;
-			}
-			return;
-		}
-		if (nwritten < 1)
-			return;
-
-		count -= nwritten;
-		buf += nwritten;
-	}
-}
 
 
 /*
  * Create a per-euid, per-tty, lockfile in ${TMPDIR:-${TMP:-/tmp}} for the
  * tty on the given file descriptor.
  */
-static void pv_crs_open_lockfile(pvstate_t state, int fd)
+static void pv_crs_open_lockfile(pvcursorstate_t cursor, readonly_pvcontrol_t control, int fd)
 {
 	char *ttydev;
 	char *tmpdir;
 	int openflags;
 
-	state->crs_lock_fd = -1;
+	cursor->lock_fd = -1;
 
 	ttydev = ttyname(fd);
 	if (!ttydev) {
-		if (!state->force) {
-			pv_error(state, "%s: %s", _("failed to get terminal name"), strerror(errno));
+		if (!control->force) {
+			pv_error("%s: %s", _("failed to get terminal name"), strerror(errno));
 		}
 		/*
 		 * If we don't know our terminal name, we can neither do IPC
 		 * nor make a lock file, so turn off cursor positioning.
 		 */
-		state->cursor = 0;
+		cursor->disable = true;
 		debug("%s", "ttyname failed - cursor positioning disabled");
 		return;
 	}
 
-	tmpdir = (char *) getenv("TMPDIR");
-	if (!tmpdir)
-		tmpdir = (char *) getenv("TMP");
-	if (!tmpdir)
+	tmpdir = (char *) getenv("TMPDIR"); /* flawfinder: ignore */
+	if ((NULL == tmpdir) || ('\0' == tmpdir[0]))
+		tmpdir = (char *) getenv("TMP");	/* flawfinder: ignore */
+	if ((NULL == tmpdir) || ('\0' == tmpdir[0]))
 		tmpdir = "/tmp";
 
-	memset(state->crs_lock_file, 0, PV_SIZEOF_CRS_LOCK_FILE);
-	(void) pv_snprintf(state->crs_lock_file,
+	/*
+	 * flawfinder rationale: null and zero-size values of $TMPDIR and
+	 * $TMP are rejected, and the destination buffer is bounded.
+	 */
+
+	memset(cursor->lock_file, 0, PV_SIZEOF_CRS_LOCK_FILE);
+	(void) pv_snprintf(cursor->lock_file,
 			   PV_SIZEOF_CRS_LOCK_FILE, "%s/pv-%s-%i.lock", tmpdir, basename(ttydev), (int) geteuid());
 
 	/*
-	 * Pawel Piatek - not everyone has O_NOFOLLOW, e.g. AIX doesn't
+	 * Pawel Piatek - not everyone has O_NOFOLLOW, e.g. AIX doesn't.
 	 */
 #ifdef O_NOFOLLOW
 	openflags = O_RDWR | O_CREAT | O_NOFOLLOW;
@@ -112,10 +93,18 @@ static void pv_crs_open_lockfile(pvstate_t state, int fd)
 	openflags = O_RDWR | O_CREAT;
 #endif
 
-	state->crs_lock_fd = open(state->crs_lock_file, openflags, 0600);
-	if (state->crs_lock_fd < 0) {
-		pv_error(state, "%s: %s: %s", state->crs_lock_file, _("failed to open lock file"), strerror(errno));
-		state->cursor = 0;
+	cursor->lock_fd = open(cursor->lock_file, openflags, 0600);	/* flawfinder: ignore */
+
+	/*
+	 * flawfinder rationale: we aren't truncating the lock file, we
+	 * don't change its contents, and we are attempting to use
+	 * O_NOFOLLOW where possible to avoid symlink attacks, so this
+	 * open() is as safe as we can make it.
+	 */
+
+	if (cursor->lock_fd < 0) {
+		pv_error("%s: %s: %s", cursor->lock_file, _("failed to open lock file"), strerror(errno));
+		cursor->disable = true;
 		return;
 	}
 }
@@ -125,14 +114,14 @@ static void pv_crs_open_lockfile(pvstate_t state, int fd)
  * Lock the terminal on the given file descriptor, falling back to using a
  * lockfile if the terminal itself cannot be locked.
  */
-static void pv_crs_lock(pvstate_t state, int fd)
+static void pv_crs_lock(pvcursorstate_t cursor, readonly_pvcontrol_t control, int fd)
 {
 	struct flock lock;
 	int lock_fd;
 
 	lock_fd = fd;
-	if (state->crs_lock_fd >= 0)
-		lock_fd = state->crs_lock_fd;
+	if (cursor->lock_fd >= 0)
+		lock_fd = cursor->lock_fd;
 
 	memset(&lock, 0, sizeof(lock));
 	lock.l_type = (short) F_WRLCK;
@@ -141,20 +130,20 @@ static void pv_crs_lock(pvstate_t state, int fd)
 	lock.l_len = 1;
 	while (fcntl(lock_fd, F_SETLKW, &lock) < 0) {
 		if (errno != EINTR) {
-			if (state->crs_lock_fd == -2) {
-				pv_crs_open_lockfile(state, fd);
-				if (state->crs_lock_fd >= 0) {
-					lock_fd = state->crs_lock_fd;
+			if (cursor->lock_fd == -2) {
+				pv_crs_open_lockfile(cursor, control, fd);
+				if (cursor->lock_fd >= 0) {
+					lock_fd = cursor->lock_fd;
 				}
 			} else {
-				pv_error(state, "%s: %s", _("lock attempt failed"), strerror(errno));
+				pv_error("%s: %s", _("lock attempt failed"), strerror(errno));
 				return;
 			}
 		}
 	}
 
-	if (state->crs_lock_fd >= 0) {
-		debug("%s: %s", state->crs_lock_file, "terminal lockfile acquired");
+	if (cursor->lock_fd >= 0) {
+		debug("%s: %s", cursor->lock_file, "terminal lockfile acquired");
 	} else {
 		debug("%s", "terminal lock acquired");
 	}
@@ -165,14 +154,14 @@ static void pv_crs_lock(pvstate_t state, int fd)
  * Unlock the terminal on the given file descriptor.  If pv_crs_lock used
  * lockfile locking, unlock the lockfile.
  */
-static void pv_crs_unlock(pvstate_t state, int fd)
+static void pv_crs_unlock(pvcursorstate_t cursor, int fd)
 {
 	struct flock lock;
 	int lock_fd;
 
 	lock_fd = fd;
-	if (state->crs_lock_fd >= 0)
-		lock_fd = state->crs_lock_fd;
+	if (cursor->lock_fd >= 0)
+		lock_fd = cursor->lock_fd;
 
 	memset(&lock, 0, sizeof(lock));
 	lock.l_type = (short) F_UNLCK;
@@ -181,8 +170,8 @@ static void pv_crs_unlock(pvstate_t state, int fd)
 	lock.l_len = 1;
 	(void) fcntl(lock_fd, F_SETLK, &lock);
 
-	if (state->crs_lock_fd >= 0) {
-		debug("%s: %s", state->crs_lock_file, "terminal lockfile released");
+	if (cursor->lock_fd >= 0) {
+		debug("%s: %s", cursor->lock_file, "terminal lockfile released");
 	} else {
 		debug("%s", "terminal lock released");
 	}
@@ -196,20 +185,20 @@ static void pv_crs_unlock(pvstate_t state, int fd)
  * cursor mode (including us), and store it in pv_crs_pvcount. If this is
  * larger than pv_crs_pvmax, update pv_crs_pvmax.
  */
-static void pv_crs_ipccount(pvstate_t state)
+static void pv_crs_ipccount(pvcursorstate_t cursor)
 {
 	struct shmid_ds buf;
 
 	memset(&buf, 0, sizeof(buf));
 	buf.shm_nattch = 0;
 
-	(void) shmctl(state->crs_shmid, IPC_STAT, &buf);
-	state->crs_pvcount = (int) (buf.shm_nattch);
+	(void) shmctl(cursor->shmid, IPC_STAT, &buf);
+	cursor->pvcount = (int) (buf.shm_nattch);
 
-	if (state->crs_pvcount > state->crs_pvmax)
-		state->crs_pvmax = state->crs_pvcount;
+	if (cursor->pvcount > cursor->pvmax)
+		cursor->pvmax = cursor->pvcount;
 
-	debug("%s: %d", "pvcount", state->crs_pvcount);
+	debug("%s: %d", "pvcount", cursor->pvcount);
 }
 #endif				/* HAVE_IPC */
 
@@ -217,12 +206,17 @@ static void pv_crs_ipccount(pvstate_t state)
 /*
  * Get the current cursor Y co-ordinate by sending the ECMA-48 CPR code to
  * the terminal connected to the given file descriptor.
+ *
+ * This should only be called while the terminal is locked, to avoid
+ * confusing other "pv -c" instances about the current terminal attributes,
+ * since this function temporarily changes the terminal attributes and then
+ * puts them back.
  */
 static int pv_crs_get_ypos(int terminalfd)
 {
 	struct termios tty;
 	struct termios old_tty;
-	char cpr[32];
+	char cpr[32];			 /* flawfinder: ignore - bounded, zeroed */
 	int ypos;
 	ssize_t r;
 #ifdef CURSOR_ANSWERBACK_BYTE_BY_BYTE
@@ -247,7 +241,8 @@ static int pv_crs_get_ypos(int terminalfd)
 #ifdef CURSOR_ANSWERBACK_BYTE_BY_BYTE
 	/* Read answerback byte by byte - fails on AIX */
 	for (got = 0, r = 0; got < (int) (sizeof(cpr) - 2); got += r) {
-		r = read(terminalfd, cpr + got, 1);
+		r = read(terminalfd, cpr + got, 1);	/* flawfinder: ignore */
+		/* flawfinder rationale: bounded to buffer size by "for" */
 		if (r <= 0) {
 			debug("got=%d, r=%d: %s", got, r, strerror(errno));
 			break;
@@ -262,7 +257,8 @@ static int pv_crs_get_ypos(int terminalfd)
 
 #else				/* !CURSOR_ANSWERBACK_BYTE_BY_BYTE */
 	/* Read answerback in one big lump - may fail on Solaris */
-	r = read(terminalfd, cpr, sizeof(cpr));
+	r = read(terminalfd, cpr, sizeof(cpr) - 2);	/* flawfinder: ignore */
+	/* flawfinder rationale: bounded to buffer size */
 	if (r <= 0) {
 		debug("r=%d: %s", r, strerror(errno));
 	} else {
@@ -271,9 +267,9 @@ static int pv_crs_get_ypos(int terminalfd)
 		     terminalfd, r, cpr[0], cpr[1], cpr[2], cpr[3], cpr[4], cpr[5]);
 
 	}
-#endif				/* CURSOR_ANSWERBACK_BYTE_BY_BYTE */
+#endif				/* !CURSOR_ANSWERBACK_BYTE_BY_BYTE */
 
-	ypos = (int) pv_getnum_ui(cpr + 2);
+	ypos = (int) pv_getnum_count(cpr + 2, false);
 
 	if (0 != tcsetattr(terminalfd, TCSANOW | TCSAFLUSH, &old_tty)) {
 		debug("%s: %s", "tcsetattr (2) failed", strerror(errno));
@@ -298,7 +294,7 @@ static int pv_crs_get_ypos(int terminalfd)
  * count" of one, and so no initialisation occurs. So, we lock the terminal
  * with pv_crs_lock() while we are attaching and checking.
  */
-static int pv_crs_ipcinit(pvstate_t state, char *ttyfile, int terminalfd)
+static int pv_crs_ipcinit(pvcursorstate_t cursor, readonly_pvcontrol_t control, char *ttyfile, int terminalfd)
 {
 	key_t key;
 
@@ -313,50 +309,55 @@ static int pv_crs_ipcinit(pvstate_t state, char *ttyfile, int terminalfd)
 		return 1;
 	}
 
-	pv_crs_lock(state, terminalfd);
-	if (!state->cursor) {
+	pv_crs_lock(cursor, control, terminalfd);
+	if ((!control->cursor) || (cursor->disable)) {
 		debug("%s", "early return - cursor has been disabled");
 		return 1;
 	}
 
-	state->crs_shmid = shmget(key, sizeof(int), 0600 | IPC_CREAT);
-	if (state->crs_shmid < 0) {
+	cursor->shmid = shmget(key, sizeof(struct pvipccursorstate_s), 0600 | IPC_CREAT);
+	if (cursor->shmid < 0) {
 		debug("%s: %s", "shmget failed", strerror(errno));
-		pv_crs_unlock(state, terminalfd);
+		pv_crs_unlock(cursor, terminalfd);
 		return 1;
 	}
 
-	state->crs_y_top = shmat(state->crs_shmid, NULL, 0);
+	/*@-nullpass@ */
+	/* splint doesn't know shmaddr can be NULL */
+	cursor->shared = shmat(cursor->shmid, NULL, 0);
+	/*@+nullpass@ */
 
-	pv_crs_ipccount(state);
+	pv_crs_ipccount(cursor);
 
 	/*
 	 * If nobody else is attached to the shared memory segment, we're
 	 * the first, so we need to initialise the shared memory with our
-	 * current Y cursor co-ordinate.
+	 * current Y cursor co-ordinate and with an initial false value for
+	 * the TOSTOP-added flag.
 	 */
-	if (state->crs_pvcount < 2) {
-		state->crs_y_start = pv_crs_get_ypos(terminalfd);
-		*(state->crs_y_top) = state->crs_y_start;
-		state->crs_y_lastread = state->crs_y_start;
+	if (cursor->pvcount < 2) {
+		cursor->y_start = pv_crs_get_ypos(terminalfd);
+		cursor->shared->y_topmost = cursor->y_start;
+		cursor->shared->tty_tostop_added = false;
+		cursor->y_lastread = cursor->y_start;
 		debug("%s", "we are the first to attach");
 	}
 
-	state->crs_y_offset = state->crs_pvcount - 1;
-	if (state->crs_y_offset < 0)
-		state->crs_y_offset = 0;
+	cursor->y_offset = cursor->pvcount - 1;
+	if (cursor->y_offset < 0)
+		cursor->y_offset = 0;
 
 	/*
 	 * If anyone else had attached to the shared memory segment, we need
 	 * to read the top Y co-ordinate from it.
 	 */
-	if (state->crs_pvcount > 1) {
-		state->crs_y_start = *(state->crs_y_top);
-		state->crs_y_lastread = state->crs_y_start;
-		debug("%s: %d", "not the first to attach - got top y", state->crs_y_start);
+	if (cursor->pvcount > 1) {
+		cursor->y_start = cursor->shared->y_topmost;
+		cursor->y_lastread = cursor->y_start;
+		debug("%s: %d", "not the first to attach - got top y", cursor->y_start);
 	}
 
-	pv_crs_unlock(state, terminalfd);
+	pv_crs_unlock(cursor, terminalfd);
 
 	return 0;
 }
@@ -366,36 +367,53 @@ static int pv_crs_ipcinit(pvstate_t state, char *ttyfile, int terminalfd)
 /*
  * Initialise the terminal for cursor positioning.
  */
-void pv_crs_init(pvstate_t state)
+void pv_crs_init(pvcursorstate_t cursor, readonly_pvcontrol_t control, pvtransientflags_t flags)
 {
 	char *ttyfile;
-	int fd;
+	int terminalfd;
 
-	state->crs_lock_fd = -2;
-	state->crs_lock_file[0] = '\0';
+	cursor->lock_fd = -2;
+	cursor->lock_file[0] = '\0';
 
-	if (!state->cursor)
+	if ((!control->cursor) || (cursor->disable))
 		return;
 
 	debug("%s", "init");
 
 	ttyfile = ttyname(STDERR_FILENO);
-	if (!ttyfile) {
+	if (NULL == ttyfile) {
 		debug("%s: %s", "disabling cursor positioning because ttyname failed", strerror(errno));
-		state->cursor = 0;
+		cursor->disable = true;
 		return;
 	}
 
-	fd = open(ttyfile, O_RDWR);
-	if (fd < 0) {
-		pv_error(state, "%s: %s: %s", _("failed to open terminal"), ttyfile, strerror(errno));
-		state->cursor = false;
+	terminalfd = open(ttyfile, O_RDWR); /* flawfinder: ignore */
+
+	/*
+	 * flawfinder rationale: the file we open won't be truncated but
+	 * could be corrupted by writes attempting to get the current Y
+	 * position; but we get the filename from ttyname() and it could be
+	 * a symbolic link, so we can't do much more than trust it.
+	 */
+
+	if (terminalfd < 0) {
+		pv_error("%s: %s: %s", _("failed to open terminal"), ttyfile, strerror(errno));
+		cursor->disable = true;
 		return;
 	}
 #ifdef HAVE_IPC
-	if (pv_crs_ipcinit(state, ttyfile, fd) != 0) {
+	if (pv_crs_ipcinit(cursor, control, ttyfile, terminalfd) != 0) {
 		debug("%s", "ipcinit failed, setting noipc flag");
-		state->crs_noipc = true;
+		cursor->noipc = true;
+	}
+
+	/*
+	 * If we have already set the terminal TOSTOP attribute, set the
+	 * flag in shared memory to let the other instances know.
+	 */
+	if ((!cursor->noipc) && (1 == flags->clear_tty_tostop_on_exit) && (NULL != cursor->shared)) {
+		debug("%s", "propagating local clear_tty_tostop_on_exit true value to shared tty_tostop_added flag");
+		cursor->shared->tty_tostop_added = true;
 	}
 
 	/*
@@ -403,29 +421,29 @@ void pv_crs_init(pvstate_t state)
 	 * co-ordinate. If we are using IPC, then the pv_crs_ipcinit()
 	 * function takes care of this in a more multi-process-friendly way.
 	 */
-	if (state->crs_noipc) {
+	if (cursor->noipc) {
 #else				/* ! HAVE_IPC */
 	if (1) {
 #endif				/* HAVE_IPC */
 		/*
 		 * Get current cursor position + 1.
 		 */
-		pv_crs_lock(state, fd);
-		state->crs_y_start = pv_crs_get_ypos(fd);
+		pv_crs_lock(cursor, control, terminalfd);
+		cursor->y_start = pv_crs_get_ypos(terminalfd);
 		/*
 		 * Move down a line while the terminal is locked, so that
 		 * other processes in the pipeline will get a different
 		 * initial ypos.
 		 */
-		if (state->crs_y_start > 0)
-			pv_write_retry(STDERR_FILENO, "\n", 1);
-		pv_crs_unlock(state, fd);
+		if (cursor->y_start > 0)
+			pv_tty_write(flags, "\n", 1);
+		pv_crs_unlock(cursor, terminalfd);
 
-		if (state->crs_y_start < 1)
-			state->cursor = 0;
+		if (cursor->y_start < 1)
+			cursor->disable = true;
 	}
 
-	(void) close(fd);
+	(void) close(terminalfd);
 }
 
 
@@ -433,11 +451,11 @@ void pv_crs_init(pvstate_t state)
 /*
  * Set the "we need to reinitialise cursor positioning" flag.
  */
-void pv_crs_needreinit(pvstate_t state)
+void pv_crs_needreinit(pvcursorstate_t cursor)
 {
-	state->crs_needreinit += 2;
-	if (state->crs_needreinit > 3)
-		state->crs_needreinit = 3;
+	cursor->needreinit += 2;
+	if (cursor->needreinit > 3)
+		cursor->needreinit = 3;
 }
 #endif
 
@@ -447,60 +465,84 @@ void pv_crs_needreinit(pvstate_t state)
  * Reinitialise the cursor positioning code (called if we are backgrounded
  * then foregrounded again).
  */
-void pv_crs_reinit(pvstate_t state)
+static void pv_crs_reinit(pvcursorstate_t cursor, readonly_pvcontrol_t control, pvtransientflags_t flags)
 {
 	debug("%s", "reinit");
 
-	pv_crs_lock(state, STDERR_FILENO);
+	if (1 == flags->suspend_stderr) {
+		debug("%s", "reinit abandoned - stderr is suspended");
+		return;
+	}
 
-	state->crs_needreinit--;
-	if (state->crs_y_offset < 1)
-		state->crs_needreinit = 0;
+	pv_crs_lock(cursor, control, STDERR_FILENO);
 
-	if (state->crs_needreinit > 0) {
-		pv_crs_unlock(state, STDERR_FILENO);
+	cursor->needreinit--;
+	if (cursor->y_offset < 1)
+		cursor->needreinit = 0;
+
+	if (cursor->needreinit > 0) {
+		pv_crs_unlock(cursor, STDERR_FILENO);
 		return;
 	}
 
 	debug("%s", "reinit full");
 
-	state->crs_y_start = pv_crs_get_ypos(STDERR_FILENO);
+	cursor->y_start = pv_crs_get_ypos(STDERR_FILENO);
 
-	if (state->crs_y_offset < 1)
-		*(state->crs_y_top) = state->crs_y_start;
-	state->crs_y_lastread = state->crs_y_start;
+	if ((cursor->y_offset < 1) && (NULL != cursor->shared)) {
+		cursor->shared->y_topmost = cursor->y_start;
+	}
+	cursor->y_lastread = cursor->y_start;
 
-	pv_crs_unlock(state, STDERR_FILENO);
+	pv_crs_unlock(cursor, STDERR_FILENO);
 }
 #endif
 
 
 /*
- * Output a single-line update, moving the cursor to the correct position to
- * do so.
+ * Output a single-line update (\0-terminated), using the ECMA-48 CSI "CUP"
+ * sequence to move the cursor to the correct position to do so.
  */
-void pv_crs_update(pvstate_t state, const char *str)
+void pv_crs_update(pvcursorstate_t cursor, readonly_pvcontrol_t control, pvtransientflags_t flags,
+		   const char *output_line)
 {
-	char pos[32];
+	char cup_cmd[32];		 /* flawfinder: ignore */
+	size_t cup_cmd_length, output_line_length;
 	int y;
 
-#ifdef HAVE_IPC
-	if (!state->crs_noipc) {
-		if (state->crs_needreinit > 0)
-			pv_crs_reinit(state);
+	/* Early return if cursor positioning was disabled. */
+	if (cursor->disable)
+		return;
 
-		pv_crs_ipccount(state);
-		if (state->crs_y_lastread != *(state->crs_y_top)) {
-			state->crs_y_start = *(state->crs_y_top);
-			state->crs_y_lastread = state->crs_y_start;
+	/*
+	 * flawfinder rationale: the "cup_cmd" buffer is always zeroed
+	 * before each use, and is only written to by pv_snprintf() bounded
+	 * by its size; also, that function explictly zero-terminates the
+	 * string it writes.  The write() call is also bounded.
+	 */
+
+	output_line_length = strlen(output_line);	/* flawfinder: ignore */
+	/* flawfinder - output_line is explictly expected to be \0-terminated. */
+
+#ifdef HAVE_IPC
+	if (!cursor->noipc) {
+		if (cursor->needreinit > 0)
+			pv_crs_reinit(cursor, control, flags);
+
+		pv_crs_ipccount(cursor);
+		if (NULL != cursor->shared) {
+			if (cursor->y_lastread != cursor->shared->y_topmost) {
+				cursor->y_start = cursor->shared->y_topmost;
+				cursor->y_lastread = cursor->y_start;
+			}
 		}
 
-		if (state->crs_needreinit > 0)
+		if (cursor->needreinit > 0)
 			return;
 	}
 #endif				/* HAVE_IPC */
 
-	y = state->crs_y_start;
+	y = cursor->y_start;
 
 #ifdef HAVE_IPC
 	/*
@@ -509,80 +551,91 @@ void pv_crs_update(pvstate_t state, const char *str)
 	 * scroll the screen (only if we're the first `pv'), and then move
 	 * our initial Y co-ordinate up.
 	 */
-	if (((state->crs_y_start + state->crs_pvmax) > (int) (state->height))
-	    && (!state->crs_noipc)
+	if (((cursor->y_start + cursor->pvmax) > (int) (control->height))
+	    && (!cursor->noipc)
 	    ) {
 		int offs;
 
-		offs = ((state->crs_y_start + state->crs_pvmax) - state->height);
+		offs = ((cursor->y_start + cursor->pvmax) - control->height);
 
-		state->crs_y_start -= offs;
-		if (state->crs_y_start < 1)
-			state->crs_y_start = 1;
+		cursor->y_start -= offs;
+		if (cursor->y_start < 1)
+			cursor->y_start = 1;
 
 		debug("%s: %d", "scroll offset", offs);
 
 		/*
 		 * Scroll the screen if we're the first `pv'.
 		 */
-		if (0 == state->crs_y_offset) {
-			pv_crs_lock(state, STDERR_FILENO);
+		if (0 == cursor->y_offset) {
+			pv_crs_lock(cursor, control, STDERR_FILENO);
 
-			memset(pos, 0, sizeof(pos));
-			(void) pv_snprintf(pos, sizeof(pos), "\033[%u;1H", state->height);
-			pv_write_retry(STDERR_FILENO, pos, strlen(pos));
+			memset(cup_cmd, 0, sizeof(cup_cmd));
+			(void) pv_snprintf(cup_cmd, sizeof(cup_cmd), "\033[%u;1H", control->height);
+			cup_cmd_length = strlen(cup_cmd);	/* flawfinder: ignore */
+			pv_tty_write(flags, cup_cmd, cup_cmd_length);
 			for (; offs > 0; offs--) {
-				pv_write_retry(STDERR_FILENO, "\n", 1);
+				pv_tty_write(flags, "\n", 1);
 			}
 
-			pv_crs_unlock(state, STDERR_FILENO);
+			pv_crs_unlock(cursor, STDERR_FILENO);
 
 			debug("%s", "we are the first - scrolled screen");
 		}
 	}
 
-	if (!state->crs_noipc)
-		y = state->crs_y_start + state->crs_y_offset;
+	if (!cursor->noipc)
+		y = cursor->y_start + cursor->y_offset;
 #endif				/* HAVE_IPC */
 
 	/*
 	 * Keep the Y co-ordinate within sensible bounds, so we can never
-	 * overflow the "pos" buffer.
+	 * overflow the "cup_cmd" buffer.
 	 */
 	if ((y < 1) || (y > 999999))
 		y = 1;
 
-	memset(pos, 0, sizeof(pos));
-	(void) pv_snprintf(pos, sizeof(pos), "\033[%d;1H", y);
+	memset(cup_cmd, 0, sizeof(cup_cmd));
+	(void) pv_snprintf(cup_cmd, sizeof(cup_cmd), "\033[%d;1H", y);
+	cup_cmd_length = strlen(cup_cmd);   /* flawfinder: ignore */
 
-	pv_crs_lock(state, STDERR_FILENO);
+	/*
+	 * flawfinder rationale: "cup_cmd" is only written to by
+	 * pv_snprintf(), which explicitly ensures that the string will be
+	 * \0-terminated, and the buffer is zeroed beforehand so if
+	 * pv_snprintf() fails to run the string will be of zero length.
+	 */
 
-	pv_write_retry(STDERR_FILENO, pos, strlen(pos));
-	pv_write_retry(STDERR_FILENO, str, strlen(str));
+	pv_crs_lock(cursor, control, STDERR_FILENO);
 
-	pv_crs_unlock(state, STDERR_FILENO);
+	pv_tty_write(flags, cup_cmd, cup_cmd_length);
+	pv_tty_write(flags, output_line, output_line_length);
+
+	pv_crs_unlock(cursor, STDERR_FILENO);
 }
 
 
 /*
  * Reposition the cursor to a final position.
  */
-void pv_crs_fini(pvstate_t state)
+void pv_crs_fini(pvcursorstate_t cursor, readonly_pvcontrol_t control, pvtransientflags_t flags)
 {
-	char pos[32];
+	char cup_cmd[32];		 /* flawfinder: ignore */
 	unsigned int y;
 
+	/* flawfinder - "cup_cmd" is zeroed, and only written by pv_snprintf() */
+
 	debug("%s", "fini");
 
-	y = (unsigned int) (state->crs_y_start);
+	y = (unsigned int) (cursor->y_start);
 
 #ifdef HAVE_IPC
-	if ((state->crs_pvmax > 0) && (!state->crs_noipc))
-		y += state->crs_pvmax - 1;
+	if ((cursor->pvmax > 0) && (!cursor->noipc))
+		y += cursor->pvmax - 1;
 #endif				/* HAVE_IPC */
 
-	if (y > state->height)
-		y = state->height;
+	if (y > control->height)
+		y = control->height;
 
 	/*
 	 * Absolute bounds check.
@@ -590,36 +643,56 @@ void pv_crs_fini(pvstate_t state)
 	if ((y < 1) || (y > 999999))
 		y = 1;
 
-	memset(pos, 0, sizeof(pos));
-	(void) pv_snprintf(pos, sizeof(pos), "\033[%u;1H\n", y);
+	memset(cup_cmd, 0, sizeof(cup_cmd));
+	(void) pv_snprintf(cup_cmd, sizeof(cup_cmd), "\033[%u;1H\n", y);
 
-	pv_crs_lock(state, STDERR_FILENO);
+	pv_crs_lock(cursor, control, STDERR_FILENO);
 
-	pv_write_retry(STDERR_FILENO, pos, strlen(pos));
+	if (!cursor->disable) {
+		pv_tty_write(flags, cup_cmd, strlen(cup_cmd));	/* flawfinder: ignore */
+	}
+	/* flawfinder - pv_snprintf() always \0-terminates (see above). */
 
 #ifdef HAVE_IPC
-	pv_crs_ipccount(state);
-	(void) shmdt((void *) state->crs_y_top);
+	/*
+	 * If any other "pv -c" instances have set the terminal TOSTOP
+	 * attribute, set our local flag so pv_sig_fini() will know about
+	 * it.
+	 */
+	if ((!cursor->noipc) && (NULL != cursor->shared) && cursor->shared->tty_tostop_added) {
+		if (0 == flags->clear_tty_tostop_on_exit) {
+			debug("%s",
+			      "propagating shared tty_tostop_added true value to local clear_tty_tostop_on_exit flag");
+			flags->clear_tty_tostop_on_exit = 1;
+		}
+	}
+
+	pv_crs_ipccount(cursor);
+	if (NULL != cursor->shared) {
+		(void) shmdt(cursor->shared);
+	}
+	cursor->shared = NULL;
 
 	/*
 	 * If we are the last instance detaching from the shared memory,
 	 * delete it so it's not left lying around.
 	 */
-	if (state->crs_pvcount < 2)
-		(void) shmctl(state->crs_shmid, IPC_RMID, NULL);
+	if (cursor->pvcount < 2) {
+		struct shmid_ds shm_buf;
+		memset(&shm_buf, 0, sizeof(shm_buf));
+		(void) shmctl(cursor->shmid, IPC_RMID, &shm_buf);
+	}
 
 #endif				/* HAVE_IPC */
 
-	pv_crs_unlock(state, STDERR_FILENO);
+	pv_crs_unlock(cursor, STDERR_FILENO);
 
-	if (state->crs_lock_fd >= 0) {
-		(void) close(state->crs_lock_fd);
+	if (cursor->lock_fd >= 0) {
+		(void) close(cursor->lock_fd);
 		/*
 		 * We can get away with removing this on exit because all
 		 * the other PVs will be finishing at the same sort of time.
 		 */
-		(void) remove(state->crs_lock_file);
+		(void) remove(cursor->lock_file);
 	}
 }
-
-/* EOF */

src/pv/elapsedtime.c

@@ -0,0 +1,250 @@
+/*
+ * Functions relating to elapsed time.
+ *
+ * Copyright 2023-2025 Andrew Wood
+ *
+ * License GPLv3+: GNU GPL version 3 or later; see `docs/COPYING'.
+ */
+
+#include "config.h"
+#include "pv.h"
+#include "pv-internal.h"
+#include <stdio.h>
+#include <string.h>
+#include <errno.h>
+
+
+/*
+ * Read the current elapsed time, relative to an unspecified point in the
+ * past, and store it in the given timespec buffer.  The time is guaranteed
+ * to not go backwards and does not count time when the system was
+ * suspended.  See clock_gettime(2) with CLOCK_MONOTONIC.
+ *
+ * The read should not fail; if it does, the program is aborted with exit
+ * status 16 (transfer error).
+ */
+void pv_elapsedtime_read(struct timespec *return_time)
+{
+	/*@-unrecog@ *//* splint doesn't know clock_gettime */
+	if (0 != clock_gettime(CLOCK_MONOTONIC, return_time)) {
+		fprintf(stderr, "%s: %s: %s\n", PACKAGE_NAME, "clock_gettime", strerror(errno));
+		/*@-exitarg@ *//* we explicitly want a special exit status */
+		exit(PV_ERROREXIT_TRANSFER);
+		/*@+exitarg@ */
+	}
+	/*@+unrecog@ */
+}
+
+
+/*
+ * Set the time in the given timespec to zero.
+ */
+void pv_elapsedtime_zero(struct timespec *zero_time)
+{
+	if (NULL == zero_time)
+		return;
+	zero_time->tv_sec = 0;
+	zero_time->tv_nsec = 0;
+}
+
+
+/*
+ * Copy source_time into dest_time.  Analogous to strcpy(3).
+ */
+void pv_elapsedtime_copy(struct timespec *dest_time, const struct timespec *source_time)
+{
+	if (NULL == dest_time)
+		return;
+	if (NULL == source_time)
+		return;
+	dest_time->tv_sec = source_time->tv_sec;
+	dest_time->tv_nsec = source_time->tv_nsec;
+}
+
+
+/*
+ * Return -1, 0, or 1 depending on whether the first time is earlier than,
+ * equal to, or later than the second time.  Analogous to strcmp(3).
+ */
+int pv_elapsedtime_compare(const struct timespec *first_time, const struct timespec *second_time)
+{
+	/* Treat NULL as a zero time. */
+	if ((NULL == first_time) && (NULL == second_time))
+		return 0;
+	if ((NULL == first_time) && (NULL != second_time))
+		return -1;
+	if ((NULL != first_time) && (NULL == second_time))
+		return 1;
+
+	/* These should never happen, but check just in case. */
+	if (NULL == first_time)
+		return 0;
+	if (NULL == second_time)
+		return 0;
+
+	/* Check the seconds part, first */
+	if (first_time->tv_sec < second_time->tv_sec)
+		return -1;
+	if (first_time->tv_sec > second_time->tv_sec)
+		return 1;
+
+	/* Seconds are equal - compare nanoseconds. */
+	if (first_time->tv_nsec < second_time->tv_nsec)
+		return -1;
+	if (first_time->tv_nsec > second_time->tv_nsec)
+		return 1;
+
+	/* Nanoseconds are also equal - times are equal. */
+	return 0;
+}
+
+
+/*
+ * Add first_time and second_time, writing the result to return_time.
+ */
+void pv_elapsedtime_add(struct timespec *return_time, const struct timespec *first_time,
+			const struct timespec *second_time)
+{
+	long long seconds, nanoseconds;
+
+	if (NULL == return_time)
+		return;
+
+	seconds = 0;
+	nanoseconds = 0;
+
+	if (NULL != first_time) {
+		seconds += first_time->tv_sec;
+		nanoseconds += first_time->tv_nsec;
+	}
+
+	if (NULL != second_time) {
+		seconds += second_time->tv_sec;
+		nanoseconds += second_time->tv_nsec;
+	}
+
+	seconds += nanoseconds / 1000000000;
+	nanoseconds = nanoseconds % 1000000000;
+
+	/*@-type@ */
+	return_time->tv_sec = seconds;
+	return_time->tv_nsec = nanoseconds;
+	/*@+type@ */
+
+	/*
+	 * splint rationale: we know the types are different but should be
+	 * large enough and are relying on the compiler to do the casting
+	 * correctly, since the manual for timespec(3) states the types are
+	 * implementation-defined.
+	 */
+}
+
+
+/*
+ * Add a number of nanoseconds to the given timespec.
+ */
+void pv_elapsedtime_add_nsec(struct timespec *return_time, long long add_nanoseconds)
+{
+	long long seconds, nanoseconds;
+
+	if (NULL == return_time)
+		return;
+
+	seconds = return_time->tv_sec;
+	nanoseconds = return_time->tv_nsec + add_nanoseconds;
+
+	seconds += nanoseconds / 1000000000;
+	nanoseconds = nanoseconds % 1000000000;
+
+	/*@-type@ *//* see above */
+	return_time->tv_sec = seconds;
+	return_time->tv_nsec = nanoseconds;
+	/*@+type@ */
+}
+
+
+/*
+ * Set the return timespec to the first time minus the second time.
+ */
+void pv_elapsedtime_subtract(struct timespec *return_time, const struct timespec *first_time,
+			     const struct timespec *second_time)
+{
+	long long seconds, nanoseconds;
+
+	if (NULL == return_time)
+		return;
+
+	seconds = 0;
+	nanoseconds = 0;
+
+	if (NULL != first_time) {
+		seconds += first_time->tv_sec;
+		nanoseconds += first_time->tv_nsec;
+	}
+
+	if (NULL != second_time) {
+		seconds -= second_time->tv_sec;
+		nanoseconds -= second_time->tv_nsec;
+	}
+
+	seconds += nanoseconds / 1000000000;
+	nanoseconds = nanoseconds % 1000000000;
+
+	if (nanoseconds < 0) {
+		seconds--;
+		nanoseconds = 1000000000 + nanoseconds;
+	}
+
+	/*@-type@ *//* see above */
+	return_time->tv_sec = seconds;
+	return_time->tv_nsec = nanoseconds;
+	/*@+type@ */
+}
+
+
+/*
+ * Convert a timespec to seconds.
+ */
+long double pv_elapsedtime_seconds(const struct timespec *elapsed_time)
+{
+	long double seconds;
+
+	if (NULL == elapsed_time)
+		return 0.0;
+
+	seconds = (long double) elapsed_time->tv_sec;
+	seconds += (long double) (elapsed_time->tv_nsec) / 1000000000.0L;
+
+	return seconds;
+}
+
+
+/*
+ * Sleep for a number of nanoseconds.
+ */
+void pv_nanosleep(long long nanoseconds)
+{
+#if HAVE_NANOSLEEP
+	struct timespec sleep_for, time_remaining;
+
+	memset(&sleep_for, 0, sizeof(sleep_for));
+	memset(&time_remaining, 0, sizeof(time_remaining));
+
+	sleep_for.tv_sec = 0;
+	/*@-type@ */
+	sleep_for.tv_nsec = nanoseconds;
+	/*@+type@ *//* splint rationale - best effort */
+	/*@-unrecog@ */
+	(void) nanosleep(&sleep_for, &time_remaining);
+	/*@+unrecog@ *//* splint rationale - doesn't know of nanosleep() */
+#else
+	struct timeval tv;
+	tv.tv_sec = 0;
+	/*@-type@ */
+	tv.tv_usec = nanoseconds / 1000;
+	/*@+type@ *//* splint rationale - best effort */
+	/*@-null@ */
+	(void) select(0, NULL, NULL, NULL, &tv);
+	/*@+null@ *//* splint doesn't know about select() */
+#endif
+}

src/pv/file.c

@@ -1,9 +1,9 @@
 /*
- * Functions for opening and closing files.
+ * Functions for opening and closing files, and calculating their size.
  *
- * Copyright 2002-2008, 2010, 2012-2015, 2017, 2021, 2023 Andrew Wood
+ * Copyright 2002-2008, 2010, 2012-2015, 2017, 2021, 2023-2025 Andrew Wood
  *
- * Distributed under the Artistic License v2.0; see `doc/COPYING'.
+ * License GPLv3+: GNU GPL version 3 or later; see `docs/COPYING'.
  */
 
 #include "config.h"
@@ -20,79 +20,104 @@
 #include <limits.h>
 
 
+/*@-type@*/
+/* splint has trouble with off_t and mode_t throughout this file. */
+
 /*
- * Try to work out the total size of all data by adding up the sizes of all
- * input files. If any of the input files are of indeterminate size (i.e.
- * they are a pipe), the total size is set to zero.
+ * Calculate the total number of bytes to be transferred by adding up the
+ * sizes of all input files.  If any of the input files are of indeterminate
+ * size (such as if they are a pipe), the total size is set to zero.
  *
  * Any files that cannot be stat()ed or that access() says we can't read
- * will cause a warning to be output and will be removed from the list.
- *
- * In line mode, any files that pass the above checks will then be read to
- * determine how many lines they contain, and the total size will be set to
- * the total line count. Only regular files will be read.
+ * will be skipped, and the total size will be set to zero.
  *
  * Returns the total size, or 0 if it is unknown.
  */
-unsigned long long pv_calc_total_size(pvstate_t state)
+static off_t pv_calc_total_bytes(pvstate_t state)
 {
-	unsigned long long total;
+	off_t total;
 	struct stat sb;
-	int rc, i, j, fd;
+	unsigned int file_idx;
 
 	total = 0;
-	rc = 0;
 	memset(&sb, 0, sizeof(sb));
 
 	/*
 	 * No files specified - check stdin.
 	 */
-	if (state->input_file_count < 1) {
+	if ((state->files.file_count < 1) || (NULL == state->files.filename)) {
 		if (0 == fstat(STDIN_FILENO, &sb))
 			total = sb.st_size;
 		return total;
 	}
 
-	for (i = 0; i < state->input_file_count; i++) {
-		if (0 == strcmp(state->input_files[i], "-")) {
+	for (file_idx = 0; file_idx < state->files.file_count; file_idx++) {
+		int rc;
+
+		/* Skip any NULL entries, though they should be impossible. */
+		if (NULL == state->files.filename[file_idx])
+			continue;
+
+		if (0 == strcmp(state->files.filename[file_idx], "-")) {
 			rc = fstat(STDIN_FILENO, &sb);
 			if (rc != 0) {
 				total = 0;
 				return total;
 			}
 		} else {
-			rc = stat(state->input_files[i], &sb);
-			if (0 == rc)
-				rc = access(state->input_files[i], R_OK);
+			rc = stat(state->files.filename[file_idx], &sb);
+			if (0 == rc) {
+				rc = access(state->files.filename[file_idx], R_OK);	/* flawfinder: ignore */
+				/*
+				 * flawfinder rationale: we're not really
+				 * using access() to do permissions checks,
+				 * but to zero the total if we might be
+				 * unable to read the file later, so if an
+				 * attacker redirected one of the input
+				 * files in between this part and the actual
+				 * reading, the outcome would be that the
+				 * total byte count would be wrong or
+				 * missing, nothing useful.
+				 */
+			}
 		}
 
 		if (rc != 0) {
-			pv_error(state, "%s: %s", state->input_files[i], strerror(errno));
-			for (j = i; j < state->input_file_count - 1; j++) {
-				state->input_files[j] = state->input_files[j + 1];
-			}
-			state->input_file_count--;
-			i--;
-			state->exit_status |= 2;
-			continue;
+			debug("%s: %s", state->files.filename[file_idx], strerror(errno));
+			total = 0;
+			return total;
 		}
 
 		if (S_ISBLK(sb.st_mode)) {
+			int fd;
+
 			/*
 			 * Get the size of block devices by opening
 			 * them and seeking to the end.
 			 */
-			if (0 == strcmp(state->input_files[i], "-")) {
-				fd = open("/dev/stdin", O_RDONLY);
+			if (0 == strcmp(state->files.filename[file_idx], "-")) {
+				fd = open("/dev/stdin", O_RDONLY);	/* flawfinder: ignore */
+				/*
+				 * flawfinder rationale: "/dev/stdin" may be
+				 * a symlink, so can't use O_NOFOLLOW, and
+				 * so we have to assume that it being under
+				 * "/dev" means the path is less likely to
+				 * be under the control of someone else.
+				 */
 			} else {
-				fd = open(state->input_files[i], O_RDONLY);
+				fd = open(state->files.filename[file_idx], O_RDONLY);	/* flawfinder: ignore */
+				/* flawfinder - see last open() below. */
 			}
 			if (fd >= 0) {
-				total += lseek(fd, 0, SEEK_END);
-				close(fd);
+				off_t end_position;
+				end_position = lseek(fd, 0, SEEK_END);
+				if (end_position > 0) {
+					total += end_position;
+				}
+				(void) close(fd);
 			} else {
-				pv_error(state, "%s: %s", state->input_files[i], strerror(errno));
-				state->exit_status |= 2;
+				total = 0;
+				return total;
 			}
 		} else if (S_ISREG(sb.st_mode)) {
 			total += sb.st_size;
@@ -106,18 +131,27 @@ unsigned long long pv_calc_total_size(pvstate_t state)
 	 * input, but we are writing to a block device, then use the size of
 	 * the output block device.
 	 *
-	 * Further modified to check that stdout is not in append-only mode
+	 * Further modified to check that output is not in append-only mode
 	 * and that we can seek back to the start after getting the size.
 	 */
-	if (total <= 0) {
-		rc = fstat(STDOUT_FILENO, &sb);
+	if (total < 1) {
+		int rc;
+
+		rc = fstat(state->control.output_fd, &sb);
+
 		if ((0 == rc) && S_ISBLK(sb.st_mode)
-		    && (0 == (fcntl(STDOUT_FILENO, F_GETFL) & O_APPEND))) {
-			total = lseek(STDOUT_FILENO, 0, SEEK_END);
-			if (lseek(STDOUT_FILENO, 0, SEEK_SET) != 0) {
-				pv_error(state, "%s: %s: %s", "(stdout)",
+		    && (0 == (fcntl(state->control.output_fd, F_GETFL) & O_APPEND))) {
+			off_t end_position;
+			end_position = lseek(state->control.output_fd, 0, SEEK_END);
+			total = 0;
+			if (end_position > 0) {
+				total = end_position;
+			}
+			if (lseek(state->control.output_fd, 0, SEEK_SET) != 0) {
+				pv_error("%s: %s: %s",
+					 NULL == state->control.output_name ? "(null)" : state->control.output_name,
 					 _("failed to seek to start of output"), strerror(errno));
-				state->exit_status |= 2;
+				state->status.exit_status |= PV_ERROREXIT_ACCESS;
 			}
 			/*
 			 * If we worked out a size, then set the
@@ -126,167 +160,390 @@ unsigned long long pv_calc_total_size(pvstate_t state)
 			 * device.
 			 */
 			if (total > 0) {
-				state->stop_at_size = 1;
+				state->control.stop_at_size = true;
 			}
 		}
 	}
 
-	if (!state->linemode)
-		return total;
-
-	/*
-	 * In line mode, we count input lines to work out the total size.
-	 */
-	total = 0;
-
-	for (i = 0; i < state->input_file_count; i++) {
-		fd = -1;
-
-		if (0 == strcmp(state->input_files[i], "-")) {
-			rc = fstat(STDIN_FILENO, &sb);
-			if ((rc != 0) || (!S_ISREG(sb.st_mode))) {
-				total = 0;
-				return total;
-			}
-			fd = dup(STDIN_FILENO);
-		} else {
-			rc = stat(state->input_files[i], &sb);
-			if ((rc != 0) || (!S_ISREG(sb.st_mode))) {
-				total = 0;
-				return total;
-			}
-			fd = open(state->input_files[i], O_RDONLY);
-		}
-
-		if (fd < 0) {
-			pv_error(state, "%s: %s", state->input_files[i], strerror(errno));
-			total = 0;
-			state->exit_status |= 2;
-			return total;
-		}
-
-		while (1) {
-			unsigned char scanbuf[1024];
-			int numread, j;
-
-			numread = read(fd, scanbuf, sizeof(scanbuf));
-			if (numread < 0) {
-				pv_error(state, "%s: %s", state->input_files[i], strerror(errno));
-				state->exit_status |= 2;
-				break;
-			} else if (0 == numread) {
-				break;
-			}
-			for (j = 0; j < numread; j++) {
-				if ('\n' == scanbuf[j])
-					total++;
-			}
-		}
-
-		lseek(fd, 0, SEEK_SET);
-		close(fd);
-	}
-
 	return total;
 }
 
 
+/*
+ * Count the total number of lines to be transferred by reading through all
+ * input files.  If any of the inputs are not regular files (such as if they
+ * are a pipe or a block device), the total size is set to zero.
+ *
+ * Any files that cannot be stat()ed or that access() says we can't read
+ * will be skipped, and the total size will be set to zero.
+ *
+ * Returns the total size, or 0 if it is unknown.
+ */
+static off_t pv_calc_total_lines(pvstate_t state)
+{
+	off_t total;
+	struct stat sb;
+	unsigned int file_idx;
+
+	total = 0;
+
+	for (file_idx = 0; file_idx < state->files.file_count && NULL != state->files.filename; file_idx++) {
+		int fd = -1;
+		int rc = 0;
+
+		/* Skip any NULL entries, though they should be impossible. */
+		if (NULL == state->files.filename[file_idx])
+			continue;
+
+		if (0 == strcmp(state->files.filename[file_idx], "-")) {
+			rc = fstat(STDIN_FILENO, &sb);
+			if ((rc != 0) || (!S_ISREG(sb.st_mode))) {
+				total = 0;
+				return total;
+			}
+			fd = dup(STDIN_FILENO);
+		} else {
+			rc = stat(state->files.filename[file_idx], &sb);
+			if ((rc != 0) || (!S_ISREG(sb.st_mode))) {
+				total = 0;
+				return total;
+			}
+			fd = open(state->files.filename[file_idx], O_RDONLY);	/* flawfinder: ignore */
+			/* flawfinder - see last open() below. */
+		}
+
+		if (fd < 0) {
+			debug("%s: %s", state->files.filename[file_idx], strerror(errno));
+			total = 0;
+			return total;
+		}
+#if HAVE_POSIX_FADVISE
+		/* Advise the OS that we will only be reading sequentially. */
+		(void) posix_fadvise(fd, 0, 0, POSIX_FADV_SEQUENTIAL);
+#endif
+
+		while (true) {
+			char scanbuf[1024];	/* flawfinder: ignore */
+			ssize_t numread, buf_idx;
+
+			/* flawfinder - always bounded, below. */
+
+			numread = read(fd, scanbuf, sizeof(scanbuf));	/* flawfinder: ignore */
+			/*
+			 * flawfinder rationale: each time around the loop
+			 * we are always reading into the start of the
+			 * buffer, not moving along it, so the bounding is
+			 * OK.
+			 */
+			if (numread < 0) {
+				pv_error("%s: %s", state->files.filename[file_idx], strerror(errno));
+				state->status.exit_status |= PV_ERROREXIT_ACCESS;
+				break;
+			} else if (0 == numread) {
+				break;
+			}
+			for (buf_idx = 0; buf_idx < numread; buf_idx++) {
+				if (state->control.null_terminated_lines) {
+					if ('\0' == scanbuf[buf_idx])
+						total++;
+				} else {
+					if ('\n' == scanbuf[buf_idx])
+						total++;
+				}
+			}
+		}
+
+		if (0 != lseek(fd, 0, SEEK_SET)) {
+			pv_error("%s: %s", state->files.filename[file_idx], strerror(errno));
+			state->status.exit_status |= PV_ERROREXIT_ACCESS;
+		}
+
+		(void) close(fd);
+	}
+
+	return total;
+}
+
+
+/*
+ * Work out the total size of all data by adding up the sizes of all input
+ * files, using either pv_calc_total_bytes() or pv_calc_total_lines()
+ * depending on whether state->control.linemode is true.
+ *
+ * Returns the total size, or 0 if it is unknown.
+ */
+off_t pv_calc_total_size(pvstate_t state)
+{
+	if (state->control.linemode) {
+		return pv_calc_total_lines(state);
+	} else {
+		return pv_calc_total_bytes(state);
+	}
+}
+
+
 /*
  * Close the given file descriptor and open the next one, whose number in
  * the list is "filenum", returning the new file descriptor (or negative on
  * error). It is an error if the next input file is the same as the file
- * stdout is pointing to.
+ * the output is pointing to.
  *
- * Updates state->current_file in the process.
+ * Updates state->status.current_input_file in the process.
  */
-int pv_next_file(pvstate_t state, int filenum, int oldfd)
+int pv_next_file(pvstate_t state, unsigned int filenum, int oldfd)
 {
 	struct stat isb;
 	struct stat osb;
-	int fd, input_file_is_stdout;
+	int fd;
+	bool input_file_is_output;
+	char *next_filename;
 
-	if (oldfd > 0) {
-		if (close(oldfd)) {
-			pv_error(state, "%s: %s", _("failed to close file"), strerror(errno));
-			state->exit_status |= 8;
+	if (oldfd >= 0) {
+		if (0 != close(oldfd)) {
+			pv_error("%s: %s", _("failed to close file"), strerror(errno));
+			state->status.exit_status |= PV_ERROREXIT_TRANSITION;
 			return -1;
 		}
 	}
 
-	if (filenum >= state->input_file_count) {
-		state->exit_status |= 8;
+	if (filenum >= state->files.file_count) {
+		debug("%s: %d >= %d", "filenum too large", filenum, state->files.file_count);
+		state->status.exit_status |= PV_ERROREXIT_TRANSITION;
 		return -1;
 	}
 
-	if (filenum < 0) {
-		state->exit_status |= 8;
-		return -1;
+	next_filename = NULL;
+	if (NULL != state->files.filename) {
+		next_filename = state->files.filename[filenum];
+		if (NULL == next_filename) {
+			debug("%s: @%d, max %d", "unexpected null filename", filenum, state->files.file_count);
+			state->status.exit_status |= PV_ERROREXIT_TRANSITION;
+			return -1;
+		}
 	}
 
-	if (0 == strcmp(state->input_files[filenum], "-")) {
+	if ((NULL == next_filename) || (0 == strcmp(next_filename, "-"))) {
 		fd = STDIN_FILENO;
 	} else {
-		fd = open(state->input_files[filenum], O_RDONLY);
+		fd = open(next_filename, O_RDONLY);	/* flawfinder: ignore */
+		/*
+		 * flawfinder rationale: the input file list is under the
+		 * control of the operator by its nature, so we can't refuse
+		 * to open symlinks etc as that would be counterintuitive.
+		 */
 		if (fd < 0) {
-			pv_error(state, "%s: %s: %s",
-				 _("failed to read file"), state->input_files[filenum], strerror(errno));
-			state->exit_status |= 2;
+			pv_error("%s: %s: %s", _("failed to read file"), next_filename, strerror(errno));
+			state->status.exit_status |= PV_ERROREXIT_ACCESS;
 			return -1;
 		}
 	}
 
-	if (fstat(fd, &isb)) {
-		pv_error(state, "%s: %s: %s", _("failed to stat file"), state->input_files[filenum], strerror(errno));
-		close(fd);
-		state->exit_status |= 2;
+	if (0 != fstat(fd, &isb)) {
+		pv_error("%s: %s: %s", _("failed to stat file"),
+			 NULL == next_filename ? "-" : next_filename, strerror(errno));
+		(void) close(fd);
+		state->status.exit_status |= PV_ERROREXIT_ACCESS;
 		return -1;
 	}
 
-	if (fstat(STDOUT_FILENO, &osb)) {
-		pv_error(state, "%s: %s", _("failed to stat output file"), strerror(errno));
-		close(fd);
-		state->exit_status |= 2;
+	if (0 != fstat(state->control.output_fd, &osb)) {
+		pv_error("%s: %s", _("failed to stat output file"), strerror(errno));
+		(void) close(fd);
+		state->status.exit_status |= PV_ERROREXIT_ACCESS;
 		return -1;
 	}
 
 	/*
-	 * Check that this new input file is not the same as stdout's
+	 * Check that this new input file is not the same as output's
 	 * destination. This restriction is ignored for anything other
 	 * than a regular file or block device.
 	 */
-	input_file_is_stdout = 1;
+	input_file_is_output = true;
 	if (isb.st_dev != osb.st_dev)
-		input_file_is_stdout = 0;
+		input_file_is_output = false;
 	if (isb.st_ino != osb.st_ino)
-		input_file_is_stdout = 0;
-	if (isatty(fd))
-		input_file_is_stdout = 0;
+		input_file_is_output = false;
+	if (0 != isatty(fd))
+		input_file_is_output = false;
 	if ((!S_ISREG(isb.st_mode)) && (!S_ISBLK(isb.st_mode)))
-		input_file_is_stdout = 0;
+		input_file_is_output = false;
 
-	if (input_file_is_stdout) {
-		pv_error(state, "%s: %s", _("input file is output file"), state->input_files[filenum]);
-		close(fd);
-		state->exit_status |= 4;
+	if (input_file_is_output) {
+		pv_error("%s: %s", _("input file is output file"), NULL == next_filename ? "-" : next_filename);
+		(void) close(fd);
+		state->status.exit_status |= PV_ERROREXIT_OUROBOROS;
 		return -1;
 	}
 
-	state->current_file = state->input_files[filenum];
-	if (0 == strcmp(state->input_files[filenum], "-")) {
-		state->current_file = "(stdin)";
-	}
+	state->status.current_input_file = filenum;
 #ifdef O_DIRECT
 	/*
 	 * Set or clear O_DIRECT on the file descriptor.
 	 */
-	fcntl(fd, F_SETFL, (state->direct_io ? O_DIRECT : 0) | fcntl(fd, F_GETFL));
+	if (0 != fcntl(fd, F_SETFL, (state->control.direct_io ? O_DIRECT : 0) | fcntl(fd, F_GETFL))) {
+		/*@-compdef@ */
+		/*
+		 * splint - passed or returned storage is undefined - but at
+		 * this point we know the input file list is been populated,
+		 * so that's OK.
+		 */
+		debug("%s: %s: %s", pv_current_file_name(state), "fcntl", strerror(errno));
+		/*@+compdef@ */
+	}
 	/*
 	 * We don't clear direct_io_changed here, to avoid race conditions
 	 * that could cause the input and output settings to differ.
 	 */
 #endif				/* O_DIRECT */
 
+	debug("%s: %d: %s: fd=%d", "next file opened", filenum, pv_current_file_name(state), fd);
+
 	return fd;
 }
 
-/* EOF */
+
+/*
+ * Return the name of the current file.  The returned buffer may point to
+ * internal state and must not be passed to free() or used after "state" is
+ * freed.
+ */
+/*@keep@*/ const char *pv_current_file_name(pvstate_t state)
+{
+	static char *str_none = NULL;
+	static char *str_stdin = NULL;
+	const char *input_file_name = NULL;
+
+	/*@-observertrans@ */
+	/*@-onlytrans@ */
+	/*@-statictrans@ */
+	/*
+	 * Here we are doing bad things with regards to whether the returned
+	 * string is an allocated string from the state->files.filename array,
+	 * a constant string, or a returned string from gettext(), but it
+	 * has no impact.  We explicitly document, above, that the returned
+	 * string expires with the state, and hence switch off the
+	 * associated splint warnings.
+	 */
+
+	if (NULL == str_none)
+		str_none = _("(none)");
+	if (NULL == str_stdin)
+		str_stdin = _("(stdin)");
+
+	/* Fallback in case of translation failure. */
+	if (NULL == str_none)
+		str_none = "(none)";
+	if (NULL == str_stdin)
+		str_stdin = "(stdin)";
+
+	if (state->status.current_input_file < 0)
+		return str_none;
+	if ((unsigned int) (state->status.current_input_file) >= state->files.file_count)
+		return str_none;
+
+	if (NULL == state->files.filename) {
+		input_file_name = NULL;
+	} else {
+		input_file_name = state->files.filename[state->status.current_input_file];
+	}
+	if (NULL == input_file_name)
+		return str_none;
+	if (0 == strcmp(input_file_name, "-"))
+		return str_stdin;
+
+	/*@-compdef@ */
+	return input_file_name;
+	/*@+compdef@ */
+	/*
+	 * splint warns about state->files.filename being undefined, but we
+	 * know it's been populated fully by the time this function is
+	 * called.
+	 */
+
+	/*@+statictrans@ */
+	/*@+onlytrans@ */
+	/*@+observertrans@ */
+}
+
+
+/*
+ * Return a stream pointer, and populate the filename buffer, for a control
+ * file associated with a particular process ID, for the given signal
+ * number; it will be opened for writing if "sender" is true.  Returns NULL
+ * on error.
+ */
+/*@null@ */
+/*@dependent@ */
+FILE *pv_open_controlfile(char *filename, size_t bufsize, pid_t control_pid, int signum, bool sender)
+{
+	int open_flags, open_mode, control_fd;
+	/*@dependent@ */ FILE *control_fptr = NULL;
+
+	open_flags = O_RDONLY;
+#ifdef O_NOFOLLOW
+	open_flags += O_NOFOLLOW;
+#endif
+	if (sender)
+		open_flags = O_WRONLY | O_CREAT | O_EXCL;
+
+	open_mode = 0644;
+
+	(void) pv_snprintf(filename, bufsize, "/run/user/%lu/pv.remote.%d.%lu", (unsigned long) geteuid(), signum,
+			   (unsigned long) control_pid);
+	control_fd = open(filename, open_flags, open_mode);	/* flawfinder: ignore */
+
+	/*
+	 * If /run/user/<uid> wasn't usable, try $HOME/.pv instead.
+	 */
+	if (control_fd < 0) {
+		char *home_dir;
+
+		home_dir = getenv("HOME");  /* flawfinder: ignore */
+		if (NULL == home_dir)
+			return NULL;
+		if ('\0' == home_dir[0])
+			return NULL;
+
+		/*
+		 * flawfinder rationale: null and zero-size values are
+		 * rejected, and the destination buffer is bounded.
+		 */
+
+		(void) pv_snprintf(filename, bufsize, "%s/.pv/remote.%d.%lu", home_dir, signum,
+				   (unsigned long) control_pid);
+		control_fd = open(filename, open_flags, open_mode);	/* flawfinder: ignore */
+
+		/*
+		 * If the open failed, try creating the $HOME/.pv directory
+		 * first.
+		 */
+		if (control_fd < 0) {
+			(void) pv_snprintf(filename, bufsize, "%s/.pv", home_dir);
+			(void) mkdir(filename, 0700);
+			/* In case of weird umask, explicitly chmod the dir. */
+			(void) chmod(filename, 0700);	/* flawfinder: ignore */
+			(void) pv_snprintf(filename, bufsize, "%s/.pv/remote.%d.%lu", home_dir, signum,
+					   (unsigned long) control_pid);
+			control_fd = open(filename, open_flags, open_mode);	/* flawfinder: ignore */
+		}
+	}
+
+	/*
+	 * flawfinder rationale: the files are in a directory whose parents
+	 * cannot be manipulated, and we are not allowing the final
+	 * component to be a symbolic link.  We are checking that $HOME is
+	 * not NULL, and it's bounded by pv_snprintf() so it can't overshoot
+	 * the filename buffer.  When we chmod $HOME/.pv, we assume that an
+	 * attacker is unlikely to be able to manipulate $HOME's contents to
+	 * make use of us setting $HOME/.pv to mode 700.
+	 */
+
+	if (control_fd < 0)
+		return NULL;
+
+	debug("%s: %s", "control filename", filename);
+
+	control_fptr = fdopen(control_fd, sender ? "wb" : "rb");
+
+	return control_fptr;
+}

src/pv/format/averagerate.c

@@ -0,0 +1,44 @@
+/*
+ * Formatter function for average rate.
+ *
+ * Copyright 2024-2025 Andrew Wood
+ *
+ * License GPLv3+: GNU GPL version 3 or later; see `docs/COPYING'.
+ */
+
+#include "config.h"
+#include "pv.h"
+#include "pv-internal.h"
+
+
+/*
+ * Average transfer rate.
+ */
+pvdisplay_bytecount_t pv_formatter_average_rate(pvformatter_args_t args)
+{
+	char content[128];		 /* flawfinder: ignore - always bounded */
+
+	content[0] = '\0';
+
+	if (0 == args->buffer_size)
+		return 0;
+
+	/*@-mustfreefresh@ */
+	if (args->control->numeric) {
+		/* numeric - raw value without suffix. */
+		(void) pv_snprintf(content, sizeof(content),
+				   "%.4Lf", ((args->control->bits ? 8.0 : 1.0) * args->calc->average_rate));
+	} else if (args->control->bits && !args->control->linemode) {
+		/* bits per second */
+		pv_describe_amount(content, sizeof(content),
+				   "(%s)", 8 * args->calc->average_rate, "", _("b/s"), args->display->count_type);
+	} else {
+		/* bytes or lines per second */
+		pv_describe_amount(content,
+				   sizeof(content), "(%s)", args->calc->average_rate, _("/s"), _("B/s"),
+				   args->display->count_type);
+	}
+	/*@+mustfreefresh@ *//* splint: see above. */
+
+	return pv_formatter_segmentcontent(content, args);
+}

src/pv/format/barstyle.c

@@ -0,0 +1,204 @@
+/*
+ * Formatter functions for styled progress bars.
+ *
+ * Copyright 2024-2025 Andrew Wood
+ *
+ * License GPLv3+: GNU GPL version 3 or later; see `docs/COPYING'.
+ */
+
+#include "config.h"
+#include "pv.h"
+#include "pv-internal.h"
+
+#include <string.h>
+#if defined(ENABLE_NLS) && defined(HAVE_WCHAR_H)
+#include <wchar.h>
+#if defined(HAVE_WCTYPE_H)
+#include <wctype.h>
+#endif
+#endif
+
+
+/*
+ * Populate "style" with the named bar style, falling back to plain if the
+ * name was not recognised.  Returns true if the named style was found.
+ *
+ * Note that strings are copied into the structure, rather than just
+ * updating pointers, to maintain separation of concern between different
+ * parts of the code - and because on 64-bit architectures, the sizes of the
+ * data types and their associated alignment padding tend to outweigh the
+ * memory savings from using pointers and shared strings.
+ */
+static bool pv_barstyle(pvformatter_args_t args, pvbarstyle_t style, const char *name)
+{
+#define populate_string(item, str, w) { \
+  item.width = w; \
+  item.bytes = strlen(str); /* flawfinder: ignore */ \
+  if (item.bytes > 0 && item.bytes <= PV_BARSTYLE_SIZEOF_STRING) \
+	  memcpy(item.string, str, item.bytes); /* flawfinder: ignore */ \
+}
+	/*
+	 * flawfinder - strlen() on null-terminated static strings is OK,
+	 * and with the memcpy(), we check the buffer is big enough.
+	 */
+
+	memset(style, 0, sizeof(*style));
+
+	if (args->status->terminal_supports_utf8 && 0 == strcmp(name, "block")) {
+
+		style->style_id = 2;
+
+		populate_string(style->indicator, "◀▶", 2);
+		populate_string(style->tip, "", 0);
+
+		populate_string(style->filler[0], " ", 1);
+		populate_string(style->filler[1], "█", 1);
+
+		style->filler_entries = 2;
+
+		return true;
+
+	} else if (args->status->terminal_supports_utf8 && 0 == strcmp(name, "granular")) {
+
+		style->style_id = 3;
+
+		populate_string(style->indicator, "◀▶", 2);
+		populate_string(style->tip, "", 0);
+
+		populate_string(style->filler[0], " ", 1);
+		populate_string(style->filler[1], "▏", 1);
+		populate_string(style->filler[2], "▎", 1);
+		populate_string(style->filler[3], "▍", 1);
+		populate_string(style->filler[4], "▌", 1);
+		populate_string(style->filler[5], "▋", 1);
+		populate_string(style->filler[6], "▊", 1);
+		populate_string(style->filler[7], "▉", 1);
+		populate_string(style->filler[8], "█", 1);
+
+		style->filler_entries = 9;
+
+		return true;
+
+	} else if (args->status->terminal_supports_utf8 && 0 == strcmp(name, "shaded")) {
+
+		style->style_id = 4;
+
+		populate_string(style->indicator, "▒▓▒", 3);
+		populate_string(style->tip, "", 0);
+
+		populate_string(style->filler[0], "░", 1);
+		populate_string(style->filler[1], "▒", 1);
+		populate_string(style->filler[2], "▓", 1);
+		populate_string(style->filler[3], "█", 1);
+
+		style->filler_entries = 4;
+
+		return true;
+	}
+
+	/* Default plain style. */
+
+	style->style_id = 1;
+
+	populate_string(style->indicator, "<=>", 3);
+	populate_string(style->tip, ">", 1);
+
+	populate_string(style->filler[0], " ", 1);
+	populate_string(style->filler[1], "=", 1);
+
+	style->filler_entries = 2;
+
+	if (0 == strcmp(name, "plain"))
+		return true;
+
+	return false;
+}
+
+
+/*
+ * Return the index into args->display->barstyle for the style with the
+ * given name, adding that style to the array if it's not there already and
+ * there's room.
+ *
+ * If there is no room, returns zero, so the first style is re-used.
+ */
+int8_t pv_display_barstyle_index(pvformatter_args_t args, const char *name)
+{
+	struct pvbarstyle_s style;
+	int8_t barstyle_index;
+#ifdef ENABLE_DEBUGGING
+	bool found;
+#endif
+
+	memset(&style, 0, sizeof(style));
+#ifdef ENABLE_DEBUGGING
+	found = pv_barstyle(args, &style, name);
+	if (!found)
+		debug("%s: %s", name, "bar style not found, using plain");
+#else
+	(void) pv_barstyle(args, &style, name);
+#endif
+
+	for (barstyle_index = 0;
+	     barstyle_index < PV_BARSTYLE_MAX && args->display->barstyle[barstyle_index].style_id > 0;
+	     barstyle_index++) {
+		if (args->display->barstyle[barstyle_index].style_id == style.style_id) {
+			debug("%s: %s: %d", name, "found in bar style array", barstyle_index);
+			return barstyle_index;
+		}
+	}
+
+	if (barstyle_index >= PV_BARSTYLE_MAX) {
+		debug("%s: %s", name, "no room to add another bar style - returning 0");
+		return 0;
+	}
+
+	memcpy(&(args->display->barstyle[barstyle_index]), &style, sizeof(style));	/* flawfinder: ignore */
+	/* flawfinder - the destination is an array element of the right size. */
+	debug("%s: %s: %d", name, "added to bar style array", barstyle_index);
+	return barstyle_index;
+}
+
+
+pvdisplay_bytecount_t pv_formatter_bar_default(pvformatter_args_t args)
+{
+	if (0 == args->segment->parameter) {
+		const char *default_name;
+		default_name = args->control->default_bar_style;
+		/*@-branchstate@ */
+		if (NULL == default_name)
+			default_name = "plain";
+		/*@+branchstate@ */
+		/* splint - it doesn't matter that default_name may be static */
+		args->segment->parameter = 1 + pv_display_barstyle_index(args, default_name);
+	}
+	return pv_formatter_progress_bar_only(args);
+}
+
+pvdisplay_bytecount_t pv_formatter_bar_plain(pvformatter_args_t args)
+{
+	if (0 == args->segment->parameter)
+		args->segment->parameter = 1 + pv_display_barstyle_index(args, "plain");
+	return pv_formatter_progress_bar_only(args);
+}
+
+pvdisplay_bytecount_t pv_formatter_bar_block(pvformatter_args_t args)
+{
+	if (0 == args->segment->parameter)
+		args->segment->parameter = 1 + pv_display_barstyle_index(args, "block");
+	return pv_formatter_progress_bar_only(args);
+}
+
+pvdisplay_bytecount_t pv_formatter_bar_granular(pvformatter_args_t args)
+{
+	if (0 == args->segment->parameter)
+		args->segment->parameter = 1 + pv_display_barstyle_index(args, "granular");
+	return pv_formatter_progress_bar_only(args);
+}
+
+pvdisplay_bytecount_t pv_formatter_bar_shaded(pvformatter_args_t args)
+{
+	if (0 == args->segment->parameter)
+		args->segment->parameter = 1 + pv_display_barstyle_index(args, "shaded");
+	return pv_formatter_progress_bar_only(args);
+}

src/pv/format/bufferpercent.c

@@ -0,0 +1,39 @@
+/*
+ * Formatter function for transfer buffer percentage utilisation.
+ *
+ * Copyright 2024-2025 Andrew Wood
+ *
+ * License GPLv3+: GNU GPL version 3 or later; see `docs/COPYING'.
+ */
+
+#include "config.h"
+#include "pv.h"
+#include "pv-internal.h"
+
+
+/*
+ * Percentage transfer buffer utilisation.
+ */
+pvdisplay_bytecount_t pv_formatter_buffer_percent(pvformatter_args_t args)
+{
+	char content[16];		 /* flawfinder: ignore - always bounded */
+
+	content[0] = '\0';
+
+	if (0 == args->buffer_size)
+		return 0;
+
+	if (args->transfer->buffer_size > 0) {
+		double pct_used = pv_percentage((off_t)
+						(args->transfer->read_position - args->transfer->write_position),
+						(off_t)
+						(args->transfer->buffer_size));
+		(void) pv_snprintf(content, sizeof(content), "{%3.0f%%}", pct_used);
+	}
+#ifdef HAVE_SPLICE
+	if (args->transfer->splice_used)
+		(void) pv_snprintf(content, sizeof(content), "{%s}", "----");
+#endif
+
+	return pv_formatter_segmentcontent(content, args);
+}

src/pv/format/bytes.c

@@ -0,0 +1,44 @@
+/*
+ * Formatter function for bytes or lines transferred.
+ *
+ * Copyright 2024-2025 Andrew Wood
+ *
+ * License GPLv3+: GNU GPL version 3 or later; see `docs/COPYING'.
+ */
+
+#include "config.h"
+#include "pv.h"
+#include "pv-internal.h"
+
+
+/*
+ * Number of bytes or lines transferred.
+ */
+pvdisplay_bytecount_t pv_formatter_bytes(pvformatter_args_t args)
+{
+	char content[128];		 /* flawfinder: ignore - always bounded */
+
+	args->display->showing_bytes = true;
+
+	if (0 == args->buffer_size)
+		return 0;
+
+	content[0] = '\0';
+
+	/*@-mustfreefresh@ */
+	if (args->control->numeric) {
+		/* Numeric mode - raw values only, no suffix. */
+		(void) pv_snprintf(content, sizeof(content),
+				   "%lld", (long long) ((args->control->bits ? 8 : 1) * args->transfer->transferred));
+	} else if (args->control->bits && !args->control->linemode) {
+		pv_describe_amount(content, sizeof(content), "%s",
+				   (long double) (args->transfer->transferred * 8), "", _("b"),
+				   args->display->count_type);
+	} else {
+		pv_describe_amount(content, sizeof(content), "%s",
+				   (long double) (args->transfer->transferred), "", _("B"), args->display->count_type);
+	}
+	/*@+mustfreefresh@ *//* splint - false positive from gettext(). */
+
+	return pv_formatter_segmentcontent(content, args);
+}

src/pv/format/eta.c

@@ -0,0 +1,72 @@
+/*
+ * Formatter function for ETA display.
+ *
+ * Copyright 2024-2025 Andrew Wood
+ *
+ * License GPLv3+: GNU GPL version 3 or later; see `docs/COPYING'.
+ */
+
+#include "config.h"
+#include "pv.h"
+#include "pv-internal.h"
+
+
+/*
+ * Estimated time until completion.
+ */
+pvdisplay_bytecount_t pv_formatter_eta(pvformatter_args_t args)
+{
+	char content[128];		 /* flawfinder: ignore - always bounded */
+	long eta;
+
+	content[0] = '\0';
+
+	/*
+	 * Don't try to calculate this if the size is not known.
+	 */
+	if (args->control->size < 1)
+		return 0;
+
+	if (0 == args->buffer_size)
+		return 0;
+
+	eta =
+	    pv_seconds_remaining((args->transfer->transferred - args->display->initial_offset),
+				 args->control->size - args->display->initial_offset, args->calc->current_avg_rate);
+
+	/*
+	 * Bounds check, so we don't overrun the suffix buffer.  This means
+	 * the ETA will always be less than 100,000 hours.
+	 */
+	eta = pv_bound_long(eta, 0, (long) 360000000L);
+
+	/*
+	 * If the ETA is more than a day, include a day count as well as
+	 * hours, minutes, and seconds.
+	 */
+	/*@-mustfreefresh@ */
+	if (eta > 86400L) {
+		(void) pv_snprintf(content,
+				   sizeof(content),
+				   "%.16s %ld:%02ld:%02ld:%02ld",
+				   _("ETA"), eta / 86400, (eta / 3600) % 24, (eta / 60) % 60, eta % 60);
+	} else {
+		(void) pv_snprintf(content,
+				   sizeof(content),
+				   "%.16s %ld:%02ld:%02ld", _("ETA"), eta / 3600, (eta / 60) % 60, eta % 60);
+	}
+	/*@+mustfreefresh@ *//* splint: see above. */
+
+	/*
+	 * If this is the final update, show a blank space where the ETA
+	 * used to be.
+	 */
+	if (args->display->final_update) {
+		size_t erase_idx;
+		for (erase_idx = 0; erase_idx < sizeof(content) && content[erase_idx] != '\0'; erase_idx++) {
+			content[erase_idx] = ' ';
+		}
+	}
+
+	return pv_formatter_segmentcontent(content, args);
+}

src/pv/format/fineta.c

@@ -0,0 +1,95 @@
+/*
+ * Formatter function for the local time at which the transfer is expected
+ * to complete.
+ *
+ * Copyright 2024-2025 Andrew Wood
+ *
+ * License GPLv3+: GNU GPL version 3 or later; see `docs/COPYING'.
+ */
+
+#include "config.h"
+#include "pv.h"
+#include "pv-internal.h"
+
+#include <string.h>
+#include <time.h>
+
+
+/*
+ * Estimated local time of completion.
+ */
+pvdisplay_bytecount_t pv_formatter_fineta(pvformatter_args_t args)
+{
+	char content[128];		 /* flawfinder: ignore - always bounded */
+	time_t now, then;
+	struct tm *time_ptr;
+	long eta;
+	const char *time_format;
+	bool show_fineta;
+
+	content[0] = '\0';
+
+	/*
+	 * Don't try to calculate this if the size is not known.
+	 */
+	if (args->control->size < 1)
+		return 0;
+
+	if (0 == args->buffer_size)
+		return 0;
+
+	now = time(NULL);
+	show_fineta = true;
+	time_format = NULL;
+
+	/*
+	 * The completion clock time may be hidden by a failed localtime
+	 * lookup.
+	 */
+
+	eta = pv_seconds_remaining(args->transfer->transferred - args->display->initial_offset,
+				   args->control->size - args->display->initial_offset, args->calc->current_avg_rate);
+
+	/* Bounds check - see pv_formatter_eta(). */
+	eta = pv_bound_long(eta, 0, (long) 360000000L);
+
+	/*
+	 * Only include the date if the ETA is more than 6 hours
+	 * away.
+	 */
+	if (eta > (long) (6 * 3600)) {
+		time_format = "%Y-%m-%d %H:%M:%S";
+	} else {
+		time_format = "%H:%M:%S";
+	}
+
+	then = now + eta;
+	time_ptr = localtime(&then);
+
+	if (NULL == time_ptr) {
+		show_fineta = false;
+	} else {
+		/*
+		 * The localtime() function keeps data stored in a static
+		 * buffer that gets overwritten by time functions.
+		 */
+		struct tm time = *time_ptr;
+		size_t content_bytes;
+
+		/*@-mustfreefresh@ */
+		(void) pv_snprintf(content, sizeof(content), "%.16s ", _("FIN"));
+		/*@+mustfreefresh@ *//* splint: see above. */
+		content_bytes = strlen(content);	/* flawfinder: ignore */
+		/* flawfinder: always bounded with \0 by pv_snprintf(). */
+		(void) strftime(content + content_bytes, sizeof(content) - 1 - content_bytes, time_format, &time);
+	}
+
+	if (!show_fineta) {
+		size_t erase_idx;
+		for (erase_idx = 0; erase_idx < sizeof(content) && content[erase_idx] != '\0'; erase_idx++) {
+			content[erase_idx] = ' ';
+		}
+	}
+
+	return pv_formatter_segmentcontent(content, args);
+}

src/pv/format/lastwritten.c

@@ -0,0 +1,54 @@
+/*
+ * Formatter function for showing the last bytes written.
+ *
+ * Copyright 2024-2025 Andrew Wood
+ *
+ * License GPLv3+: GNU GPL version 3 or later; see `docs/COPYING'.
+ */
+
+#include "config.h"
+#include "pv.h"
+#include "pv-internal.h"
+
+
+/*
+ * Display the last few bytes written.
+ *
+ * As a side effect, this sets args->display->lastwritten_bytes to
+ * the segment's chosen_size, if it was previously smaller than that.
+ */
+pvdisplay_bytecount_t pv_formatter_last_written(pvformatter_args_t args)
+{
+	pvdisplay_bytecount_t bytes_to_show, read_offset, write_offset, remaining;
+
+	args->display->showing_last_written = true;
+
+	bytes_to_show = args->segment->chosen_size;
+	if (0 == bytes_to_show)
+		bytes_to_show = args->segment->width;
+	if (0 == bytes_to_show)
+		return 0;
+
+	if (bytes_to_show > PV_SIZEOF_LASTWRITTEN_BUFFER)
+		bytes_to_show = PV_SIZEOF_LASTWRITTEN_BUFFER;
+	if (bytes_to_show > args->display->lastwritten_bytes)
+		args->display->lastwritten_bytes = bytes_to_show;
+
+	if (0 == args->buffer_size)
+		return 0;
+
+	if (args->offset + bytes_to_show >= args->buffer_size)
+		return 0;
+
+	args->segment->offset = args->offset;
+	args->segment->bytes = bytes_to_show;
+
+	read_offset = args->display->lastwritten_bytes - bytes_to_show;
+	write_offset = args->offset;
+	for (remaining = bytes_to_show; remaining > 0; remaining--) {
+		char display_char = args->display->lastwritten_buffer[read_offset++];
+		args->buffer[write_offset++] = pv_isprint(display_char) ? display_char : '.';
+	}
+
+	return bytes_to_show;
+}

src/pv/format/name.c

@@ -0,0 +1,43 @@
+/*
+ * Formatter function for showing the name of the transfer.
+ *
+ * Copyright 2024-2025 Andrew Wood
+ *
+ * License GPLv3+: GNU GPL version 3 or later; see `docs/COPYING'.
+ */
+
+#include "config.h"
+#include "pv.h"
+#include "pv-internal.h"
+
+#include <string.h>
+
+
+/*
+ * Display the transfer's name.
+ */
+pvdisplay_bytecount_t pv_formatter_name(pvformatter_args_t args)
+{
+	char string_format[32];		 /* flawfinder: ignore - always bounded */
+	char content[512];		 /* flawfinder: ignore - always bounded */
+	pvdisplay_bytecount_t field_width;
+
+	if (0 == args->buffer_size)
+		return 0;
+
+	field_width = args->segment->chosen_size;
+	if (field_width < 1)
+		field_width = 9;
+	if (field_width > 500)
+		field_width = 500;
+
+	memset(string_format, 0, sizeof(string_format));
+	(void) pv_snprintf(string_format, sizeof(string_format), "%%%d.500s:", field_width);
+
+	content[0] = '\0';
+	if (NULL != args->control->name) {
+		(void) pv_snprintf(content, sizeof(content), string_format, args->control->name);
+	}
+
+	return pv_formatter_segmentcontent(content, args);
+}

src/pv/format/previousline.c

@@ -0,0 +1,49 @@
+/*
+ * Formatter function for the most recently written line.
+ *
+ * Copyright 2024-2025 Andrew Wood
+ *
+ * License GPLv3+: GNU GPL version 3 or later; see `docs/COPYING'.
+ */
+
+#include "config.h"
+#include "pv.h"
+#include "pv-internal.h"
+
+
+/*
+ * Display the previously written line.
+ */
+pvdisplay_bytecount_t pv_formatter_previous_line(pvformatter_args_t args)
+{
+	pvdisplay_bytecount_t bytes_to_show, read_offset, write_offset, remaining;
+
+	args->display->showing_previous_line = true;
+
+	if (0 == args->buffer_size)
+		return 0;
+
+	bytes_to_show = args->segment->chosen_size;
+	if (0 == bytes_to_show)
+		bytes_to_show = args->segment->width;
+	if (0 == bytes_to_show)
+		return 0;
+
+	if (bytes_to_show > PV_SIZEOF_PREVLINE_BUFFER)
+		bytes_to_show = PV_SIZEOF_PREVLINE_BUFFER;
+
+	if (args->offset + bytes_to_show >= args->buffer_size)
+		return 0;
+
+	args->segment->offset = args->offset;
+	args->segment->bytes = bytes_to_show;
+
+	read_offset = 0;
+	write_offset = args->offset;
+	for (remaining = bytes_to_show; remaining > 0; remaining--) {
+		char display_char = args->display->previous_line[read_offset++];
+		args->buffer[write_offset++] = pv_isprint(display_char) ? display_char : ' ';
+	}
+
+	return bytes_to_show;
+}

src/pv/format/progressbar.c

@@ -0,0 +1,410 @@
+/*
+ * Formatter functions for progress bars.
+ *
+ * Copyright 2024-2025 Andrew Wood
+ *
+ * License GPLv3+: GNU GPL version 3 or later; see `docs/COPYING'.
+ */
+
+#include "config.h"
+#include "pv.h"
+#include "pv-internal.h"
+
+#include <string.h>
+
+#if HAVE_MATH_H
+#include <math.h>
+#endif
+
+/* Convenience macro for appending a string to the buffer. */
+#define append_to_buffer(x) { \
+  if (buffer_offset < (buffer_size - x.bytes)) { \
+      memcpy(&(buffer[buffer_offset]), x.string, x.bytes); /* flawfinder: ignore */ \
+      buffer_offset += x.bytes; \
+  } \
+}
+/*
+ * flawfinder - we are checking that there is room in the destination
+ * buffer, given its size and our current offset.
+ */
+
+
+/*
+ * Write a progress bar to a buffer, in known-size or rate-gauge mode - a
+ * bar, and a percentage (size) or max rate (gauge).  The total width of the
+ * content is bounded to the given width.  Returns the number of bytes
+ * written to the buffer.
+ *
+ * If "bar_sides" is false, only the bar itself is rendered, not the opening
+ * and closing characters.
+ *
+ * If "include_bar" is false, the bar is omitted entirely.
+ *
+ * If "include_amount" is false, the percentage or rate after the bar is
+ * omitted.
+ *
+ * This is only called by pv_formatter_progress().
+ */
+static pvdisplay_bytecount_t pv_formatter_progress_knownsize(pvformatter_args_t args, char *buffer,
+							     pvdisplay_bytecount_t buffer_size, bool bar_sides,
+							     bool include_bar, bool include_amount)
+{
+	char after_bar[32];		 /* flawfinder: ignore - only populated by pv_snprintf(). */
+	pvdisplay_bytecount_t after_bar_bytes, buffer_offset;
+	pvdisplay_width_t after_bar_width;
+	pvdisplay_width_t bar_area_width, filled_bar_width, pad_count;
+	double bar_percentage;
+	pvbarstyle_t style;
+	pvdisplay_bytecount_t full_cell_index;
+	bool has_tip = false;
+
+	buffer[0] = '\0';
+
+	if (args->segment->parameter > 0 && args->segment->parameter <= PV_BARSTYLE_MAX) {
+		style = &(args->display->barstyle[args->segment->parameter - 1]);
+	} else {
+		style = &(args->display->barstyle[0]);
+	}
+
+	full_cell_index = style->filler_entries;
+	if (full_cell_index > 0)
+		full_cell_index--;
+	if (1 == full_cell_index && style->tip.width > 0)
+		has_tip = true;
+
+	memset(after_bar, 0, sizeof(after_bar));
+
+	if (args->control->size > 0) {
+		/* Percentage of data transferred. */
+		bar_percentage = (double) (args->calc->percentage);
+		(void) pv_snprintf(after_bar, sizeof(after_bar), " %3ld%%", (int) bar_percentage);
+	} else {
+		/* Current rate vs max rate. */
+		bar_percentage = 0.0;
+		if (args->calc->rate_max > 0) {
+			bar_percentage = (double) (100.0 * args->calc->transfer_rate / args->calc->rate_max);
+		}
+
+		/*@-mustfreefresh@ */
+		if (args->control->bits && !args->control->linemode) {
+			/* bits per second */
+			pv_describe_amount(after_bar, sizeof(after_bar), "/%s",
+					   8.0 * args->calc->rate_max, "", _("b/s"), args->display->count_type);
+		} else {
+			/* bytes or lines per second */
+			pv_describe_amount(after_bar, sizeof(after_bar),
+					   "/%s", args->calc->rate_max, _("/s"), _("B/s"), args->display->count_type);
+		}
+		/*@+mustfreefresh@ *//* splint: see above about gettext(). */
+	}
+
+	if (!include_amount)
+		after_bar[0] = '\0';
+
+	after_bar_bytes = strlen(after_bar);	/* flawfinder: ignore */
+	/* flawfinder: always \0-terminated by pv_snprintf() and the earlier memset(). */
+	after_bar_width = pv_strwidth(after_bar, after_bar_bytes);
+
+	if (!include_bar) {
+		/*
+		 * Only returning the "after bar" portion - the amount
+		 * (progress or max rate).
+		 */
+		if (buffer_size < after_bar_bytes)
+			return 0;
+		if (after_bar_bytes > 1) {
+			/* NB we skip the leading space. */
+			memmove(buffer, after_bar + 1, after_bar_bytes - 1);
+			buffer[after_bar_bytes - 1] = '\0';
+			return after_bar_bytes - 1;
+		}
+		return 0;
+	}
+
+	if (bar_sides) {
+		if (args->segment->width < (after_bar_width + 2))
+			return 0;
+		bar_area_width = args->segment->width - after_bar_width - 2;
+	} else {
+		if (args->segment->width < after_bar_width)
+			return 0;
+		bar_area_width = args->segment->width - after_bar_width;
+	}
+
+	filled_bar_width = (pvdisplay_width_t) ((bar_area_width * bar_percentage) / 100);
+	/* Leave room for the tip of the bar. */
+	if (has_tip && filled_bar_width > 0)
+		filled_bar_width -= style->tip.width;
+
+	debug("percentage=%.2f width=%d bar_area_width=%d filled_bar_width=%d after_bar_width=%d", bar_percentage,
+	      args->segment->width, bar_area_width, filled_bar_width, after_bar_width);
+
+	buffer_offset = 0;
+
+	if (bar_sides) {
+		/* The opening of the bar area. */
+		buffer[buffer_offset++] = '[';
+	}
+
+	/* The bar portion. */
+	pad_count = 0;
+	while (pad_count < filled_bar_width && pad_count < bar_area_width) {
+		append_to_buffer(style->filler[full_cell_index]);
+		pad_count += style->filler[full_cell_index].width;
+		if (0 == style->filler[full_cell_index].width)
+			pad_count++;
+	}
+
+	/* The tip of the bar, if not at 100%. */
+	if (has_tip && pad_count < bar_area_width) {
+		append_to_buffer(style->tip);
+		pad_count += style->tip.width;
+	}
+
+	/* A partial cell, if there are intermediates and we're not at 100%. */
+	if (pad_count < bar_area_width && full_cell_index > 1 && !has_tip) {
+		double exact_width = (((double) bar_area_width) * bar_percentage) / 100.0;
+		double cell_portion = exact_width - (double) filled_bar_width;
+		double cell_index_double = ((double) full_cell_index) * cell_portion;
+		size_t cell_index = (size_t) cell_index_double;
+
+		if (cell_index > full_cell_index)
+			cell_index = full_cell_index;
+
+		append_to_buffer(style->filler[cell_index]);
+		pad_count += style->filler[cell_index].width;
+		if (0 == style->filler[cell_index].width)
+			pad_count++;
+	}
+
+	/* The spaces after the bar. */
+	while (pad_count < bar_area_width) {
+		append_to_buffer(style->filler[0]);
+		pad_count += style->filler[0].width;
+		if (0 == style->filler[0].width)
+			pad_count++;
+	}
+
+	if (bar_sides) {
+		/* The closure of the bar area. */
+		if (buffer_offset < buffer_size - 1)
+			buffer[buffer_offset++] = ']';
+	}
+
+	/* The percentage. */
+	if (after_bar_bytes > 0 && after_bar_bytes < (buffer_size - 1 - buffer_offset)) {
+		memmove(buffer + buffer_offset, after_bar, after_bar_bytes);
+		buffer_offset += after_bar_bytes;
+	}
+
+	buffer[buffer_offset] = '\0';
+
+	return buffer_offset;
+}
+
+
+/*
+ * Write a progress bar to a buffer, in unknown-size mode - just a moving
+ * indicator.  The total width of the content is bounded to the given width. 
+ * Returns the number of bytes written to the buffer.
+ *
+ * If "bar_sides" is false, only the bar itself is rendered, not the opening
+ * and closing characters.
+ *
+ * This is only called by pv_formatter_progress().
+ */
+static pvdisplay_bytecount_t pv_formatter_progress_unknownsize(pvformatter_args_t args, char *buffer,
+							       pvdisplay_bytecount_t buffer_size, bool bar_sides)
+{
+	pvdisplay_bytecount_t buffer_offset;
+	pvdisplay_width_t bar_area_width, pad_count;
+	double indicator_position, padding_width;
+	pvbarstyle_t style;
+
+	buffer[0] = '\0';
+
+	if (args->segment->parameter > 0 && args->segment->parameter <= PV_BARSTYLE_MAX) {
+		style = &(args->display->barstyle[args->segment->parameter - 1]);
+	} else {
+		style = &(args->display->barstyle[0]);
+	}
+
+	if (bar_sides) {
+		if (args->segment->width < (style->indicator.width + 3))
+			return 0;
+		bar_area_width = args->segment->width - (style->indicator.width + 2);
+	} else {
+		if (args->segment->width < (style->indicator.width + 2))
+			return 0;
+		bar_area_width = args->segment->width - style->indicator.width;
+	}
+
+	/*
+	 * Note that pv_calculate_transfer_rate() sets the percentage when
+	 * the size is unknown to a value that goes 0 - 200 and resets, so
+	 * here we make values above 100 send the indicator back down again,
+	 * so it moves back and forth.
+	 */
+	indicator_position = args->calc->percentage;
+	if (indicator_position > 200.0)
+#if HAVE_FMOD
+		indicator_position = fmod(indicator_position, 200.0);
+#else
+	{
+		while (indicator_position > 200.0)
+			indicator_position -= 200.0;
+	}
+#endif
+	if (indicator_position > 100.0)
+		indicator_position = 200.0 - indicator_position;
+	if (indicator_position < 0.0)
+		indicator_position = 0.0;
+
+	buffer_offset = 0;
+
+	if (bar_sides) {
+		/* The opening of the bar area. */
+		buffer[buffer_offset++] = '[';
+	}
+
+	/* The spaces before the indicator. */
+	pad_count = 0;
+	padding_width = (((double) bar_area_width) * indicator_position) / 100.0;
+	while (pad_count < bar_area_width && pad_count < (pvdisplay_width_t) padding_width) {
+		append_to_buffer(style->filler[0]);
+		pad_count += style->filler[0].width;
+		if (0 == style->filler[0].width)
+			pad_count++;
+	}
+
+	/* The indicator. */
+	if (buffer_offset < buffer_size - style->indicator.bytes) {
+		append_to_buffer(style->indicator);
+	}
+
+	/* The spaces after the indicator. */
+	while (pad_count < bar_area_width) {
+		append_to_buffer(style->filler[0]);
+		pad_count += style->filler[0].width;
+		if (0 == style->filler[0].width)
+			pad_count++;
+	}
+
+	if (bar_sides) {
+		/* The closure of the bar area. */
+		if (buffer_offset < buffer_size - 1)
+			buffer[buffer_offset++] = ']';
+	}
+
+	buffer[buffer_offset] = '\0';
+
+	return buffer_offset;
+}
+
+
+/*
+ * Progress bar.
+ */
+pvdisplay_bytecount_t pv_formatter_progress(pvformatter_args_t args)
+{
+	char content[4096];		 /* flawfinder: ignore - always bounded */
+	pvdisplay_bytecount_t bytes;
+
+	content[0] = '\0';
+
+	if (0 == args->segment->parameter) {
+		const char *default_name;
+		default_name = args->control->default_bar_style;
+		/*@-branchstate@ */
+		if (NULL == default_name)
+			default_name = "plain";
+		/*@+branchstate@ */
+		/* splint - it doesn't matter that default_name may be static */
+		args->segment->parameter = 1 + pv_display_barstyle_index(args, default_name);
+	}
+
+	if (0 == args->buffer_size)
+		return 0;
+
+	if (args->control->size > 0 || args->control->rate_gauge) {
+		/* Known size or rate gauge - bar with percentage. */
+		bytes = pv_formatter_progress_knownsize(args, content, sizeof(content), true, true, true);
+	} else {
+		/* Unknown size - back-and-forth moving indicator. */
+		bytes = pv_formatter_progress_unknownsize(args, content, sizeof(content), true);
+	}
+
+	content[bytes] = '\0';
+
+	return pv_formatter_segmentcontent(content, args);
+}
+
+
+/*
+ * Progress bar, without sides and without a number afterwards.
+ */
+pvdisplay_bytecount_t pv_formatter_progress_bar_only(pvformatter_args_t args)
+{
+	char content[4096];		 /* flawfinder: ignore - always bounded */
+	pvdisplay_bytecount_t bytes;
+
+	content[0] = '\0';
+
+	if (0 == args->segment->parameter) {
+		const char *default_name;
+		default_name = args->control->default_bar_style;
+		/*@-branchstate@ */
+		if (NULL == default_name)
+			default_name = "plain";
+		/*@+branchstate@ */
+		/* splint - it doesn't matter that default_name may be static */
+		args->segment->parameter = 1 + pv_display_barstyle_index(args, default_name);
+	}
+
+	if (0 == args->buffer_size)
+		return 0;
+
+	if (args->control->size > 0 || args->control->rate_gauge) {
+		/* Known size or rate gauge - bar with percentage. */
+		bytes = pv_formatter_progress_knownsize(args, content, sizeof(content), false, true, false);
+	} else {
+		/* Unknown size - back-and-forth moving indicator. */
+		bytes = pv_formatter_progress_unknownsize(args, content, sizeof(content), false);
+	}
+
+	content[bytes] = '\0';
+
+	return pv_formatter_segmentcontent(content, args);
+}
+
+
+/*
+ * The number after the progress bar.
+ */
+pvdisplay_bytecount_t pv_formatter_progress_amount_only(pvformatter_args_t args)
+{
+	char content[256];		 /* flawfinder: ignore - always bounded */
+	pvdisplay_bytecount_t bytes;
+
+	memset(content, 0, sizeof(content));
+
+	if (0 == args->buffer_size)
+		return 0;
+
+	if (args->control->numeric) {
+		/* Numeric mode - percentage as a rounded integer with no suffix. */
+		(void) pv_snprintf(content, sizeof(content), "%.0f", args->calc->percentage);
+		bytes = strlen(content);    /* flawfinder: ignore */
+		/* flawfinder: always \0-terminated by pv_snprintf() and the earlier memset(). */
+	} else if (args->control->size > 0 || args->control->rate_gauge) {
+		/* Known size or rate gauge - percentage or rate. */
+		bytes = pv_formatter_progress_knownsize(args, content, sizeof(content), false, false, true);
+	} else {
+		/* Unknown size - no number. */
+		return 0;
+	}
+
+	content[bytes] = '\0';
+
+	return pv_formatter_segmentcontent(content, args);
+}

src/pv/format/rate.c

@@ -0,0 +1,45 @@
+/*
+ * Formatter function for the current rate of transfer.
+ *
+ * Copyright 2024-2025 Andrew Wood
+ *
+ * License GPLv3+: GNU GPL version 3 or later; see `docs/COPYING'.
+ */
+
+#include "config.h"
+#include "pv.h"
+#include "pv-internal.h"
+
+
+/*
+ * Transfer rate.
+ */
+pvdisplay_bytecount_t pv_formatter_rate(pvformatter_args_t args)
+{
+	char content[128];		 /* flawfinder: ignore - always bounded */
+
+	args->display->showing_rate = true;
+
+	content[0] = '\0';
+
+	if (0 == args->buffer_size)
+		return 0;
+
+	/*@-mustfreefresh@ */
+	if (args->control->numeric) {
+		/* numeric - raw value without suffix. */
+		(void) pv_snprintf(content, sizeof(content),
+				   "%.4Lf", ((args->control->bits ? 8.0 : 1.0) * args->calc->transfer_rate));
+	} else if (args->control->bits && !args->control->linemode) {
+		/* bits per second */
+		pv_describe_amount(content, sizeof(content), "[%s]",
+				   8 * args->calc->transfer_rate, "", _("b/s"), args->display->count_type);
+	} else {
+		/* bytes or lines per second */
+		pv_describe_amount(content, sizeof(content),
+				   "[%s]", args->calc->transfer_rate, _("/s"), _("B/s"), args->display->count_type);
+	}
+	/*@+mustfreefresh@ *//* splint: see above. */
+
+	return pv_formatter_segmentcontent(content, args);
+}

src/pv/format/sgr.c

@@ -0,0 +1,214 @@
+/*
+ * Formatter function for ECMA-48 SGR codes.
+ *
+ * Copyright 2024-2025 Andrew Wood
+ *
+ * License GPLv3+: GNU GPL version 3 or later; see `docs/COPYING'.
+ */
+
+#include "config.h"
+#include "pv.h"
+#include "pv-internal.h"
+
+#include <string.h>
+
+struct sgr_keyword_map_s {
+	/*@null@ */ const char *keyword;
+	uint8_t bytes;
+	uint8_t code;
+};
+
+
+/*
+ * Return an array mapping keywords to ECMA-48 SGR code numbers.
+ */
+/*@keep@ */ static struct sgr_keyword_map_s *sgr_keywords(void)
+{
+	/*@keep@ */ static struct sgr_keyword_map_s keywords[] = {
+		{ "reset", 0, 0 },
+		{ "none", 0, 0 },
+		{ "bold", 0, 1 },
+		{ "dim", 0, 2 },
+		{ "italic", 0, 3 },
+		{ "underscore", 0, 4 },
+		{ "underline", 0, 4 },
+		{ "blink", 0, 5 },
+		{ "reverse", 0, 7 },
+		{ "no-bold", 0, 22 },	    /* same as no-dim */
+		{ "no-dim", 0, 22 },
+		{ "no-italic", 0, 23 },
+		{ "no-underscore", 0, 24 },
+		{ "no-underline", 0, 24 },
+		{ "no-blink", 0, 25 },
+		{ "no-reverse", 0, 27 },
+		{ "black", 0, 30 },
+		{ "red", 0, 31 },
+		{ "green", 0, 32 },
+		{ "brown", 0, 33 },
+		{ "yellow", 0, 33 },
+		{ "blue", 0, 34 },
+		{ "magenta", 0, 35 },
+		{ "cyan", 0, 36 },
+		{ "white", 0, 37 },
+		{ "fg-black", 0, 30 },
+		{ "fg-red", 0, 31 },
+		{ "fg-green", 0, 32 },
+		{ "fg-brown", 0, 33 },
+		{ "fg-yellow", 0, 33 },
+		{ "fg-blue", 0, 34 },
+		{ "fg-magenta", 0, 35 },
+		{ "fg-cyan", 0, 36 },
+		{ "fg-white", 0, 37 },
+		{ "fg-default", 0, 39 },
+		{ "bg-black", 0, 40 },
+		{ "bg-red", 0, 41 },
+		{ "bg-green", 0, 42 },
+		{ "bg-brown", 0, 43 },
+		{ "bg-yellow", 0, 43 },
+		{ "bg-blue", 0, 44 },
+		{ "bg-magenta", 0, 45 },
+		{ "bg-cyan", 0, 46 },
+		{ "bg-white", 0, 47 },
+		{ "bg-default", 0, 49 },
+		{ NULL, 0, 0 }
+	};
+	int keyword_index;
+
+	/* Calculate the lengths of each keyword on the first call. */
+	if (0 == keywords[0].bytes) {
+		for (keyword_index = 0; NULL != keywords[keyword_index].keyword; keyword_index++) {
+			keywords[keyword_index].bytes = strlen(keywords[keyword_index].keyword);	/* flawfinder: ignore */
+			/* flawfinder - strlen() on a static null-terminated string is OK. */
+		}
+	}
+
+	/*@-compmempass@ */
+	return keywords;
+	/*@+compmempass@ */
+	/*
+	 * splint - found no other way to pass static back without a false
+	 * positive warning about a memory leak.
+	 */
+}
+
+
+/*
+ * Display SGR codes if colour output is supported.
+ */
+pvdisplay_bytecount_t pv_formatter_sgr(pvformatter_args_t args)
+{
+	/*@keep@ */ static struct sgr_keyword_map_s *keywords;
+	char content[1024];		 /* flawfinder: ignore */
+	pvdisplay_bytecount_t write_position, read_position, keyword_start, keyword_length;
+	int numeric_value, code_count, most_recent_code;
+
+	/* flawfinder - null-terminated and bounded with pv_snprintf(). */
+
+	if (!args->display->colour_permitted)
+		return 0;
+
+	args->display->format_uses_colour = true;
+
+	if (!args->status->terminal_supports_colour)
+		return 0;
+	if (NULL == args->segment->string_parameter)
+		return 0;
+	if (0 == args->segment->string_parameter_bytes)
+		return 0;
+
+	keywords = sgr_keywords();
+
+	write_position = 0;
+	content[0] = '\0';
+
+	debug("%p+%d [%.*s]", args->segment->string_parameter, args->segment->string_parameter_bytes,
+	      args->segment->string_parameter_bytes, args->segment->string_parameter);
+
+	read_position = 0;
+	keyword_start = 0;
+	keyword_length = 0;
+	numeric_value = -1;
+	code_count = 0;
+	most_recent_code = -1;
+
+	while (read_position < args->segment->string_parameter_bytes) {
+		char read_char = args->segment->string_parameter[read_position++];
+		if ((',' == read_char) || (';' == read_char)) {
+			keyword_length = read_position - keyword_start;
+			if (keyword_length > 0)
+				keyword_length--;
+		} else {
+			if ((read_char >= '0' && read_char <= '9')
+			    && (numeric_value >= 0 || keyword_start == read_position - 1)) {
+				if (keyword_start == read_position - 1)
+					numeric_value = 0;
+				numeric_value = numeric_value * 10 + (int) (read_char - '0');
+			} else {
+				numeric_value = -1;
+			}
+			if (read_position >= args->segment->string_parameter_bytes) {
+				keyword_length = read_position - keyword_start;
+			}
+		}
+		if (keyword_length > 0) {
+			int code = -1;
+
+			debug("keyword@%d+%d: [%.*s]; numeric=%d", keyword_start, keyword_length, keyword_length,
+			      &(args->segment->string_parameter[keyword_start]), numeric_value);
+
+			if (numeric_value >= 0 && numeric_value < 255) {
+				code = numeric_value;
+			} else {
+				int keyword_index;
+				for (keyword_index = 0; -1 == code && NULL != keywords[keyword_index].keyword;
+				     keyword_index++) {
+					if (keyword_length != keywords[keyword_index].bytes)
+						continue;
+					if (0 !=
+					    strncmp(keywords[keyword_index].keyword,
+						    &(args->segment->string_parameter[keyword_start]), keyword_length))
+						continue;
+					code = (int) (keywords[keyword_index].code);
+				}
+			}
+
+			debug("code=%d", code);
+
+			if (code >= 0) {
+				if (code_count > 15) {
+					write_position +=
+					    pv_snprintf(content + write_position, sizeof(content) - write_position,
+							"%s", "m");
+					code_count = 0;
+				}
+				if (0 == code_count) {
+					write_position +=
+					    pv_snprintf(content + write_position, sizeof(content) - write_position,
+							"%s", "\033[");
+				} else {
+					write_position +=
+					    pv_snprintf(content + write_position, sizeof(content) - write_position,
+							"%s", ";");
+				}
+				write_position +=
+				    pv_snprintf(content + write_position, sizeof(content) - write_position, "%d", code);
+				code_count++;
+				most_recent_code = code;
+			}
+
+			keyword_length = 0;
+			keyword_start = read_position;
+		}
+	}
+
+	if (code_count > 0)
+		write_position += pv_snprintf(content + write_position, sizeof(content) - write_position, "%s", "m");
+
+	if (most_recent_code > 0) {
+		args->display->sgr_code_active = true;
+	} else if (0 == most_recent_code) {
+		args->display->sgr_code_active = false;
+	}
+
+	return pv_formatter_segmentcontent(content, args);
+}

src/pv/format/timer.c

@@ -0,0 +1,66 @@
+/*
+ * Formatter function for the elapsed transfer time.
+ *
+ * Copyright 2024-2025 Andrew Wood
+ *
+ * License GPLv3+: GNU GPL version 3 or later; see `docs/COPYING'.
+ */
+
+#include "config.h"
+#include "pv.h"
+#include "pv-internal.h"
+
+
+/*
+ * Elapsed time.
+ */
+pvdisplay_bytecount_t pv_formatter_timer(pvformatter_args_t args)
+{
+	char content[128];		 /* flawfinder: ignore - always bounded */
+	long double elapsed_seconds;
+
+	args->display->showing_timer = true;
+
+	content[0] = '\0';
+
+	if (0 == args->buffer_size)
+		return 0;
+
+	elapsed_seconds = args->transfer->elapsed_seconds;
+
+	/*
+	 * Bounds check, so we don't overrun the prefix buffer.  This does
+	 * mean that the timer will stop at a 100,000 hours, but since
+	 * that's 11 years, it shouldn't be a problem.
+	 */
+	if (elapsed_seconds > (long double) 360000000.0L)
+		elapsed_seconds = (long double) 360000000.0L;
+
+	/* Also check it's not negative. */
+	if (elapsed_seconds < 0.0)
+		elapsed_seconds = 0.0;
+
+	if (args->control->numeric) {
+		/* Numeric mode - show the number of seconds, unformatted. */
+		(void) pv_snprintf(content, sizeof(content), "%.4Lf", elapsed_seconds);
+	} else if (elapsed_seconds > (long double) 86400.0L) {
+		/*
+		 * If the elapsed time is more than a day, include a day count as
+		 * well as hours, minutes, and seconds.
+		 */
+		(void) pv_snprintf(content,
+				   sizeof(content),
+				   "%ld:%02ld:%02ld:%02ld",
+				   ((long) (elapsed_seconds)) / 86400,
+				   (((long) (elapsed_seconds)) / 3600) %
+				   24, (((long) (elapsed_seconds)) / 60) % 60, ((long) (elapsed_seconds)) % 60);
+	} else {
+		(void) pv_snprintf(content,
+				   sizeof(content),
+				   "%ld:%02ld:%02ld",
+				   ((long) (elapsed_seconds)) / 3600,
+				   (((long) (elapsed_seconds)) / 60) % 60, ((long) (elapsed_seconds)) % 60);
+	}
+
+	return pv_formatter_segmentcontent(content, args);
+}

src/pv/number.c

@@ -1,9 +1,9 @@
 /*
  * Functions for converting strings to numbers.
  *
- * Copyright 2002-2008, 2010, 2012-2015, 2017, 2021, 2023 Andrew Wood
+ * Copyright 2002-2008, 2010, 2012-2015, 2017, 2021, 2023-2025 Andrew Wood
  *
- * Distributed under the Artistic License v2.0; see `doc/COPYING'.
+ * License GPLv3+: GNU GPL version 3 or later; see `docs/COPYING'.
  */
 
 #include "config.h"
@@ -17,70 +17,92 @@
  * including <ctype.h> causes weird versioned glibc dependencies on certain
  * Red Hat systems, complicating package management.
  */
-static bool pv__isdigit(char c)
+bool pv_isdigit(char c)
 {
 	return ((c >= '0') && (c <= '9')) ? true : false;
 }
 
 
 /*
- * Return the numeric value of "str", as an unsigned long long.
+ * Return the numeric value of "str", as an off_t, where "str" is expected
+ * to be a sequence of digits (without a thousands separator), possibly with
+ * a fractional part, optionally followed by a units suffix such as "K" for
+ * kibibytes.  If "decimal_units" is true, suffixes are interpreted as
+ * multiples of 1000, rather than multiples of 1024.
  */
-unsigned long long pv_getnum_ull(const char *str)
+off_t pv_getnum_size(const char *str, bool decimal_units)
 {
-	unsigned long long n = 0;
-	unsigned long long decimal = 0;
-	unsigned int decdivisor = 1;
-	unsigned int shift = 0;
+	off_t integral_part = 0;
+	off_t fractional_part = 0;
+	unsigned int fractional_divisor = 1;
+	unsigned int binary_shift = 0;
+	off_t decimal_multiplier = 0;
+	size_t readpos = 0;
 
 	if (NULL == str)
-		return n;
+		return (off_t) 0;
 
-	while (str[0] != '\0' && (!pv__isdigit(str[0])))
-		str++;
+	/* Skip any non-numeric leading characters. */
+	while (str[readpos] != '\0' && (!pv_isdigit(str[readpos])))
+		readpos++;
 
-	for (; pv__isdigit(str[0]); str++) {
-		n = n * 10;
-		n += (unsigned long long) (str[0] - '0');
+	/*
+	 * Parse the integral part of the number - the digits before the
+	 * decimal mark or units.
+	 */
+	for (; pv_isdigit(str[readpos]); readpos++) {
+		integral_part = integral_part * 10;
+		integral_part += (off_t) (str[readpos] - '0');
 	}
 
 	/*
-	 * If a decimal value was given, skip the decimal part.
+	 * If the next character is a decimal mark, skip over it and parse
+	 * the following digits as the fractional part of the number.
+	 *
+	 * Note that we hard-code the decimal mark as '.' or ',' so this
+	 * will fail if there are any locales whose decimal mark is not one
+	 * of those two characters.
 	 */
-	if (('.' == str[0]) || (',' == str[0])) {
-		str++;
-		for (; pv__isdigit(str[0]); str++) {
-			if (decdivisor < 10000) {
-				decimal = decimal * 10;
-				decimal += (unsigned long long) (str[0] - '0');
-				decdivisor = decdivisor * 10;
+	if (('.' == str[readpos]) || (',' == str[readpos])) {
+		readpos++;
+		for (; pv_isdigit(str[readpos]); readpos++) {
+			/* Stop counting below 0.0001. */
+			if (fractional_divisor < 10000) {
+				fractional_part = fractional_part * 10;
+				fractional_part += (off_t) (str[readpos] - '0');
+				fractional_divisor = fractional_divisor * 10;
 			}
 		}
 	}
 
 	/*
 	 * Parse any units given (K=KiB=*1024, M=MiB=1024KiB, G=GiB=1024MiB,
-	 * T=TiB=1024GiB).
+	 * T=TiB=1024GiB; replace 1024 with 1000 if decimal_units is true).
 	 */
-	if (str[0] != '\0') {
-		while ((' ' == str[0]) || ('\t' == str[0]))
-			str++;
-		switch (str[0]) {
+	if (str[readpos] != '\0') {
+		/* Skip any spaces or tabs after the digits. */
+		while ((' ' == str[readpos]) || ('\t' == str[readpos]))
+			readpos++;
+		switch (str[readpos]) {
 		case 'k':
 		case 'K':
-			shift = 10;
+			binary_shift = 10;
+			decimal_multiplier = 1000;
 			break;
 		case 'm':
 		case 'M':
-			shift = 20;
+			binary_shift = 20;
+			decimal_multiplier = 1000000;
 			break;
 		case 'g':
 		case 'G':
-			shift = 30;
+			binary_shift = 30;
+			decimal_multiplier = 1000000000;
 			break;
 		case 't':
 		case 'T':
-			shift = 40;
+			binary_shift = 40;
+			decimal_multiplier = 1000000000000;
 			break;
 		default:
 			break;
@@ -88,109 +110,157 @@ unsigned long long pv_getnum_ull(const char *str)
 	}
 
 	/*
-	 * Binary left-shift the supplied number by "shift" times, i.e.
+	 * If decimal_units is false, zero decimal_multiplier; if true, zero
+	 * binary_shift.  This is so we only do one or the other.
+	 */
+	if (decimal_units) {
+		binary_shift = 0;
+	} else {
+		decimal_multiplier = 0;
+	}
+
+	/*
+	 * Binary left-shift the supplied number by "binary_shift" times, i.e.
 	 * apply the given units (KiB, MiB, etc) to it, but never shift left
 	 * more than 30 at a time to avoid overflows.
 	 */
-	while (shift > 0) {
+	while (binary_shift > 0) {
 		unsigned int shiftby;
 
-		shiftby = shift;
+		shiftby = binary_shift;
 		if (shiftby > 30)
 			shiftby = 30;
 
-		n = n << shiftby;
-		decimal = decimal << shiftby;
-		shift -= shiftby;
+		/*@-shiftimplementation@ */
+		/*
+		 * splint note: ignore the fact that the types we are
+		 * shifting are signed, because we know they are definitely
+		 * not negative.
+		 */
+		integral_part = (off_t) (integral_part << shiftby);
+		fractional_part = (off_t) (fractional_part << shiftby);
+		/*@+shiftimplementation@ */
+
+		binary_shift -= shiftby;
 	}
 
 	/*
-	 * Add any decimal component.
+	 * Multiply the supplied number by the decimal multiplier.
 	 */
-	decimal = decimal / decdivisor;
-	n += decimal;
+	if (decimal_multiplier > 0) {
+		integral_part = integral_part * decimal_multiplier;
+		fractional_part = fractional_part * decimal_multiplier;
+	}
 
-	return n;
+	/*
+	 * Add the fractional part, divided by its divisor, to the integral
+	 * part, now that we've multiplied everything by the appropriate
+	 * units.
+	 */
+	fractional_part = fractional_part / fractional_divisor;
+	integral_part += fractional_part;
+
+	debug("%s [%s] = %lld", str, decimal_units ? "decimal" : "binary", (long long) integral_part);
+
+	return integral_part;
 }
 
 
 /*
- * Return the numeric value of "str", as a double.
+ * Return the numeric value of "str", as a double, where "str" is expected
+ * to be a positive decimal number expressing a time interval.
  */
-double pv_getnum_d(const char *str)
+double pv_getnum_interval(const char *str)
 {
-	double n = 0.0;
+	double result = 0.0;
 	double step = 1;
 
 	if (NULL == str)
-		return n;
+		return 0.0;
 
-	while (str[0] != '\0' && (!pv__isdigit(str[0])))
+	/* Skip any non-digit characters at the start. */
+	while (str[0] != '\0' && (!pv_isdigit(str[0])))
 		str++;
 
-	for (; pv__isdigit(str[0]); str++) {
-		n = n * 10;
-		n += (double) (str[0] - '0');
+	/* Parse the digits before the decimal mark. */
+	for (; pv_isdigit(str[0]); str++) {
+		result = result * 10;
+		result += (double) (str[0] - '0');
 	}
 
+	/* If there is no decimal mark, return the value as-is. */
 	if ((str[0] != '.') && (str[0] != ','))
-		return n;
+		return result;
 
+	/* Move past the decimal mark. */
 	str++;
 
-	for (; pv__isdigit(str[0]) && step < 1000000; str++) {
+	/* Parse the digits after the decimal mark, up to 0.0000001. */
+	for (; pv_isdigit(str[0]) && step < 1000000; str++) {
 		step = step * 10;
-		n += ((double) (str[0] - '0')) / step;
+		result += ((double) (str[0] - '0')) / step;
 	}
 
-	return n;
+	return result;
 }
 
 
 /*
- * Return the numeric value of "str", as an unsigned int.
+ * Return the numeric value of "str", as an unsigned int, following the same
+ * rules as pv_getnum_size(), expecting "str" to express a value to be used
+ * as a count (such as number of screen columns, or size of a buffer).
  */
-unsigned int pv_getnum_ui(const char *str)
+unsigned int pv_getnum_count(const char *str, bool decimal_units)
 {
-	return (unsigned int) pv_getnum_ull(str);
+	return (unsigned int) pv_getnum_size(str, decimal_units);
 }
 
 
 /*
- * Return nonzero if the given string is not a valid number of the given
- * type.
+ * Return true if the given string is a valid number of the given type.
  */
-int pv_getnum_check(const char *str, pv_numtype_t type)
+bool pv_getnum_check(const char *str, pv_numtype type)
 {
-	if (0 == str)
-		return 1;
+	if (NULL == str)
+		return false;
 
+	/* Skip leading spaces and tabs. */
 	while ((' ' == str[0]) || ('\t' == str[0]))
 		str++;
 
-	if (!pv__isdigit(str[0]))
-		return 1;
+	/* If the next character isn't a digit, this isn't a number. */
+	if (!pv_isdigit(str[0]))
+		return false;
 
-	for (; pv__isdigit(str[0]); str++);
-
-	if (('.' == str[0]) || (',' == str[0])) {
-		if (type == PV_NUMTYPE_INTEGER)
-			return 1;
-		str++;
-		for (; pv__isdigit(str[0]); str++);
-	}
-
-	if ('\0' == str[0])
-		return 0;
+	/* Skip over the digits. */
+	for (; pv_isdigit(str[0]); str++);
 
 	/*
-	 * Suffixes are not allowed for doubles, only for integers.
+	 * If there's a decimal mark (see note in pv_getnum_size() above),
+	 * check that too.
 	 */
-	if (type == PV_NUMTYPE_DOUBLE)
-		return 1;
+	if (('.' == str[0]) || (',' == str[0])) {
+		/* Bare integers should have no decimal mark. */
+		if (type == PV_NUMTYPE_BARE_INTEGER)
+			return false;
+		/* Skip the decimal mark, then all digits. */
+		str++;
+		for (; pv_isdigit(str[0]); str++);
+	}
 
+	/* If the string ends here, this is a valid number. */
+	if ('\0' == str[0])
+		return true;
+
+	/* A units suffix is only allowed for ANY_WITH_SUFFIX. */
+	if (type != PV_NUMTYPE_ANY_WITH_SUFFIX)
+		return false;
+
+	/* Skip trailing spaces or tabs. */
 	while ((' ' == str[0]) || ('\t' == str[0]))
 		str++;
+
+	/* Check the units suffix is one we know about. */
 	switch (str[0]) {
 	case 'k':
 	case 'K':
@@ -203,13 +273,32 @@ int pv_getnum_check(const char *str, pv_numtype_t type)
 		str++;
 		break;
 	default:
-		return 1;
+		return false;
 	}
 
+	/* If the string has trailing text, it's not a valid number. */
 	if (str[0] != '\0')
-		return 1;
+		return false;
 
-	return 0;
+	return true;
 }
 
-/* EOF */
+
+/*
+ * Return a value representing "amount" as a percentage of "total", i.e.
+ * 100*amount/total.  If "total" is zero or less, return 0.
+ */
+double pv_percentage(off_t amount, const off_t total)
+{
+	double amount_as_double;
+
+	if (total < 1)
+		return 0.0;
+
+	amount_as_double = (double) amount;
+
+	amount_as_double *= 100.0;
+	amount_as_double /= (double) total;
+
+	return amount_as_double;
+}

src/pv/proctitle.c

@@ -0,0 +1,118 @@
+/*
+ * Functions for setting the process title.
+ *
+ * Copyright 2024-2025 Andrew Wood
+ *
+ * License GPLv3+: GNU GPL version 3 or later; see `docs/COPYING'.
+ */
+
+#include "config.h"
+#include "pv.h"
+#include <stdio.h>
+#include <stdarg.h>
+#include <string.h>
+#include <unistd.h>
+
+#if ! HAVE_SETPROCTITLE
+extern char **environ;
+
+/*@null@*/ static char **base_argv = NULL;
+static size_t space_available = 0;
+
+
+/*
+ * Assuming the environment comes after the command line arguments, we make
+ * a duplicate of the environment array and all its values, so we can use
+ * the space the environment used to occupy for the process title.
+ *
+ * The logic for this was derived from util-linux-ng.
+ */
+/*@-mustfreefresh@ */
+/*@-nullstate@ */
+void initproctitle(int argc, char **argv)
+{
+	char **original_environment = environ;
+	char **new_environment;
+	size_t env_array_size, env_index;
+
+	/* Find the number of entries in the environment array. */
+	for (env_array_size = 0; environ[env_array_size] != NULL; env_array_size++)
+		continue;
+
+	/* Allocate a new environment array. */
+	new_environment = (char **) malloc(sizeof(char *) * (env_array_size + 1));
+	if (NULL == new_environment)
+		return;
+
+	/* Duplicate the strings in the environment. */
+	for (env_index = 0; original_environment[env_index] != NULL; env_index++) {
+		new_environment[env_index] = pv_strdup(original_environment[env_index]);
+		if (NULL == new_environment[env_index])
+			return;
+	}
+	new_environment[env_index] = NULL;
+
+	base_argv = argv;
+
+	/* Work out how much room we have. */
+	if (env_index > 0) {
+		/* From argv[0] to the end of the last environment value. */
+		space_available = (size_t)
+		    (original_environment[env_index - 1] + strlen(original_environment[env_index - 1]) - argv[0]);	/* flawfinder: ignore */
+	} else if (argc > 0) {
+		/* No environment; from argv[0] to the end of the last argument. */
+		space_available = (size_t) (argv[argc - 1] + strlen(argv[argc - 1]) - argv[0]);	/* flawfinder: ignore */
+	}
+
+	/*
+	 * flawfinder - we have to trust that the environment and argument
+	 * strings are null-terminated, since that's what the OS is supposed
+	 * to guarantee.
+	 */
+
+	environ = new_environment;
+}
+
+/*@+nullstate@ */
+/*@+mustfreefresh@ */
+
+
+/*
+ * Set the process title visible to ps(1), by overwriting argv[0] with the
+ * given printf() format string.
+ */
+void setproctitle(const char *format, ...)
+{
+	char title[1024];		 /* flawfinder: ignore */
+	size_t length;
+	va_list ap;
+
+	/* flawfinder - buffer is zeroed and users of it are bounded. */
+
+	if (NULL == base_argv)
+		return;
+
+	memset(title, 0, sizeof(title));
+
+	va_start(ap, format);
+	(void) vsnprintf(title, sizeof(title) - 1, format, ap);	/* flawfinder: ignore */
+	va_end(ap);
+
+	/*
+	 * flawfinder - the format is explicitly caller-supplied.  Callers
+	 * of this function are all passing fixed format strings and not
+	 * user-supplied formats.
+	 */
+
+	length = strlen(title);		    /* flawfinder: ignore */
+	/* flawfinder - we left a byte at the end to force null-termination. */
+
+	if (length > space_available - 2)
+		length = space_available - 2;
+
+	(void) pv_snprintf(base_argv[0], space_available, "%s -- %s", PACKAGE_NAME, title);
+	if (space_available > length)
+		memset(base_argv[0] + length, 0, space_available - length);
+}
+
+#endif

src/pv/remote.c

@@ -0,0 +1,667 @@
+/*
+ * Remote-control and remote-query functions.
+ *
+ * Copyright 2002-2008, 2010, 2012-2015, 2017, 2021, 2023-2025 Andrew Wood
+ *
+ * License GPLv3+: GNU GPL version 3 or later; see `docs/COPYING'.
+ */
+
+#include "config.h"
+#include "pv.h"
+#include "pv-internal.h"
+
+#include <stdio.h>
+#include <stdlib.h>
+#include <string.h>
+#include <errno.h>
+#include <signal.h>
+#include <unistd.h>
+#include <fcntl.h>
+#include <sys/types.h>
+#include <sys/time.h>
+#include <sys/stat.h>
+
+#ifdef PV_REMOTE_CONTROL
+
+/* Structure for transferring settings with --remote. */
+struct remote_msg {
+	bool progress;			 /* progress bar flag */
+	bool timer;			 /* timer flag */
+	bool eta;			 /* ETA flag */
+	bool fineta;			 /* absolute ETA flag */
+	bool rate;			 /* rate counter flag */
+	bool average_rate;		 /* average rate counter flag */
+	bool bytes;			 /* bytes transferred flag */
+	bool bufpercent;		 /* transfer buffer percentage flag */
+	size_t lastwritten;		 /* last-written bytes count */
+	off_t rate_limit;		 /* rate limit, in bytes per second */
+	size_t buffer_size;		 /* buffer size, in bytes (0=default) */
+	off_t size;			 /* total size of data */
+	double interval;		 /* interval between updates */
+	unsigned int width;		 /* screen width */
+	unsigned int height;		 /* screen height */
+	bool width_set_manually;	 /* width was set manually, not detected */
+	bool height_set_manually;	 /* height was set manually, not detected */
+	char name[256];			 /* flawfinder: ignore */
+	char format[256];		 /* flawfinder: ignore */
+	char extra_display[256];	 /* flawfinder: ignore */
+};
+
+/* Structure for transferring transfer state with --query. */
+struct query_msg {
+	long double elapsed_seconds;	 /* from state.transfer */
+	off_t transferred;		 /* from state.transfer */
+	off_t size;			 /* from state.control */
+	bool response;			 /* true if this is the response signal. */
+};
+
+/*
+ * flawfinder rationale: name, format, and extra_display are always
+ * explicitly zeroed and bounded to one less than their size so they are
+ * always \0 terminated.
+ */
+
+
+/*
+ * Set the options of a remote process by writing them to a file, sending a
+ * signal to the receiving process, and waiting for the message to be
+ * consumed by the remote process.
+ *
+ * Returns nonzero on error.
+ */
+int pv_remote_set(pvstate_t state, pid_t remote)
+{
+	char control_filename[4096];	 /* flawfinder: ignore */
+	FILE *control_fptr;
+	struct remote_msg msgbuf;
+	pid_t signal_sender;
+	long timeout;
+	bool received;
+
+	/*
+	 * flawfinder rationale: buffer is large enough, explicitly zeroed,
+	 * and always bounded properly as we are only writing to it with
+	 * pv_snprintf().
+	 */
+
+	/*
+	 * Check that the remote process exists.
+	 */
+	if (kill((pid_t) (remote), 0) != 0) {
+		pv_error("%u: %s", remote, strerror(errno));
+		return PV_ERROREXIT_REMOTE_OR_PID;
+	}
+
+	/*
+	 * Copy parameters into message buffer.
+	 */
+	memset(&msgbuf, 0, sizeof(msgbuf));
+	msgbuf.progress = state->control.format_option.progress;
+	msgbuf.timer = state->control.format_option.timer;
+	msgbuf.eta = state->control.format_option.eta;
+	msgbuf.fineta = state->control.format_option.fineta;
+	msgbuf.rate = state->control.format_option.rate;
+	msgbuf.average_rate = state->control.format_option.average_rate;
+	msgbuf.bytes = state->control.format_option.bytes;
+	msgbuf.bufpercent = state->control.format_option.bufpercent;
+	msgbuf.lastwritten = state->control.format_option.lastwritten;
+	msgbuf.rate_limit = state->control.rate_limit;
+	msgbuf.buffer_size = state->control.target_buffer_size;
+	msgbuf.size = state->control.size;
+	msgbuf.interval = state->control.interval;
+	msgbuf.width = (unsigned int) (state->control.width);
+	msgbuf.height = (unsigned int) (state->control.height);
+	msgbuf.width_set_manually = state->control.width_set_manually;
+	msgbuf.height_set_manually = state->control.height_set_manually;
+
+	if (state->control.name != NULL) {
+		strncpy(msgbuf.name, state->control.name, sizeof(msgbuf.name) - 1);	/* flawfinder: ignore */
+	}
+	if (state->control.format_string != NULL) {
+		strncpy(msgbuf.format, state->control.format_string, sizeof(msgbuf.format) - 1);	/* flawfinder: ignore */
+	}
+	if (state->control.extra_display_spec != NULL) {
+		strncpy(msgbuf.extra_display, state->control.extra_display_spec, sizeof(msgbuf.extra_display) - 1);	/* flawfinder: ignore */
+	}
+
+	/*
+	 * Make sure parameters are within sensible bounds.
+	 */
+	if (msgbuf.width < 1)
+		msgbuf.width = 80;
+	if (msgbuf.height < 1)
+		msgbuf.height = 25;
+	if (msgbuf.width > 999999)
+		msgbuf.width = 999999;
+	if (msgbuf.height > 999999)
+		msgbuf.height = 999999;
+	if ((msgbuf.interval > 0) && (msgbuf.interval < 0.1))
+		msgbuf.interval = 0.1;
+	if (msgbuf.interval > 600)
+		msgbuf.interval = 600;
+
+	/*
+	 * flawfinder rationale: name, format, and extra_display are
+	 * explicitly bounded to 1 less than the size of their buffer and
+	 * the buffer is \0 terminated by memset() earlier.
+	 */
+
+	/*
+	 * Get the filename and file stream to use for remote control.
+	 */
+	memset(control_filename, 0, sizeof(control_filename));
+	control_fptr = pv_open_controlfile(control_filename, sizeof(control_filename), (pid_t) getpid(), SIGUSR2, true);
+	if (NULL == control_fptr) {
+		pv_error("%s", strerror(errno));
+		return PV_ERROREXIT_REMOTE_OR_PID;
+	}
+
+	/*
+	 * Write the message buffer to the remote control file, and close
+	 * it.
+	 */
+	if (1 != fwrite(&msgbuf, sizeof(msgbuf), 1, control_fptr)) {
+		pv_error("%s", strerror(errno));
+		(void) fclose(control_fptr);
+		(void) remove(control_filename);
+		return PV_ERROREXIT_REMOTE_OR_PID;
+	}
+
+	if (0 != fclose(control_fptr)) {
+		pv_error("%s", strerror(errno));
+		(void) remove(control_filename);
+		return PV_ERROREXIT_REMOTE_OR_PID;
+	}
+
+	/*
+	 * Send a SIGUSR2 signal to the remote process, to tell it a message
+	 * is ready to read, after clearing our own "SIGUSR2 received" flag.
+	 */
+	signal_sender = 0;
+	(void) pv_sigusr2_received(state, &signal_sender);
+	if (kill((pid_t) (remote), SIGUSR2) != 0) {
+		pv_error("%u: %s", remote, strerror(errno));
+		(void) remove(control_filename);
+		return PV_ERROREXIT_REMOTE_OR_PID;
+	}
+
+	debug("%s", "message sent");
+
+	/*
+	 * Wait for a signal from the remote process to say it has received
+	 * the message.
+	 */
+
+	timeout = 1100000;
+	received = false;
+
+	while (timeout > 10000 && !received) {
+		struct timeval tv;
+
+		memset(&tv, 0, sizeof(tv));
+		tv.tv_sec = 0;
+		tv.tv_usec = 10000;
+		/*@-nullpass@ *//* splint: NULL is OK with select() */
+		(void) select(0, NULL, NULL, NULL, &tv);
+		/*@+nullpass@ */
+		timeout -= 10000;
+
+		if (pv_sigusr2_received(state, &signal_sender)) {
+			if (signal_sender == remote) {
+				debug("%s", "message received");
+				received = true;
+			}
+		}
+	}
+
+	/*
+	 * Remove the remote control file.
+	 */
+	debug("%s: %s", "removing", control_filename);
+	if (0 != remove(control_filename)) {
+		pv_error("%s", strerror(errno));
+	}
+
+	/*
+	 * Return 0 if the message was received.
+	 */
+	if (received)
+		return 0;
+
+	/*@-mustfreefresh@ */
+	/*
+	 * splint note: the gettext calls made by _() cause memory leak
+	 * warnings, but in this case it's unavoidable, and mitigated by the
+	 * fact we only translate each string once.
+	 */
+	pv_error("%u: %s", remote, _("message not received"));
+	return PV_ERROREXIT_REMOTE_OR_PID;
+	/*@+mustfreefresh @ */
+}
+
+
+/*
+ * Check for a --remote message (SIGUSR2), returning false if none was
+ * found.
+ *
+ * If a message was received, update the current process's options with the
+ * ones in the message.
+ *
+ * Note that this relies on pv_state_set_format() causing the output format
+ * to be reparsed.
+ */
+static bool pv__rxsignal_usr2(pvstate_t state)
+{
+	pid_t signal_sender;
+	char control_filename[4096];	 /* flawfinder: ignore */
+	FILE *control_fptr;
+	struct remote_msg msgbuf;
+
+	/* flawfinder rationale: as above. */
+
+	/*
+	 * Return early if a SIGUSR2 signal has not been received.
+	 */
+	signal_sender = 0;
+	if (!pv_sigusr2_received(state, &signal_sender))
+		return false;
+
+	memset(control_filename, 0, sizeof(control_filename));
+	control_fptr = pv_open_controlfile(control_filename, sizeof(control_filename), signal_sender, SIGUSR2, false);
+	if (NULL == control_fptr) {
+		pv_error("%s: %s", control_filename, strerror(errno));
+		return false;
+	}
+
+	/*
+	 * Read the message buffer from the remote control file, and close
+	 * it.
+	 */
+	if (1 != fread(&msgbuf, sizeof(msgbuf), 1, control_fptr)) {
+		pv_error("%s", strerror(errno));
+		(void) fclose(control_fptr);
+		return false;
+	}
+
+	if (0 != fclose(control_fptr)) {
+		pv_error("%s", strerror(errno));
+		return false;
+	}
+
+	/*
+	 * Send a SIGUSR2 signal to the sending process, to tell it the
+	 * message has been received.
+	 */
+	if (kill(signal_sender, SIGUSR2) != 0) {
+		debug("%u: %s", signal_sender, strerror(errno));
+	}
+
+	debug("%s", "received remote control message");
+
+	pv_state_format_string_set(state, NULL);
+	pv_state_name_set(state, NULL);
+	pv_state_extra_display_set(state, NULL);
+
+	msgbuf.name[sizeof(msgbuf.name) - 1] = '\0';
+	msgbuf.format[sizeof(msgbuf.format) - 1] = '\0';
+	msgbuf.extra_display[sizeof(msgbuf.extra_display) - 1] = '\0';
+
+	pv_state_set_format(state, msgbuf.progress, msgbuf.timer,
+			    msgbuf.eta, msgbuf.fineta, msgbuf.rate,
+			    msgbuf.average_rate,
+			    msgbuf.bytes, msgbuf.bufpercent,
+			    msgbuf.lastwritten, '\0' == msgbuf.name[0] ? NULL : msgbuf.name);
+
+	if (msgbuf.rate_limit > 0)
+		pv_state_rate_limit_set(state, msgbuf.rate_limit);
+	if (msgbuf.buffer_size > 0) {
+		pv_state_target_buffer_size_set(state, msgbuf.buffer_size);
+	}
+	if (msgbuf.size > 0)
+		pv_state_size_set(state, msgbuf.size);
+	if (msgbuf.interval > 0)
+		pv_state_interval_set(state, msgbuf.interval);
+	if (msgbuf.width > 0 && msgbuf.width_set_manually)
+		pv_state_width_set(state, msgbuf.width, msgbuf.width_set_manually);
+	if (msgbuf.height > 0 && msgbuf.height_set_manually)
+		pv_state_height_set(state, msgbuf.height, msgbuf.height_set_manually);
+	if (msgbuf.format[0] != '\0')
+		pv_state_format_string_set(state, msgbuf.format);
+	if (msgbuf.extra_display[0] != '\0')
+		pv_state_extra_display_set(state, msgbuf.extra_display);
+
+	return true;
+}
+
+
+/*
+ * Check for a --query message (SIGUSR1).
+ *
+ * If a type 0 message was received (query), then write a type 1 (response)
+ * message to the control file and send a SIGUSR1 to the sending process.
+ *
+ * If a type 1 message was received (response), update the state from the
+ * message in the control file.
+ *
+ * In both cases, the receiver of the message deletes its control file.
+ *
+ * The state transferred by message is transfer.elapsed_seconds,
+ * transfer.transferred, and control.size.
+ *
+ * Returns true if a signal was received and dealt with, false otherwise.
+ *
+ * If match_sender is not zero, then ignores the signal and returns false if
+ * the sending PID is not match_sender.
+ */
+static bool pv__rxsignal_usr1(pvstate_t state, pid_t match_sender)
+{
+	pid_t signal_sender;
+	char control_filename[4096];	 /* flawfinder: ignore */
+	FILE *control_fptr;
+	struct query_msg msgbuf;
+
+	/* flawfinder rationale: as above. */
+
+	/*
+	 * Return early if a SIGUSR1 signal has not been received.
+	 */
+	signal_sender = 0;
+	if (!pv_sigusr1_received(state, &signal_sender))
+		return false;
+
+	/*
+	 * If match_sender was specified, ignore the signal if the sender
+	 * doesn't match.
+	 */
+	if ((0 != match_sender) && (signal_sender != match_sender)) {
+		debug("%s=%d, %s=%d - %s", "match_sender", match_sender, "signal_sender", signal_sender,
+		      "ignoring USR1");
+		return false;
+	}
+
+	/*
+	 * Note that we use debug() rather than pv_error() here so that the
+	 * display of a running pv doesn't get interrupted by, for example,
+	 * a querying pv being terminated.
+	 */
+
+	memset(control_filename, 0, sizeof(control_filename));
+	control_fptr = pv_open_controlfile(control_filename, sizeof(control_filename), signal_sender, SIGUSR1, false);
+	if (NULL == control_fptr) {
+		debug("%s: %s", control_filename, strerror(errno));
+		return false;
+	}
+
+	/*
+	 * Read the message buffer from the remote control file, close it,
+	 * and delete it.
+	 */
+	if (1 != fread(&msgbuf, sizeof(msgbuf), 1, control_fptr)) {
+		debug("fread: %s", strerror(errno));
+		(void) fclose(control_fptr);
+		return false;
+	}
+
+	if (0 != fclose(control_fptr)) {
+		debug("fclose: %s", strerror(errno));
+		return false;
+	}
+
+	debug("%s: %s", "removing", control_filename);
+	if (0 != remove(control_filename)) {
+		debug("remove: %s", strerror(errno));
+		return false;
+	}
+
+	if (msgbuf.response) {
+		/* Response message - update local state. */
+		debug("%s: %d [%Lg, %ld, %ld]", "query response received", signal_sender, msgbuf.elapsed_seconds,
+		      msgbuf.transferred, msgbuf.size);
+		state->transfer.elapsed_seconds = msgbuf.elapsed_seconds;
+		state->transfer.transferred = msgbuf.transferred;
+		state->control.size = msgbuf.size;
+		return true;
+	}
+
+	/* Query message - transmit state to sender. */
+
+	debug("%s: %d", "query received", signal_sender);
+
+	msgbuf.elapsed_seconds = state->transfer.elapsed_seconds;
+	msgbuf.transferred = state->transfer.transferred;
+	msgbuf.size = state->control.size;
+	msgbuf.response = true;
+
+	memset(control_filename, 0, sizeof(control_filename));
+	control_fptr = pv_open_controlfile(control_filename, sizeof(control_filename), (pid_t) getpid(), SIGUSR1, true);
+	if (NULL == control_fptr) {
+		debug("%s", strerror(errno));
+		return true;		    /* true since the signal was received. */
+	}
+
+	if (1 != fwrite(&msgbuf, sizeof(msgbuf), 1, control_fptr)) {
+		debug("fwrite: %s", strerror(errno));
+		(void) fclose(control_fptr);
+		(void) remove(control_filename);
+		return true;		    /* as above. */
+	}
+
+	if (0 != fclose(control_fptr)) {
+		debug("fclose: %s", strerror(errno));
+		(void) remove(control_filename);
+		return true;
+	}
+
+	/*
+	 * Send a SIGUSR1 signal to the remote process, to tell it this
+	 * query response message is ready to read.
+	 */
+	if (kill((pid_t) (signal_sender), SIGUSR1) != 0) {
+		debug("%u: %s", signal_sender, strerror(errno));
+		(void) remove(control_filename);
+		return true;
+	}
+
+	debug("%s: %d", "query response sent", signal_sender);
+
+	return true;
+}
+
+
+/*
+ * Check for remote control messages.  For a SIGUSR2 (--remote), replace the
+ * current process's options with those being passed in.  For a SIGUSR1
+ * (--query), either receive transfer state from the sending process, or
+ * send our transfer state to the sending process, depending on the content
+ * of the message.
+ *
+ * NB --remote relies on pv_state_set_format() causing the output format to
+ * be reparsed.
+ *
+ * Returns true if a --remote message was received, false otherwise.
+ */
+bool pv_remote_check(pvstate_t state)
+{
+	bool received_remote;
+
+	received_remote = pv__rxsignal_usr2(state);
+	(void) pv__rxsignal_usr1(state, 0);
+
+	return received_remote;
+}
+
+
+/*
+ * Replace the transfer state with that of the given process, including the
+ * total transfer size.  If sizeptr is not NULL, the size is also copied to
+ * *sizeptr (this is so a caller can get the size without knowing the
+ * structure of pvstate_t).
+ *
+ * Returns nonzero on error.  If "silent" is false, reports the error.
+ */
+int pv_remote_transferstate_fetch(pvstate_t state, pid_t query, /*@null@ */ off_t * sizeptr, bool silent)
+{
+	char control_filename[4096];	 /* flawfinder: ignore */
+	FILE *control_fptr;
+	struct query_msg msgbuf;
+	pid_t signal_sender;
+	long timeout;
+	bool received;
+
+	/*
+	 * flawfinder rationale: buffer is large enough, explicitly zeroed,
+	 * and always bounded properly as we are only writing to it with
+	 * pv_snprintf().
+	 */
+
+	/*
+	 * Check that the remote process exists.
+	 */
+	if (kill((pid_t) (query), 0) != 0) {
+		if (!silent)
+			pv_error("%u: %s", query, strerror(errno));
+		return PV_ERROREXIT_REMOTE_OR_PID;
+	}
+
+	/* Set up the query message. */
+	memset(&msgbuf, 0, sizeof(msgbuf));
+	msgbuf.response = false;
+
+	/*
+	 * Get the filename and file stream to use.
+	 */
+	memset(control_filename, 0, sizeof(control_filename));
+	control_fptr = pv_open_controlfile(control_filename, sizeof(control_filename), (pid_t) getpid(), SIGUSR1, true);
+	if (NULL == control_fptr) {
+		if (!silent)
+			pv_error("%s", strerror(errno));
+		return PV_ERROREXIT_REMOTE_OR_PID;
+	}
+
+	/*
+	 * Write the message to the control file, and close it.
+	 */
+	if (1 != fwrite(&msgbuf, sizeof(msgbuf), 1, control_fptr)) {
+		if (!silent)
+			pv_error("%s", strerror(errno));
+		(void) fclose(control_fptr);
+		(void) remove(control_filename);
+		return PV_ERROREXIT_REMOTE_OR_PID;
+	}
+
+	if (0 != fclose(control_fptr)) {
+		if (!silent)
+			pv_error("%s", strerror(errno));
+		(void) remove(control_filename);
+		return PV_ERROREXIT_REMOTE_OR_PID;
+	}
+
+	/*
+	 * Send a SIGUSR1 signal to the remote process, to tell it a query
+	 * message is ready, after first clearing our own SIGUSR1 received
+	 * flag.
+	 */
+	signal_sender = 0;
+	(void) pv_sigusr1_received(state, &signal_sender);
+	if (kill((pid_t) (query), SIGUSR1) != 0) {
+		if (!silent)
+			pv_error("%u: %s", query, strerror(errno));
+		(void) remove(control_filename);
+		return PV_ERROREXIT_REMOTE_OR_PID;
+	}
+
+	debug("%s: %d", "query sent", query);
+
+	/*
+	 * Wait for a SIGUSR1 signal to be sent back with a query response
+	 * message.
+	 */
+
+	timeout = 1100000;
+	received = false;
+
+	while (timeout > 10000 && !received && 0 == state->flags.trigger_exit) {
+		struct timeval tv;
+
+		memset(&tv, 0, sizeof(tv));
+		tv.tv_sec = 0;
+		tv.tv_usec = 10000;
+		/*@-nullpass@ *//* splint: NULL is OK with select() */
+		(void) select(0, NULL, NULL, NULL, &tv);
+		/*@+nullpass@ */
+		timeout -= 10000;
+
+		if (pv__rxsignal_usr1(state, query)) {
+			debug("%s", "response received");
+			received = true;
+			if (NULL != sizeptr)
+				*sizeptr = state->control.size;
+		}
+	}
+
+	/*
+	 * Remove the control file in case it still exists - the other
+	 * process should have removed it.
+	 */
+	debug("%s: %s", "cleaning up", control_filename);
+	(void) remove(control_filename);
+
+	/*
+	 * Return 0 if the message was received.
+	 */
+	if (received)
+		return 0;
+
+	/*@-mustfreefresh@ */
+	/*
+	 * splint note: the gettext calls made by _() cause memory leak
+	 * warnings, but in this case it's unavoidable, and mitigated by the
+	 * fact we only translate each string once.
+	 */
+	if (!silent)
+		pv_error("%u: %s", query, _("message not received"));
+	return PV_ERROREXIT_REMOTE_OR_PID;
+	/*@+mustfreefresh @ */
+
+}
+
+
+#else				/* !PV_REMOTE_CONTROL */
+
+/*
+ * Dummy stubs for remote control when we don't have PV_REMOTE_CONTROL.
+ */
+
+bool pv_remote_check( /*@unused@ */  __attribute__((unused)) pvstate_t state)
+{
+}
+
+
+int pv_remote_set(			 /*@unused@ */
+			 __attribute__((unused)) pvstate_t state, /*@unused@ */  __attribute__((unused)) pid_t remote)
+{
+	/*@-mustfreefresh@ *//* splint - see above */
+	pv_error("%s", _("SA_SIGINFO not supported on this system"));
+	/*@+mustfreefresh@ */
+	return PV_ERROREXIT_REMOTE_OR_PID;
+}
+
+
+int pv_remote_transferstate_fetch(	 /*@unused@ */
+					 __attribute__((unused)) pvstate_t state,
+					 /*@unused@ */
+					 __attribute__((unused)) pid_t query,
+					 /*@null@ */
+					 /*@unused@ */
+					 __attribute__((unused)) off_t * sizeptr,
+					 /*@unused@ */
+					 __attribute__((unused))
+					 bool silent)
+{
+	/*@-mustfreefresh@ *//* splint - see above */
+	fprintf(stderr, "%s\n", _("SA_SIGINFO not supported on this system"));
+	/*@+mustfreefresh@ */
+	return PV_ERROREXIT_REMOTE_OR_PID;
+}
+
+#endif				/* PV_REMOTE_CONTROL */

src/pv/signal.c

@@ -1,50 +1,114 @@
 /*
  * Signal handling functions.
  *
- * Copyright 2002-2008, 2010, 2012-2015, 2017, 2021, 2023 Andrew Wood
+ * Copyright 2002-2008, 2010, 2012-2015, 2017, 2021, 2023-2025 Andrew Wood
  *
- * Distributed under the Artistic License v2.0; see `doc/COPYING'.
+ * License GPLv3+: GNU GPL version 3 or later; see `docs/COPYING'.
  */
 
 #include "config.h"
 #include "pv.h"
 #include "pv-internal.h"
 
+#include <string.h>
+#include <errno.h>
 #include <signal.h>
 #include <termios.h>
-#include <time.h>
 #include <unistd.h>
 #include <sys/stat.h>
 #include <fcntl.h>
 
 #ifdef HAVE_IPC
-void pv_crs_needreinit(pvstate_t);
+void pv_crs_needreinit(pvcursorstate_t);
 #endif
 
-static pvstate_t pv_sig_state = NULL;
+/*@null@*/ static pvstate_t pv_sig_state = NULL;
 
 
 /*
- * Handle SIGTTOU (tty output for background process) by redirecting stderr
- * to /dev/null, so that we can be stopped and backgrounded without messing
- * up the terminal. We store the old stderr file descriptor so that on a
- * subsequent SIGCONT we can try writing to the terminal again, in case we
- * get backgrounded and later get foregrounded again.
+ * Ensure that terminal attribute TOSTOP is set.  If we have to set it,
+ * record that fact by setting "clear_tty_tostop_on_exit" to 1, so that in
+ * pv_sig_fini() we can turn it back off again.
+ *
+ * In "-c" mode with IPC, then if we have to set TOSTOP, we also tell the
+ * other PV instances about it via the shared "tty_tostop_added" flag, so
+ * those instances can set their own on-exit flag, meaning that if any of
+ * the PV instances set it, the last one to exit will clear it.
  */
-static void pv_sig_ttou( __attribute__((unused))
-			int s)
+static void pv_sig_ensure_tty_tostop()
 {
-	int fd;
+	struct termios terminal_attributes;
 
-	fd = open("/dev/null", O_RDWR);
-	if (fd < 0)
+	if (NULL == pv_sig_state)
 		return;
 
-	if (-1 == pv_sig_state->pv_sig_old_stderr)
-		pv_sig_state->pv_sig_old_stderr = dup(STDERR_FILENO);
+	/* Can't look at terminal flags if backgrounded. */
+	if (1 == pv_sig_state->flags.suspend_stderr)
+		return;
 
-	dup2(fd, STDERR_FILENO);
-	close(fd);
+	if (0 != tcgetattr(STDERR_FILENO, &terminal_attributes)) {
+		debug("%s: %s", "failed to read terminal attributes", strerror(errno));
+		return;
+	}
+
+	/* Can't set terminal flags if backgrounded. */
+	if (1 == pv_sig_state->flags.suspend_stderr)
+		return;
+
+	if (0 == (terminal_attributes.c_lflag & TOSTOP)) {
+		terminal_attributes.c_lflag |= TOSTOP;
+		if (0 == tcsetattr(STDERR_FILENO, TCSANOW, &terminal_attributes)) {
+			pv_sig_state->flags.clear_tty_tostop_on_exit = 1;
+			debug("%s", "set terminal TOSTOP attribute");
+#if HAVE_IPC
+			/*
+			 * In "-c" mode with IPC, make all "pv -c" instances
+			 * aware that we set TOSTOP, so the last one can
+			 * clear it on exit.
+			 */
+			if (pv_sig_state->control.cursor && (NULL != pv_sig_state->cursor.shared)
+			    && (!pv_sig_state->cursor.noipc)) {
+				pv_sig_state->cursor.shared->tty_tostop_added = true;
+			}
+#endif
+		} else {
+			debug("%s: %s", "failed to set terminal TOSTOP attribute", strerror(errno));
+		}
+	}
+}
+
+/*
+ * Handle SIGTTOU (tty output for background process) by setting the flag to
+ * suspend writes to stderr, so that we can be stopped and backgrounded
+ * without messing up the terminal.  On a subsequent SIGCONT we will try
+ * writing to the terminal again, in case we get backgrounded and later get
+ * foregrounded again.
+ *
+ * When we get backgrounded and cause a SIGTTOU, the rest of the pipeline
+ * gets stopped too, so transfers involving pipelines need us to send a
+ * SIGCONT to the rest of the process group here, otherwise backgrounding
+ * stops transfers involving pipes.
+ */
+static void pv_sig_ttou( /*@unused@ */  __attribute__((unused))
+			int s)
+{
+	if (NULL == pv_sig_state)
+		return;
+
+	if (1 != pv_sig_state->flags.suspend_stderr) {
+		debug("%s", "SIGTTOU - suspending stderr");
+		pv_sig_state->flags.suspend_stderr = 1;
+		/* Also tell the SIGCONT handler to do nothing next time. */
+		pv_sig_state->flags.skip_next_sigcont++;
+		/* Raise an immediate SIGCONT to bring the rest of the pipeline back up. */
+		/*@-unrecog@ *//* splint doesn't know about killpg() */
+		if (0 != killpg(getpgrp(), SIGCONT)) {
+			debug("%s: %s", "killpg", strerror(errno));
+		}
+		/*@+unrecog@ */
+	} else {
+		debug("%s", "SIGTTOU - but stderr was already suspended");
+	}
 }
 
 
@@ -52,86 +116,230 @@ static void pv_sig_ttou( __attribute__((unused))
  * Handle SIGTSTP (stop typed at tty) by storing the time the signal
  * happened for later use by pv_sig_cont(), and then stopping the process.
  */
-static void pv_sig_tstp( __attribute__((unused))
+static void pv_sig_tstp( /*@unused@ */  __attribute__((unused))
 			int s)
 {
-	gettimeofday(&(pv_sig_state->pv_sig_tstp_time), NULL);
-	raise(SIGSTOP);
+	if (NULL == pv_sig_state)
+		return;
+	pv_elapsedtime_read(&(pv_sig_state->signal.when_tstp_arrived));
+	if (0 != raise(SIGSTOP)) {
+		debug("%s: %s", "raise", strerror(errno));
+	}
 }
 
 
 /*
  * Handle SIGCONT (continue if stopped) by adding the elapsed time since the
  * last SIGTSTP to the elapsed time offset, and by trying to write to the
- * terminal again (by replacing the /dev/null stderr with the old stderr).
+ * terminal again.
  */
-static void pv_sig_cont( __attribute__((unused))
+static void pv_sig_cont( /*@unused@ */  __attribute__((unused))
 			int s)
 {
-	struct timeval tv;
-	struct termios t;
+	struct timespec current_time;
+	struct timespec time_spent_stopped;
 
-	pv_sig_state->pv_sig_newsize = 1;
-
-	if (0 == pv_sig_state->pv_sig_tstp_time.tv_sec) {
-		tcgetattr(STDERR_FILENO, &t);
-		t.c_lflag |= TOSTOP;
-		tcsetattr(STDERR_FILENO, TCSANOW, &t);
-#ifdef HAVE_IPC
-		pv_crs_needreinit(pv_sig_state);
-#endif
+	if (NULL == pv_sig_state)
 		return;
+
+	if (pv_sig_state->flags.skip_next_sigcont > 0) {
+		debug("%s: %d", "SIGCONT received but ignored - current value of skip_next_sigcont",
+		      pv_sig_state->flags.skip_next_sigcont);
+		pv_sig_state->flags.skip_next_sigcont--;
+		return;
+	} else if (pv_sig_state->flags.skip_next_sigcont < 0) {
+		pv_sig_state->flags.skip_next_sigcont = 0;
+		debug("%s", "skip_next_sigcont underrun cleared");
 	}
 
-	gettimeofday(&tv, NULL);
+	debug("%s: %d", "SIGCONT received - current value of suspend_stderr", pv_sig_state->flags.suspend_stderr);
 
-	pv_sig_state->pv_sig_toffset.tv_sec += (tv.tv_sec - pv_sig_state->pv_sig_tstp_time.tv_sec);
-	pv_sig_state->pv_sig_toffset.tv_usec += (tv.tv_usec - pv_sig_state->pv_sig_tstp_time.tv_usec);
-	if (pv_sig_state->pv_sig_toffset.tv_usec >= 1000000) {
-		pv_sig_state->pv_sig_toffset.tv_sec++;
-		pv_sig_state->pv_sig_toffset.tv_usec -= 1000000;
-	}
-	if (pv_sig_state->pv_sig_toffset.tv_usec < 0) {
-		pv_sig_state->pv_sig_toffset.tv_sec--;
-		pv_sig_state->pv_sig_toffset.tv_usec += 1000000;
+	pv_sig_state->flags.terminal_resized = 1;
+
+	/*
+	 * We can only make the time adjustments if this SIGCONT followed a
+	 * SIGTSTP such that we have a stop time.
+	 */
+	if (0 != pv_sig_state->signal.when_tstp_arrived.tv_sec) {
+
+		memset(&current_time, 0, sizeof(current_time));
+		memset(&time_spent_stopped, 0, sizeof(time_spent_stopped));
+
+		pv_elapsedtime_read(&current_time);
+
+		/* time spent stopped = current time - time SIGTSTP received */
+		pv_elapsedtime_subtract(&time_spent_stopped, &current_time, &(pv_sig_state->signal.when_tstp_arrived));
+
+		/* add time spent stopped the total stopped-time count */
+		pv_elapsedtime_add(&(pv_sig_state->signal.total_stoppage_time),
+				   &(pv_sig_state->signal.total_stoppage_time), &time_spent_stopped);
+
+		/* In watchfd mode, update the stoppage time of all watched fds. */
+		if (pv_sig_state->watchfd.count > 0 && NULL != pv_sig_state->watchfd.watching) {
+			unsigned int watch_idx;
+
+			for (watch_idx = 0; watch_idx < pv_sig_state->watchfd.count; watch_idx++) {
+				int info_idx;
+
+				if (pv_sig_state->watchfd.watching[watch_idx].finished)
+					continue;
+
+				if (NULL == pv_sig_state->watchfd.watching[watch_idx].info_array)
+					continue;
+
+				for (info_idx = 0; info_idx < pv_sig_state->watchfd.watching[watch_idx].array_length;
+				     info_idx++) {
+					pvwatchfd_t info_item =
+					    &(pv_sig_state->watchfd.watching[watch_idx].info_array[info_idx]);
+
+					if (info_item->unused)
+						continue;
+
+					if (!info_item->displayable)
+						continue;
+
+					pv_elapsedtime_add(&(info_item->total_stoppage_time),
+							   &(info_item->total_stoppage_time), &time_spent_stopped);
+				}
+			}
+		}
+
+		/* reset the SIGTSTP receipt time */
+		pv_elapsedtime_zero(&(pv_sig_state->signal.when_tstp_arrived));
 	}
 
-	pv_sig_state->pv_sig_tstp_time.tv_sec = 0;
-	pv_sig_state->pv_sig_tstp_time.tv_usec = 0;
-
-	if (pv_sig_state->pv_sig_old_stderr != -1) {
-		dup2(pv_sig_state->pv_sig_old_stderr, STDERR_FILENO);
-		close(pv_sig_state->pv_sig_old_stderr);
-		pv_sig_state->pv_sig_old_stderr = -1;
+	/*
+	 * Try resuming our use of stderr, if we had suspended it, but only
+	 * if we're now in the foreground.
+	 */
+	if (1 == pv_sig_state->flags.suspend_stderr) {
+		if (pv_in_foreground()) {
+			debug("%s", "SIGCONT - resuming stderr");
+			pv_sig_state->flags.suspend_stderr = 0;
+		} else {
+			debug("%s", "SIGCONT but still in background - not resuming stderr");
+		}
 	}
 
-	tcgetattr(STDERR_FILENO, &t);
-	t.c_lflag |= TOSTOP;
-	tcsetattr(STDERR_FILENO, TCSANOW, &t);
-
+	if (0 == pv_sig_state->flags.suspend_stderr) {
+		pv_sig_ensure_tty_tostop();
 #ifdef HAVE_IPC
-	pv_crs_needreinit(pv_sig_state);
+		pv_crs_needreinit(&(pv_sig_state->cursor));
 #endif
+	}
 }
 
 
+#ifdef SIGWINCH
 /*
  * Handle SIGWINCH (window size changed) by setting a flag.
  */
-static void pv_sig_winch( __attribute__((unused))
+static void pv_sig_winch( /*@unused@ */  __attribute__((unused))
 			 int s)
 {
-	pv_sig_state->pv_sig_newsize = 1;
+	if (NULL == pv_sig_state)
+		return;
+	pv_sig_state->flags.terminal_resized = 1;
 }
+#endif
 
 
 /*
  * Handle termination signals by setting the abort flag.
  */
-static void pv_sig_term( __attribute__((unused))
+static void pv_sig_term( /*@unused@ */  __attribute__((unused))
 			int s)
 {
-	pv_sig_state->pv_sig_abort = 1;
+	if (NULL == pv_sig_state)
+		return;
+	pv_sig_state->flags.trigger_exit = 1;
+}
+
+
+#ifdef PV_REMOTE_CONTROL
+/*
+ * Handle a SIGUSR2 by setting a flag to say we received it, after recording
+ * the sending PID.
+ */
+static void pv_sig_usr2( /*@unused@ */  __attribute__((unused))
+			int sig, siginfo_t * info, /*@unused@ */  __attribute__((unused))
+			void *ucontext)
+{
+	if (NULL == pv_sig_state)
+		return;
+	if (NULL == info)
+		return;
+	pv_sig_state->signal.sender_usr2 = info->si_pid;
+	pv_sig_state->signal.rxusr2 = 1;
+}
+
+
+/*
+ * Return true if a SIGUSR2 signal has been received since the last time
+ * this function was called, populating *pid with the sending PID if so.
+ */
+bool pv_sigusr2_received(pvstate_t state, pid_t * pid)
+{
+	if (NULL == state)
+		return false;
+	if (0 == state->signal.rxusr2)
+		return false;
+	if (NULL != pid)
+		*pid = state->signal.sender_usr2;
+	state->signal.rxusr2 = 0;
+	return true;
+}
+
+
+/*
+ * Handle a SIGUSR1 by setting a flag to say we received it, after recording
+ * the sending PID.
+ */
+static void pv_sig_usr1( /*@unused@ */  __attribute__((unused))
+			int sig, siginfo_t * info, /*@unused@ */  __attribute__((unused))
+			void *ucontext)
+{
+	if (NULL == pv_sig_state)
+		return;
+	if (NULL == info)
+		return;
+	pv_sig_state->signal.sender_usr1 = info->si_pid;
+	pv_sig_state->signal.rxusr1 = 1;
+}
+
+
+/*
+ * Return true if a SIGUSR1 signal has been received since the last time
+ * this function was called, populating *pid with the sending PID if so.
+ */
+bool pv_sigusr1_received(pvstate_t state, pid_t * pid)
+{
+	if (NULL == state)
+		return false;
+	if (0 == state->signal.rxusr1)
+		return false;
+	if (NULL != pid)
+		*pid = state->signal.sender_usr1;
+	state->signal.rxusr1 = 0;
+	return true;
+}
+
+#endif				/* PV_REMOTE_CONTROL */
+
+
+/*
+ * Handle alarm signals by doing nothing.
+ *
+ * Note that we have to use a signal handler like this, instead of using
+ * SIG_IGN, because if we ignore the signal entirely, it does nothing,
+ * including not interrupting blocking write() calls - which is what we're
+ * using alarm signals for in the first place.
+ */
+static void pv_sig_alrm( /*@unused@ */  __attribute__((unused))
+			int s)
+{
+	debug("%s", "SIGALRM received");
+	/* Do nothing. */
 }
 
 
@@ -140,42 +348,56 @@ static void pv_sig_term( __attribute__((unused))
  */
 void pv_sig_init(pvstate_t state)
 {
-	struct sigaction sa;
+	static struct sigaction sa;
+
+	memset(&sa, 0, sizeof(sa));
+
+	/*
+	 * Note that wherever we use a "struct sigaction", we declare it
+	 * static and explicitly zero it before use, because it may contain
+	 * deeper structures (e.g. "sigset_t") which trigger splint
+	 * warnings about potential memory leaks.
+	 */
 
 	pv_sig_state = state;
 
-	pv_sig_state->pv_sig_old_stderr = -1;
-	pv_sig_state->pv_sig_tstp_time.tv_sec = 0;
-	pv_sig_state->pv_sig_tstp_time.tv_usec = 0;
-	pv_sig_state->pv_sig_toffset.tv_sec = 0;
-	pv_sig_state->pv_sig_toffset.tv_usec = 0;
+	pv_sig_state->flags.suspend_stderr = 0;
+	pv_elapsedtime_zero(&(pv_sig_state->signal.when_tstp_arrived));
+	pv_elapsedtime_zero(&(pv_sig_state->signal.total_stoppage_time));
 
 	/*
-	 * Ignore SIGPIPE, so we don't die if stdout is a pipe and the other
-	 * end closes unexpectedly.
+	 * Note that we cast all sigemptyset() and sigaction() return values
+	 * to void, because there's nothing we can reasonably do about any
+	 * conceivable error they may return.
+	 */
+
+	/*
+	 * Ignore SIGPIPE, so we don't die if the output is a pipe and the
+	 * other end closes unexpectedly.
 	 */
 	sa.sa_handler = SIG_IGN;
-	sigemptyset(&(sa.sa_mask));
+	(void) sigemptyset(&(sa.sa_mask));
 	sa.sa_flags = 0;
-	sigaction(SIGPIPE, &sa, &(pv_sig_state->pv_sig_old_sigpipe));
+	(void) sigaction(SIGPIPE, &sa, &(pv_sig_state->signal.old_sigpipe));
 
 	/*
 	 * Handle SIGTTOU by continuing with output switched off, so that we
 	 * can be stopped and backgrounded without messing up the terminal.
 	 */
+	pv_sig_state->flags.skip_next_sigcont = 0;
 	sa.sa_handler = pv_sig_ttou;
-	sigemptyset(&(sa.sa_mask));
+	(void) sigemptyset(&(sa.sa_mask));
 	sa.sa_flags = 0;
-	sigaction(SIGTTOU, &sa, &(pv_sig_state->pv_sig_old_sigttou));
+	(void) sigaction(SIGTTOU, &sa, &(pv_sig_state->signal.old_sigttou));
 
 	/*
 	 * Handle SIGTSTP by storing the time the signal happened for later
 	 * use by pv_sig_cont(), and then stopping the process.
 	 */
 	sa.sa_handler = pv_sig_tstp;
-	sigemptyset(&(sa.sa_mask));
+	(void) sigemptyset(&(sa.sa_mask));
 	sa.sa_flags = 0;
-	sigaction(SIGTSTP, &sa, &(pv_sig_state->pv_sig_old_sigtstp));
+	(void) sigaction(SIGTSTP, &sa, &(pv_sig_state->signal.old_sigtstp));
 
 	/*
 	 * Handle SIGCONT by adding the elapsed time since the last SIGTSTP
@@ -183,53 +405,158 @@ void pv_sig_init(pvstate_t state)
 	 * terminal again.
 	 */
 	sa.sa_handler = pv_sig_cont;
-	sigemptyset(&(sa.sa_mask));
+	(void) sigemptyset(&(sa.sa_mask));
 	sa.sa_flags = 0;
-	sigaction(SIGCONT, &sa, &(pv_sig_state->pv_sig_old_sigcont));
+	(void) sigaction(SIGCONT, &sa, &(pv_sig_state->signal.old_sigcont));
 
 	/*
 	 * Handle SIGWINCH by setting a flag to let the main loop know it
 	 * has to reread the terminal size.
 	 */
+#ifdef SIGWINCH
 	sa.sa_handler = pv_sig_winch;
-	sigemptyset(&(sa.sa_mask));
+	(void) sigemptyset(&(sa.sa_mask));
 	sa.sa_flags = 0;
-	sigaction(SIGWINCH, &sa, &(pv_sig_state->pv_sig_old_sigwinch));
+	(void) sigaction(SIGWINCH, &sa, &(pv_sig_state->signal.old_sigwinch));
+#endif
 
 	/*
 	 * Handle SIGINT, SIGHUP, SIGTERM by setting a flag to let the
 	 * main loop know it should quit now.
 	 */
 	sa.sa_handler = pv_sig_term;
-	sigemptyset(&(sa.sa_mask));
+	(void) sigemptyset(&(sa.sa_mask));
 	sa.sa_flags = 0;
-	sigaction(SIGINT, &sa, &(pv_sig_state->pv_sig_old_sigint));
+	(void) sigaction(SIGINT, &sa, &(pv_sig_state->signal.old_sigint));
 
 	sa.sa_handler = pv_sig_term;
-	sigemptyset(&(sa.sa_mask));
+	(void) sigemptyset(&(sa.sa_mask));
 	sa.sa_flags = 0;
-	sigaction(SIGHUP, &sa, &(pv_sig_state->pv_sig_old_sighup));
+	(void) sigaction(SIGHUP, &sa, &(pv_sig_state->signal.old_sighup));
 
 	sa.sa_handler = pv_sig_term;
-	sigemptyset(&(sa.sa_mask));
+	(void) sigemptyset(&(sa.sa_mask));
 	sa.sa_flags = 0;
-	sigaction(SIGTERM, &sa, &(pv_sig_state->pv_sig_old_sigterm));
+	(void) sigaction(SIGTERM, &sa, &(pv_sig_state->signal.old_sigterm));
+
+#ifdef PV_REMOTE_CONTROL
+	/*
+	 * Handle SIGUSR2 by setting a flag to say the signal has been
+	 * received, and storing the sending process's PID.
+	 */
+	memset(&sa, 0, sizeof(sa));
+	sa.sa_sigaction = pv_sig_usr2;
+	(void) sigemptyset(&(sa.sa_mask));
+	/*@-unrecog@ *//* splint doesn't know about SA_SIGINFO */
+	sa.sa_flags = SA_SIGINFO;
+	/*@+unrecog@ */
+	(void) sigaction(SIGUSR2, &sa, &(pv_sig_state->signal.old_sigusr2));
+	memset(&sa, 0, sizeof(sa));
+
+	/*
+	 * Handle SIGUSR1 by setting a flag to say the signal has been
+	 * received, and storing the sending process's PID.
+	 */
+	memset(&sa, 0, sizeof(sa));
+	sa.sa_sigaction = pv_sig_usr1;
+	(void) sigemptyset(&(sa.sa_mask));
+	/*@-unrecog@ *//* splint doesn't know about SA_SIGINFO */
+	sa.sa_flags = SA_SIGINFO;
+	/*@+unrecog@ */
+	(void) sigaction(SIGUSR1, &sa, &(pv_sig_state->signal.old_sigusr1));
+	memset(&sa, 0, sizeof(sa));
+#endif				/* PV_REMOTE_CONTROL */
+
+	/*
+	 * Ensure that the TOSTOP terminal attribute is set, so that a
+	 * SIGTTOU signal will be raised if we try to write to the terminal
+	 * while backgrounded (see the SIGTTOU handler above).
+	 */
+	pv_sig_ensure_tty_tostop();
+
+	/*
+	 * Handle SIGALRM by doing nothing, so we can use alarms or interval
+	 * timers to interrupt blocking writes (returning EINTR).
+	 */
+	sa.sa_handler = pv_sig_alrm;
+	(void) sigemptyset(&(sa.sa_mask));
+	sa.sa_flags = 0;
+	(void) sigaction(SIGALRM, &sa, &(pv_sig_state->signal.old_sigalrm));
 }
 
 
 /*
- * Shut down signal handling.
+ * Shut down signal handling.  If we had set the TOSTOP terminal attribute,
+ * and we're in the foreground, also turn that off (though if we're in
+ * cursor "-c" mode, only do that if we're the last PV instance, otherwise
+ * leave the terminal alone).
  */
-void pv_sig_fini( __attribute__((unused)) pvstate_t state)
+void pv_sig_fini( /*@unused@ */  __attribute__((unused)) pvstate_t state)
 {
-	sigaction(SIGPIPE, &(pv_sig_state->pv_sig_old_sigpipe), NULL);
-	sigaction(SIGTTOU, &(pv_sig_state->pv_sig_old_sigttou), NULL);
-	sigaction(SIGTSTP, &(pv_sig_state->pv_sig_old_sigtstp), NULL);
-	sigaction(SIGCONT, &(pv_sig_state->pv_sig_old_sigcont), NULL);
-	sigaction(SIGWINCH, &(pv_sig_state->pv_sig_old_sigwinch), NULL);
-	sigaction(SIGINT, &(pv_sig_state->pv_sig_old_sigint), NULL);
-	sigaction(SIGHUP, &(pv_sig_state->pv_sig_old_sighup), NULL);
-	sigaction(SIGTERM, &(pv_sig_state->pv_sig_old_sigterm), NULL);
+	bool need_to_clear_tostop = false;
+
+	if (NULL == pv_sig_state)
+		return;
+
+	(void) sigaction(SIGPIPE, &(pv_sig_state->signal.old_sigpipe), NULL);
+	(void) sigaction(SIGTTOU, &(pv_sig_state->signal.old_sigttou), NULL);
+	(void) sigaction(SIGTSTP, &(pv_sig_state->signal.old_sigtstp), NULL);
+	(void) sigaction(SIGCONT, &(pv_sig_state->signal.old_sigcont), NULL);
+#ifdef SIGWINCH
+	(void) sigaction(SIGWINCH, &(pv_sig_state->signal.old_sigwinch), NULL);
+#endif
+	(void) sigaction(SIGINT, &(pv_sig_state->signal.old_sigint), NULL);
+	(void) sigaction(SIGHUP, &(pv_sig_state->signal.old_sighup), NULL);
+	(void) sigaction(SIGTERM, &(pv_sig_state->signal.old_sigterm), NULL);
+#ifdef PV_REMOTE_CONTROL
+	(void) sigaction(SIGUSR2, &(pv_sig_state->signal.old_sigusr2), NULL);
+	(void) sigaction(SIGUSR1, &(pv_sig_state->signal.old_sigusr1), NULL);
+#endif
+	(void) sigaction(SIGALRM, &(pv_sig_state->signal.old_sigalrm), NULL);
+
+	need_to_clear_tostop = (1 == pv_sig_state->flags.clear_tty_tostop_on_exit) ? true : false;
+
+	if (pv_sig_state->control.cursor) {
+#ifdef HAVE_IPC
+		/*
+		 * We won't clear TOSTOP if other "pv -c" instances
+		 * were still running when pv_crs_fini() ran.
+		 *
+		 * TODO: we need a better way to determine if we're the last
+		 * "pv" left.
+		 */
+		if (pv_sig_state->control.cursor && pv_sig_state->cursor.pvcount > 1) {
+			need_to_clear_tostop = false;
+		}
+#else				/* !HAVE_IPC */
+		/*
+		 * Without IPC we can't tell whether the other "pv -c"
+		 * instances in the pipeline have finished so we will just
+		 * have to clear TOSTOP anyway.
+		 */
+#endif				/* !HAVE_IPC */
+	}
+
+	debug("%s=%s", "need_to_clear_tostop", need_to_clear_tostop ? "true" : "false");
+
+	if (need_to_clear_tostop && pv_in_foreground()) {
+		struct termios terminal_attributes;
+
+		debug("%s", "about to to clear TOSTOP terminal attribute if it is set");
+
+		if (0 != tcgetattr(STDERR_FILENO, &terminal_attributes)) {
+			debug("%s: %s", "tcgetattr", strerror(errno));
+		} else if (0 != (terminal_attributes.c_lflag & TOSTOP)) {
+			terminal_attributes.c_lflag -= TOSTOP;
+			if (0 == tcsetattr(STDERR_FILENO, TCSANOW, &terminal_attributes)) {
+				debug("%s", "cleared TOSTOP terminal attribute");
+			} else {
+				debug("%s: %s", "failed to clear TOSTOP terminal attribute", strerror(errno));
+			}
+		}
+
+		pv_sig_state->flags.clear_tty_tostop_on_exit = 0;
+	}
 }
 
 
@@ -238,17 +565,17 @@ void pv_sig_fini( __attribute__((unused)) pvstate_t state)
  */
 void pv_sig_nopause(void)
 {
-	struct sigaction sa;
+	sigset_t signal_set, signal_oldset;
 
-	sa.sa_handler = SIG_IGN;
-	sigemptyset(&(sa.sa_mask));
-	sa.sa_flags = 0;
-	sigaction(SIGTSTP, &sa, NULL);
+	debug("%s", "blocking SIGTSTP, SIGCONT");
 
-	sa.sa_handler = SIG_DFL;
-	sigemptyset(&(sa.sa_mask));
-	sa.sa_flags = 0;
-	sigaction(SIGCONT, &sa, NULL);
+	(void) sigemptyset(&signal_set);
+	(void) sigaddset(&signal_set, SIGTSTP);
+	(void) sigaddset(&signal_set, SIGCONT);
+
+	if (0 != sigprocmask(SIG_BLOCK, &signal_set, &signal_oldset)) {
+		debug("%s: %s", "failed to set signal mask", strerror(errno));
+	}
 }
 
 
@@ -257,50 +584,48 @@ void pv_sig_nopause(void)
  */
 void pv_sig_allowpause(void)
 {
-	struct sigaction sa;
+	sigset_t signal_set, signal_oldset;
 
-	sa.sa_handler = pv_sig_tstp;
-	sigemptyset(&(sa.sa_mask));
-	sa.sa_flags = 0;
-	sigaction(SIGTSTP, &sa, NULL);
+	debug("%s", "unblocking SIGTSTP, SIGCONT");
 
-	sa.sa_handler = pv_sig_cont;
-	sigemptyset(&(sa.sa_mask));
-	sa.sa_flags = 0;
-	sigaction(SIGCONT, &sa, NULL);
+	(void) sigemptyset(&signal_set);
+	(void) sigaddset(&signal_set, SIGTSTP);
+	(void) sigaddset(&signal_set, SIGCONT);
+
+	if (0 != sigprocmask(SIG_UNBLOCK, &signal_set, &signal_oldset)) {
+		debug("%s: %s", "failed to set signal mask", strerror(errno));
+	}
 }
 
 
 /*
- * If we have redirected stderr to /dev/null, check every second or so to
- * see whether we can write to the terminal again - this is so that if we
- * get backgrounded, then foregrounded again, we start writing to the
- * terminal again.
+ * If we have suspended stderr, check every second or so to see whether we
+ * can write to the terminal again - this is so that if we get backgrounded,
+ * then foregrounded again, we start writing to the terminal again.
  */
 void pv_sig_checkbg(void)
 {
 	static time_t next_check = 0;
-	struct termios t;
+
+	if (NULL == pv_sig_state)
+		return;
 
 	if (time(NULL) < next_check)
 		return;
 
 	next_check = time(NULL) + 1;
 
-	if (-1 == pv_sig_state->pv_sig_old_stderr)
+	if (0 == pv_sig_state->flags.suspend_stderr)
 		return;
 
-	dup2(pv_sig_state->pv_sig_old_stderr, STDERR_FILENO);
-	close(pv_sig_state->pv_sig_old_stderr);
-	pv_sig_state->pv_sig_old_stderr = -1;
+	if (!pv_in_foreground())
+		return;
 
-	tcgetattr(STDERR_FILENO, &t);
-	t.c_lflag |= TOSTOP;
-	tcsetattr(STDERR_FILENO, TCSANOW, &t);
+	debug("%s: %s", "pv_sig_checkbg", "attempting to resume stderr");
+	pv_sig_state->flags.suspend_stderr = 0;
 
+	pv_sig_ensure_tty_tostop();
 #ifdef HAVE_IPC
-	pv_crs_needreinit(pv_sig_state);
+	pv_crs_needreinit(&(pv_sig_state->cursor));
 #endif
 }
-
-/* EOF */

src/pv/state.c

@@ -1,85 +1,327 @@
 /*
  * State management functions.
  *
- * Copyright 2002-2008, 2010, 2012-2015, 2017, 2021, 2023 Andrew Wood
+ * Copyright 2002-2008, 2010, 2012-2015, 2017, 2021, 2023-2025 Andrew Wood
  *
- * Distributed under the Artistic License v2.0; see `doc/COPYING'.
+ * License GPLv3+: GNU GPL version 3 or later; see `docs/COPYING'.
  */
 
 #include "config.h"
 #include "pv.h"
 #include "pv-internal.h"
 
+/* We do not set this because it breaks "dd" - see below. */
+/* #undef MAKE_OUTPUT_NONBLOCKING */
+
 #include <stdio.h>
 #include <stdlib.h>
 #include <string.h>
 #include <unistd.h>
 #include <errno.h>
+#include <fcntl.h>
 
 
-/* alloc / realloc history buffer */
-static void pv_alloc_history(pvstate_t state)
+/*
+ * Allocate or reallocate the history buffer for calculating average
+ * transfer rate.
+ */
+static void pv_alloc_calc_history(pvtransfercalc_t calc)
 {
-	if (NULL != state->history)
-		free(state->history);
-	state->history = NULL;
+	if (NULL != calc->history)
+		free(calc->history);
+	calc->history = NULL;
 
-	state->history = calloc(state->history_len, sizeof(state->history[0]));
-	if (NULL == state->history) {
-		fprintf(stderr, "%s: %s: %s\n", state->program_name,
-			_("history structure allocation failed"), strerror(errno));
+	calc->history = calloc((size_t) (calc->history_len), sizeof(calc->history[0]));
+	if (NULL == calc->history) {
+		/*@-mustfreefresh@ */
+		/*
+		 * splint note: the gettext calls made by _() cause memory
+		 * leak warnings, but in this case it's unavoidable, and
+		 * mitigated by the fact we only translate each string once.
+		 */
+		pv_error("%s: %s", _("history structure allocation failed"), strerror(errno));
+		/*@+mustfreefresh@ */
 		return;
 	}
 
-	state->history_first = state->history_last = 0;
-	state->history[0].elapsed_sec = 0.0;	/* to be safe, memset() not recommended for doubles */
+	calc->history_first = calc->history_last = 0;
+	calc->history[0].elapsed_sec = 0.0; /* to be safe, memset() not recommended for doubles */
 }
 
+
+/*
+ * Set the "calc" state sub-structure's history length appropriately for the
+ * given average rate window setting, allocate an appropriate history, and
+ * return the appropriate history interval to use.
+ */
+unsigned int pv_update_calc_average_rate_window(pvtransfercalc_t calc, unsigned int val)
+{
+	unsigned int history_interval;
+
+	if (val < 1)
+		val = 1;
+
+	if (val >= 20) {
+		calc->history_len = (size_t) (val / 5 + 1);
+		history_interval = 5;
+	} else {
+		calc->history_len = (size_t) (val + 1);
+		history_interval = 1;
+	}
+
+	pv_alloc_calc_history(calc);
+
+	return history_interval;
+}
+
+
+/*
+ * Clear the "calc" part of a state structure.
+ */
+void pv_reset_calc(pvtransfercalc_t calc)
+{
+	if (NULL == calc)
+		return;
+	/*
+	 * Explicitly set important floating point values to 0, as memset()
+	 * is not recommended for this.
+	 */
+	calc->transfer_rate = 0.0;
+	calc->average_rate = 0.0;
+	calc->prev_elapsed_sec = 0.0;
+	calc->prev_rate = 0.0;
+	calc->prev_trans = 0.0;
+	calc->current_avg_rate = 0.0;
+	calc->rate_min = 0.0;
+	calc->rate_max = 0.0;
+	calc->rate_sum = 0.0;
+	calc->ratesquared_sum = 0.0;
+	calc->measurements_taken = 0;
+	calc->prev_transferred = 0;
+	calc->percentage = 0.0;
+	calc->history_first = calc->history_last = 0;
+	if (NULL != calc->history) {
+		calc->history[0].elapsed_sec = 0.0;
+	}
+}
+
+
+/*
+ * Clear the "transfer" part of a state structure.
+ */
+void pv_reset_transfer(pvtransferstate_t transfer)
+{
+	if (NULL == transfer)
+		return;
+
+	transfer->elapsed_seconds = 0.0;
+	transfer->read_position = 0;
+	transfer->write_position = 0;
+	transfer->to_write = 0;
+	transfer->written = 0;
+	transfer->total_bytes_read = 0;
+	transfer->total_written = 0;
+	transfer->written_but_not_consumed = 0;
+	transfer->read_errors_in_a_row = 0;
+	transfer->last_read_skip_fd = 0;
+#ifdef HAVE_SPLICE
+	transfer->splice_failed_fd = -1;
+#endif				/* HAVE_SPLICE */
+
+	transfer->line_positions_length = 0;
+	transfer->line_positions_head = 0;
+	transfer->last_output_position = 0;
+	transfer->output_not_seekable = false;
+}
+
+
+/*
+ * Reset the calculated parts of the "flags" state structure.
+ */
+void pv_reset_flags(pvtransientflags_t flags)
+{
+	if (NULL == flags)
+		return;
+	flags->reparse_display = 1;
+}
+
+
+/*
+ * Reset the calculated parts of a "display" state structure.
+ */
+void pv_reset_display(pvdisplay_t display)
+{
+	if (NULL == display)
+		return;
+	display->initial_offset = 0;
+	display->output_produced = false;
+}
+
+
+/*
+ * Clear the calculated parts of a state structure.
+ */
+void pv_state_reset(pvstate_t state)
+{
+	if (NULL == state)
+		return;
+
+	pv_reset_flags(&(state->flags));
+	state->status.current_input_file = -1;
+
+	pv_reset_display(&(state->display));
+	pv_reset_display(&(state->extra_display));
+
+	pv_reset_calc(&(state->calc));
+	pv_reset_transfer(&(state->transfer));
+}
+
+
 /*
  * Create a new state structure, and return it, or 0 (NULL) on error.
  */
-pvstate_t pv_state_alloc(const char *program_name)
+pvstate_t pv_state_alloc(void)
 {
 	pvstate_t state;
 
 	state = calloc(1, sizeof(*state));
 	if (NULL == state)
 		return NULL;
+	memset(state, 0, sizeof(*state));
 
-	state->program_name = program_name;
-	state->watch_pid = 0;
-	state->watch_fd = -1;
+	state->watchfd.count = 0;
+	state->control.output_fd = -1;
 #ifdef HAVE_IPC
-	state->crs_shmid = -1;
-	state->crs_pvcount = 1;
+	state->cursor.shmid = -1;
+	state->cursor.pvcount = 1;
 #endif				/* HAVE_IPC */
-	state->crs_lock_fd = -1;
+	state->cursor.lock_fd = -1;
 
-	state->reparse_display = 1;
-	state->current_file = _("none");
-#ifdef HAVE_SPLICE
-	state->splice_failed_fd = -1;
-#endif				/* HAVE_SPLICE */
-	state->display_visible = false;
+	pv_state_reset(state);
 
 	/*
 	 * Get the current working directory, if possible, as a base for
 	 * showing relative filenames with --watchfd.
 	 */
-	if (NULL == getcwd(state->cwd, PV_SIZEOF_CWD - 1)) {
+	if (NULL == getcwd(state->status.cwd, PV_SIZEOF_CWD - 1)) {
 		/* failed - will always show full path */
-		state->cwd[0] = '\0';
+		state->status.cwd[0] = '\0';
 	}
-	if ('\0' == state->cwd[1]) {
+	if ('\0' == state->status.cwd[1]) {
 		/* CWD is root directory - always show full path */
-		state->cwd[0] = '\0';
+		state->status.cwd[0] = '\0';
 	}
-	state->cwd[PV_SIZEOF_CWD - 1] = '\0';
+	state->status.cwd[PV_SIZEOF_CWD - 1] = '\0';
 
 	return state;
 }
 
 
+/*
+ * Free dynamic contents of a display structure.
+ */
+void pv_freecontents_display(pvdisplay_t display)
+{
+	if (NULL != display->display_buffer)
+		free(display->display_buffer);
+	display->display_buffer = NULL;
+}
+
+
+/*
+ * Free dynamic contents of a transfer state structure.
+ */
+void pv_freecontents_transfer(pvtransferstate_t transfer)
+{
+	/*@-keeptrans@ */
+	if (NULL != transfer->transfer_buffer)
+		free(transfer->transfer_buffer);
+	transfer->transfer_buffer = NULL;
+	/*@+keeptrans@ */
+	/* splint - explicitly freeing this structure, so free() here is OK. */
+
+	if (NULL != transfer->line_positions)
+		free(transfer->line_positions);
+	transfer->line_positions = NULL;
+}
+
+
+/*
+ * Free dynamic contents of a calculated transfer state structure.
+ */
+void pv_freecontents_calc(pvtransfercalc_t calc)
+{
+	if (NULL != calc->history)
+		free(calc->history);
+	calc->history = NULL;
+}
+
+
+/*
+ * Free the contents of a watchfd watched-items array.
+ */
+void pv_freecontents_watchfd_items(struct pvwatcheditem_s *watching, unsigned int count)
+{
+	unsigned int watch_idx;
+
+	if (NULL == watching)
+		return;
+
+	/*@-compdestroy@ */
+	for (watch_idx = 0; watch_idx < count; watch_idx++) {
+		int info_idx;
+		if (NULL == watching[watch_idx].info_array)
+			continue;
+		for (info_idx = 0; info_idx < watching[watch_idx].array_length; info_idx++) {
+			pv_freecontents_watchfd(&(watching[watch_idx].info_array[info_idx]));
+		}
+		free(watching[watch_idx].info_array);
+		watching[watch_idx].info_array = NULL;
+		watching[watch_idx].array_length = 0;
+	}
+
+	return;
+	/*@+compdestroy @ */
+	/*
+	 * splint warns that watching[].info_array->transfer.transfer_buffer
+	 * and other deep structures may not be deallocated and so leak
+	 * memory, but that's what pv_freecontents_watchfd() takes care of.
+	 */
+}
+
+
+/*
+ * Truncate the output file descriptor to its current position, if it's a
+ * valid fd, we're in sparse output mode, and no lseek() failed.
+ */
+static void pv_truncate_output(pvstate_t state)
+{
+	off_t current_offset;
+
+	if (!state->control.sparse_output)
+		return;
+	if (state->transfer.output_not_seekable)
+		return;
+	if (state->control.output_fd < 0)
+		return;
+
+	current_offset = (off_t) lseek(state->control.output_fd, (off_t) 0, SEEK_CUR);
+	if (current_offset == (off_t) - 1)
+		return;
+
+	debug("%s: %ld", "truncating to current offset", (long) current_offset);
+
+	/*@+longintegral@ */
+	/*
+	 * splint has trouble with off_t / __off_t.
+	 */
+	if (0 != ftruncate(state->control.output_fd, current_offset)) {
+		debug("%s: %s", "output ftruncate() failed", strerror(errno));
+	}
+	/*@-longintegral@ */
+}
+
+
 /*
  * Free a state structure, after which it can no longer be used.
  */
@@ -88,17 +330,76 @@ void pv_state_free(pvstate_t state)
 	if (0 == state)
 		return;
 
-	if (NULL != state->display_buffer)
-		free(state->display_buffer);
-	state->display_buffer = NULL;
+	/*
+	 * Close the output file first, so we can report any errors while we
+	 * still know the program name and output filename.
+	 */
+	if (state->control.output_fd >= 0) {
+		pv_truncate_output(state);
+		if (STDOUT_FILENO != state->control.output_fd) {
+			if (close(state->control.output_fd) < 0) {
+				pv_error("%s: %s",
+					 NULL == state->control.output_name ? "(null)" : state->control.output_name,
+					 strerror(errno));
+			}
+		}
+		state->control.output_fd = -1;
+	}
 
-	if (NULL != state->transfer_buffer)
-		free(state->transfer_buffer);
-	state->transfer_buffer = NULL;
+	if (NULL != state->control.output_name) {
+		free(state->control.output_name);
+		state->control.output_name = NULL;
+	}
 
-	if (NULL != state->history)
-		free(state->history);
-	state->history = NULL;
+	pv_freecontents_display(&(state->display));
+	pv_freecontents_display(&(state->extra_display));
+
+	if (NULL != state->control.name) {
+		free(state->control.name);
+		state->control.name = NULL;
+	}
+
+	if (NULL != state->control.default_bar_style) {
+		free(state->control.default_bar_style);
+		state->control.default_bar_style = NULL;
+	}
+
+	if (NULL != state->control.format_string) {
+		free(state->control.format_string);
+		state->control.format_string = NULL;
+	}
+
+	if (NULL != state->control.extra_display_spec) {
+		free(state->control.extra_display_spec);
+		state->control.extra_display_spec = NULL;
+	}
+
+	if (NULL != state->control.extra_format_string) {
+		free(state->control.extra_format_string);
+		state->control.extra_format_string = NULL;
+	}
+
+	pv_freecontents_transfer(&(state->transfer));
+
+	pv_freecontents_calc(&(state->calc));
+
+	if (NULL != state->files.filename) {
+		unsigned int file_idx;
+		for (file_idx = 0; file_idx < state->files.file_count; file_idx++) {
+			/*@-unqualifiedtrans@ */
+			free(state->files.filename[file_idx]);
+			/*@+unqualifiedtrans@ */
+			/* splint: see similar code below. */
+		}
+		free(state->files.filename);
+		state->files.filename = NULL;
+	}
+
+	if (NULL != state->watchfd.watching) {
+		pv_freecontents_watchfd_items(state->watchfd.watching, state->watchfd.count);
+		free(state->watchfd.watching);
+		state->watchfd.watching = NULL;
+	}
 
 	free(state);
 
@@ -109,182 +410,451 @@ void pv_state_free(pvstate_t state)
 /*
  * Set the formatting string, given a set of old-style formatting options.
  */
-void pv_state_set_format(pvstate_t state, bool progress,
-			 bool timer, bool eta,
-			 bool fineta, bool rate,
-			 bool average_rate, bool bytes, bool bufpercent, unsigned int lastwritten, const char *name)
+void pv_state_set_format(pvstate_t state, bool progress, bool timer, bool eta, bool fineta, bool rate, bool average_rate, bool bytes, bool bufpercent, size_t lastwritten,	/*@null@ */
+			 const char *name)
 {
 #define PV_ADDFORMAT(x,y) if (x) { \
-		if (state->default_format[0] != '\0') \
-			pv_strlcat(state->default_format, " ", sizeof(state->default_format)); \
-		pv_strlcat(state->default_format, y, sizeof(state->default_format)); \
+		if (state->control.default_format[0] != '\0') \
+			(void) pv_strlcat(state->control.default_format, " ", sizeof(state->control.default_format)); \
+		(void) pv_strlcat(state->control.default_format, y, sizeof(state->control.default_format)); \
 	}
 
-	state->default_format[0] = '\0';
-	PV_ADDFORMAT(name, "%N");
-	PV_ADDFORMAT(bytes, "%b");
-	PV_ADDFORMAT(bufpercent, "%T");
-	PV_ADDFORMAT(timer, "%t");
-	PV_ADDFORMAT(rate, "%r");
-	PV_ADDFORMAT(average_rate, "%a");
-	PV_ADDFORMAT(progress, "%p");
-	PV_ADDFORMAT(eta, "%e");
-	PV_ADDFORMAT(fineta, "%I");
-	if (lastwritten > 0) {
-		char buf[16];
-		memset(buf, 0, sizeof(buf));
-		(void) pv_snprintf(buf, sizeof(buf), "%%%uA", lastwritten);
-		PV_ADDFORMAT(lastwritten > 0, buf);
+	state->control.format_option.progress = progress;
+	state->control.format_option.timer = timer;
+	state->control.format_option.eta = eta;
+	state->control.format_option.fineta = fineta;
+	state->control.format_option.rate = rate;
+	state->control.format_option.average_rate = average_rate;
+	state->control.format_option.bytes = bytes;
+	state->control.format_option.bufpercent = bufpercent;
+	state->control.format_option.lastwritten = lastwritten;
+
+	state->control.default_format[0] = '\0';
+
+	if (false == state->control.numeric) {
+		/* Standard progress display mode (without "--numeric"). */
+
+		/*
+		 * Add the format strings for the enabled options in a
+		 * standard order.
+		 */
+		PV_ADDFORMAT(name, "%N");
+		PV_ADDFORMAT(bytes, "%b");
+		PV_ADDFORMAT(bufpercent, "%T");
+		PV_ADDFORMAT(timer, "%t");
+		PV_ADDFORMAT(rate, "%r");
+		PV_ADDFORMAT(average_rate, "%a");
+		PV_ADDFORMAT(progress, "%p");
+		PV_ADDFORMAT(eta, "%e");
+		PV_ADDFORMAT(fineta, "%I");
+
+		if (lastwritten > 0) {
+			char buf[16];	 /* flawfinder: ignore */
+			memset(buf, 0, sizeof(buf));
+			(void) pv_snprintf(buf, sizeof(buf), "%%%uA", (unsigned int) lastwritten);
+			PV_ADDFORMAT(lastwritten > 0, buf);
+			/*
+			 * flawfinder rationale: large enough for string,
+			 * zeroed before use, only written to by
+			 * pv_snprintf() with the right buffer length.
+			 */
+		}
+
+	} else {
+		/* Numeric mode has different behaviour. */
+
+		PV_ADDFORMAT(timer, "%t");
+		PV_ADDFORMAT(bytes, "%b");
+		PV_ADDFORMAT(rate, "%r");
+		PV_ADDFORMAT(!(bytes || rate), "%{progress-amount-only}");
+
 	}
 
-	state->name = name;
-	state->reparse_display = 1;
+	debug("%s: [%s]", "default format set", state->control.default_format);
+
+	/* Free any previously set name. */
+	if (NULL != state->control.name) {
+		free(state->control.name);
+		state->control.name = NULL;
+	}
+
+	/* Set a new name if one was given. */
+	if (NULL != name)
+		state->control.name = pv_strdup(name);
+
+	/* Tell pv_format() that the format has changed. */
+	state->flags.reparse_display = 1;
 }
 
 
 void pv_state_force_set(pvstate_t state, bool val)
 {
-	state->force = val;
+	state->control.force = val;
 }
 
 void pv_state_cursor_set(pvstate_t state, bool val)
 {
-	state->cursor = val;
-};
+	state->control.cursor = val;
+}
+
+void pv_state_show_stats_set(pvstate_t state, bool val)
+{
+	state->control.show_stats = val;
+}
 
 void pv_state_numeric_set(pvstate_t state, bool val)
 {
-	state->numeric = val;
-};
+	state->control.numeric = val;
+}
 
 void pv_state_wait_set(pvstate_t state, bool val)
 {
-	state->wait = val;
-};
+	state->control.wait = val;
+}
 
 void pv_state_delay_start_set(pvstate_t state, double val)
 {
-	state->delay_start = val;
-};
+	state->control.delay_start = val;
+}
+
+void pv_state_rate_gauge_set(pvstate_t state, bool val)
+{
+	state->control.rate_gauge = val;
+}
 
 void pv_state_linemode_set(pvstate_t state, bool val)
 {
-	state->linemode = val;
-};
+	state->control.linemode = val;
+}
 
 void pv_state_bits_set(pvstate_t state, bool bits)
 {
-	state->bits = bits;
-};
+	state->control.bits = bits;
+}
 
-void pv_state_null_set(pvstate_t state, bool val)
+void pv_state_decimal_units_set(pvstate_t state, bool decimal_units)
 {
-	state->null = val;
-};
+	state->control.decimal_units = decimal_units;
+}
 
-void pv_state_no_op_set(pvstate_t state, bool val)
+void pv_state_null_terminated_lines_set(pvstate_t state, bool val)
 {
-	state->no_op = val;
-};
+	state->control.null_terminated_lines = val;
+}
+
+void pv_state_no_display_set(pvstate_t state, bool val)
+{
+	state->control.no_display = val;
+}
 
 void pv_state_skip_errors_set(pvstate_t state, unsigned int val)
 {
-	state->skip_errors = val;
-};
+	state->control.skip_errors = val;
+}
+
+void pv_state_error_skip_block_set(pvstate_t state, off_t val)
+{
+	state->control.error_skip_block = val;
+}
 
 void pv_state_stop_at_size_set(pvstate_t state, bool val)
 {
-	state->stop_at_size = val;
-};
+	state->control.stop_at_size = val;
+}
 
 void pv_state_sync_after_write_set(pvstate_t state, bool val)
 {
-	state->sync_after_write = val;
-};
+	state->control.sync_after_write = val;
+}
 
 void pv_state_direct_io_set(pvstate_t state, bool val)
 {
-	state->direct_io = val;
-	state->direct_io_changed = true;
-};
+	state->control.direct_io = val;
+	state->control.direct_io_changed = true;
+}
 
-void pv_state_rate_limit_set(pvstate_t state, unsigned long long val)
+void pv_state_sparse_output_set(pvstate_t state, bool val)
 {
-	state->rate_limit = val;
-};
+	state->control.sparse_output = val;
+}
 
-void pv_state_target_buffer_size_set(pvstate_t state, unsigned long long val)
+void pv_state_discard_input_set(pvstate_t state, bool val)
 {
-	state->target_buffer_size = val;
-};
+	state->control.discard_input = val;
+}
+
+void pv_state_rate_limit_set(pvstate_t state, off_t val)
+{
+	state->control.rate_limit = val;
+}
+
+void pv_state_target_buffer_size_set(pvstate_t state, size_t val)
+{
+	state->control.target_buffer_size = val;
+}
 
 void pv_state_no_splice_set(pvstate_t state, bool val)
 {
-	state->no_splice = val;
-};
+	state->control.no_splice = val;
+}
 
-void pv_state_size_set(pvstate_t state, unsigned long long val)
+void pv_state_size_set(pvstate_t state, off_t val)
 {
-	state->size = val;
-};
+	state->control.size = val;
+}
 
 void pv_state_interval_set(pvstate_t state, double val)
 {
-	state->interval = val;
-};
+	state->control.interval = val;
+}
 
-void pv_state_width_set(pvstate_t state, unsigned int val)
+void pv_state_width_set(pvstate_t state, unsigned int val, bool was_set_manually)
 {
-	state->width = val;
-};
+	if (val > PVDISPLAY_WIDTH_MAX)
+		val = PVDISPLAY_WIDTH_MAX;
+	state->control.width = (pvdisplay_width_t) val;
+	state->control.width_set_manually = was_set_manually;
+}
 
-void pv_state_height_set(pvstate_t state, unsigned int val)
+void pv_state_height_set(pvstate_t state, unsigned int val, bool was_set_manually)
 {
-	state->height = val;
-};
+	state->control.height = val;
+	state->control.height_set_manually = was_set_manually;
+}
 
-void pv_state_name_set(pvstate_t state, const char *val)
+void pv_state_name_set(pvstate_t state, /*@null@ */ const char *val)
 {
-	state->name = val;
-};
+	if (NULL != state->control.name) {
+		free(state->control.name);
+		state->control.name = NULL;
+	}
+	if (NULL != val)
+		state->control.name = pv_strdup(val);
+}
 
-void pv_state_format_string_set(pvstate_t state, const char *val)
+void pv_state_default_bar_style_set(pvstate_t state, /*@null@ */ const char *val)
 {
-	state->format_string = val;
-};
+	if (NULL != state->control.default_bar_style) {
+		free(state->control.default_bar_style);
+		state->control.default_bar_style = NULL;
+	}
+	if (NULL != val)
+		state->control.default_bar_style = pv_strdup(val);
+}
 
-void pv_state_watch_pid_set(pvstate_t state, unsigned int val)
+void pv_state_format_string_set(pvstate_t state, /*@null@ */ const char *val)
 {
-	state->watch_pid = val;
-};
+	if (NULL != state->control.format_string) {
+		free(state->control.format_string);
+		state->control.format_string = NULL;
+	}
+	if (NULL != val)
+		state->control.format_string = pv_strdup(val);
+}
 
-void pv_state_watch_fd_set(pvstate_t state, int val)
+void pv_state_extra_display_set(pvstate_t state, /*@null@ */ const char *val)
 {
-	state->watch_fd = val;
-};
+	const char *word_start;
+	size_t offset;
 
-void pv_state_average_rate_window_set(pvstate_t state, int val)
+	if (NULL != state->control.extra_display_spec) {
+		free(state->control.extra_display_spec);
+		state->control.extra_display_spec = NULL;
+	}
+
+	if (NULL != state->control.extra_format_string) {
+		free(state->control.extra_format_string);
+		state->control.extra_format_string = NULL;
+	}
+
+	state->control.extra_displays = 0;
+	if (NULL == val)
+		return;
+
+	if (NULL != val)
+		state->control.extra_display_spec = pv_strdup(val);
+
+	word_start = val;
+	while (NULL != word_start && '\0' != word_start[0]) {
+		offset = 0;
+		while ('\0' != word_start[offset] && ',' != word_start[offset] && ':' != word_start[offset])
+			offset++;
+		if (((11 == offset) && (0 == strncmp(word_start, "windowtitle", 11)))
+		    || ((6 == offset) && (0 == strncmp(word_start, "window", 6)))
+		    ) {
+			debug("%s", "enabling windowtitle");
+			state->control.extra_displays |= PV_DISPLAY_WINDOWTITLE;
+		} else if (((12 == offset) && (0 == strncmp(word_start, "processtitle", 12)))
+			   || ((9 == offset) && (0 == strncmp(word_start, "proctitle", 9)))
+			   || ((7 == offset) && (0 == strncmp(word_start, "process", 7)))
+			   || ((4 == offset) && (0 == strncmp(word_start, "proc", 4)))
+		    ) {
+			debug("%s", "enabling processtitle");
+			state->control.extra_displays |= PV_DISPLAY_PROCESSTITLE;
+		}
+		switch (word_start[offset]) {
+		case ',':
+			offset++;
+			break;
+		case ':':
+			offset++;
+			debug("%s: [%s]", "setting extra_format_string", word_start + offset);
+			state->control.extra_format_string = pv_strdup(word_start + offset);
+			word_start = NULL;
+			break;
+		default:
+			word_start = NULL;
+			break;
+		}
+		if (NULL != word_start)
+			word_start += offset;
+	}
+}
+
+void pv_state_output_set(pvstate_t state, int fd, const char *name)
+{
+	/*
+	 * Close any previous output file first, so we can report any errors
+	 * before we store the new output filename.
+	 */
+	pv_truncate_output(state);
+	if (state->control.output_fd >= 0 && state->control.output_fd != STDOUT_FILENO) {
+		if (close(state->control.output_fd) < 0) {
+			pv_error("%s: %s",
+				 NULL == state->control.output_name ? "(null)" : state->control.output_name,
+				 strerror(errno));
+		}
+	}
+	if (NULL != state->control.output_name)
+		free(state->control.output_name);
+	state->control.output_fd = fd;
+	state->control.output_name = pv_strdup(name);
+#ifdef MAKE_OUTPUT_NONBLOCKING
+	/*
+	 * Try and make the output use non-blocking I/O.
+	 *
+	 * Note that this can cause problems with (broken) applications
+	 * such as dd when used in a pipeline.
+	 */
+	fcntl(state->control.output_fd, F_SETFL, O_NONBLOCK | fcntl(state->control.output_fd, F_GETFL));
+#endif				/* MAKE_OUTPUT_NONBLOCKING */
+
+	/*
+	 * In sparse output mode, if the output is in append mode (>>),
+	 * explicitly lseek() to the end of the file.  Otherwise, the file
+	 * offset is not set until the first write(), which means that if
+	 * the input starts with null bytes, when we lseek() past them
+	 * relative to the current position, the "current position" is 0
+	 * rather than the end of the file, and the file gets truncated on
+	 * exit to the wrong size.
+	 */
+	if (state->control.sparse_output && 0 != (fcntl(fd, F_GETFL) & O_APPEND)) {
+		debug("%s", "sparse output mode, and appending - seeking output to the end");
+		if ((off_t) lseek(fd, 0, SEEK_END) == (off_t) - 1) {
+			debug("%s: %s", "lseek failed", strerror(errno));
+		}
+	}
+}
+
+void pv_state_average_rate_window_set(pvstate_t state, unsigned int val)
 {
 	if (val < 1)
 		val = 1;
-	if (val >= 20) {
-		state->history_len = val / 5 + 1;
-		state->history_interval = 5;
-	} else {
-		state->history_len = val + 1;
-		state->history_interval = 1;
-	}
-	pv_alloc_history(state);
-};
+	state->control.average_rate_window = val;
+	state->control.history_interval = pv_update_calc_average_rate_window(&(state->calc), val);
+}
 
+void pv_state_set_terminal_supports_utf8(pvstate_t state, bool val)
+{
+	state->status.terminal_supports_utf8 = val;
+}
 
 /*
  * Set the array of input files.
  */
-void pv_state_inputfiles(pvstate_t state, int input_file_count, const char **input_files)
+void pv_state_inputfiles(pvstate_t state, unsigned int input_file_count, const char **input_files)
 {
-	state->input_file_count = input_file_count;
-	state->input_files = input_files;
+	unsigned int file_idx;
+	/*@only@ */ nullable_string_t *new_array;
+
+	/* Free the old array and its contents, if there was one. */
+	if (NULL != state->files.filename) {
+		for (file_idx = 0; file_idx < state->files.file_count; file_idx++) {
+			free(state->files.filename[file_idx]);
+		}
+		free(state->files.filename);
+		state->files.filename = NULL;
+		state->files.file_count = 0;
+	}
+
+	/* Allocate an empty new array of the right size. */
+	new_array = calloc((size_t) (input_file_count + 1), sizeof(char *));
+	if (NULL == new_array) {
+		/*@-mustfreefresh@ *//* see similar _() issue above */
+		pv_error("%s: %s", _("file list allocation failed"), strerror(errno));
+		/*@+mustfreefresh@ */
+		return;
+	}
+	state->files.filename = new_array;
+
+	/* Populate the new array with copies of the filenames. */
+	for (file_idx = 0; file_idx < input_file_count; file_idx++) {
+		/*@only@ */ char *new_string;
+		new_string = pv_strdup(input_files[file_idx]);
+		if (NULL == new_string) {
+			/*@-mustfreefresh@ *//* see similar _() issue above */
+			pv_error("%s: %s", _("file list allocation failed"), strerror(errno));
+			/*@+mustfreefresh@ */
+			return;
+		}
+		state->files.filename[file_idx] = new_string;
+	}
+	state->files.file_count = input_file_count;
 }
 
-/* EOF */
+/*
+ * Set the arrays of watchfd process IDs and file descriptors.
+ */
+void pv_state_watchfds(pvstate_t state, unsigned int watchfd_count, const pid_t * pids, const int *fds)
+{
+	unsigned int item_idx;
+	/*@only@ */ struct pvwatcheditem_s *new_array = NULL;
+
+	/* Free the old arrays, if there were any. */
+	if (NULL != state->watchfd.watching) {
+		/*@-compdestroy@ */
+		pv_freecontents_watchfd_items(state->watchfd.watching, state->watchfd.count);
+		free(state->watchfd.watching);
+		state->watchfd.watching = NULL;
+		/*@+compdestroy@ */
+		/*
+		 * splint warns about deep structures not being deallocated,
+		 * but that's what pv_freecontents_watchfd_items() does.
+		 */
+	}
+	state->watchfd.count = 0;
+	state->watchfd.multiple_pids = false;
+
+	/* Allocate an empty new array of the right size. */
+	new_array = malloc((1 + state->watchfd.count) * sizeof(*new_array));
+	if (NULL == new_array) {
+		/*@-mustfreefresh@ *//* see similar _() issue above */
+		pv_error("%s: %s", _("buffer allocation failed"), strerror(errno));
+		/*@+mustfreefresh@ */
+		return;
+	}
+	memset(new_array, 0, (1 + state->watchfd.count) * sizeof(*new_array));
+	state->watchfd.watching = new_array;
+
+	/* Populate the new array with the values supplied. */
+	for (item_idx = 0; item_idx < watchfd_count; item_idx++) {
+		state->watchfd.watching[item_idx].pid = pids[item_idx];
+		state->watchfd.watching[item_idx].fd = fds[item_idx];
+		if ((item_idx > 0) && (pids[item_idx] != pids[item_idx - 1]))
+			state->watchfd.multiple_pids = true;
+	}
+	state->watchfd.count = watchfd_count;
+
+	debug("%s=%d, %s=%s", "watchfd.count", state->watchfd.count, "multiple_pids",
+	      state->watchfd.multiple_pids ? "true" : "false");
+}

src/pv/string.c

@@ -1,9 +1,9 @@
 /*
- * Functions for converting strings to numbers.
+ * Functions for portably managing strings.
  *
- * Copyright 2023 Andrew Wood
+ * Copyright 2023-2025 Andrew Wood
  *
- * Distributed under the Artistic License v2.0; see `doc/COPYING'.
+ * License GPLv3+: GNU GPL version 3 or later; see `docs/COPYING'.
  */
 
 #include "config.h"
@@ -12,6 +12,13 @@
 #include <stdio.h>
 #include <stdarg.h>
 #include <string.h>
+#include <errno.h>
+#if defined(ENABLE_NLS) && defined(HAVE_WCHAR_H)
+#include <wchar.h>
+#if defined(HAVE_WCTYPE_H)
+#include <wctype.h>
+#endif
+#endif
 
 
 /*
@@ -40,14 +47,21 @@ int pv_snprintf(char *str, size_t size, const char *format, ...)
 
 	va_start(ap, format);
 #ifdef HAVE_VSNPRINTF
-	ret = vsnprintf(str, size, format, ap);
+	ret = vsnprintf(str, size, format, ap);	/* flawfinder: ignore */
 #else				/* ! HAVE_VSNPRINTF */
-	ret = vsprintf(str, format, ap);
+	ret = vsprintf(str, format, ap);    /* flawfinder: ignore */
 #endif				/* HAVE_VSNPRINTF */
 	va_end(ap);
 
 	str[size - 1] = '\0';
 
+	/*
+	 * flawfinder rationale: this function replaces snprintf so
+	 * explicitly takes a non-constant format; also it explicitly
+	 * \0-terminates the output buffer, as flawfinder warns that some
+	 * sprintf() variants do not.
+	 */
+
 	return ret;
 }
 
@@ -70,7 +84,14 @@ int pv_snprintf(char *str, size_t size, const char *format, ...)
 size_t pv_strlcat(char *dst, const char *src, size_t dstsize)
 {
 #ifdef HAVE_STRLCAT
-	return strlcat(dst, src, dstsize);
+	size_t result;
+
+	result = strlcat(dst, src, dstsize);
+
+	if ((NULL != dst) && (dstsize > 0))
+		dst[dstsize - 1] = '\0';
+
+	return result;
 #else
 	size_t dstlen, srclen, available;
 
@@ -82,8 +103,14 @@ size_t pv_strlcat(char *dst, const char *src, size_t dstsize)
 		return 0;
 
 	dst[dstsize - 1] = '\0';
-	dstlen = strlen(dst);
-	srclen = strlen(src);
+	dstlen = strlen(dst);		    /* flawfinder: ignore */
+	srclen = strlen(src);		    /* flawfinder: ignore */
+
+	/*
+	 * flawfinder rationale: src must explicitly be \0 terminated, so
+	 * this is up to the caller; with dst, we enforce \0 termination
+	 * before calling strlen().
+	 */
 
 	available = dstsize - dstlen;
 	if (available > 1)
@@ -93,4 +120,198 @@ size_t pv_strlcat(char *dst, const char *src, size_t dstsize)
 #endif
 }
 
-/* EOF */
+
+/*
+ * Allocate and return a duplicate of a \0-terminated string, ensuring that
+ * the duplicate is also \0-terminated.  Returns NULL on error.
+ */
+/*@null@ */
+/*@only@ */
+char *pv_strdup(const char *original)
+{
+	size_t length;
+	char *duplicate;
+
+	if (NULL == original) {
+		errno = EINVAL;
+		return NULL;
+	}
+
+	length = strlen(original);	    /* flawfinder: ignore */
+	/*
+	 * flawfinder rationale: the original string is explicitly required
+	 * to be \0 terminated.
+	 */
+	duplicate = calloc(1, 1 + length);
+	if (NULL == duplicate)
+		return NULL;
+
+	memcpy(duplicate, original, length);	/* flawfinder: ignore */
+	/*
+	 * flawfinder rationale: the buffer is explicitly allocated to be
+	 * large enough.
+	 */
+
+	duplicate[length] = '\0';
+
+	return duplicate;
+}
+
+
+/*
+ * Return a pointer to the last matching character in the buffer, or NULL if
+ * not found.
+ */
+/*@null@ */
+/*@temp@ */
+void *pv_memrchr(const void *buffer, int match, size_t length)
+{
+#ifdef HAVE_MEMRCHR
+	/*@-unrecog@ *//* splint doesn't know of memrchr() */
+	return memrchr(buffer, match, length);
+	/*@+unrecog@ */
+#else
+	unsigned char *ptr;
+
+	if (length < 1)
+		return NULL;
+
+	ptr = ((unsigned char *) buffer) + length - 1;
+	while (ptr >= (unsigned char *) buffer) {
+		if ((int) (ptr[0]) == match)
+			return (void *) ptr;
+		ptr--;
+	}
+
+	return NULL;
+#endif
+}
+
+
+/*
+ * Return the number of display columns needed to show the
+ * non-null-terminated string "string" whose length in bytes is "bytes".
+ *
+ * Skips ECMA-48 CSI (ESC [ ...) sequences, but any other control characters
+ * are treated as printable.
+ *
+ * To do this, we convert it to a wide character string, and use the wide
+ * character display width function "wcswidth()" on it.
+ *
+ * If NLS is disabled, or the string cannot be converted, this just returns
+ * the value of "bytes".
+ *
+ * Note that this function uses internal buffers if the string is short
+ * enough, otherwise it has to call malloc() and free(), so it becomes less
+ * efficient with larger strings.
+ */
+size_t pv_strwidth(const char *string, size_t bytes)
+{
+	char *allocated_raw = NULL;
+	static char internal_raw[256];	 /* flawfinder: ignore - bounded */
+	char *raw_string = NULL;
+	size_t read_pos, write_pos;
+	size_t raw_bytes, width;
+#if defined(ENABLE_NLS) && defined(HAVE_WCHAR_H)
+	size_t wide_char_count;
+	size_t wide_string_buffer_size;
+	wchar_t *allocated_wide = NULL;
+	static wchar_t internal_wide[256];	/* flawfinder: ignore - bounded */
+	wchar_t *wide_string = NULL;
+#endif				/* defined(ENABLE_NLS) && defined(HAVE_WCHAR_H) */
+
+	if (NULL == string)
+		return 0;
+	if (0 == bytes)
+		return 0;
+
+	if (bytes < sizeof(internal_raw) - 1) {
+		raw_string = internal_raw;
+	} else {
+		allocated_raw = calloc(1, 1 + bytes);
+		if (NULL == allocated_raw)
+			return bytes;
+		raw_string = allocated_raw;
+	}
+
+	/* Copy the original string, skipping ECMA-48 CSI sequences. */
+	for (read_pos = 0, write_pos = 0; read_pos < bytes; read_pos++) {
+		if ((string[read_pos] != '\033') || (read_pos >= bytes - 1) || (string[read_pos + 1] != '[')) {
+			raw_string[write_pos++] = string[read_pos];
+			continue;
+		}
+		read_pos += 2;
+		while ((read_pos < bytes - 1)
+		       && ((string[read_pos] >= '0' && string[read_pos] <= '9')
+			   || (';' == string[read_pos])
+		       )
+		    ) {
+			read_pos++;
+		}
+	}
+	raw_string[write_pos] = '\0';
+	raw_bytes = write_pos;
+
+	width = raw_bytes;
+
+#if defined(ENABLE_NLS) && defined(HAVE_WCHAR_H)
+	/*@-nullpass@ */
+	/*
+	 * splint note: mbstowcs() manual page on Linux explicitly says it
+	 * takes NULL.
+	 */
+	wide_char_count = mbstowcs(NULL, raw_string, 0);
+	/*@+nullpass@ */
+	if (wide_char_count == (size_t) -1) {
+		debug("%s: %s: %s", "mbstowcs", raw_string, strerror(errno));
+		if (NULL != allocated_raw)
+			free(allocated_raw);
+		return raw_bytes;
+	}
+
+	wide_string_buffer_size = sizeof(*wide_string) * (1 + wide_char_count);
+
+	if (wide_string_buffer_size < sizeof(internal_wide)) {
+		wide_string = internal_wide;
+	} else {
+		allocated_wide = malloc(wide_string_buffer_size);
+		if (NULL == allocated_wide) {
+			perror("malloc");
+			if (NULL != allocated_raw)
+				free(allocated_raw);
+			return raw_bytes;
+		}
+		wide_string = allocated_wide;
+	}
+	memset(wide_string, 0, wide_string_buffer_size);
+
+	if (mbstowcs(wide_string, raw_string, 1 + wide_char_count) == (size_t) -1) {
+		debug("%s: %s: %s", "mbstowcs", raw_string, strerror(errno));
+	} else if (NULL != wide_string) {
+		/*@-unrecog@ *//* splint seems unable to see the prototype. */
+		width = wcswidth(wide_string, wide_char_count);
+		/*@+unrecog@ */
+	} else {
+		width = 0;
+	}
+
+	if (NULL != allocated_wide)
+		free(allocated_wide);
+#endif				/* defined(ENABLE_NLS) && defined(HAVE_WCHAR_H) */
+
+	if (NULL != allocated_raw)
+		free(allocated_raw);
+
+	return width;
+}
+
+
+/*
+ * Return true if the character is printable.  This function is used instead
+ * of the macro from <ctype.h> to avoid causing versioned glibc dependencies
+ * on some systems.
+ */
+bool pv_isprint(char c)
+{
+	return ((c >= (char) 32) && (c <= (char) 126)) ? true : false;
+}

src/pv/watchpid.c

@@ -1,9 +1,9 @@
 /*
  * Functions for watching file descriptors in other processes.
  *
- * Copyright 2002-2008, 2010, 2012-2015, 2017, 2021, 2023 Andrew Wood
+ * Copyright 2002-2008, 2010, 2012-2015, 2017, 2021, 2023-2025 Andrew Wood
  *
- * Distributed under the Artistic License v2.0; see `doc/COPYING'.
+ * License GPLv3+: GNU GPL version 3 or later; see `docs/COPYING'.
  */
 
 #include "config.h"
@@ -31,8 +31,19 @@
 #include <sys/proc_info.h>
 #endif
 
-int filesize(pvwatchfd_t info)
+/*@-type@*/
+/* splint has trouble with off_t and mode_t. */
+
+/*
+ * Set info->size to the size of the file info->file_fdpath points to,
+ * assuming that info->sb_fd has been populated by stat(), or to 0 if the
+ * file size could not be determined or the file was opened in write mode;
+ * returns false if the file was not a block device or regular file.
+ */
+static bool filesize(pvwatchfd_t info)
 {
+	if (NULL == info)
+		return false;
 	if (S_ISBLK(info->sb_fd.st_mode)) {
 		int fd;
 
@@ -40,10 +51,25 @@ int filesize(pvwatchfd_t info)
 		 * Get the size of block devices by opening
 		 * them and seeking to the end.
 		 */
-		fd = open(info->file_fdpath, O_RDONLY);
+		fd = open(info->file_fdpath, O_RDONLY);	/* flawfinder: ignore */
+		/*
+		 * flawfinder: redirection check below; risk is minimal as
+		 * we are not actually reading any data here.
+		 */
 		if (fd >= 0) {
-			info->size = lseek(fd, 0, SEEK_END);
-			close(fd);
+			/*
+			 * TOCTOU mitigation: check it's still a block
+			 * device before trying to seek to the end. 
+			 * Otherwise treat it as unreadable and set the size
+			 * to 0.
+			 */
+			struct stat check_fd_sb;
+			memset(&check_fd_sb, 0, sizeof(check_fd_sb));
+			info->size = 0;
+			if (0 == fstat(fd, &check_fd_sb) && S_ISBLK(check_fd_sb.st_mode)) {
+				info->size = lseek(fd, 0, SEEK_END);
+			}
+			(void) close(fd);
 		} else {
 			info->size = 0;
 		}
@@ -52,14 +78,16 @@ int filesize(pvwatchfd_t info)
 			info->size = info->sb_fd.st_size;
 		}
 	} else {
-		return 4;
+		return false;
 	}
 
-	return 0;
+	return true;
 }
 
+/*@+type@*/
+
 #ifdef __APPLE__
-int pv_watchfd_info(pvstate_t state, pvwatchfd_t info, int automatic)
+int pv_watchfd_info(pvstate_t state, pvwatchfd_t info, bool automatic)
 {
 	struct vnode_fdinfowithpath vnodeInfo = { };
 
@@ -70,7 +98,7 @@ int pv_watchfd_info(pvstate_t state, pvwatchfd_t info, int automatic)
 
 	if (kill(info->watch_pid, 0) != 0) {
 		if (!automatic)
-			pv_error(state, "%s %u: %s", _("pid"), info->watch_pid, strerror(errno));
+			pv_error("%s %u: %s", _("pid"), info->watch_pid, strerror(errno));
 		return 1;
 	}
 
@@ -79,8 +107,7 @@ int pv_watchfd_info(pvstate_t state, pvwatchfd_t info, int automatic)
 				  PROC_PIDFDVNODEPATHINFO, &vnodeInfo,
 				  PROC_PIDFDVNODEPATHINFO_SIZE);
 	if (size != PROC_PIDFDVNODEPATHINFO_SIZE) {
-		pv_error(state, "%s %u: %s %d: %s",
-			 _("pid"), info->watch_pid, _("fd"), info->watch_fd, strerror(errno));
+		pv_error("%s %u: %s %d: %s", _("pid"), info->watch_pid, _("fd"), info->watch_fd, strerror(errno));
 		return 3;
 	}
 
@@ -90,15 +117,15 @@ int pv_watchfd_info(pvstate_t state, pvwatchfd_t info, int automatic)
 
 	if (!(0 == stat(info->file_fdpath, &(info->sb_fd)))) {
 		if (!automatic)
-			pv_error(state, "%s %u: %s %d: %s: %s",
+			pv_error("%s %u: %s %d: %s: %s",
 				 _("pid"),
 				 info->watch_pid, _("fd"), info->watch_fd, info->file_fdpath, strerror(errno));
 		return 3;
 	}
 
-	if (filesize(info) != 0) {
+	if (!filesize(info)) {
 		if (!automatic)
-			pv_error(state, "%s %u: %s %d: %s: %s",
+			pv_error("%s %u: %s %d: %s: %s",
 				 _("pid"),
 				 info->watch_pid,
 				 _("fd"), info->watch_fd, info->file_fdpath, _("not a regular file or block device"));
@@ -123,11 +150,11 @@ int pv_watchfd_info(pvstate_t state, pvwatchfd_t info, int automatic)
  *   3 - stat or lstat on /proc/pid/fd/N failed
  *   4 - file descriptor is not opened on a regular file
  *
- * If "automatic" is nonzero, then this fd was picked automatically, and so
- * if it's not readable or not a regular file, no error is displayed and the
+ * If "automatic" is true, then this fd was picked automatically, and so if
+ * it's not readable or not a regular file, no error is displayed and the
  * function just returns an error code.
  */
-int pv_watchfd_info(pvstate_t state, pvwatchfd_t info, int automatic)
+int pv_watchfd_info(pvstate_t state, pvwatchfd_t info, bool automatic)
 {
 	if (NULL == state)
 		return -1;
@@ -136,7 +163,7 @@ int pv_watchfd_info(pvstate_t state, pvwatchfd_t info, int automatic)
 
 	if (kill(info->watch_pid, 0) != 0) {
 		if (!automatic)
-			pv_error(state, "%s %u: %s", _("pid"), info->watch_pid, strerror(errno));
+			pv_error("%s %u: %s", _("pid"), info->watch_pid, strerror(errno));
 		return 1;
 	}
 	(void) pv_snprintf(info->file_fdinfo, PV_SIZEOF_FILE_FDINFO,
@@ -144,9 +171,17 @@ int pv_watchfd_info(pvstate_t state, pvwatchfd_t info, int automatic)
 	(void) pv_snprintf(info->file_fd, PV_SIZEOF_FILE_FD, "/proc/%u/fd/%d", info->watch_pid, info->watch_fd);
 
 	memset(info->file_fdpath, 0, PV_SIZEOF_FILE_FDPATH);
-	if (readlink(info->file_fd, info->file_fdpath, PV_SIZEOF_FILE_FDPATH - 1) < 0) {
+	if (readlink(info->file_fd, info->file_fdpath, PV_SIZEOF_FILE_FDPATH - 1) < 0) {	/* flawfinder: ignore */
+		/*
+		 * flawfinder: memset() has put \0 at the end already, and
+		 * we tell readlink() to use 1 byte less than the buffer
+		 * length, so \0 termination is assured.  There is no
+		 * mitigation for the risk of the link changing while we
+		 * read it, but we are only reading from the destination,
+		 * and then only if it's a block device - see filesize().
+		 */
 		if (!automatic)
-			pv_error(state, "%s %u: %s %d: %s",
+			pv_error("%s %u: %s %d: %s",
 				 _("pid"), info->watch_pid, _("fd"), info->watch_fd, strerror(errno));
 		return 2;
 	}
@@ -154,7 +189,7 @@ int pv_watchfd_info(pvstate_t state, pvwatchfd_t info, int automatic)
 	if (!((0 == stat(info->file_fd, &(info->sb_fd)))
 	      && (0 == lstat(info->file_fd, &(info->sb_fd_link))))) {
 		if (!automatic)
-			pv_error(state, "%s %u: %s %d: %s: %s",
+			pv_error("%s %u: %s %d: %s: %s",
 				 _("pid"),
 				 info->watch_pid, _("fd"), info->watch_fd, info->file_fdpath, strerror(errno));
 		return 3;
@@ -162,14 +197,13 @@ int pv_watchfd_info(pvstate_t state, pvwatchfd_t info, int automatic)
 
 	info->size = 0;
 
-	int ret = filesize(info);
-	if (ret != 0) {
+	if (!filesize(info)) {
 		if (!automatic)
-			pv_error(state, "%s %u: %s %d: %s: %s",
+			pv_error("%s %u: %s %d: %s: %s",
 				 _("pid"),
 				 info->watch_pid,
 				 _("fd"), info->watch_fd, info->file_fdpath, _("not a regular file or block device"));
-		return ret;
+		return 4;
 	}
 
 	return 0;
@@ -177,32 +211,38 @@ int pv_watchfd_info(pvstate_t state, pvwatchfd_t info, int automatic)
 #endif
 
 #ifdef __APPLE__
-int pv_watchfd_changed(pvwatchfd_t info)
+bool pv_watchfd_changed(pvwatchfd_t info)
 {
-	return 1;
+	return true;
 }
 #else
 /*
- * Return nonzero if the given file descriptor has changed in some way since
- * we started looking at it (i.e.  changed destination or permissions).
+ * Return true if the given file descriptor has changed in some way since
+ * we started looking at it (i.e. changed destination or permissions).
  */
-int pv_watchfd_changed(pvwatchfd_t info)
+bool pv_watchfd_changed(pvwatchfd_t info)
 {
 	struct stat sb_fd, sb_fd_link;
 
+	if (NULL == info)
+		return false;
+
+	memset(&sb_fd, 0, sizeof(sb_fd));
+	memset(&sb_fd_link, 0, sizeof(sb_fd_link));
+
 	if ((0 == stat(info->file_fd, &sb_fd))
 	    && (0 == lstat(info->file_fd, &sb_fd_link))) {
 		if ((sb_fd.st_dev != info->sb_fd.st_dev)
 		    || (sb_fd.st_ino != info->sb_fd.st_ino)
 		    || (sb_fd_link.st_mode != info->sb_fd_link.st_mode)
 		    ) {
-			return 1;
+			return true;
 		}
 	} else {
-		return 1;
+		return true;
 	}
 
-	return 0;
+	return false;
 }
 #endif
 
@@ -211,9 +251,9 @@ int pv_watchfd_changed(pvwatchfd_t info)
  * Return the current file position of the given file descriptor, or -1 if
  * the fd has closed or has changed in some way.
  */
-long long pv_watchfd_position(pvwatchfd_t info)
+off_t pv_watchfd_position(pvwatchfd_t info)
 {
-	long long position;
+	off_t position;
 #ifdef __APPLE__
 	struct vnode_fdinfowithpath vnodeInfo = { };
 	int32_t proc_fd = (int32_t) info->watch_fd;
@@ -225,22 +265,36 @@ long long pv_watchfd_position(pvwatchfd_t info)
 		return -1;
 	}
 
-	position = (long long) vnodeInfo.pfi.fi_offset;
+	position = (off_t) vnodeInfo.pfi.fi_offset;
 #else
+	long long pos_long;
 	FILE *fptr;
 
+	if (NULL == info)
+		return -1;
+
 	if (pv_watchfd_changed(info))
 		return -1;
 
-	fptr = fopen(info->file_fdinfo, "r");
+	fptr = fopen(info->file_fdinfo, "r");	/* flawfinder: ignore */
+	/* flawfinder: trusted location (/proc). */
 	if (NULL == fptr)
 		return -1;
+	pos_long = -1;
 	position = -1;
-	if (1 != fscanf(fptr, "pos: %llu", &position))
-		position = -1;
-	fclose(fptr);
+	if (1 == fscanf(fptr, "pos: %lld", &pos_long)) {
+		position = (off_t) pos_long;
+	}
+	(void) fclose(fptr);
 #endif
 
+	/*
+	 * This debugging line can be quite noisy - turned off for now,
+	 * uncomment if needed.
+	 *
+	 * debug("pid:%d fd:%d position:%lld", (int) (info->watch_pid), info->watch_fd, position);
+	 */
+
 	return position;
 }
 
@@ -250,7 +304,7 @@ static int pidfds(pvstate_t state, unsigned int pid, struct proc_fdinfo **fds, i
 {
 	int size_needed = proc_pidinfo(pid, PROC_PIDLISTFDS, 0, 0, 0);
 	if (size_needed == -1) {
-		pv_error(state, "%s: unable to list pid fds: %s", _("pid"), strerror(errno));
+		pv_error("%s: unable to list pid fds: %s", _("pid"), strerror(errno));
 		return -1;
 	}
 
@@ -258,9 +312,10 @@ static int pidfds(pvstate_t state, unsigned int pid, struct proc_fdinfo **fds, i
 
 	*fds = (struct proc_fdinfo *) malloc(size_needed);
 	if (*fds == NULL) {
-		pv_error(state, "%s: alloc failed: %s", _("pid"), strerror(errno));
+		pv_error("%s: alloc failed: %s", _("pid"), strerror(errno));
 		return -1;
 	}
+	memset(*fds, 0, size_needed);
 
 	proc_pidinfo(pid, PROC_PIDLISTFDS, 0, *fds, size_needed);
 
@@ -268,34 +323,136 @@ static int pidfds(pvstate_t state, unsigned int pid, struct proc_fdinfo **fds, i
 }
 #endif
 
+/*@-compdestroy @ */
+/*@-usereleased @ */
+/*@-compdef @ */
+
+/*
+ * splint: extending or creating entries and then zeroing them makes splint
+ * believe that data previously there may refer to pointers that are now
+ * lost - but these are newly added array entries so there is no loss.
+ */
+
+/*
+ * Extend the info array by one, returning false on error.
+ */
+static bool extend_info_array(int *array_length_ptr, pvwatchfd_t * info_array_ptr)
+{
+	int array_length = 0;
+	struct pvwatchfd_s *info_array = NULL;
+	struct pvwatchfd_s *new_info_array;
+
+	array_length = *array_length_ptr;
+	info_array = *info_array_ptr;
+
+	array_length++;
+
+	if (NULL == info_array) {
+		new_info_array = malloc(array_length * sizeof(*info_array));
+		if (NULL != new_info_array)
+			memset(new_info_array, 0, array_length * sizeof(*info_array));
+	} else {
+		new_info_array = realloc(info_array, array_length * sizeof(*info_array));
+		if (NULL != new_info_array)
+			memset(&(new_info_array[array_length - 1]), 0, sizeof(*info_array));
+	}
+
+	if (NULL == new_info_array) {
+		return false;
+	}
+
+	new_info_array[array_length - 1].unused = true;
+
+	debug("%s", "extended info array");
+
+	*info_array_ptr = new_info_array;
+	*array_length_ptr = array_length;
+	return true;
+}
+
+/*@+compdestroy @ */
+/*@+usereleased @ */
+/*@+compdef @ */
+
+
+/*
+ * Reset calculated values in the given watchfd info structure.
+ */
+void pv_reset_watchfd(pvwatchfd_t info)
+{
+	if (NULL == info)
+		return;
+	pv_reset_calc(&(info->calc));
+	pv_reset_transfer(&(info->transfer));
+	pv_reset_flags(&(info->flags));
+	pv_reset_display(&(info->display));
+}
+
+
+/*
+ * Free dynamically allocated areas in the given watchfd info structure.
+ */
+void pv_freecontents_watchfd(pvwatchfd_t info)
+{
+	if (NULL == info)
+		return;
+	pv_freecontents_calc(&(info->calc));
+	pv_freecontents_transfer(&(info->transfer));
+	pv_freecontents_display(&(info->display));
+}
+
+
+/*
+ * Comparison function for qsort, to compare two pvwatchfd_s structures.
+ */
+static int pv_compare_watchfd(const void *a, const void *b)
+{
+	int fd_a, fd_b;
+
+	fd_a = 0;
+	fd_b = 0;
+	if (NULL != a)
+		fd_a = ((pvwatchfd_t) a)->watch_fd;
+	if (NULL != b)
+		fd_b = ((pvwatchfd_t) b)->watch_fd;
+
+	if (fd_a < fd_b)
+		return -1;
+	if (fd_a > fd_b)
+		return 1;
+	return 0;
+}
+
+
 /*
  * Scan the given process and update the arrays with any new file
- * descriptors.
+ * descriptors.  If "watch_fd" is not -1, then all other file descriptor
+ * numbers will be ignored,
  *
  * Returns 0 on success, 1 if the process no longer exists or could not be
  * read, or 2 for a memory allocation error.
  */
-int pv_watchpid_scanfds(pvstate_t state, pvstate_t pristine,
-			unsigned int watch_pid, int *array_length_ptr,
-			pvwatchfd_t * info_array_ptr, pvstate_t * state_array_ptr, int *fd_to_idx)
+int pv_watchpid_scanfds(pvstate_t state, pid_t watch_pid, int watch_fd, int *array_length_ptr,
+			pvwatchfd_t * info_array_ptr)
 {
-	char fd_dir[512] = { 0, };
 	int array_length = 0;
 	struct pvwatchfd_s *info_array = NULL;
-	struct pvstate_s *state_array = NULL;
+	bool changes_made;
 
 #ifdef __APPLE__
 	struct proc_fdinfo *fd_infos = NULL;
 	int fd_infos_count = 0;
 
 	if (pidfds(state, watch_pid, &fd_infos, &fd_infos_count) != 0) {
-		pv_error(state, "%s: pidfds failed", _("pid"));
+		pv_error("%s: pidfds failed", _("pid"));
 		return -1;
 	}
 #else
+	char fd_dir[512];		 /* flawfinder: ignore - zeroed, bounded with pv_snprintf(). */
 	DIR *dptr;
 	struct dirent *d;
 
+	memset(fd_dir, 0, sizeof(fd_dir));
 	(void) pv_snprintf(fd_dir, sizeof(fd_dir), "/proc/%u/fd", watch_pid);
 
 	dptr = opendir(fd_dir);
@@ -305,19 +462,20 @@ int pv_watchpid_scanfds(pvstate_t state, pvstate_t pristine,
 
 	array_length = *array_length_ptr;
 	info_array = *info_array_ptr;
-	state_array = *state_array_ptr;
+
+	changes_made = false;
 
 #ifdef __APPLE__
 	if (fd_infos_count < 1) {
-		pv_error(state, "%s: no fds found", _("pid"));
+		pv_error("%s: no fds found", _("pid"));
 		return -1;
 	}
 	for (int i = 0; i < fd_infos_count; i++) {
 #else
 	while ((d = readdir(dptr)) != NULL) {
 #endif
-		int fd, check_idx, use_idx, rc;
-		long long position_now;
+		int fd, check_idx, found_idx, use_idx, rc;
+		off_t position_now;
 
 		fd = -1;
 #ifdef __APPLE__
@@ -325,129 +483,136 @@ int pv_watchpid_scanfds(pvstate_t state, pvstate_t pristine,
 #else
 		if (sscanf(d->d_name, "%d", &fd) != 1)
 			continue;
-		if ((fd < 0) || (fd >= FD_SETSIZE))
-			continue;
 #endif
+
+		/* Skip if the fd is negative. */
+		if (fd < 0)
+			continue;
+
+		/* If a watch_fd was specified, skip if this isn't it. */
+		if (watch_fd >= 0 && watch_fd != fd)
+			continue;
+
 		/*
 		 * Skip if this fd is already known to us.
 		 */
-		if (fd_to_idx[fd] != -1) {
-			continue;
+		found_idx = -1;
+		for (check_idx = 0; check_idx < array_length && NULL != info_array; check_idx++) {
+			if (info_array[check_idx].unused)
+				continue;
+			if (info_array[check_idx].watch_fd != fd)
+				continue;
+			if (info_array[check_idx].closed) {
+				/*
+				 * If the fd is known but closed,
+				 * immediately free it for re-use.
+				 */
+				info_array[check_idx].unused = true;
+				info_array[check_idx].displayable = false;
+				pv_freecontents_watchfd(&(info_array[check_idx]));
+				continue;
+			}
+			found_idx = check_idx;
+			break;
 		}
+		if (found_idx >= 0)
+			continue;
 
 		/*
-		 * See if there's an empty slot we can re-use. An empty slot
-		 * has a watch_pid of 0.
+		 * See if there's an empty slot we can re-use.
 		 */
 		use_idx = -1;
-		for (check_idx = 0; check_idx < array_length; check_idx++) {
-			if (info_array[check_idx].watch_pid == 0) {
+		for (check_idx = 0; check_idx < array_length && NULL != info_array; check_idx++) {
+			if (info_array[check_idx].unused) {
 				use_idx = check_idx;
 				break;
 			}
 		}
 
 		/*
-		 * If there's no empty slot, extend the arrays.
+		 * If there's no empty slot, extend the array.
 		 */
 		if (use_idx < 0) {
-			struct pvwatchfd_s *new_info_array;
-			struct pvstate_s *new_state_array;
-
-			array_length++;
+			if (!extend_info_array(array_length_ptr, info_array_ptr))
+				return 2;
+			array_length = *array_length_ptr;
+			info_array = *info_array_ptr;
 			use_idx = array_length - 1;
-
-			if (NULL == info_array) {
-				new_info_array = malloc(array_length * sizeof(*info_array));
-			} else {
-				new_info_array = realloc(info_array, array_length * sizeof(*info_array));
-			}
-			if (NULL == new_info_array)
-				return 2;
-			info_array = new_info_array;
-			*info_array_ptr = info_array;
-			info_array[use_idx].watch_pid = 0;
-
-			if (NULL == state_array) {
-				new_state_array = malloc(array_length * sizeof(*state_array));
-			} else {
-				new_state_array = realloc(state_array, array_length * sizeof(*state_array));
-			}
-			if (NULL == new_state_array)
-				return 2;
-			state_array = new_state_array;
-			*state_array_ptr = state_array;
-
-			*array_length_ptr = array_length;
-
-			for (check_idx = 0; check_idx < array_length; check_idx++) {
-				state_array[check_idx].name = info_array[check_idx].display_name;
-				state_array[check_idx].reparse_display = 1;
-			}
 		}
 
+		/* At this point, the array should exist. */
+		if (NULL == info_array)
+			return 2;
+
 		debug("%s: %d => index %d", "found new fd", fd, use_idx);
 
+		changes_made = true;
+
 		/*
 		 * Initialise the details of this new entry.
 		 */
-		memcpy(&(state_array[use_idx]), pristine, sizeof(*pristine));
 		memset(&(info_array[use_idx]), 0, sizeof(info_array[use_idx]));
 
+		pv_reset_watchfd(&(info_array[use_idx]));
 		info_array[use_idx].watch_pid = watch_pid;
 		info_array[use_idx].watch_fd = fd;
+		info_array[use_idx].closed = false;
+		info_array[use_idx].unused = false;
+		info_array[use_idx].displayable = true;
+
+		/*
+		 * Set the average rate window so that a new history buffer
+		 * is allocated for this state.
+		 */
+		(void) pv_update_calc_average_rate_window(&(info_array[use_idx].calc),
+							  state->control.average_rate_window);
+
 #ifdef __APPLE__
 		if (fd_infos[i].proc_fdtype != PROX_FDTYPE_VNODE) {
 			continue;
 		}
 #endif
-		rc = pv_watchfd_info(state, &(info_array[use_idx]), 1);
+		/* Retrieve the details of this file descriptor. */
+		rc = pv_watchfd_info(state, &(info_array[use_idx]), -1 == watch_fd ? true : false);
 
 		/*
 		 * Lookup failed - mark this slot as being free for re-use.
 		 */
 		if ((rc != 0) && (rc != 4)) {
-			info_array[use_idx].watch_pid = 0;
 			debug("%s %d: %s: %d", "fd", fd, "lookup failed - marking slot for re-use", use_idx);
+			pv_freecontents_watchfd(&(info_array[use_idx]));
+			info_array[use_idx].unused = true;
+			info_array[use_idx].displayable = false;
 			continue;
 		}
 
-		fd_to_idx[fd] = use_idx;
-
 		/*
-		 * Not displayable - set fd to -1 so the main loop doesn't
-		 * show it.
+		 * Not displayable - mark it as such so the main loop
+		 * doesn't show it.
 		 */
 		if (rc != 0) {
 			debug("%s %d: %s", "fd", fd, "marking as not displayable");
-			info_array[use_idx].watch_fd = -1;
+			info_array[use_idx].displayable = false;
 		}
 
-		state_array[use_idx].size = info_array[use_idx].size;
-		if (state_array[use_idx].size < 1) {
-			char *fmt;
-			while (NULL != (fmt = strstr(state_array[use_idx].default_format, "%e"))) {
-				debug("%s", "zero size - removing ETA");
-				/* strlen-1 here to include trailing NUL */
-				memmove(fmt, fmt + 2, strlen(fmt) - 1);
-				state_array[use_idx].reparse_display = 1;
-			}
-		}
-
-		state_array[use_idx].name = info_array[use_idx].display_name;
-
+		/* Set the info display_name appropriately. */
 		pv_watchpid_setname(state, &(info_array[use_idx]));
 
-		state_array[use_idx].reparse_display = 1;
+		/* Force the display to be re-parsed. */
+		info_array[use_idx].flags.reparse_display = 1;
 
-		gettimeofday(&(info_array[use_idx].start_time), NULL);
+		pv_elapsedtime_read(&(info_array[use_idx].start_time));
 
-		state_array[use_idx].initial_offset = 0;
+		/*
+		 * Set the starting position (and initial offset, for the
+		 * display), if known, so that ETA and so on are calculated
+		 * correctly.
+		 */
+		info_array[use_idx].display.initial_offset = 0;
 		info_array[use_idx].position = 0;
-
 		position_now = pv_watchfd_position(&(info_array[use_idx]));
 		if (position_now >= 0) {
-			state_array[use_idx].initial_offset = position_now;
+			info_array[use_idx].display.initial_offset = position_now;
 			info_array[use_idx].position = position_now;
 		}
 	}
@@ -456,9 +621,17 @@ int pv_watchpid_scanfds(pvstate_t state, pvstate_t pristine,
 #ifdef __APPLE__
 	free(fd_infos);
 #else
-	closedir(dptr);
+	(void) closedir(dptr);
 #endif
 
+	/*
+	 * If any changes were made (i.e. new file descriptors were found),
+	 * sort the array so that file descriptors are always displayed in
+	 * ascending numerical order.
+	 */
+	if (changes_made && NULL != info_array && array_length > 1)
+		qsort(info_array, (size_t) array_length, sizeof(info_array[0]), pv_compare_watchfd);
+
 	return 0;
 }
 
@@ -467,43 +640,67 @@ int pv_watchpid_scanfds(pvstate_t state, pvstate_t pristine,
  * Set the display name for the given watched file descriptor, truncating at
  * the relevant places according to the current screen width.
  *
+ * If more than one distinct PID is being watched, include the PID in the
+ * name as well as the file descriptor number.
+ *
  * If the file descriptor is pointing to a file under the current working
  * directory, show its relative path, not the full path.
  */
 void pv_watchpid_setname(pvstate_t state, pvwatchfd_t info)
 {
-	int path_length, cwd_length, max_display_length;
-	char *file_fdpath = info->file_fdpath;
+	size_t path_length, cwd_length;
+	int max_display_length;
+	char *file_fdpath;
+
+	if (NULL == info)
+		return;
+
+	file_fdpath = info->file_fdpath;
 
 	memset(info->display_name, 0, PV_SIZEOF_DISPLAY_NAME);
 
-	path_length = strlen(info->file_fdpath);
-	cwd_length = strlen(state->cwd);
+	path_length = strlen(info->file_fdpath);	/* flawfinder: ignore */
+	cwd_length = strlen(state->status.cwd);	/* flawfinder: ignore */
+	/* flawfinder: both strings are always \0 terminated. */
 	if (cwd_length > 0 && path_length > cwd_length) {
-		if (0 == strncmp(info->file_fdpath, state->cwd, cwd_length)) {
+		if (0 == strncmp(info->file_fdpath, state->status.cwd, cwd_length)) {
 			file_fdpath += cwd_length + 1;
 			path_length -= cwd_length + 1;
 		}
 	}
 
-	max_display_length = (state->width / 2) - 6;
-	if (max_display_length >= path_length) {
-		(void) pv_snprintf(info->display_name,
-				   PV_SIZEOF_DISPLAY_NAME, "%4d:%.498s", info->watch_fd, file_fdpath);
+	max_display_length = (int) (state->control.width / 2) - 6;
+	if (state->watchfd.multiple_pids)
+		max_display_length -= 9;
+	if (max_display_length >= (int) path_length) {
+		if (state->watchfd.multiple_pids) {
+			(void) pv_snprintf(info->display_name,
+					   PV_SIZEOF_DISPLAY_NAME, "%8d:%4d:%.498s", (int) (info->watch_pid),
+					   info->watch_fd, file_fdpath);
+		} else {
+			(void) pv_snprintf(info->display_name,
+					   PV_SIZEOF_DISPLAY_NAME, "%4d:%.498s", info->watch_fd, file_fdpath);
+		}
 	} else {
 		int prefix_length, suffix_length;
 
 		prefix_length = max_display_length / 4;
 		suffix_length = max_display_length - prefix_length - 3;
 
-		(void) pv_snprintf(info->display_name,
-				   PV_SIZEOF_DISPLAY_NAME,
-				   "%4d:%.*s...%.*s",
-				   info->watch_fd, prefix_length,
-				   file_fdpath, suffix_length, file_fdpath + path_length - suffix_length);
+		if (state->watchfd.multiple_pids) {
+			(void) pv_snprintf(info->display_name,
+					   PV_SIZEOF_DISPLAY_NAME,
+					   "%8d:%4d:%.*s...%.*s",
+					   (int) (info->watch_pid), info->watch_fd, prefix_length,
+					   file_fdpath, suffix_length, file_fdpath + path_length - suffix_length);
+		} else {
+			(void) pv_snprintf(info->display_name,
+					   PV_SIZEOF_DISPLAY_NAME,
+					   "%4d:%.*s...%.*s",
+					   info->watch_fd, prefix_length,
+					   file_fdpath, suffix_length, file_fdpath + path_length - suffix_length);
+		}
 	}
 
 	debug("%s: %d: [%s]", "set name for fd", info->watch_fd, info->display_name);
 }
-
-/* EOF */

tests/Bug_-_Display_length_at_magnitude_boundary_-_Bytes.test

@@ -4,8 +4,11 @@
 # 1MiB, described here:
 # http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=586763
 
-# Dummy assignments for "shellcheck".
-testSubject="${testSubject:-false}"; workFile1="${workFile1:-.tmp1}"
+# Allow all tests to be skipped, e.g. during a release build
+test "${SKIP_ALL_TESTS}" = "1" && exit 77
+
+true "${testSubject:?not set - call this from 'make check'}"
+true "${workFile1:?not set - call this from 'make check'}"
 
 # Transfer 1500kB of data in a bursty fashion.
 #
@@ -28,5 +31,3 @@ test "${lineLengthCount}" = "1" && exit 0
 echo "variable line lengths detected"
 tr '\r' '\n' < "${workFile1}"
 exit 1
-
-# EOF