Skip to content

Latest commit

 

History

History
323 lines (265 loc) · 19.2 KB

README.md

File metadata and controls

323 lines (265 loc) · 19.2 KB

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 Linux 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 Linux 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 Linux 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 Linux commments
guid interface guid
ibytes
obytes
unicast ibytes
unicast obytes
broadcast ibytes
broadcast obytes
multicast ibytes
multicast obytes

Serial Ports

properties Windows Linux 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