procinfo

README

procinfo

Golang Linux based /proc parsing to retrieve information about processes.

Doesn't touch Windows cause that's the bad place.

Documentation

Index

• Constants
• Variables
• type Lock
• type Process
  • func GetProcessByPid(pid uint32) Process

Constants

const (
	ProcLockColPriority = iota
	ProcLockColType

	ProcLockColExclusive
	ProcLockColPID
	ProcLockColInode
	ProcLockColByteStart
	ProcLockColByteEnd
)

const (
	ProcStateRunning      = 'R'
	ProcStateSleeping     = 'S'
	ProcStateWaiting      = 'D'
	ProcStateZombie       = 'Z'
	ProcStateStopped      = 'T'
	ProcStateTraceStopped = 't'
	ProcStatePaging       = 'W'
	ProcStateLegacyDead   = 'X'
	ProcStateDead         = 'x'
	ProcStateWakekill     = 'K'
	ProcStateWaking       = 'W'
	ProcStateParked       = 'P'
)

const FmtProcCmdlineFile = "/proc/%d/cmdline"

const FmtProcCwdFile = "/proc/%d/cwd"

const FmtProcEnvFile = "/proc/%d/environ"

const FmtProcLocks = "%d: %s %s %s %d %x:%x:%d"

const FmtProcPidStat = "%d %s %c %d %d %d %d %d %d %d %d %d %d %d %d %d %d %d"

position 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18

const FmtProcStatFile = "/proc/%d/stat"

const (
	ProcLock = "/proc/locks"
)

Variables

var (
	ErrPermissionDenied = errors.New("cannot read /proc/locks")
)

var FileLocks = fileLocksType{
	// contains filtered or unexported fields
}

var TestData_CheckInode_Processes = map[uint64][]Process{
	810: []Process{
		{
			Pid:          5623,
			OriginalName: "slack",
			State:        'S',
			Cwd:          "/proc/lol/fd",
			PPid:         2770,
			UserTime:     1,
			KernelTime:   286,
			Nice:         20,
			Cmdline:      []string{"/usr/lib/slack/slack"},
			Env: []string{
				"slack",
				"",
				"",
				"\n",
			},
		},
	},
	1088: []Process{
		{
			Pid:          5705,
			OriginalName: "chrome",
			State:        'S',
			Cwd:          "/proc/5715/fdinfo",
			PPid:         5680,
			UserTime:     0,
			KernelTime:   2,
			Nice:         20,
			Cmdline: []string{
				"/opt/google/chrome/chrome --type=zygote --enable-crash-reporter=4d5673fa-4274-4096-a4f8-0c3f692622fa,",
				"",
			},
			Env: []string{
				"",
				"",
				"",
				"",
				"",
				"\n",
			},
		},
	},
	23600664: []Process{
		{
			Pid:          8819,
			OriginalName: "code",
			State:        'S',
			Cwd:          "/proc/notthere",
			PPid:         1,
			UserTime:     1,
			KernelTime:   578,
			Nice:         20,
			Cmdline:      []string{"/usr/share/code/code .", ""},
			Env: []string{
				"",
				"",
				"",
				"",
				"",
				"\n",
			},
		},
	},
}

var Testdata_Lock = []Lock{
	Lock{
		Priority:  41,
		ByteRange: false,
		Exclusive: true,
		PID:       5623,
		DevMajor:  0x00,
		DevMinor:  0x17,
		Inode:     810,
	},
	Lock{
		Priority:  42,
		ByteRange: true,
		Exclusive: false,
		PID:       5705,
		DevMajor:  0x00,
		DevMinor:  0x17,
		Inode:     1088,
	},
	Lock{
		Priority:  61,
		ByteRange: false,
		Exclusive: true,
		PID:       8819,
		DevMajor:  0xfd,
		DevMinor:  0x01,
		Inode:     23600664,
	},
}

Types

type Lock

type Lock struct {
	Priority  uint32 `json:"lockPriority"`
	ByteRange bool   `json:"isByteRange"`
	Exclusive bool   `json:"exclusive"`
	PID       uint32 `json:"pid"`
	DevMajor  uint16 `json:"fsMajor"`
	DevMinor  uint16 `json:"fsMinor"`
	Inode     uint64 `json:"inode"`
}

type Process

type Process struct {
	// process number and parent process number
	Pid          uint32
	PPid         uint32
	OriginalName string
	State        rune

	UserTime   uint64
	KernelTime uint64

	Nice        uint8
	MemoryUsage uint64

	Cmdline []string
	Env     []string
	Cwd     string
}

func GetProcessByPid

func GetProcessByPid(pid uint32) Process