timer_settime(2) System Calls Manual timer_settime(2) NAVN timer_settime, timer_gettime - bevaebne og afvaebne samt hente tilstand for POSIX per proces-stopur BIBLIOTEK Real-time library (librt, -lrt) SYNOPSIS #include int timer_gettime(timer_t timerid, struct itimerspec *nuv_vaerdi); int timer_settime(timer_t timerid, int flag, const struct itimerspec *restrict ny_vaerdi, struct itimerspec *_Nullable restrict gl_vaerdi); Feature Test Macro Requirements for glibc (se feature_test_macros(7)): timer_settime(), timer_gettime(): _POSIX_C_SOURCE >= 199309L BESKRIVELSE timer_settime() bevaebner eller afvaebner stopuret identificeret af timerid. Argumentet ny_vaerdi er en peger pa en itimerspec-struktur der specificerer den nye oprindelige vaerdi og det nye interval for stopuret. Strukturen itimerspec er beskrevet i itimerspec(3type). Hver af understrukturerne for strukturen itimerspec er en timespec(3)-struktur, der gor det muligt for en tidsvaerdi at blive angivet i sekunder og nanosekunder. Disse tidsvaerdier males jaevnfor uret, der blev angivet, da stopuret blev oprettet af timer_create(2). Hvis ny_vaerdi->it_value specificerer en vaerdi forskellig fra nul (dvs. intet underfelt er forskellig fra nul), sa bevaebner (starter) timer_settime() stopuret, saetter det til det oprindelig udlob pa det givne tidspunkt. (Hvis stopuret allerede var bevaebnet, sa bliver de tidligere indstillinger overskrevet). Hvis ny_vaerdi->it_value specificerer en nul-vaerdi (dvs. begge underfelter er nul), sa afvaebnes stopuret. Feltet ny_vaerdi->it_interval specificerer perioden for stopuret, i sekunder og nanosekunder. Hvis dette felt er forskellig fra nul, sa genindlaeses stopuret hver gang et bevaebnet stopur udlober, fra vaerdien specificeret i ny_vaerdi->it_interval. Hvis ny_vaerdi->it_interval specificerer en nul-vaerdi, sa udlober stopuret bare en gang, pa tidspunktet specificeret af it_value. Som standard fortolkes den oprindelige udlobstid angivet i ny_vaerdi->it_value relativt til det nuvaerende tidspunkt pa stopuret pa tidspunktet for kaldet. Dette kan aendres ved at angive TIMER_ABSTIME i flag, hvormed ny_vaerdi->it_value fortolkes som en absolut vaerdi som malt pa stopuret; det vil sige, at stopuret vil udlose nar urvaerdien nar vaerdien angivet af ny_vaerdi->it_value. Hvis den angivne absolutte tid allerede er forlobet, sa udlober stopuret ojeblikkeligt og overlobsantallet (se timer_getoverrun(2)) vil blive angivet korrekt. Hvis vaerdien for uret CLOCK_REALTIME justeres mens et absolut stopur baeret pa det ur bevaebnes sa vil udlobet for stopuret blive justeret pa passende vis. Justeringer til uret CLOCK_REALTIME har ingen effekt pa relative stopure baseret pa det ur. If gl_vaerdi ikke er NULL, sa peger den pa et mellemlager, der bruges til at returnere det tidligere interval for stopuret (i gl_vaerdi->it_interval) og maengden af tid indtil stopuret tidligere ville have udlobet (i gl_vaerdi->it_value). timer_gettime() returnerer tidspunktet indtil naeste udlob, og intervallet for stopuret angivet af timerid, i mellemlageret pegende pa af nuv_vaerdi. Tiden tilbage indtil det naeste stopur udlober returneres i nuv_vaerdi->it_value; dette er altid en relativ vaerdi, uanset om flaget TIMER_ABSTIME blev brugt under bevaebning af stopuret. Hvis vaerdien returneret i nuv_vaerdi->it_value er nul, sa afvaebnes stopuret i ojeblikket. Stopursintervallet returneres i nuv_vaerdi->it_interval. Hvis vaerdien returneret i nuv_vaerdi->it_interval er nul, sa er dette et >>et skuds<< stopur. RETURVAERDI Ved succes returnerer timer_settime() og timer_gettime() 0. Ved fejl returneres -1 og errno angives for at indikere fejlen. FEJL Disse funktioner kan fejl med de folgende fejl: EFAULT ny_vaerdi, gl_vaerdi eller nuv_vaerdi er ikke en gyldig peger. EINVAL timerid er ugyldig. timer_settime() kan fejle med de folgende fejl: EINVAL new_value.it_value er negativ; eller new_value.it_value.tv_nsec er negativ eller storre end 999.999.999. STANDARDER POSIX.1-2024. HISTORIK Linux 2.6. POSIX.1-2001. EKSEMPLER Se timer_create(2). SE OGSA timer_create(2), timer_getoverrun(2), timespec(3), time(7) OVERSAETTELSE Oversaettere af denne manual til dansk Joe Hansen Denne oversaettelse er gratis dokumentation; laes GNU General Public License version 3 eller nyere for ophavsretbetingelser. Der er INGEN ANSVAR. Hvis du stoder pa fejl i oversaettelsen af denne vejledning, skal du sende en besked til . Linux man-pages 6.17 29. oktober 2025 timer_settime(2)