aeipass - Online w chmurze

PROGRAM:

IMIĘ

aegis integruj pass - przekaż integrację zmiany

STRESZCZENIE

egida -Integracja_Pass [ opcja...]
egida -Integracja_Pass -Lista [ opcja...]
egida -Integracja_Pass -Pomoc

OPIS

egida -Integracja_Pass polecenie służy do powiadamiania Aegis, że zmiana została przyjęta
integracja. Zmiana jest zaawansowana od który jest zintegrowany stan do zakończony
państwo. boxwid = 1 dół pole „być” „zintegrowany” strzałka „integrować” lpo prostu „przekazywać” ljust
pudełko „ukończone”

To polecenie aktualizuje historię plików, tak aby przyszłość aekp(1) polecenia mogą zostać wyodrębnione
poprzednie wersje plików z historii i tak dalej aed(1) polecenia mogą łączyć się poza-
pliki daty. Historia jest aktualizowana za pomocą polecenie_historia_tworzenia oraz
polecenie_historia_put pola pliku konfiguracyjnego projektu (patrz aepconf(5) po więcej
Informacja). Przejście integracji zostanie przerwane z błędem, jeśli jedna z tych historii
polecenia powinny zakończyć się niepowodzeniem, na przykład przez brak miejsca na dysku. Jeśli tak się stanie,
zmiana pozostanie w który jest zintegrowany stan, a katalog integracji to
niezmienione.

Po zaktualizowaniu historii nazwa katalogu integracji zostaje zmieniona na wersję bazową
katalog, a stary katalog bazowy zostanie usunięty.

Po zakończeniu integracji zmiana nie jest już przypisana do bieżącego użytkownika.

Wsparcia Sponsorskiego Narzędzia modyfikować Akta
Wiele narzędzi historycznych (na przykład RCS i SCCS) mogą modyfikować zawartość pliku, gdy taki istnieje
zaangażowany. Zwykle wymaga to użycia określonych ciągów „słów kluczowych” i takie są
zazwyczaj opcje wyłączenia tego zachowania, ale użytkownicy zaznajomieni z narzędziami kontroli wersji
(w przeciwieństwie do systemów zarządzania konfiguracją) często korzystają z tych funkcji. The
problem polega na tym, że jeśli zatwierdzenie zmieni plik, plik źródłowy w repozytorium będzie teraz nie
już pasuje do pliku obiektowego w repozytorium. To znaczy narzędzie historii uległo uszkodzeniu
integralność referencyjna repozytorium. Domyślnie emitowany jest błąd krytyczny, jeśli
plik jest zmieniany podczas zaewidencjonowania, jednakże można to zmodyfikować tak, aby było ostrzeżeniem lub nawet
całkowicie ignorowane; zobacz plik_historii_put_trashes Pole aepconf(5) po więcej
informacje.

filet Modyfikacja Czasy
Czasy modyfikacji wszystkich plików zmodyfikowanych od początku integracji (patrz
aeib(1) aby uzyskać więcej informacji) są aktualizowane od początku integracji pass.
Kolejność czasów modyfikacji zostanie zachowana, bez względu na zakres czasowy
skompresowany w największym możliwym stopniu. Zapewnia to dalszy rozwój
builds zauważy zmianę plików bazowych.

Należy pamiętać, że jeśli w integracji istnieje wiele nowych plików z różnymi znacznikami czasu
katalogu, a jeśli liczba plików z różnymi znacznikami czasu przekracza liczbę
sekund od uruchomienia polecenia integr-pass, może być konieczne ustawienie pliku przez Aegis
czasów modyfikacji w przyszłość.

kompilacja_czasu_regulacji dziedzina projektu config plik kontroluje zachowanie Aegis w tym przypadku
sprawa. (Widzieć aepconf(5), aby uzyskać więcej informacji.) Dostępne są trzy ustawienia:

dostosuj_i_uśpij
To ustawienie, które jest domyślne, powoduje, że Aegis uśpiony do czasu pliku
czasy modyfikacji nie będą już miały miejsca w przyszłości. Pozwala to uniknąć obu
rozwój buduje problemy, a integracja buduje problemy, jedno i drugie
mogą wyniknąć „ciekawe” czasy modyfikacji plików.

tylko_dopasuj
Aegis wyświetli ostrzeżenie, że czas modyfikacji pliku rozciąga się do
przyszłość, ale nie będę spać. Może to powodować problemy z kompilacją integracji,
szczególnie jeśli używasz aeintegratq(1). Kompilacje rozwojowe mogą działać
jednak zbędne kompilacje aet -rej nie powinien dawać wyników fałszywie negatywnych.

nie_reguluj
Jest to wysoce niewskazane. Jest przeznaczony wyłącznie dla niektórych bardzo rzadkich
okoliczności. To ustawienie powoduje, że Aegis nie dostosowuje modyfikacji pliku
w ogóle razy. Może to mieć bardzo niemiłe skutki uboczne, szczególnie w przypadku
kompilacja integracji była zanim jedna lub więcej kompilacji rozwojowych; najczęstszy
objawem jest to, że kompilacje rozwojowe nie zawsze powodują ponowne połączenie
niezbędne pliki wykonywalne i aet -rej może dawać fałszywe wyniki negatywne. To jest strongly
zaleca się, aby nie używać tego ustawienia.

Jeśli używasz gotować(1), zob korekta czasu flaga pokazująca, jak nawet skompresować zakres czasu
dalej. To zwykle sprawia, że ​​sen (lub okres ostrzegawczy) jest znacznie krótszy.

Zgłoszenie
Po pomyślnym wykonaniu tego polecenia, po zmianie nazwy katalogu i
po zaktualizowaniu bazy danych, Integration_pass_notify_command pole
atrybuty projektu są uruchamiane, jeśli są ustawione. Widzieć aepattr(5) i apa(1), aby uzyskać więcej informacji.
To polecenie jest uruchamiane jako właściciel projektu.

Niektóre kompilatory zakopują bezwzględne nazwy ścieżek w plikach obiektowych i plikach wykonywalnych. Zmiana nazwy
katalogu integracji, aby stał się nowym punktem odniesienia, przerywa te ścieżki. Powyższe
do polecenia przekazywana jest zmienna środowiskowa o nazwie AEGIS_INTEGRATION_DIRECTORY, dzięki czemu plik
w razie potrzeby można umieścić odpowiednie dowiązanie symboliczne.

Inne polecenia uruchamiane przez to polecenie obejmują polecenie_historia_tworzenia, historia_put_‐
komenda oraz polecenie_historia_query obszary projektu config plik. Widzieć aepconf(5) dla
więcej informacji.

THE LINIA BAZOWA LOCK

Blokada linii bazowej służy do zapewnienia, że ​​linia bazowa pozostaje w spójnym stanie przez
czas trwania poleceń, które muszą odczytać zawartość plików w linii bazowej.

Polecenia, które wymagają, aby linia bazowa była spójna (zaliczają się do nich: aeb(1)
aekp(1) i aed(1) polecenia) weź linię bazową czytać Zamek. To jest niewyłączny zamek, więc
równoczesny rozwój zmian nie jest utrudniony.

Polecenie modyfikujące linię bazową, aeipass(1), przyjmuje linię bazową napisać Zamek. Ten
to zamek ekskluzywny, forsujący aeipass(1) blokować, dopóki nie będzie aktywnego odczytu linii bazowej
zamki

Możliwe, że jedno z powyższych poleceń programistycznych zablokuje się do czasu, gdy jest to w toku
egida -Integracja_PASS kończy. Zwykle trwa to krótko, podczas gdy projekt
historia jest aktualizowana. Opóźnienie jest niezbędne, aby te polecenia otrzymały spójne
widok linii bazowej. Żadne inne polecenie integracji nie spowoduje powyższego rozwoju
polecenia do zablokowania.

Gdy używana jest funkcja oddziału aegis, blokada odczytu (niewyłączna) jest pobierana na
linia bazowa gałęzi, a także każda z linii bazowych „macierzystych”. Jednak podstawowy zapis
(ekskluzywna) blokada jest pobierana tylko na linii bazowej oddziału; „rodzice” linie bazowe są tylko
odczyt (nie na wyłączność) zablokowany.

Wsparcia Sponsorskiego Zablokować
Jeżeli projekt ma jednocześnie aktywnych wiele gałęzi, jest to możliwe
niezależna integracja poleceń przejścia dla różnych oddziałów, które mają być wydawane bardzo blisko
razem. Jest to ekskluzywny produkt historia zablokować podjęte przez przepustkę integracyjną, aby to zapewnić
jedna gałąź aktualizuje historię pliku na raz, uniemożliwiając w ten sposób plik historii
korupcja.

TESTOWANIE KORELACJE

Polecenie „egida -Test -SUGgest” może być użyte do sugerowania przez egidę odpowiedniej regresji
testuje Twoją zmianę na podstawie plików źródłowych w Twojej zmianie. To automatycznie
skupia wysiłek testowy na odpowiednich testach, zmniejszając liczbę testów regresji
musisz mieć pewność, że nie wprowadziłeś błędu.

Korelacje testowe są generowane przez polecenie „aegis -Integrate_Pass”, które:
kojarzy każdy test w zmianie z każdym plikiem źródłowym w zmianie. Tak więc każdy
plik źródłowy gromadzi listę testów, które były z nim powiązane w przeszłości.
Nie jest to tak dokładne jak analiza pokrycia kodu, ale jest rozsądnym przybliżeniem w
ćwiczyć.

aekp(1) i aenf(1) komendy służą do kojarzenia plików ze zmianą. Podczas gdy oni
nie realizuj aktywnie skojarzenia, są to pliki używane przez aeipass(1) i
aet(1) w celu określenia, które pliki źródłowe są powiązane z jakimi testami.

Testowanie Korelacja Dokładność
Zakładając, że testowe korelacje są dokładne i że testy są równomierne
rozłożone w przestrzeni funkcjonalnej, będzie mniej niż 1/liczba szansa, że
odpowiedni test nie został przeprowadzony przez „aegis -Test -SUGgest numer" Komenda. Mały
ilość szumu jest dodawana do wagi testu, więc czasami zdarzają się nieoczekiwane rzeczy
przetestowane, a te same testy nie są uruchamiane za każdym razem.

Dokładność korelacji testów można poprawić, zapewniając, że:

· Każda zmiana powinna być mocno skoncentrowana, bez nieuzasadnionych wtrąceń plików. Ten
unika fałszywych korelacji.

· Każdy element nowej funkcjonalności powinien być dodany w indywidualnej zmianie, a nie
kilka razem. To silnie koreluje testy z funkcjonalnością.

· Każdy błąd powinien być naprawiany w ramach indywidualnej zmiany, a nie kilku razem. Ten
silnie koreluje testy z funkcjonalnością.

· Korelacje testowe zostaną utracone, jeśli pliki zostaną przeniesione. Dzieje się tak, ponieważ korelacje są przez
nazwa.

Najlepszym sposobem na dokładne skorelowanie testów z plikami źródłowymi jest zmiana
zawiera test i dokładnie te pliki, które odnoszą się do testowanej funkcjonalności. Także
wiele fałszywych plików osłabi użyteczność korelacji testowych.

METRYKA

Aegis może rejestrować metryki jako część atrybutów pliku zmiany. Ten
umożliwia zapisywanie różnych właściwości plików w celu późniejszej analizy trendów lub innych
używa.

Konkretne metryki nie są dyktowane przez Aegis. Oczekuje się, że integracja
kompilacja utworzy plik metryk dla każdego pliku źródłowego, który zostanie zmieniony. Te metryki
pliki muszą być w formacie określonym przez aemetria(5).

Domyślna nazwa pliku metryk to „filename,S”, jednak może się różnić, o
ustawienie metryka_nazwa_pliku_wzorzec dziedzina projektu config plik. Widzieć aepconf(5)
po więcej informacji.

Jeśli taki plik metryk istnieje, dla każdego pliku źródłowego w zmianie zostanie on odczytany i
zapamiętany w czasie integracyjnym. Jeśli nie istnieje, Aegis zakłada, że ​​nie ma
odpowiednie metryki dla tego pliku i przebiega po cichu; to nie jest błąd.

OPCJE

Rozumie się następujące opcje:

-Zmiana numer
Ta opcja może służyć do określenia konkretnej zmiany w projekcie. Widzieć
egida(1) pełny opis tej opcji.

-Pomoc
Ta opcja może być wykorzystana do uzyskania dodatkowych informacji o tym, jak używać egida
program.

-Lista
Ta opcja może być użyta do uzyskania listy odpowiednich tematów dla tego polecenia.
Lista może być bardziej ogólna niż oczekiwano.

-Nie_logowanie
Ta opcja może być użyta do wyłączenia automatycznego rejestrowania danych wyjściowych i błędów do
plik. Jest to często przydatne, gdy kilka poleceń aegis jest połączonych w powłoce
skrypt.

-Projekt Nazwa
Ta opcja może być wykorzystana do wybrania interesującego Cię projektu. Kiedy nie -Projekt
opcja jest określona, PROJEKT AEGIS konsultowana jest zmienna środowiskowa. Gdyby
który nie istnieje, użytkownika $HOME/.aegisrc plik jest sprawdzany pod kątem wartości domyślnych
pole projektu (patrz aeuconf(5), aby uzyskać więcej informacji). Jeśli to nie istnieje,
gdy użytkownik pracuje tylko nad zmianami w ramach jednego projektu, projekt
domyślna nazwa tego projektu. W przeciwnym razie jest to błąd.

-Powód XNUMX
Ta opcja może służyć do dołączenia komentarza do historii zmian wygenerowanej przez
to polecenie. Będziesz musiał użyć cudzysłowów, aby odizolować przestrzenie od powłoki.

-Lakoniczny
Ta opcja może być używana, aby aukcje generowały minimum
Informacja. Jest to zwykle przydatne w przypadku skryptów powłoki.

-Gadatliwy
Ta opcja może być użyta, aby spowodować, że aegis będzie produkować więcej. Domyślnie egida
generuje dane wyjściowe tylko w przypadku błędów. W przypadku użycia z -Lista opcja ta opcja
powoduje dodanie nagłówków kolumn.

-Czekać Ta opcja może być użyta do zażądania, aby komendy Aegis czekały na blokady dostępu, jeśli:
nie można ich uzyskać natychmiast. Domyślnie do użytkownika preferencje_blokady_oczekiwania
jeśli nie określono, zobacz aeuconf(5), aby uzyskać więcej informacji.

-Nie, czekaj
Ta opcja może być użyta do zażądania, aby polecenia Aegis wyemitowały błąd krytyczny w przypadku dostępu
zamków nie można uzyskać natychmiast. Domyślnie do użytkownika
preferencje_blokady_oczekiwania jeśli nie określono, zobacz aeuconf(5), aby uzyskać więcej informacji.

Zobacz też egida(1) dla opcji wspólnych dla wszystkich komend egidy.

Wszystkie opcje mogą być skrócone; skrót jest dokumentowany jako wielkie litery,
wszystkie małe litery i podkreślenia (_) są opcjonalne. Musisz użyć kolejnego
sekwencje opcjonalnych liter.

Wszystkie opcje nie uwzględniają wielkości liter, można je wpisywać wielkimi lub małymi literami lub a
połączenie obu, przypadek nie jest ważny.

Na przykład: argumenty „-project”, „-PROJ” i „-p” są interpretowane jako
-Projekt opcja. Argument "-prj" nie zostanie zrozumiany, ponieważ konsekutywne
nie podano znaków opcjonalnych.

Opcje i inne argumenty wiersza poleceń mogą być dowolnie mieszane w wierszu poleceń,
po selektorach funkcji.

Długie nazwy opcji GNU są zrozumiałe. Ponieważ wszystkie nazwy opcji dla egida są długie,
oznacza to ignorowanie dodatkowego początkowego „-”. Ten "--opcja=wartość„Konwencja też jest
zrozumiany.

POLECAMY ALIAS

Zalecany alias dla tego polecenia to
csh% alias aeipass 'aegis -ipass \!* -v'
sh$ aeipass(){aegis -ipass "$@" -v}

BŁĘDY

Jest to błąd, jeśli zmiana nie jest przypisana do bieżącego użytkownika.
Jest to błąd, jeśli zmiana nie znajduje się w który jest zintegrowany stan.
To jest błąd, jeśli nie udało się 'egida -Budować' polecenie dla
integracja.
To jest błąd, jeśli nie udało się 'egida -Test' polecenie integracji.
To jest błąd, jeśli nie udało się 'egida -Test -Linia bazowa” polecenie dla
integracja.

EXIT STATUS

egida polecenie zakończy się ze statusem 1 w przypadku każdego błędu. ten egida polecenie będzie tylko
zakończ ze statusem 0, jeśli nie ma błędów.

ŚRODOWISKO ZMIENNE

See egida(1) dla listy zmiennych środowiskowych, które mogą mieć wpływ na to polecenie. Widzieć
aepconf(5) dla pliku konfiguracyjnego projektu specyficzny dla projektu pole jak ustawić
zmienne środowiskowe dla wszystkich poleceń wykonywanych przez Aegis.

Korzystaj z aeipass online, korzystając z usług onworks.net