xref: /netbsd-src/usr.sbin/wakeonlan/wakeonlan.8 (revision f56171bd03c05f09c714404c4efd6eac1595bfd9)
1*f56171bdSwiz.\" $NetBSD: wakeonlan.8,v 1.5 2018/05/14 06:52:33 wiz Exp $
26b4d01fdSuebayasi.\"
357e869faSmbalmer.\" Copyright (c) 2009 - 2017 Marc Balmer <marc@msys.ch>
46b4d01fdSuebayasi.\"
56b4d01fdSuebayasi.\" Permission to use, copy, modify, and distribute this software for any
66b4d01fdSuebayasi.\" purpose with or without fee is hereby granted, provided that the above
76b4d01fdSuebayasi.\" copyright notice and this permission notice appear in all copies.
86b4d01fdSuebayasi.\"
96b4d01fdSuebayasi.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
106b4d01fdSuebayasi.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
116b4d01fdSuebayasi.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
126b4d01fdSuebayasi.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
136b4d01fdSuebayasi.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
146b4d01fdSuebayasi.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
156b4d01fdSuebayasi.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
166b4d01fdSuebayasi.\"
17a9f8ca9aSsevan.Dd May 13, 2018
186b4d01fdSuebayasi.Dt WAKEONLAN 8
196b4d01fdSuebayasi.Os
206b4d01fdSuebayasi.Sh NAME
216b4d01fdSuebayasi.Nm wakeonlan
226b4d01fdSuebayasi.Nd send Wake on LAN frames to hosts on a local Ethernet network
236b4d01fdSuebayasi.Sh SYNOPSIS
246b4d01fdSuebayasi.Nm
256b4d01fdSuebayasi.Op Ar interface
266b4d01fdSuebayasi.Ar lladdr
276b4d01fdSuebayasi.Op Ar lladdr ...
286b4d01fdSuebayasi.Sh DESCRIPTION
296b4d01fdSuebayasiThe
306b4d01fdSuebayasi.Nm
316b4d01fdSuebayasiprogram is used to send Wake on LAN (WoL) frames over a local
326b4d01fdSuebayasiEthernet network to one or more hosts using their link layer (hardware)
336b4d01fdSuebayasiaddresses.
346b4d01fdSuebayasiWoL functionality is generally enabled in a machine's BIOS
356b4d01fdSuebayasiand can be used to power on machines from a remote system without
366b4d01fdSuebayasihaving physical access to them.
376b4d01fdSuebayasi.Pp
386b4d01fdSuebayasi.Ar interface
396b4d01fdSuebayasiis an Ethernet interface of the local machine and is used to send the
406b4d01fdSuebayasiWake on LAN frames over it.
416b4d01fdSuebayasiIf there is only one Ethernet device available that is up and running, then the
426b4d01fdSuebayasi.Ar interface
436b4d01fdSuebayasiargument can be omitted.
446b4d01fdSuebayasi.Ar lladdr
456b4d01fdSuebayasiis the link layer address of the remote machine.
4657e869faSmbalmerThis can be specified as a hardware address
476b4d01fdSuebayasior as a hostname entry in
486b4d01fdSuebayasi.Pa /etc/ethers .
496b4d01fdSuebayasi.Nm
506b4d01fdSuebayasiaccepts multiple
516b4d01fdSuebayasi.Ar lladdr
526b4d01fdSuebayasiaddresses.
536b4d01fdSuebayasiLink layer addresses can be determined and set using
546b4d01fdSuebayasi.Xr ifconfig 8 .
556b4d01fdSuebayasi.Sh FILES
566b4d01fdSuebayasi.Bl -tag -width "/etc/ethers" -compact
576b4d01fdSuebayasi.It /etc/ethers
586b4d01fdSuebayasiEthernet host name data base.
596b4d01fdSuebayasi.El
606b4d01fdSuebayasi.Sh SEE ALSO
616b4d01fdSuebayasi.Xr ethers 5 ,
626b4d01fdSuebayasi.Xr ifconfig 8
63a9f8ca9aSsevan.Sh HISTORY
64a9f8ca9aSsevanThe
65a9f8ca9aSsevan.Nm
66a9f8ca9aSsevanutility first appeared in
67*f56171bdSwiz.Nx 6.0 .
686b4d01fdSuebayasi.Sh AUTHORS
696b4d01fdSuebayasi.Nm
706b4d01fdSuebayasiwas written by
716b4d01fdSuebayasi.An Marc Balmer
726b4d01fdSuebayasi.Aq marc@msys.ch .
73