eventlog

Documentation

Overview

Package eventlog implements access to Windows event log.

Index

• Constants
• func Install(src, msgFile string, eventsSupported uint32) error
• func InstallAsEventCreate(src string, eventsSupported uint32) error
• func Remove(src string) error
• type Log
  • func Open(source string) (*Log, error)
  • func OpenRemote(host, source string) (*Log, error)
  • func (l *Log) Close() error
  • func (l *Log) Error(eid uint32, msg string) error
  • func (l *Log) Info(eid uint32, msg string) error
  • func (l *Log) Warning(eid uint32, msg string) error

Constants

const (
	// Log levels.
	Info    = winapi.EVENTLOG_INFORMATION_TYPE
	Warning = winapi.EVENTLOG_WARNING_TYPE
	Error   = winapi.EVENTLOG_ERROR_TYPE
)

Functions

func Install

func Install(src, msgFile string, eventsSupported uint32) error

Install modifies PC registry to allow logging with event source src. It adds all required keys/values to event log key. Install uses msgFile as event message file. Use bitwise of log.Error, log.Warning and log.Info to specify events supported.

func InstallAsEventCreate

func InstallAsEventCreate(src string, eventsSupported uint32) error

InstallAsEventCreate is the same as Install, but uses %SystemRoot%\System32\EventCreate.exe as event message file.

func Remove

func Remove(src string) error

Remove deletes all registry elements installed by correspondent Install.

Types

type Log

type Log struct {
	Handle syscall.Handle
}

Log provides access to system log.

func Open

func Open(source string) (*Log, error)

Open retrieves a handle to the specified event log.

func OpenRemote

func OpenRemote(host, source string) (*Log, error)

OpenRemote does the same as Open, but on different computer host.

func (*Log) Close

func (l *Log) Close() error

Close closes event log l.

func (*Log) Error

func (l *Log) Error(eid uint32, msg string) error

Error writes an error event msg with event id eid to the end of event log l. eid must be between 1 and 1000 if using EventCreate.exe as event message file.

func (*Log) Info

func (l *Log) Info(eid uint32, msg string) error

Info writes an information event msg with event id eid to the end of event log l. eid must be between 1 and 1000 if using EventCreate.exe as event message file.

func (*Log) Warning

func (l *Log) Warning(eid uint32, msg string) error

Warning writes an warning event msg with event id eid to the end of event log l. eid must be between 1 and 1000 if using EventCreate.exe as event message file.