aerevml - Online in de cloud

PROGRAMMA:

NAAM

aerevml - verzend en ontvang RevML-wijzigingssets

KORTE INHOUD

aerevml -Versturen [ optie...]
aerevml -Ontvangen [ optie...]
aerevml -Helpen
aerevml -Versie

PRODUCTBESCHRIJVING

De aerevml commando wordt gebruikt om wijzigingssets te verzenden en te ontvangen met behulp van het RevML-formaat. Dit
formaat is onafhankelijk van een bepaalde VC/SCM-tool of leverancier. Het maakt export van elk mogelijk
RevML-compatibel VC/SCM-systeem en importeren in elk ander RevML-compatibel VC/SCM-systeem.

De basisfunctie is het reproduceren van een wijziging, dus een commando zoals
aerevml -stuur | aerevml -ontvangen
kan worden gebruikt om een ​​wijziging te klonen, hoewel minder efficiënt dan aeclon(1). Het bestandsformaat
gebruikt is ontworpen om bestand te zijn tegen mailservers, dus activiteiten zoals
aerevml -stuur | e-mail | aerevml -ontvangen
(waar e-mail staat voor het verzenden, transporteren en ontvangen van uw e-mail) zal reproduceren
de wijziging op een systeem op afstand. Met geschikte tools (zoals PGP) is het mogelijk om
aerevml -stuur | versleutelen | e-mail | decoderen | aerevml -ontvangen
Het mechanisme is ook ontworpen om webgebaseerde distributie mogelijk te maken, zoals
aerevml -stuur | web Server → web Browser | aerevml -ontvangen
door het gebruik van geschikte CGI-scripts en mailcap-vermeldingen.

Met deze opdracht is het mogelijk om zowel een "push"- als een "pull"-model te ondersteunen. Voor
suggesties en ideeën voor verschillende manieren om dit te doen, zie de Aegis Users Guide.

RevML Project
Het RevML-formaat wordt gebruikt voor het kopiëren van revisiegestuurde bestanden en het wijzigen van sets daartussen
verschillende SCM-opslagplaatsen. Het RevML-project is te vinden op http://public.perforce.com/-
openbaar/revml/index.html

De nieuwste RevML DTD is te vinden op http://public.perforce.com/public/revml/revml.dtd

VERSTUREN

De verzendvariant neemt een gespecificeerde verandering, of basislijn, en construeert een verdeling
pakket met alle wijzigingsattributen en bronbestandsattributen en source
bestandsinhoud. Het resultaat wordt gecomprimeerd en gecodeerd in een tekstformaat dat kan zijn
verzonden als e-mail zonder onderweg te worden beschadigd door de mail transfer agents.

Opties
Onder de verzendvariant worden de volgende opties verstaan:

-Basislijn
Deze optie kan worden gebruikt om de bron van een project te specificeren, in plaats van een wijziging.
Impliceert de -Volledige_bron optie, tenzij overschreven.

-Verandering aantal
Deze optie kan worden gebruikt om een ​​bepaalde wijziging binnen een project te specificeren. Zien
aegis(1) voor een volledige beschrijving van deze optie.

-Compatibiliteit versienummer
Deze optie kan worden gebruikt om de versie van te specificeren aerevml(1) wat zal zijn
ontvangende deze wisselset. Deze informatie wordt gebruikt om te selecteren welke functies u wilt gebruiken
opnemen in de gegevens en welke weglaten. Standaard zal de nieuwste functieset
worden gebruikt.

-compressie-algoritme naam
Deze optie kan worden gebruikt om de te gebruiken compressie te specificeren. Ze zijn vermeld
in volgorde van compressie-efficiëntie.

geen Gebruik geen compressie (niet altijd zinvol voor alle opdrachten).

gzip Gebruik de compressie die wordt gebruikt door het gzip(1) programma.

bzip2 Gebruik de compressie die wordt gebruikt door de bzip2(1) programma.

In de toekomst kunnen meer compressie-algoritmen worden toegevoegd.

-Samendrukken
Deze optie wordt afgeschaft ten gunste van de -comp-alg=gzip or -comp-alg=bzip2
opties.

-Geen_COMDruk
Deze optie wordt afgeschaft ten gunste van de -comp-alg=geen optie.

-Content_Transfer_Encoding naam
Deze optie kan worden gebruikt om de te gebruiken codering voor inhoudsoverdracht te specificeren. Het
kan een van de volgende waarden aannemen:

Geen Er hoeft geen codering voor inhoudsoverdracht te worden uitgevoerd.

Base64 De MIME base 64-codering moet worden gebruikt. Dit is de standaardinstelling.

Geciteerd_Afdrukbaar
De MIME-geciteerde afdrukbare codering moet worden gebruikt.

Unix_naar_Unix_encode
De oude unix-naar-unix-codering moet worden gebruikt.

Deze coderingen kunnen op dezelfde manier worden afgekort als commentaarregelopties.

-Ascii_Armor
Dit betekent hetzelfde als de optie "-cte=base64" hierboven.

-Geen_Ascii_Armor
Dit betekent hetzelfde als de optie "-cte=none" hierboven.

-Delta aantal
Deze optie kan worden gebruikt om een ​​bepaalde delta in de geschiedenis van het project op te geven om
kopieer het bestand van, in plaats van de meest recente versie. Als de delta is geweest
een naam gegeven (zie en(1) voor hoe) u mag een deltanaam gebruiken in plaats van een delta
nummer. Het is een fout als de opgegeven delta niet bestaat. Delta-nummers
begin vanaf 1 en verhoog; delta 0 is een speciaal geval en betekent "wanneer de tak"
begonnen".

-DELta_Datum snaar
Deze optie kan worden gebruikt om een ​​bepaalde datum en tijd op te geven in de projectpagina's
geschiedenis waaruit u het bestand wilt kopiëren, in plaats van de meest recente versie. Het is een
fout als de opgegeven tekenreeks niet kan worden geïnterpreteerd als een geldige datum en tijd.
Citeer de tekenreeks als u spaties moet gebruiken.

-DELta_Van_Wijzigen aantal
Deze optie kan worden gebruikt om een ​​bepaalde projectdelta uit de wijziging ervan te specificeren
nummer.

-Beschrijving_Header
Deze optie kan worden gebruikt om een ​​koptekst in RFC 822-stijl toe te voegen aan de wijzigingsbeschrijving
wordt verzonden, met een regel Van en Datum. Dit is de standaardinstelling.

-Geen_Beschrijving_Header
Deze optie onderdrukt de beschrijvingskop.

-Volledige_bron
Deze optie kan worden gebruikt om de volledige bron van het project te verzenden, evenals de
bronbestanden wijzigen.

-Mime_Headers
Deze optie kan worden gebruikt om de aanwezigheid van mime-headers in de uitvoer te forceren, in
omstandigheden zouden ze gewoonlijk afwezig zijn.

-Geen_Mime_Headers
Deze optie kan worden gebruikt om de afwezigheid van mime-headers in de uitvoer te forceren, in
omstandigheden waarin ze gewoonlijk aanwezig zouden zijn.

-Gedeeltelijke_bron
Deze optie kan worden gebruikt om alleen bronbestanden van een wijziging te verzenden. Dit is de
standaard, behalve de -Basislijn optie.

-Uitgang bestandsnaam
Deze optie kan worden gebruikt om het uitvoerbestand te specificeren. De uitvoer wordt verzonden naar de
standaard uitvoer.

-Project naam
Deze optie kan worden gebruikt om het gewenste project te selecteren. wanneer nee? -Project
optie is opgegeven, de AEGIS_PROJECT omgevingsvariabele wordt geraadpleegd. Indien
die niet bestaat, die van de gebruiker $HOME/.aegisrc bestand wordt onderzocht op een standaard
projectveld (zie aeuconf(5) voor meer informatie). Als dat niet bestaat,
wanneer de gebruiker alleen aan wijzigingen binnen een enkel project werkt, wordt het project
naam is standaard voor dat project. Anders is het een fout.

-Ondertekend_Uit_Door
Deze optie kan worden gebruikt om een ​​Signed-off-by: regel toe te voegen aan de wijzigingsset
Beschrijving.

-No_Signed_Off_By
Deze optie kan worden gebruikt om te voorkomen dat een Signed-off-by:-regel wordt toegevoegd
de beschrijving van de wijzigingsset.

ONTVANGEN

De ontvangvariant neemt een wijzigingspakket dat door de verzendvariant is aangemaakt en maakt een
Aegis-wijziging (zie aenc(1)) om de wijziging binnen door te voeren. Bestanden worden toegevoegd aan de wijziging
(Zie aerm(1) acp(1) aenf(1) en aent(1)) en vervolgens wordt de inhoud van het bestand uitgepakt
in de ontwikkelingsmap.

Vervolgens wordt de wijziging opgebouwd (zie AEB(1)), verschillend (zie aed(1)), en getest (zie aet(1)).
Als dit allemaal lukt, wordt de ontwikkeling van de wijziging beëindigd (zie aed(1)). De
het automatische proces stopt op dit punt, zodat een lokale reviewer kan bevestigen dat de
verandering gewenst is.

Kennisgeving
De aerevml commando roept verschillende andere Aegis-commando's op. De gebruikelijke meldingen dat
deze commando's zouden worden uitgegeven.

Opties
Onder de ontvangvariant vallen de volgende opties:

-Verandering aantal
Deze optie kan worden gebruikt om het wijzigingsnummer te kiezen dat moet worden gebruikt, anders een
wordt automatisch gekozen.

-Delta aantal
Deze optie kan worden gebruikt om een ​​bepaalde delta in de geschiedenis van het project op te geven om
kopieer het bestand van, net als voor de acp(1) opdracht. U kunt ook een delta gebruiken
naam in plaats van een deltanummer.

-Directory pad
Deze optie kan worden gebruikt om aan te geven welke directory moet worden gebruikt. Het is een fout
als de huidige gebruiker niet de juiste machtigingen heeft om de map te maken
pad gegeven. Dit moet een absoluut pad zijn.

Let op: Als u een automounter gebruikt, gebruik dan niet `pwd` om een ​​absoluut te maken
pad geeft het meestal het verkeerde antwoord.

-Het dossier bestandsnaam
Lees de wijzigingsset uit het opgegeven bestand. De standaard is om het te lezen van de
standaard invoer. Met de bestandsnaam `-' wordt de standaard invoer bedoeld.

Als uw systeem heeft libkrull(3), en Aegis is geconfigureerd om het tijdens het compileren te gebruiken
(dit is de standaardinstelling als deze beschikbaar is) u kunt ook een
Uniform Resource Locator (URL) in plaats van de bestandsnaam. De relevante gegevens zullen
worden gedownload. (De Verbaasd optie geeft een voortgangsbalk.)

- Negeer_UUID
Deze optie kan worden gebruikt om de UUID, indien aanwezig, van de inkomende wijziging te negeren
in te stellen.

-Geen_Ignore_UUID
Deze optie dwingt de aerevml opdracht om de UUID van de wijzigingsset te gebruiken. Dit is de
standaard.

-Project naam
Deze optie kan worden gebruikt om de projectnaam in te stellen. Indien niet gespecificeerd, het project
naam in het invoerpakket zal worden gebruikt, in plaats van de gebruikelijke projectnaam
in gebreke blijvend mechanisme.

-Trojaans paard Deze optie kan worden gebruikt om de wijzigingsset te behandelen alsof deze een Trojaans paard heeft
aanval erin.

-Geen_Trojaans paard
Deze optie kan worden gebruikt om de wijzigingsset te behandelen alsof deze absoluut niet bestaat
een aanval van een Trojaans paard erin. Te gebruiken Met extreem zorg. Je moet hebben
authenticeerde het bericht eerst met zoiets als PGP en ken de auteur
goed.

Security
Wijzigingen per e-mail ontvangen en automatisch vastleggen op de basislijn zonder
controleren, zou een recept zijn voor een ramp. Er zijn een aantal waarborgen voorzien:

· Het formaat van het pakket is bevestigd als correct en het pakket is geverifieerd
interne consistentie, voordat het wordt uitgepakt en ernaar wordt gehandeld.

· Het automatische gedeelte van het proces stopt wanneer de ontwikkeling eindigt. Dit zorgt ervoor dat een
lokale beoordelaar valideert de wijziging voordat deze wordt doorgevoerd, waardoor onbedoelde of
kwaadaardige schade.

· Als de wijziging bedoeld is om het project bij te werken config bestand, wordt het automatische proces beëindigd
voordat de build of het verschil optreedt. Dit komt omdat dit bestand trojans kan bevatten
voor deze bewerkingen, dus een mens moet het bestand onderzoeken voordat de wijziging doorgaat
verder.

· Er is een potentiële_trojan_horse = [ snaar ]; veld in het projectconfig bestand.
Nomineer build-configuratiebestanden, shell-scripts, codegeneratoren, etc hier te specificeren
bestanden naast het projectconfiguratiebestand dat de automatic
verwerking te stoppen.

· Het gebruik van e-mailauthenticatie- en encryptiesystemen, zoals PGP en GPG
aangemoedigd. Er wordt echter verwacht dat deze verwerking daarna zal plaatsvinden aerevml
--versturen het pakket heeft samengesteld en daarvoor aerevml --ontvangen onderzoekt en handelt ernaar
het pakket. Verificatie van de afzender is de zekerste verdediging tegen Trojaanse paarden.

· Het automatisch verzenden en ontvangen van pakketten wordt ondersteund, maar is hierin niet geïmplementeerd
het aerevml-commando. Er wordt verwacht dat het aerevml-commando binnen shell zal worden gebruikt
scripts die zijn aangepast aan uw site en de unieke beveiligingsvereisten. Zie de Aegis
Gebruikershandleiding voor verschillende manieren om dit te doen.

· Hoe meer u gebruik maakt van de testbeheerfaciliteiten van Aegis (zie aent(1) en aet(1)) hoe moeilijker
het is voor een ontoereikende verandering om in de basislijn te komen.

duplicaat Storms
In een gedistribueerde ontwikkelomgeving is het gebruikelijk dat er uiteindelijk wijzigingen worden aangebracht
gepropageerd terug naar de maker. Er zijn situaties (vooral in sommige star
topologieën) waarbij meerdere exemplaren van het pakket naar de afzender terugkeren.

Als deze wijzigingssets niet worden gedetecteerd in de beoordelingsfase en al worden doorgegeven
nogmaals, er is de mogelijkheid van een exponentiële explosie van overtollige wijzigingssets
keer op keer uitgedeeld.

Om dit tegen te gaan, worden wijzigingen gecontroleerd nadat de bestanden zijn uitgepakt, maar vóór en bouwen of
verschil of test wordt uitgevoerd. De "aecpu --onveranderd” commando wordt gebruikt om alles uit te sluiten
bestanden die de lokale repository al in de gewenste vorm heeft. Indien geen wijzigingsbestanden
hierna overblijven, vervalt de wijziging volledig (zie aedbu(1) en aencu(1)).

LIJST

De lijstvariant kan worden gebruikt om de inhoud van een pakket te vermelden zonder daadwerkelijk uit te pakken
het eerst. De uitvoer doet denken aan de aegis -lijst wijzigingsgegevens uitgang.

Opties
Onder de lijstvariant worden de volgende opties verstaan:

-Het dossier bestandsnaam
Lees de wijzigingsset uit het opgegeven bestand. De standaard is om het te lezen van de
standaard invoer. Met de bestandsnaam `-' wordt de standaard invoer bedoeld.

Als uw systeem heeft libkrull(3), en Aegis is geconfigureerd om het tijdens het compileren te gebruiken
(dit is de standaardinstelling als deze beschikbaar is) u kunt ook een
Uniform Resource Locator (URL) in plaats van de bestandsnaam. De relevante gegevens zullen
worden gedownload. (De Verbaasd optie geeft een voortgangsbalk.)

-Uitgang bestandsnaam
Deze optie kan worden gebruikt om het uitvoerbestand te specificeren. De uitvoer wordt verzonden naar de
standaarduitvoer standaard. Alleen nuttig met de optie -Lijst.

OPTIES

De volgende opties voor deze opdracht zijn nog niet genoemd:

-Helpen
Deze optie kan worden gebruikt om meer informatie te verkrijgen over het gebruik van de aerevml
programma.

Zie ook aegis(1) voor opties die alle aegis-commando's gemeen hebben.

Alle opties kunnen worden afgekort; de afkorting is gedocumenteerd als de hoofdletters,
alle kleine letters en underscores (_) zijn optioneel. U moet opeenvolgend . gebruiken
reeksen van optionele letters.

Alle opties zijn niet hoofdlettergevoelig, u kunt ze typen in hoofdletters of kleine letters of a
combinatie van beide, case is niet belangrijk.

Bijvoorbeeld: de argumenten "-project, "-PROJ" en "-p" worden allemaal geïnterpreteerd als de
-Project optie. Het argument "-prj" wordt niet begrepen, omdat consecutief
optionele tekens zijn niet meegeleverd.

Opties en andere opdrachtregelargumenten kunnen willekeurig worden gemengd op de opdrachtregel,
na de functiekiezers.

De GNU lange optienamen worden begrepen. Aangezien alle optienamen voor aerevml zijn lang,
dit betekent het negeren van de extra leidende '-'. De "--optie=waarde"conventie is ook"
begrepen.

EXIT STATUS

De aerevml commando wordt afgesloten met een status van 1 bij elke fout. De aerevml bevel zal
sluit alleen af ​​met een status van 0 als er geen fouten zijn.

MILIEU VARIABELEN

Bekijk aegis(1) voor een lijst met omgevingsvariabelen die van invloed kunnen zijn op deze opdracht. Zien
aepconf(5) voor de projectconfiguratiebestanden project_specifiek veld voor hoe in te stellen
omgevingsvariabelen voor alle opdrachten die door Aegis worden uitgevoerd.

COPYRIGHT

aerevml versie 4.24.3.D001
Auteursrecht (C) 1991, 1992, 1993, 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002,
2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010

Het aerevml-programma wordt geleverd met ABSOLUUT GEEN GARANTIE; gebruik voor details de 'aerevml
-Versie Vergunning' commando. Dit is gratis software en je bent welkom om het opnieuw te distribueren
onder bepaalde omstandigheden; gebruik voor details de 'aerevml -Versie Vergunning' commando.

Gebruik aerevml online met behulp van onworks.net-services