⚝
One Hat Cyber Team
⚝
Your IP:
216.73.216.23
Server IP:
178.33.27.10
Server:
Linux cpanel.dev-unit.com 3.10.0-1160.108.1.el7.x86_64 #1 SMP Thu Jan 25 16:17:31 UTC 2024 x86_64
Server Software:
Apache/2.4.57 (Unix) OpenSSL/1.0.2k-fips
PHP Version:
8.2.11
Buat File
|
Buat Folder
Eksekusi
Dir :
~
/
usr
/
local
/
src
/
netdata
/
src
/
libnetdata
/
procfile
/
View File Name :
README.md
<!-- title: "PROCFILE" custom_edit_url: https://github.com/netdata/netdata/edit/master/src/libnetdata/procfile/README.md sidebar_label: "Procfile" learn_status: "Published" learn_topic_type: "Tasks" learn_rel_path: "Developers/libnetdata" --> # PROCFILE procfile is a library for reading text data files (i.e `/proc` files) in the fastest possible way. ## How it works The library automatically adapts (through the iterations) its memory so that each file is read with single `read()` call. Then the library splits the file into words, using the supplied separators. The library also supported quoted words (i.e. strings within of which the separators are ignored). ### Initialization Initially the caller: - calls `procfile_open()` to open the file and allocate the structures needed. ### Iterations For each iteration, the caller: - calls `procfile_readall()` to read updated contents. This call also rewinds (`lseek()` to 0) before reading it. For every file, a [BUFFER](https://github.com/netdata/netdata/blob/master/src/libnetdata/buffer/README.md) is used that is automatically adjusted to fit the entire file contents of the file. So the file is read with a single `read()` call (providing atomicity / consistency when the data are read from the kernel). Once the data are read, 2 arrays of pointers are updated: - a `words` array, pointing to each word in the data read - a `lines` array, pointing to the first word for each line This is highly optimized. Both arrays are automatically adjusted to fit all contents and are updated in a single pass on the data. The library provides a number of macros: - `procfile_lines()` returns the # of lines read - `procfile_linewords()` returns the # of words in the given line - `procfile_word()` returns a pointer the given word # - `procfile_line()` returns a pointer to the first word of the given line # - `procfile_lineword()` returns a pointer to the given word # of the given line # ### Cleanup When the caller exits: - calls `procfile_free()` to close the file and free all memory used. ### Performance - a **raspberry Pi 1** (the oldest single core one) can process 5.000+ `/proc` files per second. - a **J1900 Celeron** processor can process 23.000+ `/proc` files per second per core. To achieve this kind of performance, the library tries to work in batches so that the code and the data are inside the processor's caches. This library is extensively used in Netdata and its plugins.