diff options
author | Clark Williams <williams@redhat.com> | 2020-08-26 10:18:58 -0500 |
---|---|---|
committer | Clark Williams <williams@redhat.com> | 2020-08-26 10:18:58 -0500 |
commit | b309167429e8315b2611de7e8023abbd5a6f42bf (patch) | |
tree | 2e5f4e6f87bf9b9cc7a47fa36c0d157cdb888afd | |
parent | a6b884dad06a958e87a18c9c6411d21daeb11160 (diff) | |
download | stalld-b309167429e8315b2611de7e8023abbd5a6f42bf.tar.gz |
renamed project to stalld
Updated file names, content and docs to reflect name change
Signed-off-by: Clark Williams <williams@redhat.com>
-rw-r--r-- | Makefile | 14 | ||||
-rw-r--r-- | README.md | 10 | ||||
-rw-r--r-- | man/stalld.8 (renamed from man/starved.8) | 16 | ||||
-rw-r--r-- | redhat/Makefile | 10 | ||||
-rw-r--r-- | redhat/stalld.conf (renamed from redhat/starved.conf) | 6 | ||||
-rw-r--r-- | redhat/stalld.service | 11 | ||||
-rw-r--r-- | redhat/stalld.spec (renamed from redhat/starved.spec) | 12 | ||||
-rw-r--r-- | redhat/starved.service | 11 | ||||
-rw-r--r-- | src/stalld.c (renamed from src/starved.c) | 0 |
9 files changed, 45 insertions, 45 deletions
@@ -1,4 +1,4 @@ -NAME := starved +NAME := stalld VERSION := 1.0 @@ -9,21 +9,21 @@ DIRS := src redhat man FILES := Makefile README.md TARBALL := $(NAME)-$(VERSION).tar.xz -all: src/starved.o - $(CC) -o starved -ggdb -lpthread src/starved.o +all: src/stalld.o + $(CC) -o stalld -ggdb -lpthread src/stalld.o .PHONY: install install: $(INSTALL) -m 755 -d $(DESTDIR)/usr/bin $(DESTDIR)/usr/share/$(NAME)-$(VERSION) - $(INSTALL) starved -m 755 $(DESTDIR)/usr/bin/ + $(INSTALL) stalld -m 755 $(DESTDIR)/usr/bin/ $(INSTALL) README.md -m 644 $(DESTDIR)/usr/share/$(NAME)-$(VERSION) $(INSTALL) -m 755 -d $(DESTDIR)/usr/share/man/man8 - $(INSTALL) man/starved.8 -m 644 $(DESTDIR)/usr/share/man/man8 + $(INSTALL) man/stalld.8 -m 644 $(DESTDIR)/usr/share/man/man8 .PHONY: clean tarball redhat clean: - @test ! -f starved || rm starved - @test ! -f src/starved.o || rm src/starved.o + @test ! -f stalld || rm stalld + @test ! -f src/stalld.o || rm src/stalld.o @test ! -f $(TARBALL) || rm -f $(TARBALL) @make -C redhat clean @rm -rf *~ @@ -1,6 +1,6 @@ -# starved +# stalld -The starved program (which stands for 'starvation daemon') is a +The stalld program (which stands for 'stall daemon') is a mechanism to prevent the *starvation* of operating system threads in a Linux system. The premise is to start up on a *housekeeping* cpu (one that is not used for real-application purposes) and to periodically @@ -10,16 +10,16 @@ of time without being run. This condition is usually hit when the thread is on the same cpu as a high-priority cpu-intensive task and therefore is being given no opportunity to run. -When a thread is judged to be starving, starved changes +When a thread is judged to be starving, stalld changes that thread to use the SCHED_DEADLINE policy and gives the thread a small slice of time for that cpu (specified on the command line). The thread then runs and when that timeslice is used, the thread is then -returned to its original scheduling policy and starved then +returned to its original scheduling policy and stalld then continues to monitor thread states. ## Command Line Options -`Usage: starved [-l] [-v] [-k] [-s] [-f] [-h] +`Usage: stalld [-l] [-v] [-k] [-s] [-f] [-h] [-c cpu-list] [-p time in ns] [-r time in ns] [-d time in seconds ] [-t time in seconds ]` diff --git a/man/starved.8 b/man/stalld.8 index be44d10..8d9e48b 100644 --- a/man/starved.8 +++ b/man/stalld.8 @@ -1,8 +1,8 @@ -.TH STARVED 8 +.TH STALLD 8 .SH NAME -starved \- detect starving threads and boost them +stalld \- detect starving threads and boost them .SH SYNOPSIS -.B starved +.B stalld [ -l ] [ -v ] [ -k ] [ -s ] [ -f ] [ -h ] [ -c cpu-list] [ -p time-in-ns ] @@ -12,7 +12,7 @@ starved \- detect starving threads and boost them .br .SH DESCRIPTION -.I starved +.I stalld is a system daemon that monitors thread for the starvation condition. .IR Starvation @@ -75,14 +75,14 @@ print options .SH FILES .PD 0 .TP 20 -.B /etc/systemd/starved.conf +.B /etc/systemd/stalld.conf parameter file for systemd startup .TP -.B /usr/lib/systemd/system/starved.service +.B /usr/lib/systemd/system/stalld.service systemd unit file .TP -.B /usr/bin/starved -starved executable +.B /usr/bin/stalld +stalld executable .SH BUGS none .SH AUTHOR diff --git a/redhat/Makefile b/redhat/Makefile index 3962af1..ec528b0 100644 --- a/redhat/Makefile +++ b/redhat/Makefile @@ -20,16 +20,16 @@ rpmdirs: rpm: rpmdirs cp ../*.tar.xz SOURCES - rpmbuild -ba $(RPMARGS) starved.spec + rpmbuild -ba $(RPMARGS) stalld.spec clean: @rm -rf $(RPMDIRS) *~ install: $(INSTALL) -m 755 -d $(DESTDIR)/etc/systemd - $(INSTALL) starved.conf -m 644 $(DESTDIR)/etc/systemd + $(INSTALL) stalld.conf -m 644 $(DESTDIR)/etc/systemd $(INSTALL) -m 755 -d $(DESTDIR)/usr/lib/systemd/system - $(INSTALL) starved.service -m 644 $(DESTDIR)/usr/lib/systemd/system + $(INSTALL) stalld.service -m 644 $(DESTDIR)/usr/lib/systemd/system -rpmlint: starved.spec - rpmlint -i starved.spec +rpmlint: stalld.spec + rpmlint -i stalld.spec diff --git a/redhat/starved.conf b/redhat/stalld.conf index cbbaad3..be0ef0b 100644 --- a/redhat/starved.conf +++ b/redhat/stalld.conf @@ -1,5 +1,5 @@ # -# parameters for the starved service +# parameters for the stalld service # # list of cpus to monitor (default: all online) @@ -44,5 +44,5 @@ LOGGING= FG= # Write a pidfile -# ex: PF=--pidfile /run/starved.pid -PF="--pidfile /run/starved.pid" +# ex: PF=--pidfile /run/stalld.pid +PF="--pidfile /run/stalld.pid" diff --git a/redhat/stalld.service b/redhat/stalld.service new file mode 100644 index 0000000..a88d9bb --- /dev/null +++ b/redhat/stalld.service @@ -0,0 +1,11 @@ +[Unit] +Description=Stall Monitor + +[Service] +# Type=simple +Type=forking +EnvironmentFile=/etc/systemd/stalld.conf +ExecStart=/usr/bin/stalld $CLIST $AGGR $BP $BR $BD $THRESH $LOGGING $FG $PF + +[Install] +WantedBy=multi-user.target diff --git a/redhat/starved.spec b/redhat/stalld.spec index d676a22..f383aac 100644 --- a/redhat/starved.spec +++ b/redhat/stalld.spec @@ -1,17 +1,17 @@ -Name: starved +Name: stalld Version: %(grep ^VERSION ../Makefile | awk '{print $3}') Release: 1%{?dist} Summary: Daemon that finds starving tasks and gives them a temporary boost License: GPLv2 -URL: https://github.com/bristot/starved +URL: https://github.com/bristot/stalld Source0: %{name}-%{version}.tar.xz BuildRequires: glibc-devel Requires: systemd %description -The starved program monitors the set of system threads, +The stalld program monitors the set of system threads, looking for threads that are ready-to-run but have not been given processor time for some threshold period. When a starving thread is found, it is given a temporary @@ -34,13 +34,13 @@ make DESTDIR=$RPM_BUILD_ROOT -C redhat install %files %{_bindir}/%{name} %{_unitdir}/%{name}.service -%config(noreplace) /etc/systemd/starved.conf +%config(noreplace) /etc/systemd/stalld.conf %doc %{_datadir}/%{name}-%{version}/README.md -%doc %{_datadir}/man/man8/starved.8.gz +%doc %{_datadir}/man/man8/stalld.8.gz %changelog * Tue Aug 25 2020 williams@redhat,com - 1.0-1 -- rename project to starved +- rename project to stalld - set version to 1.0 - clean up rpmlint complaints diff --git a/redhat/starved.service b/redhat/starved.service deleted file mode 100644 index 59a68ff..0000000 --- a/redhat/starved.service +++ /dev/null @@ -1,11 +0,0 @@ -[Unit] -Description=Starvation Monitor - -[Service] -# Type=simple -Type=forking -EnvironmentFile=/etc/systemd/starved.conf -ExecStart=/usr/bin/starved $CLIST $AGGR $BP $BR $BD $THRESH $LOGGING $FG $PF - -[Install] -WantedBy=multi-user.target diff --git a/src/starved.c b/src/stalld.c index 7b37237..7b37237 100644 --- a/src/starved.c +++ b/src/stalld.c |