FREETZ Paket Halt-On-Lan (HOL)

/var/mod/root # hol
hol v1.0 Halt-On-Lan script
Author hermann72pb <http://www.ip-phone-forum.de/member.php?u=80424>

Usage: hol HOST [ACTION TIME MESSAGE]
HOST      Hostname or ip address: e.g. my.computer or 192.168.178.20
ACTION    Actions for poweroff: e.g. shutdown, reboot, logoff, lock, etc.
TIME      time in seconds for warning before the action:
          e.g. 10 or 0 for no warning
MESSAGE   Warning message: e.g. Please close all your files
/var/mod/root # hol 192.168.178.20
/var/mod/root # hol 192.168.178.20 lock
/var/mod/root # hol MeinPC monitor_off 15
/var/mod/root # hol DeinNotebook monitor_off 15 "Hey, du\nschalte aus!"

5 Remote Control

You can remotely control poweroff by starting it as a service and setting the ‘Allow remote control’ option. You can control it by using poweroff itself and selecting a remote computer, or you can control it by using telnet to the port where poweroff listens on (default 3210). For example telnet computer 3210. You’ll see a welcome message like this:

201 Welcome to Poweroff 3.0 created by Jorgen Bosman

Poweroff uses a protocol like ftp or smtp with commands and reply codes. You enter a command and poweroff will reply with ‘2xx message’ on success or ‘5xx message’ on error.

You can enter the following commands:

QUIT 		Terminates the connection
HELP 		Shows this help
PASSWORD p 	Authenticates the client with a password
ACTION a 	The action to perform (logoff, reboot, shutdown, poweroff, standby, hibernate, lock, wol, monitor_off, monitor_on, no_action)
WHO w 		Who must perform the action (local, remote)
WHEN w 		When must the action be performed (immediate, scheduled, after_process)
SIMULATE s 	Simulate the action (on, off)
COMPUTER c 	The remote computer name
MAC m 		The remote computer mac address (WOL)
IP i 		The remote computer ip address (WOL)
SUBNET s 	The remote computer subnet mask (WOL)
WARNING w 	Show warning before doing the action (on, off)
WARNTIME w 	The number of seconds to show the warning
MESSAGE m 	The warning message
PLAYSOUND p 	Play a sound when showing the warning (on, off)
SOUNDFILE s 	The WAV file to play
RUNPRG r 	Runs a program before doing the action (on, off)
PROGRAM p 	The program to run
DIRECTORY d 	The startup directory for the program
SCHEDULE s 	The type of schedule (fixed_day, daily, day_of_month, after_x_seconds)
TIME t 		The time when to do the action (hh:mm)
DATE d 		The date when to do the action (dd/mm/yyyy)
DAYS d 		The days of the week when to do the action (m, t, w, th, f, s, su)
WEEKS d 	The weeks of the month when to do the action (1, 2, 3, 4, 5)
DAY d 		The day of the month when to do the action (1-31)
WAIT w 		The number of seconds to wait before checking the time
SECONDS w 	The number of seconds to wait before doing the action
PROCESS p 	Wait for process p to finish
FORCE f 	Force applications to close (on, off)
CANCEL c 	Allow the user to cancel the action (on, off)
SHOW 		Show current settings
VERSION 	Show current poweroff version
DOIT 		Do the action
STOP		Stops the current scheduled action

Example:
telnet computer 3210

201 Welcome to Poweroff 3.0.0.5 created by Jorgen Bosman
action logoff
250 OK
warning on
250 OK
message You will be logged off in 10 seconds
250 OK
warntime 10
250 OK
doit
250 OK
quit
201 Bye bye
Connection closed by foreign host.