tee(1p)
PROLOG
Denna manualsida är en del av POSIX Programmer's Manual. Linux-implementationen av detta gränssnitt kan skilja sig åt. Se motsvarande Linux-manualsida för detaljer om Linux-beteende, eller observera att gränssnittet kanske inte är implementerat på Linux.
NAMN
tee — duplicera standardindata
SYNOPSIS
tee [-ai] [file...]
BESKRIVNING
Verktyget tee ska kopiera standardindata till standardutdata och samtidigt göra en kopia i noll eller flera filer. Verktyget tee ska inte buffra utdata.
Om optionen -a inte anges ska utdatafiler skrivas, se avsnittet om filläsning, skrivning och skapande i POSIX.
OPTIONER
Verktyget tee ska följa POSIX.1-2017, Base Definitions, avsnitt 12.2, Utility Syntax Guidelines.
Följande optioner ska stödjas:
-a
- Lägg till utdata i filerna i stället för att skriva över dem.
-i
- Ignorera signalen SIGINT.
OPERANDER
Följande operander ska stödjas:
file
- Sökväg till en utdatafil. Om en file-operand är - ska den hänvisa till en fil med namnet -. Implementationer ska inte behandla den som standardutdata. Stöd ska finnas för behandling av minst 13 file-operander.
STANDARDINDATA
Standardindata kan vara av valfri typ.
INDATAFILER
Inga.
MILJÖVARIABLER
Följande miljövariabler ska påverka körningen av tee:
LANG
- Anger ett standardvärde för internationaliseringsvariabler som är odefinierade eller tomma. Se POSIX.1-2017, Base Definitions, avsnitt 8.2, Internationalization Variables, för ordningen mellan internationaliseringsvariabler.
LC_ALL
- Om den är satt till ett icke-tomt strängvärde åsidosätter den värdena för alla andra internationaliseringsvariabler.
LC_CTYPE
- Bestämmer lokalinställningen för tolkning av byteföljder som tecken, till exempel enkelbyte- eller flerbytetecken i argument.
LC_MESSAGES
- Bestämmer vilken lokalinställning som ska användas för format och innehåll i diagnostiska meddelanden som skrivs till standardfel.
NLSPATH
- Bestämmer platsen för meddelandekataloger som används vid behandling av LC_MESSAGES.
ASYNKRONA HÄNDELSER
Standardbeteende, förutom att om optionen -i har angetts ska SIGINT ignoreras.
STANDARDUTDATA
Standardutdata ska vara en kopia av standardindata.
STANDARDFEL
Standardfel ska endast användas för diagnostiska meddelanden.
UTDATAFILER
Om några file-operander anges ska standardindata kopieras till varje namngiven fil.
UTÖKAD BESKRIVNING
Ingen.
AVSLUTNINGSSTATUS
Följande avslutningsvärden ska returneras:
0
- Standardindata kopierades korrekt till alla utdatafiler.
>0
- Ett fel inträffade.
FÖLJDER AV FEL
Om skrivning till någon korrekt öppnad file-operand misslyckas ska skrivning till andra korrekt öppnade file-operander och standardutdata fortsätta, men avslutningsstatusen ska vara skild från noll.
I övrigt gäller standardåtgärderna som anges i POSIX.1-2017, avsnitt 1.4, Utility Description Defaults.
Följande avsnitt är informativa.
ANVÄNDNING I PROGRAM
Verktyget tee används vanligen i en rörledning för att skapa en kopia av utdata från något annat verktyg.
Operandet file är tekniskt sett valfritt, men tee är inte mer användbart än cat när ingen fil anges.
EXEMPEL
Spara en osorterad mellanform av data i en rörledning:
... | tee unsorted | sort > sorted
Detta skickar data vidare till sort, men sparar samtidigt en kopia i filen unsorted.
MOTIVERING
Kravet på buffring innebär att tee inte får använda ISO C-standardens helt buffrade eller radbuffrade skrivningar. Det betyder inte att tee måste göra enbyte-läsningar följda av enbyte-skrivningar.
Det bör noteras att tidiga versioner av BSD ignorerar ogiltiga optioner och accepterar ett ensamt - som alternativ till -i. De skriver också ut ett meddelande om en fil inte kan öppnas:
tee: cannot access %s\n
där %s ersätts av sökvägen.
Historiska implementationer ignorerar skrivfel. Detta är uttryckligen inte tillåtet enligt denna del av POSIX.1-2017.
Vissa historiska implementationer använder O_APPEND när tilläggsläge används. Andra använder funktionen lseek() för att flytta filpositionen till filslutet efter att filen öppnats utan O_APPEND. Denna del av POSIX.1-2017 kräver funktionalitet som motsvarar användning av O_APPEND; se POSIX-avsnittet om filläsning, skrivning och skapande.
FRAMTIDA RIKTNINGAR
Inga.
SE ÄVEN
Se även POSIX.1-2017, Base Definitions:
- Kapitel 8, Environment Variables
- Avsnitt 12.2, Utility Syntax Guidelines
Samt POSIX.1-2017, System Interfaces:
COPYRIGHT
Delar av denna text är återgivna och reproducerade i elektronisk form från IEEE Std 1003.1-2017, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 7, 2018 Edition.
Copyright © 2018 Institute of Electrical and Electronics Engineers, Inc. och The Open Group.
Vid skillnader mellan denna version och den ursprungliga IEEE- och The Open Group-standarden är den ursprungliga standarden det avgörande dokumentet. Den ursprungliga standarden kan hämtas online från:
http://www.opengroup.org/unix/online.html
Typografiska fel eller formateringsfel som förekommer på denna sida har sannolikt uppstått vid konverteringen av källfilerna till manualsidesformat. Rapportera sådana fel enligt instruktionerna på:
https://www.kernel.org/doc/man-pages/reporting_bugs.html
KORT SAMMANFATTNING
tee läser från standardindata och skriver samma data både till standardutdata och till en eller flera filer.
Vanligt exempel:
kommando | tee fil.txt
Det visar kommandots utdata på skärmen och sparar samtidigt samma utdata i fil.txt.
För att lägga till i filen i stället för att skriva över den:
kommando | tee -a fil.txt
Sidslut
Orginalhemsidan på Engelska https://man7.org/linux/man-pages/man1/tee.1p.html
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/
Tack till Datorhjälp hemma som har sponsrat Linux.se med webbhotell.