no chage, new sccsid
[unix-history] / usr / src / usr.bin / uucp / uupoll / uupoll.8
CommitLineData
c843f639
KM
1.\" Copyright (c) 1986 Regents of the University of California.
2.\" All rights reserved. The Berkeley software License Agreement
3.\" specifies the terms and conditions for redistribution.
4.\"
31265d37 5.\" @(#)uupoll.8 6.2 (Berkeley) %G%
c843f639
KM
6.\"
7.TH UUPOLL 8C ""
8.UC 6
9.SH NAME
10uupoll \- poll a remote \s-1UUCP\s+1 site
11.SH SYNOPSIS
12.B uupoll
13[
14.BI \-g grade
15] [
16.B \-n
17]
18.I system
19.SH DESCRIPTION
20.I Uupoll
21is used to force a poll of a remote system. It queues a null job for the
22remote system and then invokes
23.IR uucico (8C).
24.PP
25The following options are available:
26.TP 8
27.BI \-g grade
28Only send jobs of grade
29.I grade
30or higher on this call.
31.TP 8
32.B \-n
33Queue the null job, but do not invoke
34.IR uucico .
35.PP
36.I Uupoll
37is usually run by
38.IR cron (5)
39or by a user who wants to hurry a job along. A typical entry in
40.I crontab
41could be:
42.PP
43.nf
31265d37
KM
44 0 0,8,16 * * * daemon /usr/bin/uupoll ihnp4
45 0 4,12,20 * * * daemon /usr/bin/uupoll ucbvax
c843f639
KM
46.fi
47This will poll
48.B ihnp4
49at midnight, 0800, and 1600, and
50.B ucbvax
51at 0400, noon, and 2000.
52.PP
53If the local machine is already running
54.I uucico
55every
56hour and has a limited number of outgoing modems, a more elegant approach
57might be:
58.PP
59.nf
31265d37
KM
60 0 0,8,16 * * * daemon /usr/bin/uupoll -n ihnp4
61 0 4,12,20 * * * daemon /usr/bin/uupoll -n ucbvax
62 5 * * * * daemon /usr/lib/uucp/uucico -r1
c843f639
KM
63.fi
64This will queue null jobs for the remote sites at the top of hour; they
65will be processed by
66.I uucico
67when it runs five minutes later.
68.SH FILES
69.ta \w'/usr/spool/uucp/ 'u
70.nf
71/usr/lib/uucp/ UUCP internal files/utilities
72/usr/spool/uucp/ Spool directory
73.fi
74.SH SEE ALSO
75uucp(1C), uux(1C), uucico(8C)