prs(1p)
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:
- Text som användaren anger.
- 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:
| 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.