...
Eroare Linux · Comenzi negăsite și programe lipsă

head: invalid number of lines: ‘app.log’

Pe scurt

După -n, head (sau tail) așteaptă un număr, dar a primit altceva. Cel mai des variabila cu numărul e goală, așa că -n „înghite” numele fișierului: head -n $N app.log devine head -n app.log. Dă o valoare implicită (${1:-10}) și pune variabila între ghilimele.

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

Ce înseamnă

head -n NUMĂR fișier afișează primele NUMĂR linii. Ce urmează imediat după -n e citit ca număr, orice ar fi. Mesajul invalid number of lines: ‘app.log’ îți spune exact ce a primit head în locul numărului.

Dacă între ghilimele apare numele fișierului, variabila folosită pentru număr a fost goală: head -n $N app.log cu N gol devine head -n app.log, iar head nu mai are nici număr, nici fișier. Dacă apare un text ca abc, 10x sau 5,5, valoarea nu e un întreg. Același mesaj îl dă și tail, iar pentru -c mesajul e invalid number of bytes.

În scripturi, primul pas e echo "N=[$N]" chiar înainte de head, ca să vezi ce conține variabila.

De ce apare: cauzele frecvente

1Argumentul scriptului lipsește

Greșit
BASH
N=$1
head -n $N app.log
Corect
BASH
N=${1:-3}
head -n "$N" app.log

Fără argument, $1 e gol și dispare din comandă. ${1:-3} pune 3 când lipsește.

2Număr scris cu text

Greșit
BASH
head -n 10linii app.log
Corect
BASH
head -n 10 app.log

head acceptă doar un întreg (și sufixe ca K sau M), nu text liber.

3Valoare citită cu \r din Windows

Greșit
BASH
N=$(cat numar.txt)   # "5\r"
head -n "$N" app.log
Corect
BASH
N=$(tr -d '\r' < numar.txt)
head -n "$N" app.log

Un fișier salvat în Windows are \r la final, iar 5\r nu e un număr valid.

Repară tu

Repară eroarea, direct în pagină

Scriptul primele.sh afișează primele N linii din app.log, unde N e primul argument. Rulat fără argument, bash primele.sh dă head: invalid number of lines: ‘app.log’. Repară-l, ca fără argument să afișeze primele 3 linii, iar bash primele.sh 2 să afișeze primele 2.

Indiciu

Când lipsește argumentul, $1 e gol; dă-i o valoare implicită.

Alte forme ale mesajului

  • head: invalid number of lines: ‘abc’
  • tail: invalid number of lines: ‘x’
  • head: invalid number of bytes: ‘abc’
  • head: illegal line count -- app.log
  • tail: illegal offset -- abc

Cum o eviți pe viitor

  • Pune mereu variabilele între ghilimele: head -n "$N" fisier. O variabilă goală dă atunci un mesaj clar, nu înghite fișierul.
  • Dă valori implicite argumentelor: ${1:-10}.
  • Validează numărul în script: [[ $N =~ ^[0-9]+$ ]] || exit 1.
  • Curăță \r din fișierele venite din Windows.

Întrebări frecvente

De ce mesajul conține numele fișierului?

Pentru că variabila numărului a fost goală și a dispărut din comandă. Primul cuvânt de după -n a devenit numele fișierului, iar head a încercat să-l citească drept număr.

Ce face head -n -5?

Cu semnul minus, GNU head afișează tot fișierul în afară de ultimele 5 linii. E valid, nu dă eroare.

Erori înrudite

← Toate erorile Linux

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ță Linux de la zero, cu exerciții la fiecare lecție

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