...
Eroare Securitate cibernetică · Hash-uri, semnături și criptare cu GPG

gpg: signing failed: Inappropriate ioctl for device

Pe scurt

gpg trebuie să-ți ceară parola cheii, dar programul pinentry nu știe în ce terminal să afișeze întrebarea. Adaugă export GPG_TTY=$(tty) în ~/.bashrc, deschide un terminal nou (sau rulează source ~/.bashrc) și semnează din nou.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Când semnezi sau decriptezi cu o cheie protejată de parolă, gpg nu citește el parola: o cere prin gpg-agent, care pornește un program separat, pinentry. Într-un terminal fără interfață grafică (SSH, WSL, un container), pinentry trebuie să știe pe ce terminal să deseneze caseta de parolă. Îl află din variabila GPG_TTY. Dacă variabila lipsește, apelul de sistem prin care pinentry încearcă să controleze terminalul (ioctl) eșuează, iar gpg raportează Inappropriate ioctl for device.

Mesajul apare cel mai des la git commit -S sau cu commit.gpgsign = true, unde vezi și error: gpg failed to sign the data, la gpg --clearsign și la gpg --decrypt prin SSH. Rezolvarea standard, din documentația GnuPG, este export GPG_TTY=$(tty) în fișierul de pornire al shell-ului.

De ce apare: cauzele frecvente

1GPG_TTY nu este setată

Greșit
BASH
git commit -S -m 'release 2.1'
# error: gpg failed to sign the data
Corect
BASH
echo 'export GPG_TTY=$(tty)' >> ~/.bashrc
source ~/.bashrc
git commit -S -m 'release 2.1'

Cu GPG_TTY setată, pinentry știe pe ce terminal să afișeze cererea de parolă, iar semnarea poate continua.

2Agentul a rămas cu terminalul vechi

Greșit
BASH
# te-ai reconectat prin SSH, agentul pornit în sesiunea veche
Corect
BASH
gpg-connect-agent updatestartuptty /bye

gpg-agent ține minte terminalul în care a pornit. updatestartuptty îi spune să folosească terminalul curent.

3Semnare într-un script fără terminal

Greșit
BASH
# cron: gpg --clearsign raport.txt
Corect
BASH
# cheie dedicată fără parolă, păstrată cu drepturi minime
# sau gpg --batch --pinentry-mode loopback --passphrase-file /root/.parola-semnare --clearsign raport.txt

Fără terminal, pinentry nu are unde să întrebe. Automatizările folosesc mod non-interactiv explicit, cu parola citită dintr-un fișier protejat.

Repară tu

Repară eroarea, direct în pagină

La git commit -S, semnarea eșuează cu gpg: signing failed: Inappropriate ioctl for device și error: gpg failed to sign the data, pentru că pinentry nu știe în ce terminal să ceară parola cheii. Adaugă în ~/.bashrc linia care setează și exportă variabila GPG_TTY cu terminalul curent, fără să ștergi nimic din fișier.

Indiciu

Linia este export GPG_TTY=$(tty); pune-o între ghilimele simple când o adaugi cu echo, ca $(tty) să nu se execute acum.

Alte forme ale mesajului

  • error: gpg failed to sign the data fatal: failed to write commit object
  • gpg: signing failed: No pinentry
  • gpg: decryption failed: Inappropriate ioctl for device
  • gpg: problem with the agent: Inappropriate ioctl for device

Cum o eviți pe viitor

  • Pune export GPG_TTY=$(tty) în ~/.bashrc (sau ~/.zshrc) pe orice calculator unde semnezi din terminal.
  • După ce te reconectezi prin SSH, rulează gpg-connect-agent updatestartuptty /bye dacă agentul era deja pornit.
  • Testează semnarea separat de git, cu echo test | gpg --clearsign, ca să vezi mesajul real al lui gpg.
  • Pentru automatizări, folosește o cheie dedicată și modul --batch, nu cheia ta personală.

Întrebări frecvente

De ce $(tty) și nu calea terminalului scrisă direct?

Pentru că fiecare terminal nou are alt dispozitiv (/dev/pts/0, /dev/pts/3...). $(tty) se calculează la pornirea fiecărui shell și dă terminalul curent.

Pe macOS am aceeași eroare. Merge la fel?

Da, export GPG_TTY=$(tty) în ~/.zshrc rezolvă cazul de terminal. Pentru o fereastră grafică de parolă, instalează pinentry-mac și setează-l în ~/.gnupg/gpg-agent.conf.

Erori înrudite

← Toate erorile Securitate cibernetică

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață Securitate cibernetică de la zero, cu exerciții la fiecare lecție

Curs Cybersecurity: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.