File: condor_power.rst

package info (click to toggle)
condor 23.9.6%2Bdfsg-2.1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 60,012 kB
  • sloc: cpp: 528,272; perl: 87,066; python: 42,650; ansic: 29,558; sh: 11,271; javascript: 3,479; ada: 2,319; java: 619; makefile: 615; xml: 613; awk: 268; yacc: 78; fortran: 54; csh: 24
file content (65 lines) | stat: -rw-r--r-- 2,297 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
      

*condor_power*
===============

send packet intended to wake a machine from a low power state
:index:`condor_power<single: condor_power; HTCondor commands>`\ :index:`condor_power command`

Synopsis
--------

**condor_power** [**-h** ]

**condor_power** [**-d** ] [**-i** ] [**-m** *MACaddress*]
[**-s** *subnet*] [*ClassAdFile* ]

Description
-----------

*condor_power* sends one UDP Wake on LAN (WOL) packet to a machine
specified either by command line arguments or by the contents of a
machine ClassAd. The machine ClassAd may be in a file, where the file
name specified by the optional argument *ClassAdFile* is given on the
command line. With no command line arguments to specify the machine, and
no file specified, *condor_power* quietly presumes that standard input
is the file source which will specify the machine ClassAd that includes
the public IP address and subnet of the machine.

*condor_power* needs a complete specification of the machine to be
successful. If a MAC address is provided on the command line, but no
subnet is given, then the default value for the subnet is used. If a
subnet is provided on the command line, but no MAC address is given,
then *condor_power* falls back to taking its information in the form of
the machine ClassAd as provided in a file or on standard input. Note
that this case implies that the command line specification of the subnet
is ignored.

*condor_power* relies on the router receiving the WOL packet to
correctly broadcast the request. Since routers are often configured to
ignore requests to broadcast messages on a different subnet than the
sender, the send of a WOL packet to a machine on a different subnet may
fail.

Options
-------

 **-h**
    Print usage information and exit.
 **-d**
    Enable debugging messages.
 **-i**
    Read a ClassAd that is piped in through standard input.
 **-m** *MACaddress*
    Specify the MAC address in the standard format of six groups of two
    hexadecimal digits separated by colons.
 **-s** *subnet*
    Specify the subnet in the standard form of a mask for an IPv4
    address. Without this option, a global broadcast will be sent.

Exit Status
-----------

*condor_power* will exit with a status value of 0 (zero) upon success,
and it will exit with the value 1 (one) upon failure.