.\" .\" Copyright (c) 2020-2024 Jim Warner .\" Copyright (c) 2020-2024 Craig Small .\" .\" This manual is free software; you can redistribute it and/or .\" modify it under the terms of the GNU Lesser General Public .\" License as published by the Free Software Foundation; either .\" version 2.1 of the License, or (at your option) any later version. .\" .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH PROCPS_MISC 3 2024\-07\-06 procps\-ng .\" Please adjust this date whenever revising the manpage. .\" .nh .SH NAMN procps_misc — API för diverse information i filsystemet /proc .SH SYNOPSIS .nf \fB#include \fP .PP Plattformsegenskaper .RS 4 .PP long \fBprocps_cpu_count\fP (void); long \fBprocps_hertz_get\fP (void); unsigned int \fBprocps_pid_length\fP (void); int \fBprocps_linux_version\fP (void); .RE .PP Körtidsegenskaper .PP .RS 4 int \fB procps_container_uptime\fP (double *\fIuppetid_s\fP); int \fB procps_loadavg\fP (double *\fIgs1\fP, double *\fIgs5\fP, double *\fIgs15\fP); int \fB procps_uptime\fP (double *\fIuppetid_s\fP, double *\fIinaktiv_s\fP); int \fB procps_uptime_snprint\fP ( char *restrict \fIstr\fP, size_t \fIstorlek\fP, double \fIuppetid_s\fP, const int \fIsnyggt\fP); char *\fBprocps_uptime_sprint\fP (void); char *\fBprocps_uptime_sprint_short\fP (void); int \fBprocps_users\fP (void); .RE .PP Namnrymdsegenskaper .PP .RS 4 int \fB procps_ns_get_id\fP (const char *\fInamn\fP); const char\fB *procps_ns_get_name\fP (int \fIid\fP); int \fB procps_ns_read_pid\fP (int \fIpid\fP, struct procps_ns *\fInrd\fP); .RE .PP Masknamnsuppslagning .PP .RS 4 int \fBprocps_sigmask_names\fP (char *const \fIstr\fP, size_t \fIstorlek\fP , const char *\fIsigmask\fP); int \fBprocps_capmask_names\fP (char *const \fIstr\fP, size_t \fIstorlek\fP, const char *\fIfmgmask\fP); .RE .PP .P Länka med \fI\-lproc2\fP. .SH BESKRIVNING \fBprocps_cpu_count\fP() returnerar antalet CPU:er som för närvarande är inkopplade liksom \fBsysconf(\fP\fI_SC_NPROCESSORS_ONLY\fP\fB)\fP eller ett antaget \fI1\fP. .P \fBprocps_hertz_get\fP() returnerar antalet klocktick per sekund liksom \fBsysconf(\fP\fI_SC_CLK_TCK\fP\fB)\fP eller ett antaget \fI100\fP. Att dividera tick med detta värder ger sekunder. .P \fBprocps_pid_length\fP() returnerar den maximala stränglängden för en PID på systemet. Till exempel, om det största möjliga värdet på en PID var 123, då skulle längden vara 3. Om filen \fI/proc/sys/kernel/pid_max\fP är oläsbar antas värdet vara \fI5\fP. .P \fBprocps_linux_version\fP() returnerar den aktuella Linuxversionen som ett kodat heltal. På ett icke\-Linuxsystem som har ett emulerat proc\-filsystem returnerar denna funktionen versionen på Linuxemuleringen istället. Versionen består av tre positiva heltal som representerar nivåerna större, mindre och fix. Följande makron finns för att koda en given Linuxversion eller att separera ut komponenterna av den aktuella versionen. .RS 4 .PP LINUX_VERSION(\ större\ ,\ mindre\ ,\ fix\ ) .PP LINUX_VERSION_MAJOR(\ ver\ ) .PP LINUX_VERSION_MINOR(\ ver\ ) .PP LINUX_VERSION_PATCH(\ ver\ ) .RE .P \fBprocps_loadavg\fP() hämtar genomsnittlig systemlast och lägger genomsnitten över 1, 5 och 15 minuter i platserna som anges av de pekare som inte är \fINULL\fP. .P \fBprocps_container_uptime\fP() returnerar en behållares uppetid i platsen som anges av pekaren om den inte är \fINULL\fP. Detta avgörs för närvarande av den förlupna tiden för PID 1, vilket skulle kunna ges med kommandot: .PP .in +4n .EX $ \fBps \-o etimes 1\fP FÖRLUP. 12345 .EE .in .PP Begreppet inaktiv tid finns inte i en behållare så \fBprocps_container_uptime\fP har inte den parametern. .P \fBprocps_uptime\fP() returnerar uppetiden och eller inaktiva sekunder i platserna som anges av de pekare som inte är \fINULL\fP. Varianterna \fBsprint\fP returnerar en mänskligt läsbar sträng på en av två former. .RS 4 .PP HH:MM:SS up HH:MM, # users, load average: 1, 5, 15 MM averages .PP up HH, MM .RE .P \fBprocps_uptime_snprint\fP() använder den givna bufferten \fIstr\fP med längden \fIstorlek\fP för att fylla i upptidssträngen istället för en statiskt allokerad buffert. Funktionen behöver värdet \fIuppetid_s\fP, som kan fås från \fBprocps_uptime\fP() eller \fBprocps_container_uptime\fP() och flaggan \fIsnyggt\fP avgör ifall utdata är standard eller snyggt/kort. .P \fBprocps_users\fP() returnerar antalet användare på systemet. Detta värde kommer från \fBsd_get_sessions\fP(3) och räknar användarsessionerna, klasserna user\-early och user\-incomplete eller uppräkningen via \fBgetutent\fP(3). .P \fBprocps_ns_get_id\fP() returnerar heltals\-id:t (enum namespace_type) för namnrymden för den angivna namnrymden \fInamn\fP. .P \fBprocps_ns_get_name\fP() returnerar namnet på namnrymden för det angivna \fIid:t\fP (enum namespace_type). .P \fBprocps_ns_read_pid\fP() returnerar inoderna för namnrymderna för den angivna processen procps_ns\-posten som pekas ut av \fInrp\fP. Dessa inoder kommer komma i den ordning som föreskrivs av enum namespace_type. .PP .RS 4 .nf enum namespace_type { PROCPS_NS_CGROUP, PROCPS_NS_IPC, PROCPS_NS_MNT, PROCPS_NS_NET, PROCPS_NS_PID, PROCPS_NS_TIME, PROCPS_NS_USER, PROCPS_NS_UTS }; .fi .RE .P \fBprocps_sigmask_names\fP() fyller \fIstr\fP med en mänskligt läsbar textsträng av upp till \fIstorlek\fP byte med signalerna satta i den hexadecimala signalmasken \fIsigmask\fP, se \fBsignal\fP(7). Om listan av signaler överskrider \fIstorlek\fP byte kommer strängen huggas av och sluta med ett ”+”. Det åligger det anropande programmet att se till att \fIstr\fP är korrekt allokerad med åtnimstone \fIstorlek\fP byte. .P \fBprocps_capmask_names\fP() fyller \fIstr\fP med en mänskligt läsbar textsträng av upp till \fIstorlek\fP byte med förmågorna som är satta i den hexadecimala förmågemasken \fIfmgmask\fP, se \fBcapabilities\fP(7). Om listan av förmågor överskrider \fIstorlek\fP byte kommer strängen huggas av och sluta med ett ”+”. Det åligger det anropande programmet att se till att \fIstr\fP är korrekt allokerad med åtnimstone \fIstårlek\fP byte. .P För en process som inte har några förmågor eller alla förmågor kommer strängern vara ”\-” respektive ”full”. .SH RETURVÄRDE .SS "Funktioner som returnerar en \[rq]int\[rq] eller \[rq]long\[rq]" Ett fel kommer indikera ett negativt tal som alltid är inversen av något känt värde från errno.h. .SS "Funktioner som returnerar en \[rq]adress\[rq]" Ett fel kommer indikeras av en NULL\-returpekare och orsaken går att hitta i dett formella errno\-värdet. .SH FILER .TP \fI/proc/loadavg\fP De råa värdena för lastgenomsnitt. .TP \fI/proc/sys/kernel/osrelease\fP Innehåller utgåveversionen för Linuxkärnan eller proc\-filsystemet. .TP \fI/proc/sys/kernel/pid_max\fP Innehåller värdet vid vilket PID:ar slår runt, ett större än det maximala PID\-värdet. .TP \fI/proc/uptime\fP De råa värdena för systemets uppetid och inaktiv tid. .TP \fI/proc/\fPPID\fI/ns\fP innehåller uppsättningen av namnrymder för en viss \fIPID\fP. .SH "SE ÄVEN" \fBprocps\fP(3), \fBprocps_pids\fP(3), \fBgetutent\fP(3), \fBsd_get_sessions\fP(3), \fBproc\fP(5), \fBcapabilities\fP(7), \fBsignal\fP(7).