Porbe

Hardware and OS information library for C++

Usage

Probe contains several modules to probe the hardware & software information, including system, cpu, graphics, process, network, disk, media device and so on, it is simple to use like:

#include "probe/system.h"

#include "probe/memory.h"
#include "probe/util.h"

#include <iostream>

int main()
{
    const auto mem = probe::memory::status();

    std::cout << "Operating System:\n"
              << "    System Name      : " << probe::system::name() << '\n'
              << "    System Version   : " << probe::to_string(probe::system::version()) << '\n'
              << "    Kernel Name      : " << probe::system::kernel::name() << '\n'
              << "    Kernel Version   : " << probe::to_string(probe::system::kernel::version()) << '\n'
              << "    Device Name      : " << probe::system::hostname() << '\n'
              << "    Theme            : " << probe::to_string(probe::system::theme()) << '\n'
              << "    Desktop ENV      : " << probe::to_string(probe::system::desktop_environment()) << " ("
              << probe::to_string(probe::system::desktop_environment_version()) << ")\n"
              << "    Windowing System : " << probe::to_string(probe::system::windowing_system()) << '\n'
              << "    Memory           : " << probe::util::GB(mem.avail) << " / "
              << probe::util::GB(mem.total) << " GB\n";
    return 0;
}

Output:

Operating System:                                                Operating System:
    System Name      : Windows 11 Pro                         |      System Name      : Ubuntu 22.04.3 LTS
    System Version   : 10.0.26058-1000 (24H2)                 |      System Version   : 22.4.3 (jammy)
    Kernel Name      : Windows NT                             |      Kernel Name      : Linux
    Kernel Version   : 10.0.26058-1000                        |      Kernel Version   : 6.5.0-18 (generic)
    Device Name      : EVA-0                                  |      Device Name      : EVA-2204
    Theme            : dark                                   |      Theme            : light
    Desktop ENV      : Windows Shell (10.0.26058-1000 (24H2)) |      Desktop ENV      : GNOME (42.9.0)
    Windowing System : Desktop Window Manager                 |      Windowing System : X11
    Memory           : 4.62131 / 31.9358 GB                   |      Memory           : 11.8134 / 15.5742 GB

Details

System

properties	Windows	Linux	commments
os name	✔	✔	Windows 11 Pro
os version	✔	✔	10.0.25346.1001(22H2)
kernel name	✔	✔	Windows NT
kernel version	✔	✔	10.0.25346.1001
hostname	✔	✔	Device Name/Computer Name
username	✔	✔	Name of Current User
dark/light mode	✔	`Ubuntu 22.04`	dark
desktop environment	`Windows Shell`	✔	GNOME / Unity / Cinnamon / KDE / Xfce / MATE
DE version	same as os version	✔	GNOME (3.28.2.0) / Unity / Cinnamon / KDE
windowing system	`DWM`	✔	DWM / X11 / Wayland
memory	✔	✔	15.29 / 31.94 GB

CPU

properties	Windows	Linux	commments
name	✔	✔	Intel(R) Core(TM) i7-9700K CPU @ 3.60GHz
vendor	✔	✔	GenuineIntel
sockets	✔	✔	1
cores	✔	✔	8
logical cores	✔	✔	8
base frequency	✔	✔	3.6 GHz
architecture	✔	✔	x64
endianness	✔	✔	little
CPUID/features	✔	✔	check features of CPU by cpuid
L1 Data cache	✔	✔	8 x 32 KB
L1 Inst. cache	✔	✔	8 x 32 KB
L2 cache	✔	✔	8 x 256 KB
L3 cache	✔	✔	12 MB

Graphics

GPU

properties	Windows	Linux	commments
name	✔	✔	NVIDIA GeForce RTX 2080
vendor	✔	✔	NVIDIA Corporation
dedicated memory	✔		8390705152 B
shared memory	✔		17146988544 B
frequency

Display Monitor

properties	Windows	Linux	commments
name	✔	✔	"AOC2790"
id	✔	same as name	"\.\DISPLAY1"
primary	✔	✔	true / false
position	✔	✔	(-2560, -1440)
resolution	✔	✔	2560 x 1440
refresh rate	✔	✔	59.9 Hz
BPP	✔	✔	32
logical DPI	`>=Windows 10 1607`	✔	96
scale factor	✔		125%
orientation	✔	✔	Landscape
physical size	✔		60 x 34 cm
physical DPI	✔		108

Virtual Screen

the desktop containing all displays

properties	Windows	Linux	commments
position	✔	✔	(-1920, -1080)
resolution	✔	✔	4480 x 2520

The position of the display can be negative on windows since the primary display always start at (0, 0)

Window List

Z-order: up to down

properties	Windows	Linux	commments
name	✔	✔	"README.md - probe - Visual Studio Code"
classname	✔	✔	"Chrome_WidgetWin_1"
geometry	✔	✔	(741, 328), 1568 x 995
navtive handle	✔	✔	Windows: `HWND`, Linux: `Window`
parent handle	✔	✔
visible	✔	✔	true / false
process id	✔	✔
process name	✔	✔	explorer.exe

Disk

Run as Administrator

properties	Windows	Linux	commments
name	✔	✔	\\.\PhysicalDrive2
path	✔	✔	\\?\scsi#disk&ven_phi&prod_h1#6&314c6ca8&0&000000#{53f56307-b6bf-11d0-94f2-00a0c91efb8b}
serial number	✔	✔	98BB9969766F
GUID/signature	✔		{C65630B2-E183-4363-9E18-93CE442B9515} (GPT) or 9BD1A50 (MBR)
vendor	✔	✔	Samsung
product	✔	✔	Samsung SSD 970 EVO Plus
bus type	✔	✔	SATA / NVMe / USB ...
removable	✔		true / false
writable	✔		true / false
trim	✔		true / false
cylinders	✔		121601
tracks/cylinders	✔		255
sectors/track	✔		63
bytes/sector	✔		512
partitions	✔		6

Partition

properties	Windows	commments
name	✔	Microsoft reserved partition
style	✔	GPT / MBR / RAW
type id	✔	{E3C9E316-0B5C-4DB8-817D-F92DF00215AE}
GUID	✔	{733189C5-6252-4F42-9577-151494026B2B}
offset	✔	17408
length	✔	16759808

Volume

properties	Windows	commments
label	✔	New Volume
letter	✔	C:\
filesystem	✔	NTFS
serial number	✔	10194AA9
GUID path	✔	\\?\Volume{803b42f7-bbee-4d30-ad22-2d0fe90072b6}\
capacity	✔	1870.54 GB
free space	✔	105.929 GB

Audio Devices

properties	Windows	commments
name	✔	Logi C310 HD WebCam
vendor
id	✔	{0.0.1.00000000}.{d6224b54-e7f7-49d9-ab10-b2071cb4eea5}
description	✔	Microphone
type	✔	AudioSource
state	✔	Active

Process

properties	Windows	Linux	commments
pid	✔	✔	process id
ppid	✔	✔	pid of parent process
state	-	✔	R, S, D, Z, T, t, X
priority	✔	✔
name	✔	✔	Win: "xxx.exe", Linux: "xxx"
path	✔	✔	"C:\path\to\file.exe"
cmdline		✔
starttime	✔	✔	unix time, ns
nb_threads	✔	✔
user	✔	✔	username

Thread

properties	Windows	Linux	commments
name (get)	✔	✔	get name of the thread
name (set)	✔	✔	set name of the thread

Linux

Parse the following files:

/proc/uptime
/proc/[pid]/exe
/proc/[pid]/stat
/proc/[pid]/status
/proc/[pid]/statm
/proc/[pid]/cmdline

Network

properties	Windows	Linux	commments
name	✔	✔	Windows: Intel(R) Ethernet Connection (7) I219-V; Linux: eno1
vendor id	(PCI Bus)	✔	0x0123
product	(PCI Bus)	✔	Ethernet Connection (7) I219-V
guid	✔	-	{FFE7027E-6386-11EB-95F5-806E6F6E6963}
interface guid	✔		{653D76BA-C95E-4A46-A3D6-A178841A7AC8}
description	✔	✔	Ethernet
manufacturer	✔	✔	Intel
enabled		✔	true/false
bus	(PCI Bus)	✔	PCI / USB...
bus_info	(PCI Bus)
driver	✔	✔
driver version	✔	✔
virtual	✔	✔	true / false, guessed by physical address and the description
type	✔	✔	Ethernet / IEEE 802.11 / ...
physical address (MAC)	✔	✔	00:50:56:C0:00:01
DHCP Enabled	✔		true
MTU	✔	✔	1500
ipv4_addresses	✔	✔	192.168.189.1
ipv6_addresses	✔	✔	fe80::22bc:b757:c253:a7c8
dhcpv4_server	✔
dhcpv6_server	✔
ipv4_gateways	✔
ipv6_gateways	✔
dns_suffix	✔
ipv4_dns_servers	✔
ipv6_dns_servers	✔

Traffic Statistics

properties	Windows	commments
guid	✔	interface guid
ibytes	✔
obytes	✔
unicast ibytes	✔
unicast obytes	✔
broadcast ibytes	✔
broadcast obytes	✔
multicast ibytes	✔
multicast obytes	✔

Serial Ports

properties	Windows	commments
name	✔	Windows: COM1
instance id	✔	Windows: Device Instance ID
description	✔
manufacturer	✔

Utils

functions	Windows	Linux	commments
to_utf8	✔		wchar -> utf8
to_utf16	✔		utf8 -> wchar
trim	✔	✔	trim string

Windows

functions / classes	commments
registry::read	read value of the registry key
registry::RegistryListener	listen change events of the registry key

Linux

functions / classes	commments
exec_sync	execute a commond and return the standard output
pipe_open/pipe_close	execute a commond and redirect the standard output to the pipe
PipeListener	listen the pipe of the the executed commond
gsettings functions	wrapper to gsettings commond

Compilation Requirement

C++ 20
CMake >= 3.16
Windows >= 10 1607
Linux : install libxrandr-dev

mkdir build && cd build
cmake .. -DPROBE_EXAMPLES=ON -DBUILD_SHARED_LIBS=ON
cmake --build . --config Release -j16

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

README.md

README.md

Porbe

Usage

Details

System

CPU

Graphics

GPU

Display Monitor

Virtual Screen

Window List

Disk

Partition

Volume

Audio Devices

Process

Thread

Linux

Network

Traffic Statistics

Serial Ports

Utils

Windows

Linux

Compilation Requirement

Files

README.md

Latest commit

History

README.md

File metadata and controls

Porbe

Usage

Details

System

CPU

Graphics

GPU

Display Monitor

Virtual Screen

Window List

Disk

Partition

Volume

Audio Devices

Process

Thread

Linux

Network

Traffic Statistics

Serial Ports

Utils

Windows

Linux

Compilation Requirement