prs(1p)

prs – skriv ut en SCCS-fil (UTVECKLING)

PROLOG

Denna manualsida är en del av POSIX Programmer's Manual. Linux-implementeringen av detta gränssnitt kan skilja sig från beskrivningen här. Se motsvarande Linux-manualsida för detaljer om Linux-beteende, eller observera att gränssnittet kanske inte är implementerat på Linux.

NAMN

prs – skriv ut en SCCS-fil (UTVECKLING)

SYNOPSIS

prs [-a] [-d dataspec] [-r[SID]] file...

prs [-e|-l] -c cutoff [-d dataspec] file...

prs [-e|-l] -r[SID] [-d dataspec] file...

BESKRIVNING

Verktyget prs ska skriva delar av, eller hela, en SCCS-fil till standardutmatningen i ett format som användaren anger.

FLAGGOR

Verktyget prs ska följa Base Definitions-volymen av POSIX.1-2017, avsnitt 12.2, Utility Syntax Guidelines, med undantaget att flaggan -r har ett valfritt flaggargument. Detta valfria flaggargument kan inte anges som ett separat argument.

Följande flaggor ska stödjas:

-d dataspec

Anger dataspecifikationen för utmatningen. dataspec ska vara en sträng som består av SCCS-filens datanyckelord (se Datanyckelord) blandade med valfri text som användaren anger.

-r[SID]

Anger SCCS-identifikationssträngen (SID) för en delta som information önskas om. Om inget SID-argument anges ska SID för den senast skapade deltan antas.

-e

Begär information för alla deltan som skapats tidigare än, och inklusive, den delta som anges med flaggan -r eller den datum- och tidsangivelse som ges med flaggan -c.

-l

Begär information för alla deltan som skapats senare än, och inklusive, den delta som anges med flaggan -r eller den datum- och tidsangivelse som ges med flaggan -c.

-c cutoff

Anger brytdatum och bryttid i formen:

YY[MM[DD[HH[MM[SS]]]]]

För komponenten YY ska värden i intervallet [69,99] avse åren 1969 till och med 1999, och värden i intervallet [00,68] ska avse åren 2000 till och med 2068.

Observera: Det förväntas att en framtida version av standarden kommer att ändra vilket sekel som antas som standard från ett tvåsiffrigt år. Detta skulle gälla alla kommandon som accepterar ett tvåsiffrigt år som indata.

Inga ändringar (deltan) i SCCS-filen som skapades efter angivet cutoff-datum och tid ska tas med i utmatningen. Enheter som utelämnas från datum- och tidsangivelsen får sina högsta möjliga värden. Exempel: -c 7502 är likvärdigt med -c 750228235959.

-a

Begär utskrift av information både för borttagna deltan, det vill säga delta type=R (se rmdel(1p)), och befintliga deltan, det vill säga delta type=D. Om flaggan -a inte anges ska endast information för befintliga deltan tillhandahållas.

OPERANDER

Följande operand ska stödjas:

file

Sökväg till en befintlig SCCS-fil eller en katalog. Om file är en katalog ska prs bete sig som om varje fil i katalogen hade angetts som en namngiven fil, med undantaget att filer som inte är SCCS-filer (där sista komponenten i sökvägen inte börjar med s.) och oläsbara filer ska ignoreras utan meddelande.

Om exakt en file-operand anges och den är -, ska standardindata läsas. Varje rad i standardindata ska tolkas som namnet på en SCCS-fil som ska bearbetas. Filer som inte är SCCS-filer och oläsbara filer ska ignoreras utan meddelande.

STDIN

Standardindata ska vara en textfil och används endast när operanden file anges som -. Varje rad i textfilen ska tolkas som en SCCS-sökväg.

INDATAFILER

Alla SCCS-filer som visas är filer i ett ospecificerat format.

MILJÖVARIABLER

Följande miljövariabler ska påverka körningen av prs:

LANG

Anger ett standardvärde för internationaliseringsvariabler som är odefinierade eller tomma. Se Base Definitions-volymen av POSIX.1-2017, avsnitt 8.2, Internationalization Variables, för prioritetsordningen för internationaliseringsvariabler som används för att bestämma värden för lokalkategorier.

LC_ALL

Om variabeln är satt till ett icke-tomt strängvärde åsidosätter den värdena för alla andra internationaliseringsvariabler.

LC_CTYPE

Bestämmer lokalen för tolkning av bytesekvenser i textdata som tecken, till exempel enkla byte-tecken i stället för flerbyte-tecken i argument och indatafiler.

LC_MESSAGES

Bestämmer lokalen som ska användas för att påverka format och innehåll i diagnostiska meddelanden som skrivs till standardfel.

NLSPATH

Bestämmer platsen för meddelandekataloger för behandling av LC_MESSAGES.

ASYNKRONA HÄNDELSER

Standard.

STDOUT

Standardutmatningen ska vara en textfil vars format beror på de datanyckelord som anges med flaggan -d.

Datanyckelord

Datanyckelord anger vilka delar av en SCCS-fil som ska hämtas och skrivas ut. Alla delar av en SCCS-fil har ett tillhörande datanyckelord. Ett datanyckelord kan förekomma flera gånger i en dataspec.

Informationen som skrivs av prs ska bestå av:

1. Text som användaren anger.
2. Lämpliga värden, extraherade från SCCS-filen, ersatta för de igenkända datanyckelorden i den ordning de förekommer i dataspec.

Formatet för ett datanyckelords värde ska antingen vara enkelt (S), där nyckelordsersättningen sker direkt, eller flerradigt (M).

Text som användaren anger ska vara all text utom igenkända datanyckelord. Ett <tabb>-tecken ska anges med \t och en <nyrad> med \n. När flaggan -r inte anges ska standardvärdet för dataspec vara:

:PN::\n\n

och följande dataspec ska användas för varje vald delta:

:Dt:\t:DL:\nMRs:\n:MR:COMMENTS:\n:C:

SCCS-filens datanyckelord

Nyckelord	Dataobjekt	Filavsnitt	Värde	Format
:Dt:	Delta-information	Deltatabell	Se nedan*	S
:DL:	Delta-radstatistik	Deltatabell	:Li:/:Ld:/:Lu:	S
:Li:	Rader infogade av deltan	Deltatabell	nnnnn***	S
:Ld:	Rader borttagna av deltan	Deltatabell	nnnnn***	S
:Lu:	Rader oförändrade av deltan	Deltatabell	nnnnn***	S
:DT:	Deltatyp	Deltatabell	D eller R	S
:I:	SCCS-ID-sträng (SID)	Deltatabell	Se nedan**	S
:R:	Utgåvenummer	Deltatabell	nnnn	S
:L:	Nivånummer	Deltatabell	nnnn	S
:B:	Grennummer	Deltatabell	nnnn	S
:S:	Sekvensnummer	Deltatabell	nnnn	S
:D:	Datum då deltan skapades	Deltatabell	:Dy:/:Dm:/:Dd:	S
:Dy:	År då deltan skapades	Deltatabell	nn	S
:Dm:	Månad då deltan skapades	Deltatabell	nn	S
:Dd:	Dag då deltan skapades	Deltatabell	nn	S
:T:	Tid då deltan skapades	Deltatabell	:Th:::Tm:::Ts:	S
:Th:	Timme då deltan skapades	Deltatabell	nn	S
:Tm:	Minuter då deltan skapades	Deltatabell	nn	S
:Ts:	Sekunder då deltan skapades	Deltatabell	nn	S
:P:	Programmerare som skapade deltan	Deltatabell	logname	S
:DS:	Deltans sekvensnummer	Deltatabell	nnnn	S
:DP:	Föregående deltasekvensnummer	Deltatabell	nnnn	S
:DI:	Sekvensnummer för deltan som ingår, utesluts eller ignoreras	Deltatabell	:Dn:/:Dx:/:Dg:	S
:Dn:	Deltan som ingår (sekvensnummer)	Deltatabell	:DS: :DS: ...	S
:Dx:	Deltan som utesluts (sekvensnummer)	Deltatabell	:DS: :DS: ...	S
:Dg:	Deltan som ignoreras (sekvensnummer)	Deltatabell	:DS: :DS: ...	S
:MR:	MR-nummer för deltan	Deltatabell	text	M
:C:	Kommentarer för deltan	Deltatabell	text	M
:UN:	Användarnamn	Användarnamn	text	M
:FL:	Flaggliste	Flaggor	text	M
:Y:	Flagga för modultyp	Flaggor	text	S
:MF:	Flagga för MR-validering	Flaggor	yes eller no	S
:MP:	Programnamn för MR-validering	Flaggor	text	S
:KF:	Nyckelordsfel, varningsflagga	Flaggor	yes eller no	S
:KV:	Nyckelordsvalideringssträng	Flaggor	text	S
:BF:	Grenflagga	Flaggor	yes eller no	S
:J:	Flagga för gemensam redigering	Flaggor	yes eller no	S
:LK:	Låsta utgåvor	Flaggor	:R: ...	S
:Q:	Användardefinierat nyckelord	Flaggor	text	S
:M:	Modulnamn	Flaggor	text	S
:FB:	Nedre gräns	Flaggor	:R:	S
:CB:	Övre gräns	Flaggor	:R:	S
:Ds:	Standard-SID	Flaggor	:I:	S
:ND:	Null-delta-flagga	Flaggor	yes eller no	S
:FD:	Filens beskrivande text	Kommentarer	text	M
:BD:	Kropp	Kropp	text	M
:GB:	Hämtad kropp	Kropp	text	M
:W:	En form av what-sträng	Ej tillämpligt	:Z::M:\t:I:	S
:A:	En form av what-sträng	Ej tillämpligt	:Z::Y: :M: :I::Z:	S
:Z:	Avgränsare för what-sträng	Ej tillämpligt	@(#)	S
:F:	SCCS-filnamn	Ej tillämpligt	text	S
:PN:	SCCS-filens sökväg	Ej tillämpligt	text	S

* :Dt: = :DT: :I: :D: :T: :P: :DS: :DP:

** :R:.:L:.:B:.:S: om deltan är en grendelta (:BF: == yes)

:R:.:L: om deltan inte är en grendelta (:BF: == no)

*** Radstatistiken begränsas till 99999. Om exempelvis 100000 rader var oförändrade i en viss revision ska :Lu: producera värdet 99999.

STDERR

Standardfel ska endast användas för diagnostiska meddelanden.

UTDATAFILER

Inga.

UTVIDGAD BESKRIVNING

Ingen.

SLUTSTATUS

Följande slutvärden ska returneras:

0

Slutfördes utan fel.

>0

Ett fel inträffade.

FÖLJDER AV FEL

Standard.

Följande avsnitt är informativa.

PROGRAMANVÄNDNING

Ingen.

EXEMPEL

Exempel 1

Följande exempel:

prs -d "User Names for :F: are:\n:UN:" s.file

kan skriva följande till standardutmatningen:

User Names for s.file are:
xyz
131
abc

Exempel 2

Följande exempel:

prs -d "Delta for pgm :M:: :I: - :D: By :P:" -r s.file

kan skriva följande till standardutmatningen:

Delta for pgm main.c: 3.7 - 77/12/01 By cas

Exempel 3

Som ett specialfall:

prs s.file

kan följande skrivas till standardutmatningen:

s.file:
<tom rad>
D 1.1 77/12/01 00:00:00 cas 1 000000/00000/00000
MRs:
bl78-12345
bl79-54321
COMMENTS:
this is the comment line for s.file initial delta
<tom rad>

för varje deltatabellpost av typen D. Den enda flagga som får användas tillsammans med detta specialfall är flaggan -a.

BAKGRUND

Ingen.

FRAMTIDA RIKTNING

Ingen.

SE ÄVEN

admin(1p), delta(1p), get(1p), what(1p)

Base Definitions-volymen av POSIX.1-2017, kapitel 8, Environment Variables, avsnitt 12.2, Utility Syntax Guidelines.

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 (C) 2018 av Institute of Electrical and Electronics Engineers, Inc. och The Open Group.

Vid eventuell avvikelse 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 på http://www.opengroup.org/unix/online.html .

Eventuella typografiska fel eller formateringsfel som visas på denna sida har sannolikt införts vid konverteringen av källfilerna till manualsidesformat. För att rapportera sådana fel, se https://www.kernel.org/doc/man-pages/reporting_bugs.html .

Sidslut

Orginalhemsidan på Engelska https://man7.org/linux/man-pages/man1/prs.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.