adminposix — online w chmurze

PROGRAM:

IMIĘ

admin — twórz i administruj plikami SCCS (ROZWÓJ)

STRESZCZENIE

administrator -i[Nazwa] [−rz] [-a Zaloguj Się] [-d flaga] [-tj Zaloguj Się] [−f flaga]
[−m mrlista] [−r rel] [−t[Nazwa] [-y[komentarz]] nowy plik

administrator -n [-a Zaloguj Się] [-d flaga] [-tj Zaloguj Się] [−f flaga] [−m mrlista]
[−t[Nazwa]] [-y[komentarz]] nowy plik...

Admin [-a Zaloguj Się] [-d flaga] [−m mrlista] [−r rel] [−t[Nazwa]] filet...

administrator - godz filet...

administrator -z filet...

OPIS

Połączenia Admin narzędzie utworzy nowe pliki SCCS lub zmieni parametry istniejących. Jeśli
podany plik nie istnieje, zostanie utworzony, a jego parametry zostaną zainicjowane
zgodnie z podanymi opcjami. Parametry nie zainicjowane przez opcję powinny być
przypisano wartość domyślną. Jeśli nazwany plik istnieje, parametry odpowiadające
określone opcje należy zmienić, a pozostałe parametry pozostawić bez zmian.

Wszystkie nazwy plików SCCS dostarczane przez aplikację mają postać s.filename. Nowy SCCS
pliki otrzymują tryb uprawnień tylko do odczytu. Uprawnienia do zapisu w katalogu nadrzędnym
jest wymagany do utworzenia pliku. Wszystkie napisy wykonane przez Admin będzie tymczasowy plik x,
o nazwie x.filename (Patrz otrzymać) utworzony w trybie tylko do odczytu if Admin tworzy nowy SCCS
plik lub utworzony w tym samym trybie, co plik SCCS, jeśli plik już istnieje.
Po pomyślnym wykonaniu Admin, plik SCCS zostanie usunięty (jeśli istnieje), oraz
dotychczasowy plik x zostanie przemianowana na nazwę pliku SCCS. To gwarantuje, że zmiany są
do pliku SCCS tylko wtedy, gdy nie wystąpią żadne błędy.

Połączenia Admin narzędzie będzie również używać tymczasowego pliku blokady (o nazwie z.filename), który jest używany
aby zapobiec równoczesnym aktualizacjom pliku SCCS; Widzieć otrzymać.

OPCJE

Połączenia Admin narzędzie powinno być zgodne z woluminem Base Definitions POSIX.1-2008, Sekcja
12.2, Użyteczność Składnia Wytyczne, z wyjątkiem tego, że -tj, −t, -y opcje mają opcjonalne
argumenty opcji. Tych opcjonalnych argumentów-opcji nie należy przedstawiać oddzielnie
argumenty. Obsługiwane są następujące opcje:

−rz Utwórz nowy plik SCCS. Gdy −rz jest używany bez -tj, plik SCCS powinien być
utworzone z informacjami kontrolnymi, ale bez żadnych danych pliku.

−i[Nazwa] Określ Nazwa pliku, z którego ma pochodzić tekst dla nowego pliku SCCS
zajęty. Tekst stanowi pierwszą deltę pliku (zob −r opcja
schemat numeracji delta). jeśli -tj opcja jest używana, ale Nazwa opcja-
argument zostanie pominięty, tekst uzyskamy poprzez wczytanie standardowego wejścia.
W przypadku pominięcia tej opcji plik SCCS zostanie utworzony z kontrolą
informacji, ale bez danych pliku. The -tj opcja implikuje −rz opcja.

−r SID Określ identyfikator SID początkowej delty do wstawienia. Ten identyfikator SID będzie łączem głównym
identyfikator SID; to znaczy numery rozgałęzień i sekwencyjne powinny być zerowe lub ich brakować. The
numer poziomu jest opcjonalny i domyślnie wynosi 1.

−t[Nazwa] Określ Nazwa pliku, z którego pochodzi tekst opisowy pliku SCCS
być zajętym. W przypadku istniejących plików SCCS (ani -tj ani −rz jest specyficzne):

* −t opcja bez Nazwa argument-opcja spowoduje usunięcie
tekst opisowy (jeśli istnieje) znajdujący się obecnie w pliku SCCS.

* −t opcja z A Nazwa opcja-argument spowoduje, że tekst (jeśli istnieje) w pliku
nazwany plik, aby zastąpić tekst opisowy (jeśli istnieje) znajdujący się obecnie w SCCS
plik.

−f flaga Określ plik flagai ewentualnie wartość dla flaga, do umieszczenia w SCCS
plik. Kilka −f opcje mogą być dostarczane w jednym Admin wiersz poleceń.
Implementacje będą rozpoznawać następujące flagi i powiązane wartości:

b Zezwalaj na korzystanie z −b opcja na a otrzymać polecenie tworzenia delt gałęzi.

cstropować Określ najwyższe zwolnienie (tj. pułap), liczbę mniejszą niż lub
równy 9999, który może być pobrany przez a otrzymać polecenie do edycji. The
wartość domyślna dla nieokreślonego c flagą jest 9999.

fpiętro Podaj najniższe zwolnienie (czyli piętro), liczbę większą od 0 ale
mniej niż 9999, które mogą być odzyskane przez a otrzymać polecenie do edycji. The
wartość domyślna dla nieokreślonego f flagą jest 1.

dSID Określ domyślny numer delta (SID), który ma być używany przez a otrzymać dowództwo.

istr Traktuj komunikat ``Brak słów kluczowych'' wysłany przez otrzymać or delta jako fatalny
błąd. W przypadku braku tej flagi komunikat jest tylko ostrzeżeniem. The
komunikat jest wydawany, jeśli nie ma słów kluczowych identyfikacyjnych SCCS (patrz otrzymać) są znalezione
w tekście pobranym lub przechowywanym w pliku SCCS. Jeśli wartość jest
dostarczone, aplikacja zapewni dokładne dopasowanie słów kluczowych
podany ciąg; jednak ciąg powinien zawierać słowo kluczowe i nie
osadzony postacie.

j Zezwalaj na współbieżność otrzymać polecenia do edycji na tym samym identyfikatorze SID SCCS
plik. Pozwala to na wiele jednoczesnych aktualizacji tej samej wersji programu
plik SCCS.

lpodstęp Określ plik podstęp wydań, do których nie można już tworzyć delt (tj
jest, otrzymać -tj przeciwko jednej z tych zablokowanych wersji nie powiedzie się). zgodny
aplikacje będą używać następującej składni, aby określić a podstęp.
Implementacje mogą akceptować dodatkowe formularze jako rozszerzenie:

::= a |
::= | ,
::=

Postać a podstęp będzie równoznaczne z wyszczególnieniem wszystkich
wydania dla nazwanego pliku SCCS. NieterminalnySID> w zasięgu
być numerem delta istniejącej delty powiązanej z plikiem SCCS.

n Spowodować delta aby utworzyć zerową deltę w każdym z tych wydań (jeśli istnieje)
jest pomijany, gdy w nowej wersji jest tworzona różnica (na przykład w
tworzenie delty 5.1 po delcie 2.7, wydania 3 i 4 są pomijane). Te
delty zerowe będą służyć jako punkty kontrolne, tak aby delty rozgałęzione mogły później
z nich powstać. Brak tej flagi powoduje pominięcie
wydania nie istnieją w pliku SCCS, zapobiegając deltom gałęzi
przed powstaniem z nich w przyszłości. Podczas początkowego tworzenia
pliku SCCS, n flagę można zignorować; to znaczy, jeśli −r Jest opcja
używany do ustawienia numeru wersji początkowego identyfikatora SID na większą wartość
niż 1, nie trzeba tworzyć delt zerowych dla wydań ``pominiętych''.

qXNUMX Zastępstwo definiowane przez użytkownika XNUMX dla wszystkich wystąpień %Q% słowa kluczowego w
tekst pliku SCCS pobrany przez otrzymać.

mmod Określ nazwę modułu pliku SCCS podstawionego dla wszystkich wystąpień
%M% słowo kluczowe w tekście pliku SCCS pobranym przez otrzymać, Jeśli m
flaga nie jest określona, ​​wartością przypisaną jest nazwa SCCS
plik z wiodącym '.' oddalony.

trodzaj Określ rodzaj modułu w pliku SCCS zastąpiony przez wszystkie
wystąpienia %Y% słowo kluczowe w tekście pliku SCCS pobranym przez otrzymać.

vPgm Spowodować delta monit o podanie numerów żądań modyfikacji (MR) jako
powód tworzenia delty. Opcjonalna wartość określa nazwę pliku
Program walidacji numeru MR. (Jeśli ta flaga jest ustawiona podczas tworzenia pliku SCCS
plik, wniosek zapewnia, że m opcja jest również używana nawet
jeśli jego wartość jest zerowa).

-d flaga Usuń (skasuj) określony flaga z pliku SCCS. Kilka -d opcje mogą być
dostarczane na jedynce Admin Komenda. Zobacz −f opcja dopuszczalna flaga nazwy.
( lpodstęp flaga daje podstęp wersji do odblokowania. Zobacz −f opcja
dalszy opis dot l flaga i składnia a podstęp.)

-a Zaloguj Się Określ plik Zaloguj Się nazwę lub numeryczny identyfikator grupy, który ma zostać dodany do listy użytkowników
kto może dokonywać delt (zmian) w pliku SCCS. Identyfikator grupy jest równoważny
do określenia wszystkich Zaloguj Się nazwy wspólne dla tego identyfikatora grupy. Kilka -a opcje mogą być
używany na jedynce Admin wiersz poleceń. Tak dużo Zaloguj Sięs lub numeryczne identyfikatory grup, as
pożądane mogą znajdować się na liście jednocześnie. Jeśli lista użytkowników jest pusta, to
każdy może dodać delty. Jeśli Zaloguj Się lub identyfikator grupy jest poprzedzony przez a '!', użytkownicy tak
określonych, odmawia się pozwolenia na tworzenie delt.

-tj Zaloguj Się Określ plik Zaloguj Się nazwę lub numeryczny identyfikator grupy, który ma zostać usunięty z listy użytkowników
zezwolono na dokonywanie delt (zmian) w pliku SCCS. Określenie identyfikatora grupy to
równoważne określeniu wszystkich Zaloguj Się nazwy wspólne dla tego identyfikatora grupy. Kilka -tj
opcji można użyć na jednym Admin wiersz poleceń.

−y[komentarz]
Wstaw znak komentarz tekst do pliku SCCS jako komentarz do początkowej delty
sposób identyczny jak np delta. W ustawieniach narodowych POSIX pominięcie -y
spowoduje wstawienie domyślnej linii komentarza w postaci:

"data i czas stworzony %s %s by %S", <dane>,czas>,Zaloguj Się>

gdziedane> wyraża się w formacie dane użytkowe %y/%m/%d
specyfikacja konwersji,czas> w formacie dane użytkowe %T
format specyfikacji konwersji orazZaloguj Się> to nazwa logowania użytkownika
tworzenie pliku.

−m mrlista Wstaw listę numerów wniosków o modyfikację (MR) do pliku SCCS jako
powód tworzenia początkowej delty w sposób identyczny jak delta,
wniosek zapewnia, że v flaga jest ustawiona, a numery MR są zatwierdzane
Jeśli v flag ma wartość (nazwa programu sprawdzającego numer MR). A
komunikat diagnostyczny zostanie napisany, jeśli v flaga nie jest ustawiona lub walidacja MR
zawiedzie.

-h Sprawdź strukturę pliku SCCS i porównaj nowo obliczoną sumę kontrolną
z sumą kontrolną zapisaną w pliku SCCS. Jeśli nowo obliczony
suma kontrolna nie pasuje do sumy kontrolnej w pliku SCCS, komunikat diagnostyczny
zostanie napisane.

−z Ponownie oblicz sumę kontrolną pliku SCCS i zapisz ją w pierwszym wierszu pliku SCCS
(Patrz -h opcja powyżej). Zauważ, że użycie tej opcji na naprawdę uszkodzonym
plik może uniemożliwić wykrycie uszkodzenia w przyszłości.

OPERANDY

Obsługiwane będą następujące argumenty:

filet Ścieżka do istniejącego pliku SCCS lub katalogu. Gdyby filet jest katalogiem,
Admin narzędzie powinno zachowywać się tak, jakby każdy plik w katalogu był określony
jako nazwany plik, z wyjątkiem plików innych niż SCCS (ostatni składnik ścieżki
nie zaczynaj się od s.) i nieczytelne pliki zostaną po cichu zignorowane.

nowy plik Ścieżka do pliku SCCS, który ma zostać utworzony.

Jeśli dokładnie jeden filet or nowy plik pojawia się operand i jest '-', standardowe dane wejściowe to
Czytać; każda linia standardowego wejścia będzie traktowana jako nazwa pliku SCCS, który ma być
obrobiony. Pliki inne niż SCCS i pliki nieczytelne będą po cichu ignorowane.

STDIN

Standardowym wejściem jest plik tekstowy używany tylko wtedy, gdy -tj jest określony bez opcji-
argument lub jeśli a filet or nowy plik operand jest określony jako '-'. Jeśli pierwszy znak
dowolna standardowa linia wejściowa jest w ustawieniach narodowych POSIX wyniki są nieokreślone.

WEJŚCIE AKTA

Istniejące pliki SCCS będą plikami tekstowymi o nieokreślonym formacie.

Aplikacja zapewnia, że ​​plik nazwany przez -tj opcja Nazwa opcja-argument
będzie plikiem tekstowym; jeśli pierwszym znakiem dowolnego wiersza w tym pliku jest w
Ustawienia regionalne POSIX, wyniki są nieokreślone. Jeśli ten plik zawiera więcej niż 99999 wierszy,
liczba wierszy zapisanych w nagłówku tego pliku wynosi 99999 dla tej delty.

ŚRODOWISKO ZMIENNE

Następujące zmienne środowiskowe mają wpływ na wykonanie Admin:

JĘZYK Podaj wartość domyślną dla zmiennych internacjonalizacji, które nie są ustawione lub
zero. (Patrz tom Definicje podstawowe POSIX.1‐2008, Sekcja 8.2,
Umiędzynarodowienie Zmienne o pierwszeństwo internacjonalizacji
zmienne używane do określania wartości kategorii ustawień regionalnych).

LC_ALL Jeśli jest ustawiony na niepustą wartość ciągu, nadpisz wartości wszystkich pozostałych
zmienne internacjonalizacji.

LC_CTYPE Określ lokalizację dla interpretacji sekwencji bajtów danych tekstowych
jako znaki (na przykład jednobajtowe w przeciwieństwie do wielobajtowych znaków w
argumenty i pliki wejściowe).

LC_MESSAGES
Określ ustawienia regionalne, które powinny być używane do wpływania na format i zawartość
komunikaty diagnostyczne zapisywane do błędu standardowego oraz treść pliku default -y
komentarz.

NLSPATH Określ lokalizację katalogów wiadomości do przetwarzania LC_MESSAGES.

ASYNCHRONICZNY WYDARZENIA

Domyślna.

STDOUT

Nieużywany.

STDERR

Błąd standardowy stosuje się tylko do komunikatów diagnostycznych.

WYDAJNOŚĆ AKTA

Wszelkie utworzone pliki SCCS będą plikami tekstowymi o nieokreślonym formacie. Podczas przetwarzania
a filet, zamek plik z, jak opisano w otrzymać, mogą być tworzone i usuwane.

ROZSZERZONY OPIS

Brak.

EXIT STATUS

Zwracane są następujące wartości wyjściowe:

0 Pomyślne zakończenie.

>0 Wystąpił błąd.

KONSEKWENCJE OF BŁĘDY

Domyślna.

Połączenia następujący działy jest informacyjny.

WNIOSEK ZASTOSOWANIE

Zaleca się, aby katalogi zawierające pliki SCCS miały prawo zapisu tylko dla właściciela,
i że same pliki SCCS są tylko do odczytu. Tryb katalogów powinien zezwalać tylko na
właściciela do modyfikacji plików SCCS zawartych w katalogach. Tryb plików SCCS
zapobiega wszelkim modyfikacjom z wyjątkiem poleceń SCCS.

PRZYKŁADY

Brak.

RACJONALNE UZASADNIENIE

Brak.

PRZYSZŁOŚĆ KIERUNKI

Brak.

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