gpg: signing failed: Inappropriate ioctl for device
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ă
git commit -S -m 'release 2.1'
# error: gpg failed to sign the dataecho '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
# te-ai reconectat prin SSH, agentul pornit în sesiunea vechegpg-connect-agent updatestartuptty /byegpg-agent ține minte terminalul în care a pornit. updatestartuptty îi spune să folosească terminalul curent.
3Semnare într-un script fără terminal
# cron: gpg --clearsign raport.txt# cheie dedicată fără parolă, păstrată cu drepturi minime
# sau gpg --batch --pinentry-mode loopback --passphrase-file /root/.parola-semnare --clearsign raport.txtFără terminal, pinentry nu are unde să întrebe. Automatizările folosesc mod non-interactiv explicit, cu parola citită dintr-un fișier protejat.
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.
Reparația
Adaugă linia la finalul fișierului (ghilimelele simple păstrează $(tty) neexecutat) și verifică:
echo 'export GPG_TTY=$(tty)' >> ~/.bashrc
tail -1 ~/.bashrcÎn terminalul tău rulezi apoi source ~/.bashrc și semnezi din nou.
De ce merge
pinentry află terminalul din variabila GPG_TTY. Fără ea, încercarea de a controla terminalul eșua, de aici Inappropriate ioctl for device. Linia din ~/.bashrc rulează la pornirea fiecărui shell interactiv: $(tty) dă dispozitivul terminalului curent, iar export face variabila vizibilă pentru gpg și gpg-agent. Ghilimelele simple de la echo fac ca în fișier să ajungă textul $(tty), nu terminalul de acum.
Alte forme ale mesajului
error: gpg failed to sign the data fatal: failed to write commit objectgpg: signing failed: No pinentrygpg: decryption failed: Inappropriate ioctl for devicegpg: 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 /byedacă 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
gpg: signing failed: No secret key Cheia cu care gpg trebuie să semneze (din git user.signingkey sau din -u) nu are partea privată pe acest calculator. Listează cheile private cu gpg --list-secret-keys --keyid-format=long și pune ID-ul corect în configurare. gpg: WARNING: unsafe permissions on homedir '/home/elev/.gnupg' Folderul ~/.gnupg, care conține cheile tale private, poate fi accesat și de alți utilizatori. Restrânge-l: chmod 700 ~/.gnupg și chmod 600 pentru fișierele din el (iar dacă proprietarul e root, chown -R pe utilizatorul tău). gpg: decryption failed: No secret key Fișierul a fost criptat pentru o cheie publică a cărei cheie privată nu se află în keyring-ul tău, deci nu-l poți decripta. Importă cheia privată potrivită pe calculator (gpg --import) sau cere ca fișierul să fie criptat și pentru cheia ta (--recipient tu@...). Î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.
