rpms/vnstat/devel FAQ.vnstat, NONE, 1.1 vnstat.spec, NONE, 1.1 .cvsignore, 1.1, 1.2 sources, 1.1, 1.2

Adrian Reber (adrian) fedora-extras-commits at redhat.com
Tue Mar 1 18:37:44 UTC 2005


Author: adrian

Update of /cvs/extras/rpms/vnstat/devel
In directory cvs-int.fedora.redhat.com:/tmp/cvs-serv12570/devel

Modified Files:
	.cvsignore sources 
Added Files:
	FAQ.vnstat vnstat.spec 
Log Message:
auto-import vnstat-1.4-3 on branch devel from vnstat-1.4-3.src.rpm


--- NEW FILE FAQ.vnstat ---
vnStat FAQ (for version 1.4+, 15.4.2004)


1. How should dialup users use vnStat? There's some errors
because the interface isn't available when offline.

 That's all explained at the end of the README. The idea
 is to include vnStat with enable/disable parameters in
 scripts related with the used interface. Example scripts
 can be found from the pppd directory that came with the
 source package.

2. Does vnStat work for PPPOE users?

 Although I haven't tested it, it's been reported to work
 if the supplied ppp scripts are installed correctly. As
 always, see the README and the man page.

3. How do I uninstall vnStat?

 You only need to run 'make uninstall' in the directory that
 comes when the .tar.gz is extracted. Just make sure it's
 the same version you have installed.

4. What does the 'estimated' value mean?

 The estimated value is an calculated average that tries to
 guess the total traffic for the current day/month based on
 previous traffic. This estimate works fairly well if the
 monitored interface has constant traffic of the same
 magnitude (like game servers). It can't predic peaks but
 the accuracy usually gets better by the end of the day/month.

5. Why isn't the estimated value shown with --dumpdb?

 That features only dumps the database and since the estimate
 is always calculated in realtime, there's no reason to write
 it into the database.

6. How is the estimated value calculated?

 estimate = ( x / y ) * z

   x = traffic so far for the day/month
   y = passed minutes/hours ...
   z = total minutes/hours ...

7. Why does vnStat show sometimes multiple GB of traffic although
my network connection can't even transfer that much?
     OR
Each update adds the complete amount of traffic and 'vnstat -u -D'
claims that the system has been rebooted between updates.

 That's most likely a broken kernel. Run with --testkernel
 (version 1.2+ required) and see the result. See the next question
 for some explanation.

8. Why is there problems with most 2.4.18 kernels?

 Every current kernel has a btime (boot time) value in /proc/stat
 that indicates when the system was booted. vnStat uses this to
 know when the interface counters in the database should be
 reseted. Unfortunately, some kernels don't keep the btime value
 static even when the system isn't rebooted.

9. warning: integer constant is too large for "long" type -messages
during compiling with gcc 3.xx?

 Like that message says, that's only a warning, not an error.

10. About bug reports

 Any bug report should at least include an explanation about
 how the bug can be reproduced. Having output dumps usually
 helps and the --dumpdb feature should be used if there's some
 reason to assume the bug has something to do with the database.
 Also include information about the used distribution, kernel
 (uname -a), compiler (gcc --version) and network interface
 card. Read the report again before sending it. :)


--- NEW FILE vnstat.spec ---
Summary: 	Console-based network traffic monitor
Name: 		vnstat
Version: 	1.4
Release: 	3
License: 	GPL
Group: 		System Environment/Daemons
URL: 		http://humdi.net/vnstat/
Source0: 	http://humdi.net/vnstat/vnstat-%{version}.tar.gz
Source1: 	FAQ.vnstat
BuildRoot: 	%{_tmppath}/%{name}-%{version}-%{release}-root-%(%{__id_u} -n)

%description
vnStat is a console-based network traffic monitor that uses the
/proc -filesystem to get the needed information. This means that vnStat wont
actually be sniffing any traffic. See the webpage for few 'screenshots'.

%prep
%setup -q
%{__cp} %{SOURCE1} FAQ

%build
%{__make} %{?_smp_mflags} CFLAGS="$RPM_OPT_FLAGS"

%install
%{__rm} -rf $RPM_BUILD_ROOT
%{__mkdir_p} $RPM_BUILD_ROOT%{_bindir}
%{__mkdir_p} $RPM_BUILD_ROOT%{_sbindir}
%{__mkdir_p} $RPM_BUILD_ROOT%{_mandir}/man1
%{__mkdir_p} $RPM_BUILD_ROOT%{_localstatedir}/lib/%{name}
%{__mkdir_p} $RPM_BUILD_ROOT%{_sysconfdir}/cron.d
%{__mkdir_p} $RPM_BUILD_ROOT%{_sysconfdir}/sysconfig

%{__install} -m 644 man/vnstat.1 $RPM_BUILD_ROOT%{_mandir}/man1
%{__install} -m 755 src/vnstat $RPM_BUILD_ROOT%{_bindir}

%{__cat} >> $RPM_BUILD_ROOT%{_sysconfdir}/cron.d/%{name} << END
MAILTO=root
# to enable intrerface monitoring via vnstat remove comment on next line
# */5 * * * *  vnstat %{_sbindir}/%{name}.cron
END

%{__cat} >> $RPM_BUILD_ROOT%{_sysconfdir}/sysconfig/%{name} << END
# see also: vnstat(1)
# the following sets vnstat up to monitor eth0
VNSTAT_OPTIONS="-u -i eth0"
END

%{__cat} >> $RPM_BUILD_ROOT%{_sbindir}/%{name}.cron << END
#!/bin/bash
# this script (%{_sbindir}/%{name}.cron) reads %{_sysconfdir}/sysconfig/%{name}
# to start %{_bindir}/%{name}.
# example for %{_sysconfdir}/sysconfig/%{name}:
# VNSTAT_OPTIONS="-u -i eth0"
# see also: vnstat(1)

VNSTAT_CONF=%{_sysconfdir}/sysconfig/%{name}

if [ ! -f $VNSTAT_CONF ]; then
        exit 0
fi

. \$VNSTAT_CONF

%{_bindir}/%{name} \$VNSTAT_OPTIONS
END

%clean
%{__rm} -rf $RPM_BUILD_ROOT

%pre
useradd -r -s /sbin/nologin -d %{_localstatedir}/lib/%{name} -c 'vnstat user' %{name} >/dev/null 2>&1 ||:

%preun
if [ "$1" -eq "0" ]; then
        userdel %{name}
fi

%files
%defattr(-,root,root,-)
%doc CHANGES COPYING FAQ README INSTALL cron pppd
%config(noreplace) %{_sysconfdir}/cron.d/%{name}
%config(noreplace) %{_sysconfdir}/sysconfig/%{name}
%{_mandir}/man1/*
%{_bindir}/%{name}
%attr(755,root,root)%{_sbindir}/%{name}.cron
%attr(-,vnstat,vnstat)%{_localstatedir}/lib/%{name}

%changelog
* Mon Feb 28 2005 Adrian Reber <adrian at lisas.de> 1.4-3
- removed occurences of VNSTAT_DISABLED in
  %{_sysconfdir}/sysconfig/%{name} and
  %{_sbindir}/%{name}.cron 

* Thu Feb 24 2005 Adrian Reber <adrian at lisas.de> 1.4-2
- removed "#--------------"
- added %%{version} to Source0
- replaced almost empty FAQ with the one from the web
- added INSTALL to %%doc
- added %{_sysconfdir}/sysconfig/%{name}
  and %{_sbindir}/%{name}.cron to allow flexible configuration
- cron script and configuration file defaults to vnstat disabled
- added example scripts from cron/* and pppd/* to %%doc

* Wed Jul 21 2004 Adrian Reber <adrian at lisas.de> 1.4-1
- initial build


Index: .cvsignore
===================================================================
RCS file: /cvs/extras/rpms/vnstat/devel/.cvsignore,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- .cvsignore	1 Mar 2005 18:36:49 -0000	1.1
+++ .cvsignore	1 Mar 2005 18:37:42 -0000	1.2
@@ -0,0 +1 @@
+vnstat-1.4.tar.gz


Index: sources
===================================================================
RCS file: /cvs/extras/rpms/vnstat/devel/sources,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- sources	1 Mar 2005 18:36:49 -0000	1.1
+++ sources	1 Mar 2005 18:37:42 -0000	1.2
@@ -0,0 +1 @@
+9184f79b5e60499bc059f670032291e5  vnstat-1.4.tar.gz




More information about the fedora-extras-commits mailing list