ADMIN(P)

NOME
admin - crea e amministra file SCCS (DEVELOPMENT)

SINTASSI

admin -i[name][-n][-a login][-d flag][-e login][-f flag][-m mrlist]
[-r rel][-t[name][-y[comment]] newfile

admin -n[-a login][-d flag][-e login][-f flag][-m mrlist][-t[name]]
[-y[comment]] newfile ...

admin [-a login][-d flag][-m mrlist][-r rel][-t[name]] file ...

admin -h file ...

admin -z file ...

DESCRIZIONE

L'utilità admin crea nuovi file SCCS o cambia i parametri di quelli esistenti. Se un dato file non esiste, deve essere creato, e i suoi parametri devono venire inizializzati in accordo alle opzioni specificate. Ai parametri non inizializzati da un'opzione deve essere assegnato un valore predefinito. Se un dato file esiste, i parametri corrispondenti alle opzioni specificate devono venire cambiati, e gli altri parametri devono essere lasciati come sono.

Tutti i nomi di file SCCS forniti dall'applicazione devono essere nella forma s.filename. Ai nuovi file SCCS deve essere dato il permesso in sola lettura. Per creare un file è richiesto il permesso di scrittura nella directory. Tutte le scritture fatte da admin devono essere a un x-file temporaneo, chiamato x.filename (vedere get ) creato con il permesso in sola lettura se admin sta per creare un nuovo file SCCS, o creato con gli stessi permessi del file SCCS se il file esiste già. Dopo che admin è stato eseguito con successo, il file SCCS deve essere rimosso (se esiste), e il x-file deve essere rinominato con il nome del file SCCS. questo garantisce che i cambiamenti siano fatti al file SCCS solo se non ci sono errori.

L'utilità admin deve anche usare un file di blocco transitorio ( chiamato z.filename), che è usato per impedire aggiornamenti simultanei del file SCCS; vedere get .

OPZIONI

L'utilità admin deve essere conforme al volume Base Definitions di IEEE Std 1003.1-2001, Sezione 12.2, Utility Syntax Guidelines, tranne che le opzioni -i, -t, e -y hanno opzioni-argomenti opzionali. Queste opzioni-argomenti opzionali non devono essere presentate come argomenti separati. Le seguenti opzioni sono supportate:

-n  Crea un nuovo file SCCS. Quando -n è usato senza -i, il file SCCS deve essere creato con informazione di controllo ma senza alcun dato.

-i[name]
    Specifica il nome di un file da cui deve essere preso il testo di un nuovo file SCCS. Il testo costituisce il primo delta del file (vedere l'opzione -r per lo schema di numerazione del delta). Se è usata l'opzione -i, ma l'opzione-argomento name è omessa, il testo deve essere ottenuto dalla leggendo lo standard input. Se questa opzione è omessa, il file SCCS deve essere creato con informazioni di controllo ma senza alcun dato. L'opzione -i implica l'opzione -n .

-r  SID
    Specifica il SID del delta iniziale da inserire. Questo SID deve essere un trunk SID; ovvero, i numeri di ramo e sequenza devono essere zero o mancanti. Il numero di livello è opzionale, e il valore predefinito è 1.

-t[name]
    Specifica il nome di un file da cui deve essere preso il testo descrittivo del file SCCS. In caso di file SCCS esistenti (nè -i nè -n sono specificati):

    *   Un'opzione -t senza un'opzione-argomento name deve causare la rimozione del testo descrittivo (se c'è) attualmente nel file SCCS.

    *   Un'opzione -t con un'opzione-argomento name deve far sì che il testo (se c'è) nel dato file sostituisca il testo descrittivo (se c'è)
         che attualmente è nel file SCCS.

-f  flag
    Specifica un flag, e, possibilmente, un valore per il flag, da mettere nel file SCCS. Possono essere fornite molte opzioni -f su una singola linea di comando admin. Le implementazioni devono riconoscere i seguenti flag e valori associativi:

b
    Permette l'uso dell'opzione -b su un comando get per creare rami delta.

cceil
    Specifica la release più alta (cioè, soffitto), un numero inferiore o uguale a 9999, che può essere trovata da un comando get per l'editing. Il valore di default per un flag c non specificato deve essere 9999.

ffloor
    Specifica la più bassa release (cioè, pavimento), un numero maggiore di 0 ma minore di 9999, che può essere trovata da un comando get per l'editing. Il valore di default per un flag c non specificato deve essere 1.

dSID
    Specifica il numero delta di default (SID) da usare per un comando get .

istr
    Tratta il messaggio "No ID keywords" emesso da get o delta come errore fatale. In assenza di questo flag, il messaggio è solo un avviso. Il messaggio è emesso se non vengono trovate parole chiave identificative dell'SCCS nel testo trovato o archiviato nel file SCCS (vedere get). Se è fornito un valore, l'applicazione deve assicurarsi che le parole chiave corrispondano esattamente alla stringa data; tuttavia, la stringa deve contenere una arola chiave, e nessuna <newline>.

j
    Permette comandi get concorrenti per editare lo stesso SID di un file SCCS. Questo permette aggiornamenti multipli concorrenti alla stessa versione del file SCCS.

llist
    Specifica un elenco di release da cui non si puossono più fare delta (ovvero, get -e su una di queste release bloccate fallisce). Le appplicazioni conformi devono usare la seguente sintassi per specificare un elenco. Le implementazioni possono accettare forme aggiuntive come estensioni:

        <list> ::= a | <range-list>
        <range-list> ::= <range> | <range-list>, <range>
        <range> ::= <SID>

    Il carattere a nell'elenco deve essere equivalente per specificare tutte le release del dato file SCCS. Il non-terminal <SID> nel range deve essere il numero delta di un delta esistente associato al file SCCS.

n
    Fa sì che delta crei un delta null in ciascuna delle release (se ce ne sono) che vengono saltate quando viene fatto un delta in una nuova release (per esempio, facendo delta 5.1 dopo delta 2.7, le release 3 e 4 sono saltate). Questi delta nulli devono servire come punti di ancoraggio, così che in seguito da essi possano essere creati delle ramificazioni delta. L' assenza di questo flag deve far sì che le release saltate non esistano nel file SCCS, impedendo la creazione di ramificazioni da esse in futuro. Durante la creazione iniziale di un file SCCS, il flag n deve essere ignorato; ciò significa che se l'opzione -r è usata per impostare il numero di release del SID iniziale a un valore maggiore di 1, i delta nulli non necessitano di essere creati per le release " saltate".

qtext
    Sistituisce il testo definibile dall'utente per tutte le occorrenze della parola chiave %Q% nel file di testo SCCS trovato da get.

mmod
    Specifica il nome del modulo del file SCCS sostituito per tutte le occorrenze della parola chiave %M% nel file di testo SCCS trovato da get. se il flag m non è specificato, il valore assegnato deve essere il nome del file SCCS con il '.' iniziale rimosso.

ttype
    Specifica il tipo di modulo nel file SCCS sostituito per tutte le occorrenze della parola chiave %Y% nel file di testo SCCS trovato da get.

vpgm
    Fa sì che delta attenda i numeri della modifica richiesta (MR) come ragione per creare un delta. Il valore opzionale specifica il nome di un numero MR di validazione del programma (se questo flag è impostato quando si crea un file SCCS, l'applicazione deve assicurare che anche l'opzione m sia usata, anche se il suo valore è nullo).

-d  flag
    Rimuove (delete) il flag specificato da un file SCCS. Molte opzioni -d possono essere fornite in un singolo comando admin . Vedere l'opzione -f per i nomi di flag permessi (il flag l list fornisce un elenco di release da sbloccare. Si veda l'opzione -f per un'ulteriore descrizione del flag l e della sintassi di un elenco.)

-a  login
    Specifica un nome di login, o un ID numerico di gruppo, da aggiungere all'elenco degli utenti che possono fare dei delta ( cambiamenti) al file SCCS. Un ID di gruppo deve essere equivalente a specificare tutti i nomi di login comuni a questo ID di gruppo. Numerose opzioni -a possono essere usate in una singola linea di comando admin. Nell'elenco si possono trovare tutti i logins, o ID numerici di grupo, che si desiderano contemporaneamente. Se l'elenco utenti è vuoto, allora chiunque può aggiungere dei delta. Se il login o l'ID di gruppo, è preceduto da '!' , agli utenti così specificati deve essere negato il permesso di fare dei delta.

-e  login
    Specifica un nome di login, o ID numerico di gruppo, da cancellare dall'elenco di utenti a cui è permesso di fare dei delta (cambiamenti) al file SCCS. Specificare un ID di gruppo è equivalente a specificare tutti i nomi di login comuni a questo ID di gruppo. Numerose opzioni -e possono essere usate in una singola linea di comando admin .

-y[comment]
    Inserisce il testo di commento nel file SCCS come commento per il delta iniziale in un modo identico a quello del delta. Nella localizzazione POSIX l'omissione dell'opzione -y deve risultare in una linea di commento di default inserita nella forma:

    "date and time created %s %s by %s", <data>, <ora>, <login>

dove <data> è espressa nel formato delle specifiche di conversione %y / %m / %d delle utilità di date , <ora> nel formato delle specifiche di conversione %T del'utilità date e <login> è il nome di login dell'utente che crea il file.

-m  mrlist
    Inserisce l'elenco dei numeri di modifica richiesti (MR) nel file SCCS come ragione per creare il delta iniziale in un modo identico a delta. L'applicazione deve assicurare che il flag v sia impostato e che i numeri MR siano validati se il flag v ha un valore (il nome di un numero MR di validazione del programma). Un messaggio di diagnostica deve essere scritto se il flag v non è impostato o se la validazione MR fallisce.

-h  Verifica la struttura del file SCCS e confronta il nuovo calcolo del checksum con il checksum che è archiviato nel file SCCS. Se il nuovo calcolo del checksum non corrisponde al checksum nel file SCCS, deve essere scritto un messaggio di diagnostica.

-z  Ricalcola il checksum del file SCCS e lo archivia nella prima linea del file SCCS (vedere l'opzione -h in precedenza). Notare che l'uso di questa opzione in un file realmente corrotto può impedire future individuazione della corruzione del file.

OPERANDI

Devono essere supportati i seguenti operandi:

file
    Un percorso di un file o directory SCCS esistente. Se file è una directory, l'utilità admin deve comportarsi come se ciascun file nella directory fosse specificato come file dato, tranne per i file non-SCCS (l'ultimo componente del percorso non deve iniziare con s.) e i file non leggibili, che devono essere silenziosamente ignorati.

newfile
    Il percorso del file SCCS da creare.

Se appare esattamente uno degli operandi file o newfile ed è, '-' , deve essere letto lo standard input; ciascuna linea dello standard input deve essere considerata il nome di un file SCCS da processare. I file non-SCCS e quelli non leggibili devono essere silenziosamente ignorati.

STDIN

Lo standard input deve essere un file di testo usato solo se è specificato -i senza un'opzione-argomento, o se un operando file o newfile è specificato come '-' . se il primo carattere di una linea di standard input line è <SOH> nella localizzazione POSIX, i risultati sono non specificati.

FILE DI INPUT

I file SCCS esistenti devono essere file di testo di un formato non specificato.

L'applicazione deve assicurare che il file chiamato dalle opzioni dell' opzion-argomento -i di name deve essere un file di testo; se il primo carattere di qualunque linea è <SOH> nella localizzazione POSIX i risultati sono non specificati. se questo file contiene più di 9999 linee, il numero di linee registrate nell'header per questo file deve essere 99999 per questo delta.

VARIABILI D'AMBIENTE

Le seguenti variabili d'ambiente devono influenzare l'esecuzione di admin:

LANG
    Fornisce un valore predefinito per le variabili di internazionalilzzazione che sono non impostate o nulle. (Vedere il volume Base Definitions volume di IEEE Std 1003.1-2001, Sezione 8.2, Internationalization Variables per la precedenza delle variabili di internazionalizzazione usate per determinare il valore delle categorie di localizzazione).

LC_ALL
    Se impostato a un valore di stringa non vuoto sovrascrive i valori di tutte le altre variabili di internazionalizzazione.

LC_CTYPE
    Determina la localizzazione per l'interpretazine delle sequenze di byte di dati di testo come caratteri (per esempio, caratteri singolo byte o caratteri multi-byte in argomenti e file di input).

LC_MESSAGES
    Determina la localizzazione che deve essere usata per influenzare formato e contenuti dei messaggi di diagnostica scritti sullo standard error.

NLSPATH
    Determina la locazione dei cataloghi di messaggi per il processamento di LC_MESSAGES.

EVENTI ASINCRONI

Default.

STDOUT

Non usato.

STDERR

Lo standard error deve essere usato solo per i messaggi di diagnostica.

FILE DI OUTPUT

Tutti i file SCCS creati devono essere file di testo di un formato non specificato. Durante il processamento di un file, un z-file bloccante, come descritto in get , deve essere creato e cancellato.

DESCRIZIONE ESTESA

Vuoto.

STATO DI USCITA

Devono essere restituiti in uscita i seguenti valori:

0   Completamento avvenuto.

>0  C'è stato un errore.

CONSEGUENZE DEGLI ERRORI

Default.

Le seguenti sezioni sono informative.

USO DELL'APPLICAZIONE

Si raccomanda che le directory contenenti file SCCS siano scrivibili solo dal proprietario, e che gli stessi file SCCS siano in sola lettura. I permessi delle directory devono permettere solo al proprietario di modificare i file SCCS contenuti nelle directory. I permessi dei file SCCS impediscono qualunque modifica tranne che dai comandi SCCS.

ESEMPI

Vuoto.

LOGICA

Vuoto.

DIREZIONI FUTURE

Vuoto.

VEDERE ANCHE

delta , get , prs , what

COPYRIGHT
Portions of this text are reprinted and reproduced in electronic form from IEEE Std 1003.1, 2003 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2003 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between this version and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html .