tee(1p)

Från Wiki.linux.se -Linux wikipedia på Svenska.
Hoppa till navigering Hoppa till sök


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.