log

package

v0.0.0-...-602bb2d Latest Latest Go to latest Published: Jan 19, 2026 License: MPL-2.0 Imports: 14 Imported by: 0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/celzero/firestack

Links

Open Source Insights

Documentation ¶

Index ¶

func C(msg string, scratch []byte)
func D(msg string, args ...any)
func D2(at int, msg string, args ...any)
func E(msg string, args ...any)
func E2(at int, msg string, args ...any)
func EE(msg string, args ...any) (err error)
func I(msg string, args ...any)
func I2(at int, msg string, args ...any)
func N(string, ...any)
func N2(int, string, ...any)
func NewLogger(tag string) *simpleLogger
func P(msg string, args ...any)
func R(c bool, msg string, args ...any)
func SetConsole(consoleCtx context.Context, c Console)
func SetConsoleLevel(level LogLevel)
func SetLevel(level LogLevel)
func T(msg string, args ...any)
func TALL(msg string, atleast64k []byte)
func U(msg string)
func V(msg string, args ...any)
func V2(at int, msg string, args ...any)
func VV(msg string, args ...any)
func VV2(at int, msg string, args ...any)
func W(msg string, args ...any)
func W2(at int, msg string, args ...any)
func WE(msg string, args ...any) (err error)
func Wtf(msg string, args ...any)
type Console
type FilebasedConsole
- func NewFilebased() (reader *os.File, writer FilebasedConsole, err error)
type LogFn
- func Of(tag string, l LogFn2) LogFn
type LogFn2
type LogLevel
- func LevelOf(level int32) LogLevel
type Logger
type Logmsg

Constants ¶

This section is empty.

Variables ¶

This section is empty.

Functions ¶

func C ¶

func C(msg string, scratch []byte)

C logs the stack trace of the current goroutine to Console.

func D ¶

func D(msg string, args ...any)

D logs a debug message.

func D2 ¶

func D2(at int, msg string, args ...any)

func E ¶

func E(msg string, args ...any)

E logs an error message.

func E2 ¶

func E2(at int, msg string, args ...any)

func EE ¶

func EE(msg string, args ...any) (err error)

func I ¶

func I(msg string, args ...any)

I logs an info message.

func I2 ¶

func I2(at int, msg string, args ...any)

func N ¶

func N(string, ...any)

N is a no-op logger.

func N2 ¶

func N2(int, string, ...any)

N2 is a no-op logger.

func NewLogger ¶

func NewLogger(tag string) *simpleLogger

NewLogger creates a new Glogger with the given tag.

func P ¶

func P(msg string, args ...any)

P logs a private message.

func R ¶

func R(c bool, msg string, args ...any)

R logs msg to as error to log if c is false, or to console otherwise.

func SetConsole ¶

func SetConsole(consoleCtx context.Context, c Console)

SetConsole sets external console to redirect log output to.

func SetConsoleLevel ¶

func SetConsoleLevel(level LogLevel)

func SetLevel ¶

func SetLevel(level LogLevel)

func T ¶

func T(msg string, args ...any)

T logs the stack trace of the current goroutine.

func TALL ¶

func TALL(msg string, atleast64k []byte)

TALL logs the stack trace of all active goroutines.

func U ¶

func U(msg string)

U logs a user message (notifies the user).

func V ¶

func V(msg string, args ...any)

V logs a verbose message.

func V2 ¶

func V2(at int, msg string, args ...any)

func VV ¶

func VV(msg string, args ...any)

VV logs a very verbose message.

func VV2 ¶

func VV2(at int, msg string, args ...any)

func W ¶

func W(msg string, args ...any)

W logs a warning message.

func W2 ¶

func W2(at int, msg string, args ...any)

func WE ¶

func WE(msg string, args ...any) (err error)

func Wtf ¶

func Wtf(msg string, args ...any)

Wtf logs a fatal message.

Types ¶

type Console ¶

type Console interface {
	// Log logs a multi-line msg.
	Log(level LogLevel, msg Logmsg)
}

Console is an external logger.

type FilebasedConsole ¶

type FilebasedConsole interface {
	Console
	io.Closer
	File() *os.File
}

func NewFilebased ¶

func NewFilebased() (reader *os.File, writer FilebasedConsole, err error)

NewFilebased sets a pipe-backed console and returns reader and writer. Caller is expected to hand off the read fd and read until EOF. Caller owns the reader and write and must close both.

type LogFn ¶

type LogFn func(string, ...any)

func Of ¶

func Of(tag string, l LogFn2) LogFn

type LogFn2 ¶

type LogFn2 func(int, string, ...any)

type LogLevel ¶

type LogLevel uint32

const (
	VVERBOSE   LogLevel = iota // VVERBOSE is the most verbose log level.
	VERBOSE                    // VERBOSE is the verbose log level.
	DEBUG                      // DEBUG is the debug log level.
	INFO                       // INFO is the informational log level.
	WARN                       // WARN is the warning log level.
	ERROR                      // ERROR is the error log level.
	STACKTRACE                 // STACKTRACE is the stack trace log level.
	USR                        // USR is interactive log (e.g. as user prompt).
	NONE                       // NONE no-ops the logger.
)

func LevelOf ¶

func LevelOf(level int32) LogLevel

type Logger ¶

type Logger interface {
	SetLevel(level LogLevel)
	SetConsoleLevel(level LogLevel)
	SetConsole(c Console)
	Usr(msg string)
	Printf(msg string, args ...any)
	VeryVerbosef(at int, msg string, args ...any)
	Verbosef(at int, msg string, args ...any)
	Debugf(at int, msg string, args ...any)
	Piif(at int, msg string, args ...any)
	Infof(at int, msg string, args ...any)
	Warnf(at int, msg string, args ...any)
	Errorf(at int, msg string, args ...any)
	Fatalf(at int, msg string, args ...any)
	Trace(c bool, t string)
	Stack(at int, msg string, scratch []byte)
}

var Glogger Logger = defaultLogger()

based on: github.com/eycorsican/go-tun2socks/blob/301549c43/common/log/log.go#L5

type Logmsg ¶

type Logmsg = string

Source Files ¶

View all Source files

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL