xref: /original-bsd/usr.bin/uucp/uupoll/uupoll.8 (revision b4971bb3)
1.\" Copyright (c) 1986, 1991, 1993
2.\"	The Regents of the University of California.  All rights reserved.
3.\"
4.\" %sccs.include.redist.man%
5.\"
6.\"     @(#)uupoll.8	8.1 (Berkeley) 06/06/93
7.\"
8.Dd
9.Dt UUPOLL 8
10.Os BSD 4.3
11.Sh NAME
12.Nm uupoll
13.Nd poll a remote
14.Tn UUCP
15site
16.Sh SYNOPSIS
17.Nm uupoll
18.Op Fl g Ns Ar grade
19.Op Fl n
20.Ar system
21.Sh DESCRIPTION
22.Nm Uupoll
23is used to force a poll of a remote system. It queues a null job for the
24remote system and then invokes
25.Xr uucico 8 .
26.Pp
27The following options are available:
28.Bl -tag -width Fl
29.It Fl g Ns Ar grade
30Only send jobs of grade
31.Ar grade
32or higher on this call.
33.It Fl n
34Queue the null job, but do not invoke
35.Xr uucico .
36.El
37.Pp
38.Nm Uupoll
39is usually run by
40.Xr cron 5
41or by a user who wants to hurry a job along. A typical entry in
42.Em crontab
43could be:
44.Bd -literal
450    0,8,16     *    *    *    daemon    /usr/bin/uupoll ihnp4
460    4,12,20    *    *    *    daemon    /usr/bin/uupoll ucbvax
47.Ed
48.Pp
49This will poll
50.Em ihnp4
51at midnight, 0800, and 1600, and
52.Em ucbvax
53at 0400, noon, and 2000.
54.Pp
55If the local machine is already running
56.Xr uucico
57every
58hour and has a limited number of outgoing modems, a more elegant approach
59might be:
60.Bd -literal
610    0,8,16    *    *    *    daemon    /usr/bin/uupoll -n ihnp4
620    4,12,20   *    *    *    daemon    /usr/bin/uupoll -n ucbvax
635        *     *    *    *    daemon    /usr/lib/uucp/uucico -r1
64.Ed
65.Pp
66This will queue null jobs for the remote sites at the top of hour; they
67will be processed by
68.Xr uucico
69when it runs five minutes later.
70.Sh FILES
71.Bl -tag -width /usr/lib/uucp/UUCP -compact
72.It Pa /usr/lib/uucp/UUCP
73internal files/utilities
74.It Pa /var/spool/uucp/
75Spool directory
76.El
77.Sh SEE ALSO
78.Xr uucp 1 ,
79.Xr uux 1 ,
80.Xr uucico 8
81.Sh HISTORY
82The
83.Nm
84command appeared in
85.Bx 4.3 .
86