Linux Certif

Toute la documentation sur la certification Linux LPI

upclient

BSD mandoc
GPL

NAME upclient

- logs system uptime with uptimes.wonko.com

SYNOPSIS [sudo]

upclient

[sudo] kill `cat /usr/var/run/upclient.pid`

DESCRIPTION Client for The Uptimes Project

The Uptimes Project collects data on the amount of time a computer has been running since its last reboot and provides statistics on various operating system and hardware configurations.

The client has no command-line options. Upon starting, the daemon logs a brief message to stderr and syslog (on those operating systems that support syslog) then forks into the background. If the daemon cannot start it will try to output error messages to stderr and syslog. Normally the daemon runs quietly and unobtrusively in the background, and writes entries to syslog whenever it communicates with the server.

If you need to stop upclient, signal it with TERM and it will clean up its pid file then quit. The easiest way to do this is [sudo] kill `cat /usr/var/run/upclient.pid` . The daemon ignores INT signals.

GETTING STARTED
 1. Create an account at:

http://uptimes.wonko.com/
 2. Add a host, this gives you an authorization key.
 3. Paste your auth key into /etc/upclient.conf
 4. Start the upclient daemon: [sudo] /usr/sbin/upclient.
 5. Visit your account at http://uptimes.wonko.com/ to view your
    machine's status and other collected statistics.

CONTROLLING UPCLIENT

upclient performs certain actions when it receives certain signals:

SIGALRM

Resets the timer and causes upclient to transmit uptime status immediately.

SIGHUP

Tells upclient to re-reads the configuration file and restart.

TROUBLESHOOTING If you suspect a problem with upclient, check your

syslog for upclient messages.

On BSD systems (including Darwin), upclient must be run as root to send idle time.

Use the following command to trigger an immediate upclient transmission:

[sudo] kill -SIGALRM `cat /usr/var/run/upclient.pid`

To have upclient output verbose messages to the syslog, recompile it in debug mode. In the Makefile add '-DDEBUG' to the CFLAGS line in the section appropriate for your system, like this:

    CFLAGS='-DDEBUG' \

FILES

/usr/sbin/upclient

client

/etc/upclient.conf

configuration

/usr/var/run/upclient.pid

process id

/usr/share/doc/upclient/

documentation

AUTHORS

 Carsten Klapp           carstenklapp@users.sourceforge.net
 Protocol 5 client

 Alex C. de Haas                alex@uptimes.net

 Protocol 4 client

 Martijn Broenland              tgm@uptimes.net

 Original Author

Many people have contributed to the uptime client. Please see /usr/share/doc/upclient/AUTHORS.

LICENSE

Copyright (C) 1999-2002 Martijn Broenland, Alex C. de Haas, Carsten Klapp

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 2 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, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA

SEE ALSO

uptime(1), ruptime(1), getloadavg(3), uname(3), sysctl(8)

HISTORY Version 5 by default transmits uptime information via UDP to port 49153 to

reduce load on the server. If you are behind a closed firewall or using a proxy server the client uses the older protocol 4.2 via HTTP instead, with the same functionality. See /usr/share/doc/upclient/ for more information.

$Id: upclient.man,v 1.2 2002/10/10 01:30:59 carstenklapp Exp $