Admin: Skapade sidan med '= signal-safety(7) – Asynkront signal-säkra funktioner = == NAMN == signal-safety - asynkront signal-säkra funktioner == BESKRIVNING == En asynkront signal-säker funktion är en som säkert kan anropas från en signalhanterare. Många funktioner är inte asynkront signal-säkra. I synnerhet är icke-återinträdesbara funktioner generellt osäkra att anropa från en signalhanterare. De typer av problem som gör en funktion osäker kan snabbt förstås när man...'

2024-11-26T07:55:51Z

Skapade sidan med '= signal-safety(7) – Asynkront signal-säkra funktioner = == NAMN == signal-safety - asynkront signal-säkra funktioner == BESKRIVNING == En asynkront signal-säker funktion är en som säkert kan anropas från en signalhanterare. Många funktioner är inte asynkront signal-säkra. I synnerhet är icke-återinträdesbara funktioner generellt osäkra att anropa från en signalhanterare. De typer av problem som gör en funktion osäker kan snabbt förstås när man...'

Ny sida

= signal-safety(7) – Asynkront signal-säkra funktioner =

== NAMN ==

signal-safety - asynkront signal-säkra funktioner

== BESKRIVNING ==

En asynkront signal-säker funktion är en som säkert kan anropas från en signalhanterare. Många funktioner är inte asynkront signal-säkra. I synnerhet är icke-återinträdesbara funktioner generellt osäkra att anropa från en signalhanterare.

De typer av problem som gör en funktion osäker kan snabbt förstås när man betraktar implementeringen av stdio-biblioteket, vars alla funktioner inte är asynkront signal-säkra.

När man utför buffrad I/O på en fil måste stdio-funktionerna underhålla en statiskt allokerad databuffert tillsammans med associerade räknare och index (eller pekare) som registrerar mängden data och den aktuella positionen i bufferten. Antag att huvudprogrammet är mitt i ett anrop till en stdio-funktion som [[printf(3)]], där bufferten och associerade variabler har uppdaterats delvis. Om programmet i det ögonblicket avbryts av en signalhanterare som också anropar [[printf(3)]], kommer det andra anropet till [[printf(3)]] att arbeta på inkonsekventa data, med oförutsägbara resultat.

För att undvika problem med osäkra funktioner finns två möjliga val:

(a) Säkerställ att (1) signalhanteraren endast anropar asynkront signal-säkra funktioner, och (2) signalhanteraren själv är återinträdesbar med avseende på globala variabler i huvudprogrammet.

(b) Blockera signalleverans i huvudprogrammet när man anropar funktioner som är osäkra eller arbetar på globala data som också åtkomstas av signalhanteraren.

Generellt är det andra valet svårt i program av någon komplexitet, så det första valet föredras.

POSIX.1 specificerar en uppsättning funktioner som en implementering måste göra asynkront signal-säkra. (En implementering kan tillhandahålla säkra implementationer av ytterligare funktioner, men detta krävs inte av standarden och andra implementeringar kanske inte ger samma garantier.)

Generellt är en funktion asynkront signal-säker antingen för att den är återinträdesbar eller för att den är atomisk med avseende på signaler (dvs. dess exekvering kan inte avbrytas av en signalhanterare).

Uppsättningen av funktioner som enligt POSIX.1 krävs vara asynkront signal-säkra visas i följande tabell. Funktionerna som inte annars nämns krävdes vara asynkront signal-säkra i POSIX.1-2001; tabellen detaljerar förändringar i efterföljande standarder.

Funktion | Noteringar
-----------------------|-----------------------------
[[abort(3)]] | Tillagd i POSIX.1-2001 TC1
[[accept(2)]] |
[[access(2)]] |
[[aio_error(3)]] |
[[aio_return(3)]] |
[[aio_suspend(3)]] | Se noteringar nedan
[[alarm(2)]] |
[[bind(2)]] |
[[cfgetispeed(3)]] |
[[cfgetospeed(3)]] |
[[cfsetispeed(3)]] |
[[cfsetospeed(3)]] |
[[chdir(2)]] |
[[chmod(2)]] |
[[chown(2)]] |
[[clock_gettime(2)]] |
[[close(2)]] |
[[connect(2)]] |
[[creat(2)]] |
[[dup(2)]] |
[[dup2(2)]] |
[[execl(3)]] | Tillagd i POSIX.1-2008; se noteringar nedan
[[execle(3)]] | Se noteringar nedan
[[execv(3)]] | Tillagd i POSIX.1-2008
[[execve(2)]] |
[[\_exit(2)]] |
[[\_Exit(2)]] |
[[faccessat(2)]] | Tillagd i POSIX.1-2008
[[fchdir(2)]] | Tillagd i POSIX.1-2008 TC1
[[fchmod(2)]] |
[[fchmodat(2)]] | Tillagd i POSIX.1-2008
[[fchown(2)]] |
[[fchownat(2)]] | Tillagd i POSIX.1-2008
[[fcntl(2)]] |
[[fdatasync(2)]] |
[[fexecve(3)]] | Tillagd i POSIX.1-2008
[[ffs(3)]] | Tillagd i POSIX.1-2008 TC2
[[fork(2)]] | Se noteringar nedan
[[fstat(2)]] |
[[fstatat(2)]] | Tillagd i POSIX.1-2008
[[fsync(2)]] |
[[ftruncate(2)]] |
[[futimens(3)]] | Tillagd i POSIX.1-2008
[[getegid(2)]] |
[[geteuid(2)]] |
[[getgid(2)]] |
[[getgroups(2)]] |
[[getpeername(2)]] |
[[getpgrp(2)]] |
[[getpid(2)]] |
[[getppid(2)]] |
[[getsockname(2)]] |
[[getsockopt(2)]] |
[[getuid(2)]] |
[[htonl(3)]] | Tillagd i POSIX.1-2008 TC2
[[htons(3)]] | Tillagd i POSIX.1-2008 TC2
[[kill(2)]] |
[[link(2)]] |
[[linkat(2)]] | Tillagd i POSIX.1-2008
[[listen(2)]] |
[[longjmp(3)]] | Tillagd i POSIX.1-2008 TC2; se noteringar nedan
[[lseek(2)]] |
[[lstat(2)]] |
[[memccpy(3)]] | Tillagd i POSIX.1-2008 TC2
[[memchr(3)]] | Tillagd i POSIX.1-2008 TC2
[[memcmp(3)]] | Tillagd i POSIX.1-2008 TC2
[[memcpy(3)]] | Tillagd i POSIX.1-2008 TC2
[[memmove(3)]] | Tillagd i POSIX.1-2008 TC2
[[memset(3)]] | Tillagd i POSIX.1-2008 TC2
[[mkdir(2)]] |
[[mkdirat(2)]] | Tillagd i POSIX.1-2008
[[mkfifo(3)]] |
[[mkfifoat(3)]] | Tillagd i POSIX.1-2008
[[mknod(2)]] | Tillagd i POSIX.1-2008
[[mknodat(2)]] | Tillagd i POSIX.1-2008
[[ntohl(3)]] | Tillagd i POSIX.1-2008 TC2
[[ntohs(3)]] | Tillagd i POSIX.1-2008 TC2
[[open(2)]] |
[[openat(2)]] | Tillagd i POSIX.1-2008
[[pause(2)]] |
[[pipe(2)]] |
[[poll(2)]] |
[[posix_trace_event(3)]]|
[[pselect(2)]] |
[[pthread_kill(3)]] | Tillagd i POSIX.1-2008 TC1
[[pthread_self(3)]] | Tillagd i POSIX.1-2008 TC1
[[pthread_sigmask(3)]] | Tillagd i POSIX.1-2008 TC1
[[raise(3)]] |
[[read(2)]] |
[[readlink(2)]] |
[[readlinkat(2)]] | Tillagd i POSIX.1-2008
[[recv(2)]] |
[[recvfrom(2)]] |
[[recvmsg(2)]] |
[[rename(2)]] |
[[renameat(2)]] | Tillagd i POSIX.1-2008
[[rmdir(2)]] |
[[select(2)]] |
[[sem_post(3)]] |
[[send(2)]] |
[[sendmsg(2)]] |
[[sendto(2)]] |
[[setgid(2)]] |
[[setpgid(2)]] |
[[setsid(2)]] |
[[setsockopt(2)]] |
[[setuid(2)]] |
[[shutdown(2)]] |
[[sigaction(2)]] |
[[sigaddset(3)]] |
[[sigdelset(3)]] |
[[sigemptyset(3)]] |
[[sigfillset(3)]] |
[[sigismember(3)]] |
[[siglongjmp(3)]] | Tillagd i POSIX.1-2008 TC2; se noteringar nedan
[[signal(2)]] |
[[sigpause(3)]] |
[[sigpending(2)]] |
[[sigprocmask(2)]] |
[[sigqueue(2)]] |
[[sigset(3)]] |
[[sigsuspend(2)]] |
[[sleep(3)]] |
[[sockatmark(3)]] | Tillagd i POSIX.1-2001 TC2
[[socket(2)]] |
[[socketpair(2)]] |
[[stat(2)]] |
[[stpcpy(3)]] | Tillagd i POSIX.1-2008 TC2
[[stpncpy(3)]] | Tillagd i POSIX.1-2008 TC2
[[strcat(3)]] | Tillagd i POSIX.1-2008 TC2
[[strchr(3)]] | Tillagd i POSIX.1-2008 TC2
[[strcmp(3)]] | Tillagd i POSIX.1-2008 TC2
[[strcpy(3)]] | Tillagd i POSIX.1-2008 TC2
[[strcspn(3)]] | Tillagd i POSIX.1-2008 TC2
[[strlen(3)]] | Tillagd i POSIX.1-2008 TC2
[[strncat(3)]] | Tillagd i POSIX.1-2008 TC2
[[strncmp(3)]] | Tillagd i POSIX.1-2008 TC2
[[strncpy(3)]] | Tillagd i POSIX.1-2008 TC2
[[strnlen(3)]] | Tillagd i POSIX.1-2008 TC2
[[strpbrk(3)]] | Tillagd i POSIX.1-2008 TC2
[[strrchr(3)]] | Tillagd i POSIX.1-2008 TC2
[[strspn(3)]] | Tillagd i POSIX.1-2008 TC2
[[strstr(3)]] | Tillagd i POSIX.1-2008 TC2
[[strtok_r(3)]] | Tillagd i POSIX.1-2008 TC2
[[symlink(2)]] |
[[symlinkat(2)]] | Tillagd i POSIX.1-2008
[[tcdrain(3)]] |
[[tcflow(3)]] |
[[tcflush(3)]] |
[[tcgetattr(3)]] |
[[tcgetpgrp(3)]] |
[[tcsendbreak(3)]] |
[[tcsetattr(3)]] |
[[tcsetpgrp(3)]] |
[[time(2)]] |
[[timer_getoverrun(2)]]|
[[timer_gettime(2)]] |
[[timer_settime(2)]] |
[[times(2)]] |
[[umask(2)]] |
[[uname(2)]] |
[[unlink(2)]] |
[[unlinkat(2)]] | Tillagd i POSIX.1-2008
[[utime(2)]] |
[[utimensat(2)]] | Tillagd i POSIX.1-2008
[[utimes(2)]] | Tillagd i POSIX.1-2008
[[wait(2)]] |
[[waitpid(2)]] |
[[wcpcpy(3)]] | Tillagd i POSIX.1-2008 TC2
[[wcpncpy(3)]] | Tillagd i POSIX.1-2008 TC2
[[wcscat(3)]] | Tillagd i POSIX.1-2008 TC2
[[wcschr(3)]] | Tillagd i POSIX.1-2008 TC2
[[wcscmp(3)]] | Tillagd i POSIX.1-2008 TC2
[[wcscpy(3)]] | Tillagd i POSIX.1-2008 TC2
[[wcscspn(3)]] | Tillagd i POSIX.1-2008 TC2
[[wcslen(3)]] | Tillagd i POSIX.1-2008 TC2
[[wcsncat(3)]] | Tillagd i POSIX.1-2008 TC2
[[wcsncmp(3)]] | Tillagd i POSIX.1-2008 TC2
[[wcsncpy(3)]] | Tillagd i POSIX.1-2008 TC2
[[wcsnlen(3)]] | Tillagd i POSIX.1-2008 TC2
[[wcspbrk(3)]] | Tillagd i POSIX.1-2008 TC2
[[wcsrchr(3)]] | Tillagd i POSIX.1-2008 TC2
[[wcsspn(3)]] | Tillagd i POSIX.1-2008 TC2
[[wcsstr(3)]] | Tillagd i POSIX.1-2008 TC2
[[wcstok(3)]] | Tillagd i POSIX.1-2008 TC2
[[wmemchr(3)]] | Tillagd i POSIX.1-2008 TC2
[[wmemcmp(3)]] | Tillagd i POSIX.1-2008 TC2
[[wmemcpy(3)]] | Tillagd i POSIX.1-2008 TC2
[[wmemmove(3)]] | Tillagd i POSIX.1-2008 TC2
[[wmemset(3)]] | Tillagd i POSIX.1-2008 TC2
[[write(2)]] |

**Noteringar:**

- POSIX.1-2001 och POSIX.1-2001 TC2 krävde att funktionerna [[fpathconf(3)]], [[pathconf(3)]] och [[sysconf(3)]] skulle vara asynkront signal-säkra, men detta krav togs bort i POSIX.1-2008.

- Om en signalhanterare avbryter exekveringen av en osäker funktion, och hanteraren terminerar via ett anrop till [[longjmp(3)]] eller [[siglongjmp(3)]] och programmet därefter anropar en osäker funktion, är programmets beteende odefinierat.

- POSIX.1-2001 TC1 klargjorde att om en applikation anropar [[fork(2)]] från en signalhanterare och någon av de fork-hanterare som registrerats av [[pthread_atfork(3)]] anropar en funktion som inte är asynkront signal-säker, är beteendet odefinierat. En framtida revision av standarden kommer sannolikt att ta bort [[fork(2)]] från listan över asynkront signal-säkra funktioner.

- Asynkrona signalhanterare som anropar funktioner som är avbrottspunkter och nestas över regioner med uppskjuten avbrottshantering kan utlösa avbrott vars beteende är som om asynkront avbrott hade inträffat och kan orsaka att applikationens tillstånd blir inkonsekvent.

=== errno ===

Att hämta och ställa in värdet av `errno` är asynkront signal-säkert förutsatt att signalhanteraren sparar `errno` vid inträde och återställer dess värde innan den återvänder.

=== Avvikelser i GNU C-biblioteket ===

Följande kända avvikelser från standarden förekommer i GNU C-biblioteket:

- Före glibc 2.24 använde [[execl(3)]] och [[execle(3)]] internt [[realloc(3)]], och var därför inte asynkront signal-säkra. Detta åtgärdades i glibc 2.24.

- Glibc-implementeringen av [[aio_suspend(3)]] är inte asynkront signal-säker eftersom den använder [[pthread_mutex_lock(3)]] internt.

== SEE ALSO ==

[[sigaction(2)]], [[signal(7)]], [[standards(7)]]

== COLOFON ==

Denna sida är en del av man-sidorna (Linux-kärnans och C-bibliotekets användarutrymmesgränssnitts-dokumentation) projekt. Information om projektet finns på ⟨https://www.kernel.org/doc/man-pages/⟩. Om du har en felrapport för denna man-sida, se ⟨https://git.kernel.org/pub/scm/docs/man-pages/man-pages.git/tree/CONTRIBUTING⟩. Denna sida erhölls från tarballen `man-pages-6.9.1.tar.gz` hämtad från ⟨https://mirrors.edge.kernel.org/pub/linux/docs/man-pages/⟩ den 2024-06-26. Om du upptäcker några återgivningsproblem i denna HTML-version av sidan, eller om du tror att det finns en bättre eller mer uppdaterad källa för sidan, eller om du har korrigeringar eller förbättringar av informationen i denna COLOFON (som inte är en del av den ursprungliga man-sidan), skicka ett mail till man-pages@man7.org

Linux man-sidor 6.9.1 2024-05-02 signal-safety(7)

== Sidor som hänvisar till denna sida ==

[[fork(2)]], [[sigaction(2)]], [[signal(2)]], [[pthread_atfork(3)]], [[sd_journal_get_fd(3)]], [[sd_journal_print(3)]], [[sd_journal_stream_fd(3)]], [[seccomp_load(3)]], [[seccomp_precompute(3)]], [[sem_post(3)]], [[setjmp(3)]], [[strerror(3)]], [[attributes(7)]], [[signal(7)]]

= Sidslut =

Orginalhemsidan på Engelska :https://man7.org/linux/man-pages/man7/capabilities.7.html
<HR>
Det här är en maskinöversättning av Linux man sidor till svenska. Om du hittar fel är vi tacksamma om du rapporterar dem via formuläret som finns på
https://www.linux.se/kontaka-linux-se/
<BR><BR>Tack till [https://datorhjalp.se Datorhjälp] som har sponsrat [https://www.linux.se Linux.se] med webbhotell.

[[Kategori:Övrig Informationsmanual]]
[[Kategori:Linuxmanual]]

signal-safety(7) - Versionshistorik