aeimport - Online in de cloud

PROGRAMMA:

NAAM

aeimport - importeer een buitenlandse repository in Aegis

KORTE INHOUD

import [ optie...] zeg eens
import -Helpen
import -Versie

PRODUCTBESCHRIJVING

De import commando wordt gebruikt om een ​​nieuw project te maken en het te vullen door een
buitenlandse repository (zoals RCS of CVS) zonder verlies van projectgeschiedenis.

Let op: tenzij u een versie opgeeft (zie de -versie optie, hieronder) dit commando
maakt standaard branches om versie 1.0 te ondersteunen. Mocht je dit ook ontdekt hebben
laat, alles is niet verloren: u kunt de eenenbru(1) commando om van de takken af ​​te komen
wilde niet.

Directory
De projectdirectory, waaronder de projectbaseline en geschiedenis en status en verandering
gegevens worden bewaard, worden op dit moment aangemaakt. Als de -Directory optie wordt niet gegeven, de
projectdirectory wordt gemaakt in de directory die is opgegeven door de default_project_‐
directory veld van aeuconf(5), of indien niet ingesteld in de thuismap van de huidige gebruiker; in beide
case met dezelfde naam als het project.

Medewerkers
Het project wordt gemaakt met de huidige gebruiker en groep als gebruiker en groep die eigenaar is. De
huidige gebruiker is beheerder van het project. Het project heeft geen andere
beheerders (gebruik eena(1) om meer toe te voegen).

In het project zullen alle gebruikersnamen gevonden in de geschiedenisbestanden (zie onderstaande afbeelding) geïnstalleerd zijn als
ontwikkelaars, reviewers en integrators. Dit is waarschijnlijk te breed, maar redelijk nauwkeurig
reproduceert de wijd open machtigingen die in de meeste repository's voorkomen, en die u zult willen gebruiken
aerd(1) aerrv(1) en lucht(1) waar nodig om deze lijst te ziften.

Als er slechts één naam wordt gevonden, wordt het project ingesteld op “developers_may_review = true;”
anders zal het vals zijn (zie aepattr(5) voor meer informatie). Gebruik aap(1) veranderen
dit als u een andere instelling wilt.

Het umask van het project is afgeleid van het umask van de huidige gebruiker, maar aangepast om dit te garanderen
dat groepsleden toegang hebben en dat alleen de projecteigenaar schrijfrechten heeft
toegang. Over het algemeen is dit het beste van het project niet eigendom van een account bij een ander
rol, omdat dit een hele reeks ‘oeps, ik dacht dat ik ergens anders was’-fouten voorkomt.

De geschiedenisopdrachten van het project (zie aepconf(5) voor meer informatie) zijn hierop ingesteld
geschikt voor RCS. Het build-commando is ingesteld op “exit 0”; je moet het ergens op instellen
geschikt. De symbolische linkfarm is ingeschakeld.

Wijzer
De projectaanwijzer wordt toegevoegd aan het eerste element van het zoekpad, of als er geen pad is
is ingesteld. Als dit ongepast is, gebruik dan de -Bibliotheek optie om expliciet het gewenste in te stellen
plaats. Zie de -Bibliotheek optie voor meer informatie.

U kunt ook de omgevingsvariabele AEGIS_PATH uitschakelen om het project toe te voegen aan de global
projecten lijst.

Versie
U kunt de projectversie op twee manieren specificeren:

1. Het versienummer kan impliciet zijn in de projectnaam, in welk geval de versie
nummers zullen worden verwijderd. Met “aeimport -p example.1.2” wordt bijvoorbeeld een
project met de naam “voorbeeld” waarbij filiaalnummer 1 is aangemaakt en subtak 2 van filiaal 1
aangemaakt.

2. Het versienummer kan expliciet worden vermeld, in welk geval het wordt onderverdeeld
filiaalnummers. Met “aeimport -p example -version 1.2” wordt bijvoorbeeld een project gemaakt
genaamd "voorbeeld" met filiaal nummer 1 gemaakt en subfiliaal 2 van filiaal 1 gemaakt.

In elk geval kunnen deze takken worden genoemd waar een projectnaam kan worden gegeven, zoals
"-p voorbeeld.1" en "-p voorbeeld-1.2". Het daadwerkelijke leesteken is onbelangrijk.

U kunt elke gewenste diepte van versienummers hebben. Beide methoden voor het specificeren van version
nummers kunnen worden gebruikt, en ze zullen worden gecombineerd. Als u helemaal geen versienummers wilt,
. -versie met een enkel streepje als argument, zoals in "-versie -"

Als er geen versienummer wordt gegeven, expliciet of impliciet, wordt versie 1.0 gebruikt.

Project Directory Locatie
Alstublieft Opmerking: Aegis raadpleegt ook het onderliggende bestandssysteem om zijn notie van te bepalen
maximale bestandsgrootte. Waar de maximale bestandsgrootte van het bestandssysteem kleiner is dan
maximale_bestandsnaam_lengte, het bestandssysteem wint. Dit kan bijvoorbeeld gebeuren wanneer u dat bent
met behulp van het Linux UMSDOS-bestandssysteem, of wanneer je een NFS hebt gekoppeld met een oude V7
bestandssysteem. Instelling maximale_bestandsnaam_lengte tot 255 verandert in deze gevallen niets aan de
feit dat de limieten van de onderliggende bestandssystemen veel kleiner zijn (respectievelijk 12 en 14).

Als uw ontwikkelingsmappen (of uw hele project) zich op bestandssystemen bevinden met bestandsnaam
beperkingen, of een deel van de heterogene builds vindt plaats in een dergelijke omgeving,
het helpt om Aegis te vertellen wat ze zijn (met behulp van het project config bestandsvelden) zodat u
kom niet in de situatie terecht waarin het project voortbouwt op de meer tolerante
omgevingen, maar faalt met mysterieuze fouten in de meer beperkte omgevingen.

Als uw ontwikkelingsmappen routinematig op een Linux UMSDOS-bestandssysteem staan, zou u dat doen
waarschijnlijk beter af zijn dos_bestandsnaam_vereist = waar, en ook het wijzigen van de
ontwikkelingsmap_sjabloon veld. Heterogene ontwikkeling met verschillende Windows
omgevingen kunnen dit ook vereisen.

HET PROCES

De meeste bestandsversiesystemen werken niet met wijzigingssets. Om dergelijke te importeren
opslagplaatsen in Aegis is het noodzakelijk om deze wijzigingssets te ‘ontdekken’. Het volgende
stappen worden ondernomen:

1.
De map (dirpad) die op de opdrachtregel wordt gegeven, en alle mappen daaronder, zijn dat wel
gescand op geschikte bestanden (RCS en CVS gebruiken bijvoorbeeld bestanden met het achtervoegsel “,v”).
Deze bestanden worden gelezen om de geschiedenis van het bestand te verkrijgen.
Als u een niet-standaard bestandsachtervoegsel gebruikt, kan aeimport het
bestanden.
Als u meer dan één module in uw CVS-repository heeft, werkt aeimport (nog) niet
het bestand CVSROOT/modules begrijpen. Als u aeimport naar uw hele CVSROOT richt, kan dit
onverwacht groot resultaat opleveren.

2.
De geschiedenisbestanden die in de vorige stap zijn ontdekt, worden gekopieerd naar de locatie die wordt gebruikt door
Aegis. In tegenstelling tot sommige andere tools heeft Aegis een repository per project, in plaats van voor allemaal
projecten die dezelfde repository delen.
Dit betekent ook dat Aegis de originele geschiedenisbestanden niet zal wijzigen. In het bijzonder,
als de import onverwachte resultaten oplevert, verwijdert u eenvoudigweg het project (zie aermpr(1) voor
meer informatie) en begin opnieuw.
Het is niet mogelijk om al uw geschiedenisbestanden onder bijvoorbeeld $CVSROOT te laten staan ​​en Aegis te hebben
wijs ze aan.

3.
Voor elke gebruiker die in de verschillende bestandsgeschiedenissen wordt vermeld, wordt gekeken naar de tijdstempels
zoek groepen bestanden die rond dezelfde tijd zijn vastgelegd. Bestanden gewijzigd
binnen 1 minuut na elkaar worden beschouwd als een groep.
Bestanden veranderen binnen één minuut, maar door verschillende gebruikers wel niet als een groep beschouwd.
Dit levert meestal geen probleem op, aangezien ontwikkelaars meestal alleen werken. In zeldzame gevallen
waar ontwikkelaars samenwerken, doet slechts één van hen de commit.
In sommige gevallen kan het tijdvenster te groot zijn en kunnen er meerdere zeer kleine wijzigingen optreden
gezien als één grotere veranderingsset. In de praktijk komt dit niet veel voor.

4.
Groepen bestanden worden in de Aegis-database opgeslagen als voltooide wijzigingen (dat wil zeggen alsof
aeipas(1) is al uitgevoerd). De beschrijving van de wijziging is de aaneenschakeling van alles
de unieke opmerkingen die bij de relevante bestandsversies zijn aangetroffen. Het gebruikte tijdstempel
voor de wijziging is de laatste tijdstempel van elk bestand in de groep.
Er zijn momenten waarop kleine typografische fouten tussen bestandsopmerkingen resulteren in langere-
dan verwachte wijzigingsbeschrijvingen. Dit kan worden gecorrigeerd met aeca(1) of tkaeca(1) als
gewenst. Er zijn ook momenten waarop het omgekeerde waar is: sommige bestanden bevatten geen commentaar
allemaal, en de resulterende beschrijving is niet bepaald nuttig.

5.
Tags worden omgezet in deltanamen door deltanamen over te dragen vanuit de bestanden die ze zijn
waaraan ze zijn gekoppeld, aan de wijzigingssets waaraan ze zijn gekoppeld. Wanneer er een tag zou verschijnen
die aan meer dan één wijziging is gekoppeld, wordt alleen aan de laatste wijziging gekoppeld.
Bij algemeen gebruik dienen de tags een soortgelijk doel als de deltanummers van Aegis. Zij zijn
allemaal (doorgaans) toegepast in een enkele CVS-opdracht, zodat een bepaalde release mogelijk is
later opnieuw worden gemaakt. Omdat elk bestand echter een andere versie heeft, en
van elk is de nieuwste versie opgenomen in verschillende willekeurige wisselsets.
Tags worden ook voor andere dingen gebruikt. De hier gegeven methode is slechts een gok, maar dat is zo
eentje die redelijk goed werkt.

Zodra aeimport het importeren van een project heeft voltooid, kunt u de resultaten bekijken
met de AEL projectgeschiedenis en AEL wijzig_details opdrachten. (Zien AEL(1) voor meer
informatie.)

Beperkingen
Het importprogramma is verre van perfect. Er zijn een aantal bekende beperkingen.

· Op dit moment is er geen ondersteuning voor vertakkingen. (Zodra ik weet hoe dat moet
onderscheid de root van een branch in losjes gekoppelde bestanden, ik zal het implementeren. Ideeën
en/of codebijdragen welkom.)

· Momenteel worden alleen de RCS- en SCCS-formaten begrepen. Het zou rechttoe rechtaan moeten zijn
ondersteuning toevoegen voor extra formaten in de toekomst. Slechts stap 1 van het bovenstaande proces
vereist aandacht, de rest is bestandsformaat neutraal.

· Er is geen ondersteuning voor CVS-modules, en dat is wel nodig.

· U kunt niet de tijdvenstergrootte opgeven die wordt gebruikt om wijzigingssets te bepalen. De tijd zal het leren
of dit nodig is, maar het roept de vraag op: hoe weet je welke venstergrootte
die u nodig heeft om de optie überhaupt te kunnen gebruiken.

· U kunt een CVS-repository niet in een bestaand project importeren. U kunt alleen een nieuwe aanmaken
project vanuit een CVS-repository.

· U kunt geen externe CVS-opslagplaats importeren.

OPTIES

De volgende opties worden begrepen:

-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.

-Formaat naam
Deze optie kan worden gebruikt om aan te geven welk geschiedenisformaat wordt geïmporteerd. De
volgende formaten worden begrepen:

Het RCS Release Control System-formaat bestaat al een tijdje. Het is
het formaat dat ten grondslag ligt aan CVS (Concurrent Version System). Dit is de
standaard als er geen formaatnaam is opgegeven.
Opmerking: helpen Dan moet je zorg ervoor dat RCS is geïnstalleerd voordat u begint import als je dit gebruikt
formaat, omdat RCS-opdrachten worden uitgevoerd tijdens het importproces. De
het importeren mislukt als RCS niet is geïnstalleerd. Je kunt een freeware vinden
implementatie op ftp.gnu.org, of een lokale spiegelserver.

SCCS Source Code Control System is een van de eerste Unix-versiesystemen.
(Er is mij verteld dat dit het onderliggende formaat van BitKeeper is.)
Opmerking: helpen Dan moet je zorg ervoor dat SCCS is geïnstalleerd voordat u begint import als je gebruikt
dit formaat, omdat SCCS-opdrachten worden uitgevoerd tijdens het importproces.
Het importeren mislukt als SCCS niet is geïnstalleerd. De GNU-compatibel dom
Source Control (CSSC) is een freeware-implementatie van SCCS, en dat kan ook zo zijn
gevonden bij ftp://alpha.gnu.org/gnu/CSSC/

-Bibliotheek abspathisch
Deze optie kan worden gebruikt om een ​​directory op te geven waarin moet worden gezocht naar globale status
bestanden en gebruikersstatusbestanden. (Zien aegstaat(5) en austaat(5) voor meer
informatie.) Er kunnen verschillende bibliotheekopties aanwezig zijn op de opdrachtregel, en
zijn zoeken in de aangegeven volgorde. Aan dit expliciete zoekpad zijn de
mappen gespecificeerd door de AEGIS_PATH omgevingsvariabele (gescheiden door dubbele punt),
en tenslotte, /usr/local/lib/aegis wordt altijd gezocht. Alle paden opgegeven,
hetzij op de opdrachtregel of in de AEGIS_PATH omgevingsvariabele, moet zijn
absoluut.

-Lijst
Deze optie kan worden gebruikt om een ​​lijst met geschikte onderwerpen voor deze opdracht te verkrijgen.
De lijst is mogelijk algemener dan verwacht.

-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.

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

-Versie aantal
Deze optie kan worden gebruikt om het versienummer voor het project op te geven. Versie
nummers zijn geïmplementeerd als takken. Gebruik een enkel streepje ("-") als argument als
u wilt dat er geen versietakken worden gemaakt.

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 import zijn lang,
dit betekent het negeren van de extra leidende '-'. De "--optie=waarde"conventie is ook"
begrepen.

EXIT STATUS

De import commando wordt afgesloten met een status van 1 bij elke fout. De import commando
zal alleen afsluiten 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

aeimport-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 aeimport-programma wordt geleverd met ABSOLUUT GEEN GARANTIE; gebruik voor details de 'import
-Versie Vergunning' commando. Dit is gratis software en je bent welkom om het opnieuw te distribueren
onder bepaalde omstandigheden; gebruik voor details de 'import -Versie Vergunning' commando.

Gebruik aeimport online met behulp van onworks.net-services