gowol

README

Introduction

gowol is a library which provides an easy way to do Wake-on-LAN from your Go application.

The primary goal of gowol is to provide an abstraction which enables you to easily send Wake-on-LAN packets. It supports creation and dispatching of Wake-on-LAN packets of the provided MAC to the provided IP(and port).

Example usage

package main

import "github.com/linde12/gowol"

func main() {
	if packet, err := gowol.NewMagicPacket("03:AA:FF:67:64:05"); err == nil {
		packet.Send("255.255.255.255")          // send to broadcast
		packet.SendPort("255.255.255.255", "7") // specify receiving port
	}
}

Installation

go get github.com/linde12/gowol

License

MIT

Documentation

Index

• type MagicPacket
  • func NewMagicPacket(macAddr string) (packet MagicPacket, err error)
  • func (mp MagicPacket) Send(addr string) error
  • func (mp MagicPacket) SendPort(addr string, port string) error

Types

type MagicPacket

type MagicPacket [102]byte

MagicPacket is a slice of 102 bytes containing the magic packet data.

func NewMagicPacket

func NewMagicPacket(macAddr string) (packet MagicPacket, err error)

NewMagicPacket allocates a new MagicPacket with the specified MAC.

func (MagicPacket) Send

func (mp MagicPacket) Send(addr string) error

Send writes the MagicPacket to the specified address on port 9.

func (MagicPacket) SendPort

func (mp MagicPacket) SendPort(addr string, port string) error

SendPort writes the MagicPacket to the specified address and port.