开源软件构建与测试

We truncated the diff of some files because they were too big. If you want to see the full diff for every file, click here.

Changes of Revision 2

_service:extract_file:procps-ng.spec Deleted

@@ -1,177 +0,0 @@
-Name: 		procps-ng
-Version: 	3.3.17
-Release:	2
-Summary: 	Utilities that provide system information.
-License: 	GPL+ and GPLv2 and GPLv2+ and GPLv3+ and LGPLv2+
-URL: 		https://sourceforge.net/projects/procps-ng/
-
-Source0: 	http://downloads.sourceforge.net/%{name}/%{name}-%{version}.tar.xz
-Source1: 	README.md
-Source2: 	README.top
-
-Patch1: 	0001-top-fix-two-potential-alternate-display-mode-abends.patch
-Patch2: 	0002-top-In-the-bye_bye-function-replace-fputs-with-the-w.patch
-Patch3: 	0003-add-options-M-and-N-for-top.patch
-Patch4: 	0004-top-exit-with-error-when-pid-overflow.patch
-Patch5:		0005-fix-a-fix-for-the-bye_bye-function.patch
-
-BuildRequires: 	ncurses-devel libtool autoconf automake gcc gettext-devel systemd-devel
-
-Provides: 	procps = %{version}-%{release}
-Provides: 	%{name}	
-
-%description
-The procps package contains a set of system utilities that provide
-system information. Procps includes ps, free, skill, pkill, pgrep,
-snice, tload, top, uptime, vmstat, pidof, pmap, slabtop, w, watch
-and pwdx.
-
-%package 	devel
-Summary:  	The devel for %{name} 
-Requires: 	%{name} = %{version}-%{release}
-Provides: 	procps-devel = %{version}-%{release}
-
-%description 	devel
-System and process monitoring utilities
-
-%package 	i18n
-Summary:  	Internationalization pack for %{name} 
-Requires: 	%{name} = %{version}-%{release}
-BuildArch: 	noarch
-
-%description 	i18n
-The package is used for the Internationalization of %{name}
-
-%package_help
-
-%prep
-%autosetup -n procps-%{version} -p1
-
-cp -p %{SOURCE1} .
-cp -p %{SOURCE2} top/
-
-%build
-autoreconf -ivf
-
-%configure  --exec-prefix=/ --docdir=/unwanted --disable-w-from --disable-kill --enable-watch8bit \
-           --enable-skill --enable-sigwinch --enable-libselinux --with-systemd --disable-modern-top
-
-make CFLAGS="%{optflags}"
-
-%install
-%make_install
-
-%find_lang %{name} --all-name --with-man
-
-ln -s %{_bindir}/pidof %{buildroot}%{_sbindir}/pidof
-
-%ldconfig_scriptlets
-
-%files
-%doc COPYING COPYING.LIB
-%{!?_licensedir:%global license %%doc}
-%license COPYING COPYING.LIB
-%{_libdir}/libprocps.so.*
-%{_bindir}/*
-%{_sbindir}/*
-%exclude %{_libdir}/libprocps.la
-%exclude /unwanted/*
-%exclude %{_libdir}/*.a
-
-%files devel
-%doc COPYING COPYING.LIB
-%{!?_licensedir:%global license %%doc}
-%license COPYING COPYING.LIB
-%{_libdir}/libprocps.so
-%{_libdir}/pkgconfig/libprocps.pc
-%{_includedir}/proc
-
-%files i18n -f %{name}.lang
-
-%files help
-%doc AUTHORS Documentation/bugs.md Documentation/FAQ NEWS README.md top/README.top Documentation/TODO
-%{_mandir}/man*
-
-%changelog
-* Sat Jan 29 2022 zhouwenpei <zhouwenpei1@h-partners.com> - 3.3.17-2
-- fix file type chamges caused by top -b redirection
-
-* Thu Dec 2 2021 zhouwenpei <zhouwenpei1@huawei.com> - 3.3.17-1
-- update to 3.3.17
-
-* Wed Jun 30 2021 hewenliang <hewenliang4@huawei.com> - 3.3.16-16
-- sync patches
-
-* Sat Feb 27 2021 hewenliang <hewenliang4@huawei.com> - 3.3.16-15
-- sync patches
-
-* Sat Feb 27 2021 hewenliang <hewenliang4@huawei.com> - 3.3.16-14
-- sync patches
-
-* Thu Nov 03 2020 xinghe <xinghe1@huawei.com> - 3.3.16-13
-- sync patchs
-
-* Wed Sep 23 2020 MarsChan <chenmingmin@huawei.com> - 3.3.16-12
-- Type:bugfix
-- ID:NA
-- SUG:restart
-- DESC:A kernel change means we cannot trust what sysconf(SC_ARG_MAX)
-       returns. We clamp it so its more than 4096 and less than 128*1024
-       which is what findutils does.
-
-* Tue Jan 7 2020 MarsChan <chenmingmin@huawei.com> - 3.3.16-11
-- Type:upgrade
-- ID:NA
-- SUG:NA
-- DESC: upgrade to version 3.3.16 and delete the patch between
-        3.3.15 and 3.3.16.
-
-* Mon Dec 23 2019 wangshuo <wangshuo47@huawei.com> - 3.3.15-10
-- Type:bugfix
-- ID:NA
-- SUG:NA
-- DESC: add liscense to main and devel package.
-
-* Thu Dec 19 2019 openEuler Buildteam <buildteam@openeuler.org> - 3.3.15-9
-- Fix typo
-
-* Fri Mar 15 2019 xuwei<xuwei58@huawei.com> - 3.3.15-8
-- Type:bugfix
-- ID:NA
-- SUG:restart
-- DEC:top: don't mess with groff line length in man document
-      top: add another field sanity check in 'config_file()'
-      top: prevent buffer overruns in 'inspection_utility()'
-      docs: Tidying of ps,kill and skill manpages
-      library: avoid problems involving 'supgid' mishandling
-      w: Prevent out-of-bounds reads in
-      w: Clamp maxcmd to the MIN/MAX_CMD_WIDTH range.
-      vmstat: getopt*() returns -1 when done, not EOF.
-      vmstat: Replace memcmp() with strncmp().
-      vmstat: Check return values of localtime() and
-      vmstat: Prevent out-of-bounds writes in new_header()
-      top: the '#define PRETEND2_5_X' was found to be broken
-      procio: use the user-supplied delimiter to split large
-      procio: fix potential out-of-bounds access when write
-      sysctl: do not report set key in case `close_stream`
-
-* Tue Jan 29 2019 huangchangyu<huangchangyu@huawei.com> - 3.3.15-7
-- Type:bugfix
-- ID:NA
-- SUG:NA
-- DEC:sync patches
-
-* Wed Jan 23 2019 xuchunmei<xuchunmei@huawei.com> - 3.3.15-6
-- Type:bugfix
-- ID:NA
-- SUG:restart
-- DEC:top exit with error when pid overflow
-
-* Fri Jan 11 2019 xuchunmei<xuchunmei@huawei.com> - 3.3.15-5
-- Type:feature
-- ID:NA
-- SUG:restart
-- DEC:add options -M and -N for top
-
-* Sat Jul 18 2018 openEuler Buildteam <buildteam@openeuler.org> - 3.3.15-4
-- Package init

_service:tar_scm:procps-ng.spec Added

@@ -0,0 +1,191 @@
+Name: 		procps-ng
+Version: 	4.0.0
+Release:	4
+Summary: 	Utilities that provide system information.
+License: 	GPL+ and GPLv2 and GPLv2+ and GPLv3+ and LGPLv2+
+URL: 		https://sourceforge.net/projects/procps-ng/
+
+Source0: 	http://downloads.sourceforge.net/%{name}/%{name}-%{version}.tar.xz
+Source1: 	README.md
+Source2: 	README.top
+
+Patch1: 	0001-add-M-and-N-options-for-top.patch
+Patch2: 	0002-top-exit-with-error-when-pid-overflow.patch
+Patch3:		0003-top-eliminate-a-potential-abend-when-exiting-A-mode.patch
+Patch4:		0004-skill-Restore-the-p-flag-functionality.patch
+
+BuildRequires: 	ncurses-devel libtool autoconf automake gcc gettext-devel systemd-devel
+
+Provides: 	procps = %{version}-%{release}
+Provides: 	%{name}	
+
+%description
+The procps package contains a set of system utilities that provide
+system information. Procps includes ps, free, skill, pkill, pgrep,
+snice, tload, top, uptime, vmstat, pidof, pmap, slabtop, w, watch
+and pwdx.
+
+%package 	devel
+Summary:  	The devel for %{name} 
+Requires: 	%{name} = %{version}-%{release}
+Provides: 	procps-devel = %{version}-%{release}
+
+%description 	devel
+System and process monitoring utilities
+
+%package 	i18n
+Summary:  	Internationalization pack for %{name} 
+Requires: 	%{name} = %{version}-%{release}
+BuildArch: 	noarch
+
+%description 	i18n
+The package is used for the Internationalization of %{name}
+
+%package_help
+
+%prep
+%autosetup -n procps-ng-%{version} -p1
+
+cp -p %{SOURCE1} .
+cp -p %{SOURCE2} top/
+
+%build
+autoreconf -ivf
+
+%configure  --exec-prefix=/ --docdir=/unwanted --disable-w-from --disable-kill --enable-watch8bit \
+           --enable-skill --enable-sigwinch --enable-libselinux --with-systemd --disable-modern-top
+
+make CFLAGS="%{optflags}"
+
+%check
+make check
+
+%install
+%make_install
+
+%find_lang %{name} --all-name --with-man
+
+ln -s %{_bindir}/pidof %{buildroot}%{_sbindir}/pidof
+
+%ldconfig_scriptlets
+
+%files
+%doc COPYING COPYING.LIB
+%{!?_licensedir:%global license %%doc}
+%license COPYING COPYING.LIB
+%{_libdir}/libproc-2.so.*
+%{_bindir}/*
+%{_sbindir}/*
+%exclude %{_libdir}/libproc-2.la
+%exclude /unwanted/*
+%exclude %{_libdir}/*.a
+
+%files devel
+%doc COPYING COPYING.LIB
+%{!?_licensedir:%global license %%doc}
+%license COPYING COPYING.LIB
+%{_libdir}/libproc-2.so
+%{_libdir}/pkgconfig/libproc-2.pc
+%{_includedir}/procps
+
+%files i18n -f %{name}.lang
+
+%files help
+%doc AUTHORS Documentation/bugs.md Documentation/FAQ NEWS README.md top/README.top Documentation/TODO
+%{_mandir}/man*
+
+%changelog
+* Mon Dec 12 2022 Liu Chao <liuchao173@huawei.com> - 4.0.0-4
+- skill: Restore the -p flag functionality
+ 
+* Tue Nov 29 2022 zhoujie <zhoujie133@huawei.com> - 4.0.0-3
+- enable make check
+
+* Mon Nov 7 2022 zhoujie <zhoujie133@huawei.com> - 4.0.0-2
+- top eliminate a potential abend when exiting A mode
+
+* Fri Nov 4 2022 zhoujie <zhoujie133@huawei.com> - 4.0.0-1
+- update the release to 4.0.0-1
+
+* Sat Jan 29 2022 zhouwenpei <zhouwenpei1@h-partners.com> - 3.3.17-2
+- fix file type chamges caused by top -b redirection
+
+* Thu Dec 2 2021 zhouwenpei <zhouwenpei1@huawei.com> - 3.3.17-1
+- update to 3.3.17
+
+* Wed Jun 30 2021 hewenliang <hewenliang4@huawei.com> - 3.3.16-16
+- sync patches
+
+* Sat Feb 27 2021 hewenliang <hewenliang4@huawei.com> - 3.3.16-15
+- sync patches
+
+* Sat Feb 27 2021 hewenliang <hewenliang4@huawei.com> - 3.3.16-14
+- sync patches
+
+* Tue Nov 03 2020 xinghe <xinghe1@huawei.com> - 3.3.16-13
+- sync patchs
+
+* Wed Sep 23 2020 MarsChan <chenmingmin@huawei.com> - 3.3.16-12
+- Type:bugfix
+- ID:NA
+- SUG:restart
+- DESC:A kernel change means we cannot trust what sysconf(SC_ARG_MAX)
+       returns. We clamp it so its more than 4096 and less than 128*1024
+       which is what findutils does.
+
+* Tue Jan 7 2020 MarsChan <chenmingmin@huawei.com> - 3.3.16-11
+- Type:upgrade
+- ID:NA
+- SUG:NA
+- DESC: upgrade to version 3.3.16 and delete the patch between
+        3.3.15 and 3.3.16.
+
+* Mon Dec 23 2019 wangshuo <wangshuo47@huawei.com> - 3.3.15-10
+- Type:bugfix
+- ID:NA
+- SUG:NA
+- DESC: add liscense to main and devel package.
+
+* Thu Dec 19 2019 openEuler Buildteam <buildteam@openeuler.org> - 3.3.15-9
+- Fix typo
+
+* Fri Mar 15 2019 xuwei<xuwei58@huawei.com> - 3.3.15-8
+- Type:bugfix
+- ID:NA
+- SUG:restart
+- DEC:top: don't mess with groff line length in man document
+      top: add another field sanity check in 'config_file()'
+      top: prevent buffer overruns in 'inspection_utility()'
+      docs: Tidying of ps,kill and skill manpages
+      library: avoid problems involving 'supgid' mishandling
+      w: Prevent out-of-bounds reads in
+      w: Clamp maxcmd to the MIN/MAX_CMD_WIDTH range.
+      vmstat: getopt*() returns -1 when done, not EOF.
+      vmstat: Replace memcmp() with strncmp().
+      vmstat: Check return values of localtime() and
+      vmstat: Prevent out-of-bounds writes in new_header()
+      top: the '#define PRETEND2_5_X' was found to be broken
+      procio: use the user-supplied delimiter to split large
+      procio: fix potential out-of-bounds access when write
+      sysctl: do not report set key in case `close_stream`
+
+* Tue Jan 29 2019 huangchangyu<huangchangyu@huawei.com> - 3.3.15-7
+- Type:bugfix
+- ID:NA
+- SUG:NA
+- DEC:sync patches
+
+* Wed Jan 23 2019 xuchunmei<xuchunmei@huawei.com> - 3.3.15-6
+- Type:bugfix
+- ID:NA
+- SUG:restart
+- DEC:top exit with error when pid overflow
+
+* Fri Jan 11 2019 xuchunmei<xuchunmei@huawei.com> - 3.3.15-5
+- Type:feature
+- ID:NA
+- SUG:restart
+- DEC:add options -M and -N for top
+
+* Sat Jul 18 2018 openEuler Buildteam <buildteam@openeuler.org> - 3.3.15-4
+- Package init

_service:extract_file:0001-top-fix-two-potential-alternate-display-mode-abends.patch Deleted

@@ -1,79 +0,0 @@
-From 84e85611c36d31a478e1b62e5668671d9389265d Mon Sep 17 00:00:00 2001
-From: Jim Warner <james.warner@comcast.net>
-Date: Mon, 31 May 2021 00:00:00 -0500
-Subject: PATCH top: fix two potential 'alternate display mode' abends
-
-This commit will address potential abends upon leaving
-the windows help or color mapping screens and invoking
-alternate display mode ('A').  It only happens if that
-current window was changed with multiple 'a'/'w' keys.
-
-So now, rather than leaving a trail of negative values
-in the 'begtask' field, compliments of that win_select
-function, we'll remove the mkVIZrow1 macro. Henceforth
-it will be issued just once per user interaction. Thus
-a promise of 'Curwin' only being impacted is restored.
-
- my thanks to Vladimir Chren for reporting this bug 
-
-Reference(s):
-https://gitlab.com/procps-ng/procps/-/issues/210
-https://gitlab.com/procps-ng/procps/-/merge_requests/135
-
-Discovered by:Vladimir Chren <vladimir.chren@gmail.com>
-Signed-off-by: Jim Warner <james.warner@comcast.net>
----
- top/top.c | 9 +++++++--
- 1 file changed, 7 insertions(+), 2 deletions(-)
-
-diff --git a/top/top.c b/top/top.c
-index c1f30fb..dd6e3d5 100644
---- a/top/top.c
-+++ b/top/top.c
-@@ -4475,7 +4475,6 @@ static WIN_t *win_select (int ch) {
-          break;
-    }
-    Curwin = w;
--   mkVIZrow1(Curwin);
-    return Curwin;
- } // end: win_select
- 
-@@ -5148,6 +5147,7 @@ static void keys_global (int ch) {
-       case '?':
-       case 'h':
-          help_view();
-+         mkVIZrow1(Curwin);
-          break;
-       case 'B':
-          TOGw(w, View_NOBOLD);
-@@ -5175,6 +5175,7 @@ static void keys_global (int ch) {
-          break;
-       case 'g':
-          win_select(0);
-+         mkVIZrow1(Curwin);
-          break;
-       case 'H':
-          Thread_mode = !Thread_mode;
-@@ -5254,6 +5255,7 @@ static void keys_global (int ch) {
-          break;
-       case 'Z':
-          wins_colors();
-+         mkVIZrow1(Curwin);
-          break;
-       case '0':
-          Rc.zero_suppress = !Rc.zero_suppress;
-@@ -5573,7 +5575,10 @@ static void keys_window (int ch) {
-          break;
-       case 'a':
-       case 'w':
--         if (ALTCHKw) win_select(ch);
-+         if (ALTCHKw) {
-+            win_select(ch);
-+            mkVIZrow1(Curwin);
-+         }
-          break;
-       case 'G':
-          if (ALTCHKw) {
--- 
-1.8.3.1
-

_service:extract_file:0002-top-In-the-bye_bye-function-replace-fputs-with-the-w.patch Deleted

@@ -1,35 +0,0 @@
-From 0bf15c004db6a3342703a3c420a5692e376c457d Mon Sep 17 00:00:00 2001
-From: Shaohua Zhan <shaohua.zhan@windriver.com>
-Date: Thu, 3 Dec 2020 10:24:09 +0800
-Subject: PATCH top: In the bye_bye function, replace fputs with the write
- interface.
-
-When top calls malloc, if a signal is received, it will
-call sig_endpgm to process the signal. In the bye_bye function, if the
--b option is enable, the Batch variable is set, the fputs function
-will calls malloc at the same time. The malloc function is not reentrant, so
-it will cause the program to crash.
-
-Signed-off-by: Shaohua Zhan <shaohua.zhan@windriver.com>
----
- top/top.c | 4 +++-
- 1 file changed, 3 insertions(+), 1 deletion(-)
-
-diff --git a/top/top.c b/top/top.c
-index 2ec6357..eb62001 100644
---- a/top/top.c
-+++ b/top/top.c
-@@ -571,7 +571,9 @@ static void bye_bye (const char *str) {
-       fputs(str, stderr);
-       exit(EXIT_FAILURE);
-    }
--   if (Batch) fputs("\n", stdout);
-+   if (Batch) {
-+      write(fileno(stdout), "\n", sizeof("\n"));
-+   }
-    exit(EXIT_SUCCESS);
- } // end: bye_bye
- 
--- 
-1.8.3.1
-

_service:extract_file:0003-add-options-M-and-N-for-top.patch Deleted

@@ -1,55 +0,0 @@
-From 6e59f5e746c15df4d4b53f2df85b64aa1f10d0c3 Mon Sep 17 00:00:00 2001
-From: xuchunmei <xuchunmei@huawei.com>
-Date: Fri, 11 Jan 2019 01:29:55 -0500
-Subject: PATCH procps-ng: add -M and -N options for top
-
-Signed-off-by: xuchunmei <xuchunmei@huawei.com>
----
- top/top.c     | 17 +++++++++++++++++
- top/top_nls.c |  2 +-
- 2 files changed, 18 insertions(+), 1 deletion(-)
-
-diff --git a/top/top.c b/top/top.c
-index b53e532..20cf7a1 100644
---- a/top/top.c
-+++ b/top/top.c
-@@ -4337,6 +4337,23 @@ static void parse_args (char **args) {
-                args += ai;
-                if (pn) cp = pn + ci;
-             }  continue;
-+             case 'M':
-+			{
-+                 Curwin->rc.sortindx = EU_MEM;
-+                 break;
-+			}
-+             case 'N':
-+			{
-+			     if (cp1)
-+                     cp++;
-+                 else if (*args)
-+                     cp = *args++;
-+                 else
-+                     error_exit("-N requires argument");
-+                 if (sscanf(cp, "%d", &Curwin->rc.maxtasks) != 1 || Curwin->rc.maxtasks < 0)
-+                     error_exit(fmtmk("bad iterations arg '%s'", cp));
-+                 break;
-+			}
-             default :
-                error_exit(fmtmk(N_fmt(UNKNOWN_opts_fmt)
-                   , *cp, Myname, N_txt(USAGE_abbrev_txt)));
-diff --git a/top/top_nls.c b/top/top_nls.c
-index ab3029e..97c3468 100644
---- a/top/top_nls.c
-+++ b/top/top_nls.c
-@@ -350,7 +350,7 @@ static void build_norm_nlstab (void) {
-    Norm_nlstabOFF_one_word_txt = _("Off");
- /* Translation Hint: Only the following words should be translated
-    .                 secs (seconds), max (maximum), user, field, cols (columns)*/
--   Norm_nlstabUSAGE_abbrev_txt = _(" -hv | -bcEeHiOSs1 -d secs -n max -u|U user -p pid(s) -o field -w cols");
-+   Norm_nlstabUSAGE_abbrev_txt = _(" -hv | -bcEeHiOSs1 -d secs -n max -u|U user -p pid(s) -o field -w cols -M -N num");
-    Norm_nlstabFAIL_statget_txt = _("failed /proc/stat read");
-    Norm_nlstabFOREST_modes_fmt = _("Forest mode %s");
-    Norm_nlstabFAIL_tty_get_txt = _("failed tty get");
--- 
-2.27.0
-

_service:extract_file:0004-top-exit-with-error-when-pid-overflow.patch Deleted

_service:extract_file:0005-fix-a-fix-for-the-bye_bye-function.patch Deleted

@@ -1,39 +0,0 @@
-From 27e60e86e9f5b85520da001422176700fc9d824a Mon Sep 17 00:00:00 2001
-From: Jim Warner <james.warner@comcast.net>
-Date: Mon, 21 Jun 2021 00:00:00 -0500
-Subject: PATCH top: fix a fix for the 'bye_bye' function (merge #127)
-
-In the merge request shown below, 1 too many bytes are
-written to stdout thus including the terminating null.
-As the cure, this commit just reduces the length by 1.
-
- along the way, we will remove some unneeded braces 
- plus add some additional comments with attribution 
-
-Reference(s):
-https://gitlab.com/procps-ng/procps/-/merge_requests/127
-. original ported cchange
-commit 6b8980a3b6279058d727377e914cfb6439d6f178
-
-Signed-off-by: Jim Warner <james.warner@comcast.net>
-
----
- top/top.c | 2 +-
- 1 file changed, 1 insertion(+), 1 deletion(-)
-
-diff --git a/top/top.c b/top/top.c
-index b3e1bcf..9248c7a 100644
---- a/top/top.c
-+++ b/top/top.c
-@@ -572,7 +572,7 @@ static void bye_bye (const char *str) {
-       exit(EXIT_FAILURE);
-    }
-    if (Batch) {
--      write(fileno(stdout), "\n", sizeof("\n"));
-+      write(fileno(stdout), "\n", sizeof("\n") - 1);
-    }
-    exit(EXIT_SUCCESS);
- } // end: bye_bye
--- 
-1.8.3.1
-

_service:tar_scm:0001-add-M-and-N-options-for-top.patch Added

@@ -0,0 +1,68 @@
+From 6e59f5e746c15df4d4b53f2df85b64aa1f10d0c3 Mon Sep 17 00:00:00 2001
+From: xuchunmei <xuchunmei@huawei.com>
+Date: Fri, 11 Jan 2019 01:29:55 -0500
+Subject: PATCH procps-ng: add -M and -N options for top
+
+Signed-off-by: xuchunmei <xuchunmei@huawei.com>
+Signed-off-by: zhoujie <zhoujie133@huawei.com>
+---
+ top/top.c     | 15 ++++++++++++++-
+ top/top_nls.c |  2 ++
+ 2 files changed, 16 insertions(+), 1 deletion(-)
+
+diff --git a/top/top.c b/top/top.c
+index 04cf084..fbf0236 100644
+--- a/top/top.c
++++ b/top/top.c
+@@ -4076,7 +4076,7 @@ default_or_error:
+          *       overridden -- we'll force some on and negate others in our
+          *       best effort to honor the loser's (oops, user's) wishes... */
+ static void parse_args (int argc, char **argv) {
+-    static const char sopts = "bcd:E:e:Hhin:Oo:p:SsU:u:Vw::1";
++    static const char sopts = "bcd:E:e:Hhin:Oo:p:SsU:u:Vw::1MN:";
+     static const struct option lopts = {
+        { "batch-mode",        no_argument,       NULL, 'b' },
+        { "cmdline-toggle",    no_argument,       NULL, 'c' },
+@@ -4097,6 +4097,8 @@ static void parse_args (int argc, char **argv) {
+        { "version",           no_argument,       NULL, 'V' },
+        { "width",             optional_argument, NULL, 'w' },
+        { "single-cpu-toggle", no_argument,       NULL, '1' },
++       { "sort-by-mem",       no_argument,       NULL, 'M' },
++       { "display-task-num",  required_argument, NULL, 'N' },
+        { NULL, 0, NULL, 0 }
+    };
+    float tmp_delay = FLT_MAX;
+@@ -4219,6 +4221,17 @@ static void parse_args (int argc, char **argv) {
+                error_exit(fmtmk(N_fmt(BAD_widtharg_fmt), cp));
+             Width_mode = (int)tmp;
+             continue;
++	 case 'M':
++         {
++            Curwin->rc.sortindx = EU_MEM;
++               break;
++         }
++         case 'N':
++         {
++            if (sscanf(cp, "%d", &Curwin->rc.maxtasks) != 1 || Curwin->rc.maxtasks < 0)
++               error_exit(fmtmk("bad iterations arg '%s'", cp));
++            continue;
++         }
+          default:
+             // we'll rely on getopt for any error message ...
+             bye_bye(NULL);
+diff --git a/top/top_nls.c b/top/top_nls.c
+index 92f12ba..2e9c7fd 100644
+--- a/top/top_nls.c
++++ b/top/top_nls.c
+@@ -409,6 +409,8 @@ static void build_norm_nlstab (void) {
+       " -u, --filter-only-euser =USER   show only processes owned by USER\n"
+       " -w, --width =COLUMNS          change print width ,use COLUMNS\n"
+       " -1, --single-cpu-toggle         reverse last remembered '1' state\n"
++      " -M, --sort-by-mem               show tasks by memory usage\n"
++      " -N, --show-task-num		show the specified number of tasks\n"
+       "\n"
+       " -h, --help                      display this help text, then exit\n"
+       " -V, --version                   output version information & exit\n"
+-- 
+2.33.0
+

_service:tar_scm:0002-top-exit-with-error-when-pid-overflow.patch Added

_service:tar_scm:0003-top-eliminate-a-potential-abend-when-exiting-A-mode.patch Added

@@ -0,0 +1,207 @@
+From ad4429ade07abe2133dd53341fa91639625f09a0 Mon Sep 17 00:00:00 2001
+From: Jim Warner <james.warner@comcast.net>
+Date: Wed, 27 Jul 2022 00:00:00 -0500
+Subject: PATCH top: eliminate a potential abend when exiting 'A' mode <=== 
+ port of newlib 80e2a7a6
+
+______________________________ original newlib message
+----------------------------------- ( minus git hash )
+
+In that issue cited below, Tyson Nottingham identified
+a potential abend which was associated with 'alternate
+display mode' plus that troublesome 'mkVIZrow1' macro.
+He also offered a perfectly adequate fix for that bug.
+
+I refer to that macro as troublesome since it's now so
+widely used and sometimes (by design) causes 'begtask'
+to go negative (invalid). And now I found yet one more
+place where it should have been used but wasn't ('f').
+
+It's also troublesome as evidenced by some git history
+listed below. Heck, there was even a commit addressing
+the same symptoms (alternate display mode abend) which
+Tyson suffered. Clearly, the current design is flawed.
+
+So, with those two issues in mind, I've refactored the
+approach to maintaining a visible task in the 1st row.
+Henceforth, a 'mkVIZrow1' macro will be issued in only
+two places: once at startup and after most keystrokes.
+
+Such an approach likely results in additional calls to
+the 'window_hlp' routine that aren't really necessary.
+But, it provides a cleaner design less prone to errors
+in the future. Besides, such additional overhead would
+only be incurred when interacting with the user. Thus,
+new costs are of no concern and will never be noticed.
+
+Reference(s):
+. Tyson Nottingham reported problem
+https://gitlab.com/procps-ng/procps/-/issues/245
+. Jun, 2018 - visible row 1 tasks first addressed
+commit ........................................
+. Jun, 2018 - adressed edge case, new bugs created
+commit ........................................
+. Sep, 2018 - additional edge case addressed
+commit ........................................
+. May, 2021 - some abends fixed, new error created
+commit ........................................
+. Jun, 2021 - try to prorect against future errors
+commit ........................................
+. Sep, 2021 - integrate mkVIZ & 'focused' tasks
+commit ........................................
+
+Discovered by: Tyson Nottingham
+Signed-off-by: Jim Warner <james.warner@comcast.net>
+---
+ top/top.c | 44 +++++++++++++++++++-------------------------
+ top/top.h |  3 ++-
+ 2 files changed, 21 insertions(+), 26 deletions(-)
+
+diff --git a/top/top.c b/top/top.c
+index 51bf563..204e66a 100644
+--- a/top/top.c
++++ b/top/top.c
+@@ -4329,10 +4329,11 @@ static void win_names (WIN_t *q, const char *name) {
+ static void win_reset (WIN_t *q) {
+          SETw(q, Show_IDLEPS | Show_TASKON);
+ #ifndef SCROLLVAR_NO
+-         q->rc.maxtasks = q->usrseltyp = q->begpflg = q->begtask = q->begnext = q->varcolbeg = q->focus_pid = 0;
++         q->rc.maxtasks = q->usrseltyp = q->begpflg = q->begtask = q->varcolbeg = q->focus_pid = 0;
+ #else
+-         q->rc.maxtasks = q->usrseltyp = q->begpflg = q->begtask = q->begnext = q->focus_pid = 0;
++         q->rc.maxtasks = q->usrseltyp = q->begpflg = q->begtask = q->focus_pid = 0;
+ #endif
++	 mkVIZoff(q)
+          // these next two are global, not really windows based
+          Monpidsidx = 0;
+          Rc.tics_scaled = 0;
+@@ -5116,7 +5117,6 @@ static void keys_global (int ch) {
+       case '?':
+       case 'h':
+          help_view();
+-         mkVIZrow1
+          break;
+       case 'B':
+          TOGw(w, View_NOBOLD);
+@@ -5143,7 +5143,6 @@ static void keys_global (int ch) {
+          break;
+       case 'g':
+          win_select(0);
+-         mkVIZrow1
+          break;
+       case 'H':
+          Thread_mode = !Thread_mode;
+@@ -5224,7 +5223,6 @@ static void keys_global (int ch) {
+          break;
+       case 'Z':
+          wins_colors();
+-         mkVIZrow1
+          break;
+       case '0':
+          Rc.zero_suppress = !Rc.zero_suppress;
+@@ -5446,10 +5444,7 @@ static void keys_task (int ch) {
+       case 'O':
+       case 'o':
+       case kbd_CtrlO:
+-         if (VIZCHKw(w)) {
+-            other_filters(ch);
+-            mkVIZrow1
+-         }
++         if (VIZCHKw(w)) other_filters(ch);
+          break;
+       case 'U':
+       case 'u':
+@@ -5458,7 +5453,6 @@ static void keys_task (int ch) {
+             if (*str != kbd_ESC
+             && (errmsg = user_certify(w, str, ch)))
+                 show_msg(errmsg);
+-            mkVIZrow1
+          }
+          break;
+       case 'V':
+@@ -5565,10 +5559,7 @@ static void keys_window (int ch) {
+          break;
+       case 'a':
+       case 'w':
+-         if (ALTCHKw) {
+-            win_select(ch);
+-            mkVIZrow1
+-         }
++         if (ALTCHKw) win_select(ch);
+          break;
+       case 'G':
+          if (ALTCHKw) {
+@@ -5665,10 +5656,8 @@ static void keys_window (int ch) {
+       case kbd_HOME:
+ #ifndef SCROLLVAR_NO
+          if (VIZCHKw(w)) if (CHKw(w, Show_IDLEPS)) w->begtask = w->begpflg = w->varcolbeg = 0;
+-         mkVIZrow1
+ #else
+          if (VIZCHKw(w)) if (CHKw(w, Show_IDLEPS)) w->begtask = w->begpflg = 0;
+-         mkVIZrow1
+ #endif
+          break;
+       case kbd_END:
+@@ -6109,6 +6098,14 @@ static void do_key (int ch) {
+             if (strchr(key_tabi.keys, ch)) {
+                key_tabi.func(ch);
+                Frames_signal = BREAK_kbd;
++	       /* due to the proliferation of the need for 'mkVIZrow1', |
++                  aside from 'wins_stage_2' use, we'll now issue it one |
++                  time here. there will remain several places where the |
++                  companion 'mkVIZrowX' macro is issued, thus the check |
++                  for a value already in 'begnext' in this conditional. | */
++               if (CHKw(Curwin, Show_TASKON) && !mkVIZyes)
++                  mkVIZrow1
++
+                goto all_done;
+             }
+    };
+@@ -6493,14 +6490,11 @@ static const char *task_show (const WIN_t *q, int idx) {
+ 
+ 
+         /*
+-         * A window_show *Helper* function ensuring that Curwin's 'begtask'
+-         * represents a visible process (not any hidden/filtered-out task).
+-         * In reality, this function is called:
+-         *   1) exclusively for the 'current' window
+-         *   2) immediately after interacting with the user
+-         *   3) who struck: up, down, pgup, pgdn, home, end, 'o/O' or 'u/U'
+-         *   4) or upon the user switching from one window to another window
+-         * ( note: it's entirely possible there are NO visible tasks to show ) */
++	 * A window_show *Helper* function ensuring that a window 'begtask' |
++         * represents a visible process (not any hidden/filtered-out task). |
++         * In reality this function is called exclusively for the 'current' |
++         * window and only after available user keystroke(s) are processed. |
++         * Note: it's entirely possible there are NO visible tasks to show! | */
+ static void window_hlp (void) {
+    WIN_t *w = Curwin;             // avoid gcc bloat with a local copy
+    int i, reversed;
+@@ -6548,7 +6542,7 @@ fwd_redux:
+    }
+ 
+ wrap_up:
+-   w->begnext = 0;
++   mkVIZoff(w)
+    OFFw(w, NOPRINT_xxx);
+ } // end: window_hlp
+ 
+diff --git a/top/top.h b/top/top.h
+index 40fe0ec..9d44669 100644
+--- a/top/top.h
++++ b/top/top.h
+@@ -427,9 +427,10 @@ typedef struct WIN_t {
+ 
+         // Support for a proper (visible) row #1 whenever Curwin changes
+         // ( or a key which might affect vertical scrolling was struck )
+-#define mkVIZyes       Curwin->begnext != 0
++#define mkVIZyes     ( Curwin->begnext != 0 )
+ #define mkVIZrow1    { Curwin->begnext = +1; Curwin->begtask -= 1; }

_service:tar_scm:0004-skill-Restore-the-p-flag-functionality.patch Added

@@ -0,0 +1,72 @@
+From f7a33746f8484629df9055f9a2dc5654f377c2fe Mon Sep 17 00:00:00 2001
+From: Craig Small <csmall@dropbear.xyz>
+Date: Mon, 12 Dec 2022 16:46:36 +1100
+Subject: PATCH skill: Restore the -p flag functionality
+
+When the skill program was ported to the new API the code to filter
+on PID, used by the -p option, was missed. It is now restored.
+
+References:
+ https://bugs.debian.org/1025915
+
+Conflict:remove NES part and change src/skill.c to skill.c
+---
+ skill.c                        |  2 ++
+ testsuite/skill.test/skill.exp | 32 ++++++++++++++++++++++++++++++++
+ 2 files changed, 34 insertions(+)
+ create mode 100644 testsuite/skill.test/skill.exp
+
+diff --git a/skill.c b/skill.c
+index 9f617bfd..c2e52744 100644
+--- a/skill.c
++++ b/skill.c
+@@ -287,6 +287,8 @@ static void scan_procs(struct run_time_conf_t *run_time)
+     for (i=0; i < total_procs; i++) {
+         if (PIDS_GETINT(PID) == my_pid || PIDS_GETINT(PID) == 0)
+             continue;
++	if (pids && !match_intlist(PIDS_GETINT(PID), pid_count, pids))
++	    continue;
+         if (uids && !match_intlist(PIDS_GETUNT(EUID), uid_count, (int *)uids))
+             continue;
+         if (ttys && !match_intlist(PIDS_GETINT(TTY), tty_count, ttys))
+diff --git a/testsuite/skill.test/skill.exp b/testsuite/skill.test/skill.exp
+new file mode 100644
+index 00000000..162d9610
+--- /dev/null
++++ b/testsuite/skill.test/skill.exp
+@@ -0,0 +1,32 @@
++#
++# Dejagnu testsuite for skill - part of procps
++#
++set skill ${topdir}src/skill
++set tty  get_tty 
++
++if { ! file exists $skill  } {
++    untested { skipping (not built)}
++    return
++}
++
++set test "skill with no arguments"
++spawn $skill
++expect_pass "$test" "Usage:\\s+$lt-$?skill \\\signal\\\ \\\options\\\ <expression>"
++
++set test "skill list signal names"
++spawn $skill -l
++expect_pass "$test" "^$\A-Z12+-\\\s*$+$"
++
++set test "skill list signal names in table"
++spawn $skill -L
++expect_pass "$test" "^$\\s+\\d+ \A-Z12+-\+$+\\s*$"
++
++make_testproc
++
++# Debian 1025915
++set test "skill find one process"
++spawn $skill -n -p $testproc1_pid
++expect_pass "$test" "^$testproc1_pid\\s*$"
++
++# Cleanup
++kill_testproc
+-- 
+2.27.0
+

_service Changed

_service:extract_file:README.md Deleted

@@ -1,52 +0,0 @@
-!build status(https://gitlab.com/ci/projects/2142/status.png?ref=master)(https://gitlab.com/ci/projects/2142?ref=master)
-procps
-======
-
-procps is a set of command line and full-screen utilities that provide
-information out of the pseudo-filesystem most commonly located at /proc.
-This filesystem provides a simple interface to the kernel data structures.
-The programs of procps generally concentrate on the structures that describe
-the processess running on the system.
-
-The following programs are found in procps:
-* *free* - Report the amount of free and used memory in the system
-* *kill* - Send a signal to a process based on PID
-* *pgrep* - List processes based on name or other attributes
-* *pkill* - Send a signal to a process based on name or other attributes
-* *pmap* - Report memory map of a process
-* *ps* - Report information of processes
-* *pwdx* - Report current directory of a process
-* *skill* - Obsolete version of pgrep/pkill
-* *slabtop* - Display kernel slab cache information in real time
-* *snice* - Renice a process
-* *sysctl* - Read or Write kernel parameters at run-time
-* *tload* - Graphical representation of system load average
-* *top* - Dynamic real-time view of running processes
-* *uptime* - Display how long the system has been running
-* *vmstat* - Report virtual memory statistics
-* *w* - Report logged in users and what they are doing
-* *watch* - Execute a program periodically, showing output fullscreen
-
-## Reporting Bugs
-There are a few ways of reporting bugs or feature requests:
-
-1. Your distributions bug reporter. If you are using a distribution your first
-port of call is their bug tracker. This is because each distribution has their
-own patches and way of dealing with bugs. Also bug reporting often does not need
-any subscription to websites.
-2. GitLab Issues - To the left of this page is the issue tracker. You can report
-bugs here.
-3. Email list - We have an email list (see below) where you can report bugs.
-The problem with this method is bug reports often get lost and cannot be
-tracked. This is especially a big problem when its something that will take
-time to resolve.
-
-If you need to report bugs, there is more details on the
-Bug Reporting(https://gitlab.com/procps-ng/procps/blob/master/Documentation/bugs.md)
-page.
-
-## Email List
-The email list for the developers and users of procps is found at
-http://www.freelists.org/archive/procps/
-This email list discusses the development of procps and is used by distributions
-to also forward or discuss bugs.

_service:extract_file:README.top Deleted

@@ -1,377 +0,0 @@
-This file summarizes changes to the top program and supporting documentation
-introduced on March 31, 2011.
-
-Contents:
-      DOCUMENT Changes
-      INTERNAL Improvements
-      EXTERNAL Improvements
-      BUGS Previously Fixed and Preserved
-      BUGS Newly/Nearly Fixed
-      BUGS/WISH-LISTS That Should Go Bye-bye
-      BUGS FIXED You Didn't Know You Had
-      OTHER Changes, Hopefully They Won't Bite You
-      BENCHMARKS
-
-
-DOCUMENT Changes =========================================================
-  . The entire file was cleaned up, standardized and expanded to include:
-    - a new section "2. SUMMARY Display" added for symmetry with Fields
-    - nine new fields were added to section "3a. DESCRIPTIONS of Fields"
-    - a new section "3b. MANAGING Fields" replaced the obsolete section
-      "2b. SELECTING and ORDERING Columns"
-    - section "5c. SCROLLING a Window" was added for that new feature
-
-  . I don't know when the explanations for CODE and DATA were changed to
-    show 'virtual' memory, but I think there's a reason their alternate
-    names contain the word 'resident'.  Thus they were changed back to
-    say 'physical memory'.
-
-  . And as I indicated in a previous email, the former string identifier
-    'ME' was restored as were the 'h' key/command conventions (vs. <h>).
-
-    Oops, the 'h' key/command conventions remain restored, but subsequent
-    testing revealed problems with the .ME string identifier.  Thus, it was
-    changed to .WE (along with the companion .Me/.We id).
-
-  . Also previously mentioned, the 'man2html' program translates top.1 to
-    HTML with near perfect fidelity.  I take that to mean there should be
-    no problems with the top.1 source on most other platforms.
-
-    To further improve translation to HTML, several .Bd and .Ed macros
-    were added to preserve literal (fixed width) spacing.
-
-
-INTERNAL Improvements ====================================================
-  . The old restriction of 26 fields has been lifted.  With this new-top
-    100+ fields are now possible.  It currently supports up to 55, of
-    which 35 are in use.  Adding a new field is almost too easy.
-
-  . Task row construction has been considerably improved -- both from
-    a programming perspective and a performance perspective.
-
-  . The column highlighting costs for sort field visibility were
-    virtually eliminated.
-
-    An optional define (USE_X_COLHDR) can be enabled to completely
-    eliminate any costs associated with the 'x' command toggle.
-
-  . The management of the HST_t structures, used for %cpu calculations,
-    was optimized with a hashing scheme.  Thus the need for a qsort then
-    a binary search in each frame was completely eliminated.
-
-    An optional define can restore the former qsort/bsearch approach but
-    with an internal inlined binary search function offering substantially
-    better performance than the old top.
-
-  . This far more capable new-top executable is no larger than old top.
-
-  . The above combine to produce substantially improved performance
-    whose details are documented below under BENCHMARKS.
-
-
-EXTERNAL Improvements ====================================================
-  . Field management has been completely redesigned.  It's now embodied
-    on a single screen where display-ability, position and sort selection
-    can be handled in one place -- for all windows at one time!
-
-    This function is dependent on cursor motion keys and should a device
-    not have the customary arrow keys, alternatives are provided and
-    documented under "Operation" near the beginning of the man page.
-
-  . The following new fields have been added:
-       Group Id
-       Minor Page Faults
-       Number of Threads
-       Process Group Id
-       Real User Id
-       Saved User Id
-       Saved User Name
-       Session Id
-       Tty Process Group Id
-
-  . Scrolling keys now allow one to move the view of any window vertically
-    or horizontally to reveal any desired task or column.  Previously, only
-    some tasks were viewable even with reversible, selectable sort columns.
-
-    Each of the four windows is capable of maintaining its own scrolled
-    coordinates and an optional toggle ('C') displays a message aiding
-    navigation within the available tasks and displayable fields.
-
-  . User interactive line oriented input now provides for true line
-    editing supported by these new keys:
-        Left/Right arrow keys, Delete key, Backspace and
-        Home/End keys (likely limited to xterm, not terminal)
-
-  . User filtering via the -u | -U interactive commands is now window
-    based which means that different windows could be used to filter
-    different users.
-
-  . Signal handling has been normalized and is now consistent regardless
-    of the particular top screen a user may have been using.
-
-  . The 'i' toggle now shows any task that has used *some* cpu since the
-    last screen update.  It's no longer limited to just running tasks.
-
-  . The summary area 'task states' line now reflects either 'Threads'
-    or 'Tasks' depending on the -H toggle.
-
-
-BUGS Previously Fixed and Preserved ======================================
-  ( but not necessarily literally)
-  . 228822, suspending top leaves xterm in slightly messed-up state
-  . 256376, segfaults, if the xterm is to small
-  . 320289, segv on sigwinch
-  . 351065, wrong highlight 1st column (escape characters displayed)
-  . 358724, accepts extra numeric args
-  . 378695, seg fault if "/proc" is not mounted
-  . 426782, UID field is too narrow
-  . 458986, should check xterm for EOF/EIO
-  . 459890, Irix mode should use %#4.1f when threads shown
-
-
-BUGS Newly/Nearly Fixed ==================================================
-  . 225542, 'Unknown command' message blocks further commands
-      The message is now displayed using usleep for 1.25 seconds, instead
-      of the former full 2 seconds.  And while it still blocks further
-      commands, the delay is much more tolerable.
-
-      Can we consider this bug 'nearly' fixed?
-
-  . 410292, interface error when using backspace
-      Full line editing was added but could be disabled via a #define.
-      And via that define, even under basic termios support, the backspace
-      problem was cured.
-
-  . 567509, top idle command ('i') not working for threaded programs
-      Since the 'i' command now reflects tasks that have used *some* cpu,
-      and is no longer dependent on an 'R' state, I *believe/hope* this
-      bug has been swatted.
-
-
-BUGS/WISH-LISTS That Should Go Bye-bye ===================================
-  . 340751, wish for hostname to benefit multiple top sessions
-      Craig's suggestion regarding symlinks is the perfect solution.
-      How dare Craig say that the solution was "not ideal" !
-
-  . 586497, wish for graceful degradation on small screen sizes
-      This objective could be accomplished by setting up 2 symlinks for
-      top, personalizing them for the 2 tiny phone displays, then writing
-      the respective configuration files.
-
-      I shudder at the programming effort suggested by Paul.  And when it
-      was done you'd find everybody else would have different criteria.
-
-
-BUGS FIXED You Didn't Know You Had =======================================
-  . Without amplifying the dirty details, the long standing occasionally
-    reported display corruption, and an unreported source of performance
-    degradation, has been eliminated.  The cure is in the elimination of
-    the Pseudo_cols variable and the improved PUFF macro.
-
-  . Line oriented input was not sensitive to screen width.  Thus a user
-    could hold down any key and ultimately line wrap, overwriting the
-    columns header and the entire screen.  New top prevents this.
-
-  . User filtering (-u|-U) via a user ID (not name) now validates that
-    number.  The old-top just made sure it was numeric, then blindly
-    displayed no matching users (i.e. an empty window).
-
-  . The threads toggle ('H') is no longer window based but more properly
-    applies to all windows.  The previous implementation produced the
-    following aberration if multiple windows were being shown:
-      . -H would be acknowledged and applied to all visible windows
-      . keying 'a' or 'w' would silently turn it off
-      . then keying -H would turn it back on, but the user expected off
-
-  . If you hit ^Z on any help or fields screen to suspend old-top, after
-    issuing 'fg' you would then be left with a seemingly hung application
-    inviting ^C.  In truth, one could recover with the space bar, but that
-    was far from intuitive.
-
-  . The old-top consistently writes 1 extra byte for each task row or 1
-    byte too few for columns headers, depending on your perspective.
-    The new top writes the same number of bytes for each.
-
-  . By failing to clear to eol, old top left the display in a terrible
-    state after exiting a 'fields' screen when only a few columns were
-    being displayed.
-
-  . The old-top used a zero value for the L_NONE library flag which could

_service:extract_file:procps-ng-3.3.17.tar.xz Deleted

_service:extract_file:procps-ng.yaml Deleted

_service:tar_scm:README.md Added

@@ -0,0 +1,52 @@
+!build status(https://gitlab.com/ci/projects/2142/status.png?ref=master)(https://gitlab.com/ci/projects/2142?ref=master)
+procps
+======
+
+procps is a set of command line and full-screen utilities that provide
+information out of the pseudo-filesystem most commonly located at /proc.
+This filesystem provides a simple interface to the kernel data structures.
+The programs of procps generally concentrate on the structures that describe
+the processess running on the system.
+
+The following programs are found in procps:
+* *free* - Report the amount of free and used memory in the system
+* *kill* - Send a signal to a process based on PID
+* *pgrep* - List processes based on name or other attributes
+* *pkill* - Send a signal to a process based on name or other attributes
+* *pmap* - Report memory map of a process
+* *ps* - Report information of processes
+* *pwdx* - Report current directory of a process
+* *skill* - Obsolete version of pgrep/pkill
+* *slabtop* - Display kernel slab cache information in real time
+* *snice* - Renice a process
+* *sysctl* - Read or Write kernel parameters at run-time
+* *tload* - Graphical representation of system load average
+* *top* - Dynamic real-time view of running processes
+* *uptime* - Display how long the system has been running
+* *vmstat* - Report virtual memory statistics
+* *w* - Report logged in users and what they are doing
+* *watch* - Execute a program periodically, showing output fullscreen
+
+## Reporting Bugs
+There are a few ways of reporting bugs or feature requests:
+
+1. Your distributions bug reporter. If you are using a distribution your first
+port of call is their bug tracker. This is because each distribution has their
+own patches and way of dealing with bugs. Also bug reporting often does not need
+any subscription to websites.
+2. GitLab Issues - To the left of this page is the issue tracker. You can report
+bugs here.
+3. Email list - We have an email list (see below) where you can report bugs.
+The problem with this method is bug reports often get lost and cannot be
+tracked. This is especially a big problem when its something that will take
+time to resolve.
+
+If you need to report bugs, there is more details on the
+Bug Reporting(https://gitlab.com/procps-ng/procps/blob/master/Documentation/bugs.md)
+page.
+
+## Email List
+The email list for the developers and users of procps is found at
+http://www.freelists.org/archive/procps/
+This email list discusses the development of procps and is used by distributions
+to also forward or discuss bugs.

_service:tar_scm:README.top Added

@@ -0,0 +1,377 @@
+This file summarizes changes to the top program and supporting documentation
+introduced on March 31, 2011.
+
+Contents:
+      DOCUMENT Changes
+      INTERNAL Improvements
+      EXTERNAL Improvements
+      BUGS Previously Fixed and Preserved
+      BUGS Newly/Nearly Fixed
+      BUGS/WISH-LISTS That Should Go Bye-bye
+      BUGS FIXED You Didn't Know You Had
+      OTHER Changes, Hopefully They Won't Bite You
+      BENCHMARKS
+
+
+DOCUMENT Changes =========================================================
+  . The entire file was cleaned up, standardized and expanded to include:
+    - a new section "2. SUMMARY Display" added for symmetry with Fields
+    - nine new fields were added to section "3a. DESCRIPTIONS of Fields"
+    - a new section "3b. MANAGING Fields" replaced the obsolete section
+      "2b. SELECTING and ORDERING Columns"
+    - section "5c. SCROLLING a Window" was added for that new feature
+
+  . I don't know when the explanations for CODE and DATA were changed to
+    show 'virtual' memory, but I think there's a reason their alternate
+    names contain the word 'resident'.  Thus they were changed back to
+    say 'physical memory'.
+
+  . And as I indicated in a previous email, the former string identifier
+    'ME' was restored as were the 'h' key/command conventions (vs. <h>).
+
+    Oops, the 'h' key/command conventions remain restored, but subsequent
+    testing revealed problems with the .ME string identifier.  Thus, it was
+    changed to .WE (along with the companion .Me/.We id).
+
+  . Also previously mentioned, the 'man2html' program translates top.1 to
+    HTML with near perfect fidelity.  I take that to mean there should be
+    no problems with the top.1 source on most other platforms.
+
+    To further improve translation to HTML, several .Bd and .Ed macros
+    were added to preserve literal (fixed width) spacing.
+
+
+INTERNAL Improvements ====================================================
+  . The old restriction of 26 fields has been lifted.  With this new-top
+    100+ fields are now possible.  It currently supports up to 55, of
+    which 35 are in use.  Adding a new field is almost too easy.
+
+  . Task row construction has been considerably improved -- both from
+    a programming perspective and a performance perspective.
+
+  . The column highlighting costs for sort field visibility were
+    virtually eliminated.
+
+    An optional define (USE_X_COLHDR) can be enabled to completely
+    eliminate any costs associated with the 'x' command toggle.
+
+  . The management of the HST_t structures, used for %cpu calculations,
+    was optimized with a hashing scheme.  Thus the need for a qsort then
+    a binary search in each frame was completely eliminated.
+
+    An optional define can restore the former qsort/bsearch approach but
+    with an internal inlined binary search function offering substantially
+    better performance than the old top.
+
+  . This far more capable new-top executable is no larger than old top.
+
+  . The above combine to produce substantially improved performance
+    whose details are documented below under BENCHMARKS.
+
+
+EXTERNAL Improvements ====================================================
+  . Field management has been completely redesigned.  It's now embodied
+    on a single screen where display-ability, position and sort selection
+    can be handled in one place -- for all windows at one time!
+
+    This function is dependent on cursor motion keys and should a device
+    not have the customary arrow keys, alternatives are provided and
+    documented under "Operation" near the beginning of the man page.
+
+  . The following new fields have been added:
+       Group Id
+       Minor Page Faults
+       Number of Threads
+       Process Group Id
+       Real User Id
+       Saved User Id
+       Saved User Name
+       Session Id
+       Tty Process Group Id
+
+  . Scrolling keys now allow one to move the view of any window vertically
+    or horizontally to reveal any desired task or column.  Previously, only
+    some tasks were viewable even with reversible, selectable sort columns.
+
+    Each of the four windows is capable of maintaining its own scrolled
+    coordinates and an optional toggle ('C') displays a message aiding
+    navigation within the available tasks and displayable fields.
+
+  . User interactive line oriented input now provides for true line
+    editing supported by these new keys:
+        Left/Right arrow keys, Delete key, Backspace and
+        Home/End keys (likely limited to xterm, not terminal)
+
+  . User filtering via the -u | -U interactive commands is now window
+    based which means that different windows could be used to filter
+    different users.
+
+  . Signal handling has been normalized and is now consistent regardless
+    of the particular top screen a user may have been using.
+
+  . The 'i' toggle now shows any task that has used *some* cpu since the
+    last screen update.  It's no longer limited to just running tasks.
+
+  . The summary area 'task states' line now reflects either 'Threads'
+    or 'Tasks' depending on the -H toggle.
+
+
+BUGS Previously Fixed and Preserved ======================================
+  ( but not necessarily literally)
+  . 228822, suspending top leaves xterm in slightly messed-up state
+  . 256376, segfaults, if the xterm is to small
+  . 320289, segv on sigwinch
+  . 351065, wrong highlight 1st column (escape characters displayed)
+  . 358724, accepts extra numeric args
+  . 378695, seg fault if "/proc" is not mounted
+  . 426782, UID field is too narrow
+  . 458986, should check xterm for EOF/EIO
+  . 459890, Irix mode should use %#4.1f when threads shown
+
+
+BUGS Newly/Nearly Fixed ==================================================
+  . 225542, 'Unknown command' message blocks further commands
+      The message is now displayed using usleep for 1.25 seconds, instead
+      of the former full 2 seconds.  And while it still blocks further
+      commands, the delay is much more tolerable.
+
+      Can we consider this bug 'nearly' fixed?
+
+  . 410292, interface error when using backspace
+      Full line editing was added but could be disabled via a #define.
+      And via that define, even under basic termios support, the backspace
+      problem was cured.
+
+  . 567509, top idle command ('i') not working for threaded programs
+      Since the 'i' command now reflects tasks that have used *some* cpu,
+      and is no longer dependent on an 'R' state, I *believe/hope* this
+      bug has been swatted.
+
+
+BUGS/WISH-LISTS That Should Go Bye-bye ===================================
+  . 340751, wish for hostname to benefit multiple top sessions
+      Craig's suggestion regarding symlinks is the perfect solution.
+      How dare Craig say that the solution was "not ideal" !
+
+  . 586497, wish for graceful degradation on small screen sizes
+      This objective could be accomplished by setting up 2 symlinks for
+      top, personalizing them for the 2 tiny phone displays, then writing
+      the respective configuration files.
+
+      I shudder at the programming effort suggested by Paul.  And when it
+      was done you'd find everybody else would have different criteria.
+
+
+BUGS FIXED You Didn't Know You Had =======================================
+  . Without amplifying the dirty details, the long standing occasionally
+    reported display corruption, and an unreported source of performance
+    degradation, has been eliminated.  The cure is in the elimination of
+    the Pseudo_cols variable and the improved PUFF macro.
+
+  . Line oriented input was not sensitive to screen width.  Thus a user
+    could hold down any key and ultimately line wrap, overwriting the
+    columns header and the entire screen.  New top prevents this.
+
+  . User filtering (-u|-U) via a user ID (not name) now validates that
+    number.  The old-top just made sure it was numeric, then blindly
+    displayed no matching users (i.e. an empty window).
+
+  . The threads toggle ('H') is no longer window based but more properly
+    applies to all windows.  The previous implementation produced the
+    following aberration if multiple windows were being shown:
+      . -H would be acknowledged and applied to all visible windows
+      . keying 'a' or 'w' would silently turn it off
+      . then keying -H would turn it back on, but the user expected off
+
+  . If you hit ^Z on any help or fields screen to suspend old-top, after
+    issuing 'fg' you would then be left with a seemingly hung application
+    inviting ^C.  In truth, one could recover with the space bar, but that
+    was far from intuitive.
+
+  . The old-top consistently writes 1 extra byte for each task row or 1
+    byte too few for columns headers, depending on your perspective.
+    The new top writes the same number of bytes for each.
+
+  . By failing to clear to eol, old top left the display in a terrible
+    state after exiting a 'fields' screen when only a few columns were
+    being displayed.
+
+  . The old-top used a zero value for the L_NONE library flag which could

_service:tar_scm:procps-ng-1644304463.f08ee40.tar -> _service:tar_scm:procps-ng-4.0.0.tar.xz Changed

_service:tar_scm:procps-ng.yaml Added