arposix - Online în cloud

PROGRAM:

NUME

ar — crearea și întreținerea arhivelor bibliotecii

REZUMAT

ar −d [−v] Arhiva fişier...

ar −m [−v] Arhiva fişier...
ar −m −a [−v] posname Arhiva fişier...
ar −m −b [−v] posname Arhiva fişier...
ar −m −i [−v] posname Arhiva fişier...

ar −p [−v] [−s] Arhiva [fişier...]

ar −q [−cv] Arhiva fişier...

ar −r [−cuv] Arhiva fişier...

ar −r −a [−cuv] posname Arhiva fişier...
ar −r −b [−cuv] posname Arhiva fişier...
ar −r −i [−cuv] posname Arhiva fişier...

ar −t [−v] [−s] Arhiva [fişier...]

ar -x [−v] [−sCT] Arhiva [fişier...]

DESCRIERE

ar utilitarul face parte din opțiunea Software Development Utilities.

ar utilitarul poate fi folosit pentru a crea și menține grupuri de fișiere combinate într-un
Arhiva. Odată ce o arhivă a fost creată, se pot adăuga fișiere noi și pot fi adăugate fișiere existente
o arhivă poate fi extrasă, ștearsă sau înlocuită. Când o arhivă este formată în întregime din
fișiere obiect valide, implementarea va formata arhiva astfel încât să fie utilizabilă ca a
bibliotecă pentru editarea linkurilor (vezi c99 și fort77). Când unele dintre fișierele arhivate nu sunt
fișiere obiect valide, adecvarea arhivei pentru utilizarea bibliotecii este nedefinită. Daca un
arhiva constă în întregime din fișiere imprimabile, întreaga arhivă va fi imprimabilă.

Cand ar creează o arhivă, creează informații administrative care indică dacă a
tabelul de simboluri este prezent în arhivă. Când există cel puțin un fișier obiect care ar
recunoaște ca atare în arhivă, în arhivă va fi creat un tabel cu simboluri de arhivă
și întreținut de ar; este folosit de editorul de linkuri pentru a căuta în arhivă. Ori de câte ori ar
utilitarul este folosit pentru a crea sau actualiza conținutul unei astfel de arhive, tabelul de simboluri
va fi reconstruit. The −s opțiunea va forța reconstruirea tabelului de simboluri.

TOATE fişier operanzii pot fi nume de căi. Cu toate acestea, fișierele din arhive vor fi denumite de a
nume de fișier, care este ultima componentă a căii utilizată când a fost introdus fișierul
arhiva. Comparația dintre fişier operanzi la numele fișierelor din arhive trebuie să fie
efectuată prin compararea ultimei componente a operandului cu numele fișierului din fișierul
Arhiva.

Nu este specificat dacă mai multe fișiere din arhivă pot fi numite identic. În
cazul unor astfel de dosare, totuși, fiecare fişier și posname operandul trebuie să se potrivească numai cu primul fișier
în arhivă având un nume care este același cu ultima componentă a operandului.

OPŢIUNI

ar utilitatea trebuie să se conformeze volumului Definiții de bază din POSIX.1-2008, Secțiune 12.2,
Utilitate Sintaxă Instrucțiuni, cu excepția Ghidului 9.

Următoarele opțiuni vor fi acceptate:

−a Poziționați fișierele noi în arhivă după fișierul numit de posname operand.

−b Poziționați fișierele noi în arhivă înaintea fișierului numit de posname operand.

−c Suprimați mesajul de diagnosticare care este scris în eroare standard în mod implicit
când arhiva Arhiva este creat.

−C Împiedicați fișierele extrase să înlocuiască fișierele cu nume similar în sistemul de fișiere. Acest
opțiunea este utilă când −T este de asemenea folosit, pentru a preveni trunchierea numelor de fișiere
înlocuirea fișierelor cu același prefix.

−d Ștergeți unul sau mai multe fişierde la Arhiva.

−i Poziționați fișierele noi în arhivă înaintea fișierului din arhiva numită de
posname operand (echivalent cu −b).

−m Mutați fișierele numite în arhivă. The −a, −b, −i opțiuni cu posname
operandul indică poziția; în caz contrar, mutați fișierele cu nume din arhivă în
sfârşitul arhivei.

−p Scrieți conținutul fişiers în arhiva numită de fişier operanzi din
Arhiva la ieșirea standard. Daca nu fişier operanzii sunt specificati, continutul
a tuturor dosarelor din arhivă se scrie în ordinea arhivei.

−q Adăugați fișierele numite la sfârșitul arhivei. În acest caz ar nu verifică
dacă fișierele adăugate sunt deja în arhivă. Acest lucru este util pentru ocolire
căutarea se face altfel la crearea unei arhive mari bucată cu bucată.

−r Înlocuiți sau adăugați fişiers Arhiva. Dacă arhiva numită de Arhiva nu
există, va fi creată o nouă arhivă și va fi scris un mesaj de diagnosticare
la eroare standard (cu excepția cazului în care −c este specificată opțiunea). Daca nu fişiersunt specificate
si Arhiva există, rezultatele sunt nedefinite. Fișiere care înlocuiesc cele existente
fișierele din arhivă nu vor modifica ordinea arhivei. Fișiere care fac
care nu înlocuiesc fișierele existente în arhivă vor fi anexate la arhivă
cu excepția cazului în care a −a, −b, −i opțiunea specifică o altă poziție.

−s Forțați regenerarea tabelului de simboluri de arhivă chiar dacă ar nu este invocată
cu o opțiune care modifică conținutul arhivei. Această opțiune este utilă pentru
restaurați tabelul de simboluri de arhivă după ce a fost eliminat; vedea strip.

−t Scrieți un cuprins al Arhiva la ieșirea standard. Doar fișierele
specificate de fişier operanzii vor fi incluși în lista scrisă. Daca nu fişier
operanzii sunt specificați, toate fișierele în Arhiva vor fi incluse în ordinea de
arhiva.

−T Permite trunchierea numelui fișierelor extrase ale căror nume de arhivă sunt mai lungi decât
sistemul de fișiere poate suporta. În mod implicit, extragerea unui fișier cu un nume care este
prea lung va fi o eroare; se scrie un mesaj de diagnosticare și fișierul
nu vor fi extrase.

−u Actualizați fișierele mai vechi din arhivă. Când este utilizat cu −r opțiunea, fișierele din
arhiva va fi înlocuită numai dacă este corespunzătoare fişier are un timp de modificare
care este cel puțin la fel de nou ca ora de modificare a fișierului din arhivă.

−v Oferiți rezultate detaliate. Când este utilizat cu caracterele opțiuni −d, −r, −x, scrie o
descrierea detaliată fișier cu fișier a creării și întreținerii arhivei
activitate, așa cum este descris în secțiunea STDOUT.

Când este utilizat cu −p, scrieți numele fișierului din arhivă la standard
ieșire înainte de a scrie fișierul în arhivă în sine la ieșirea standard, ca
descrise în secțiunea STDOUT.

Când este utilizat cu −t, includeți o listă lungă de informații despre fișierele din
arhivă, așa cum este descris în secțiunea STDOUT.

−x Extrageți fișierele din arhiva numită de fişier operanzi din Arhiva.
conținutul arhivei nu va fi modificat. Daca nu fişier operanzii sunt dați, toți
se extrag fișierele din arhivă. Ora de modificare a fiecărui fișier
extras va fi setat la momentul extragerii fișierului din arhivă.

OPERANDE

Următorii operanzi vor fi acceptați:

Arhiva Un nume de cale al arhivei.

fişier Un nume de cale. Numai ultima componentă va fi utilizată atunci când se compară cu
numele fișierelor din arhivă. Dacă două sau mai multe fişier operanzii au același ultimul
componentă pathname (nume de bază), rezultatele sunt nespecificate. Implementarea lui
formatul de arhivă nu va trunchia numele de fișiere valide ale fișierelor adăugate sau înlocuite
în arhivă.

posname Numele unui fișier din arhivă, folosit pentru poziționarea relativă; vezi optiunile −m
și −r.

Stdin

Nefolosit.

INTRARE DOSARE

Arhiva numită de Arhiva va fi un fișier în formatul creat de ar −r.

MEDIUL VARIABILE

Următoarele variabile de mediu vor afecta execuția ar:

LIMBA Furnizați o valoare implicită pentru variabilele de internaționalizare care sunt nesetate sau
nul. (A se vedea volumul Definiții de bază din POSIX.1‐2008, Secțiune 8.2,
Internaționalizare Variabile pentru prioritatea internaţionalizării
variabile utilizate pentru a determina valorile categoriilor locale.)

LC_ALL Dacă este setată la o valoare șir nevid, suprascrieți valorile tuturor celorlalte
variabile de internaţionalizare.

LC_CTYPE Determinați locația pentru interpretarea secvențelor de octeți de date text
ca caractere (de exemplu, caractere pe un singur octet, spre deosebire de caractere pe mai mulți octeți în
argumente și fișiere de intrare).

LC_MESSAGES
Determinați locația care ar trebui utilizată pentru a afecta formatul și conținutul
mesaje de diagnostic scrise la eroare standard.

LC_TIME Determinați formatul și conținutul șirurilor de dată și oră scrise de ar −tv.

NLSPATH Determinați locația cataloagelor de mesaje pentru procesarea LC_MESSAGES.

TMPDIR Determinați calea care înlocuiește directorul implicit pentru fișierele temporare,
dacă există.

TZ Determinați fusul orar folosit pentru a calcula șirurile de dată și oră scrise de ar
−tv. Dacă TZ este nesetat sau nul, va fi utilizat un fus orar implicit nespecificat.

ASINCRON EVENIMENTE

Implicit.

Stdout

În cazul în care −d opțiunea este utilizată cu −v opțiunea, formatul standard de ieșire va fi:

"d - %s\n", <fişier>

Unde fişier este operandul specificat pe linia de comandă.

În cazul în care −p opțiunea este utilizată cu −v opțiune, ar va precede conținutul fiecărui fișier
cu:

„\n<%s>\n\n”, <fişier>

Unde fişier este operandul specificat pe linia de comandă, dacă fişier au fost specificați operanzi,
și numele fișierului din arhivă dacă nu erau.

În cazul în care −r opțiunea este utilizată cu −v opţiune:

* Dacă fişier este deja în arhivă, formatul standard de ieșire va fi:

"r - %s\n", <fişier>

Undefişier> este operandul specificat pe linia de comandă.

* Dacă fişier nu este deja în arhivă, formatul standard de ieșire va fi:

"a - %s\n", <fişier>

Undefişier> este operandul specificat pe linia de comandă.

În cazul în care −t este folosită opțiunea, ar va scrie numele fișierelor din arhivă la
ieșire standard în formatul:

„%s\n”, <fişier>

Unde fişier este operandul specificat pe linia de comandă, dacă fişier au fost specificați operanzi,
sau numele fișierului din arhivă dacă nu erau.

În cazul în care −t opțiunea este utilizată cu −v opțiunea, formatul standard de ieșire va fi:

„%s %u/%u %u %s %d %d:%d %d %s\n", <membru mod>,utilizator ID>,
<grup ID>,număr of bytes in membru>,
<abreviat lună>,zi a lunii>,oră>,
<minut>,an>,fişier>

în cazul în care:

<fişier> Va fi operandul specificat pe linia de comandă, dacă fişier operanzii au fost
specificate sau numele fișierului din arhivă dacă nu au fost.

<membru mod>
Va fi formatat la fel ca șifişier mod> șir definit în STDOUT
secțiune de ls, cu excepția faptului că primul personaj, celintrare tip>, nu este folosit;
șirul reprezintă modul de fișier al fișierului din arhivă la momentul respectiv
a fost adăugată sau înlocuită în arhivă.

Următoarele reprezintă ora ultimei modificări a unui fișier când a fost cel mai recent
adăugat sau înlocuit în arhivă:

<abreviat lună>
Echivalent cu formatul %b formatul specificației de conversie în data.

<zi a lunii>
Echivalent cu formatul %e formatul specificației de conversie în data.

<oră> Echivalent cu formatul %H formatul specificației de conversie în data.

<minut> Echivalent cu formatul %M formatul specificației de conversie în data.

<an> Echivalent cu formatul %Y formatul specificației de conversie în data.

Cand LC_TIME nu specifică localitatea POSIX, un format și o ordine diferită a
prezentarea acestor câmpuri unul față de celălalt poate fi utilizată într-un format adecvat în
locația specificată.

În cazul în care −x opțiunea este utilizată cu −v opțiunea, formatul standard de ieșire va fi:

"x - %s\n", <fişier>

Unde fişier este operandul specificat pe linia de comandă, dacă fişier au fost specificați operanzi,
sau numele fișierului din arhivă dacă nu erau.

Stderr

Eroarea standard va fi utilizată numai pentru mesajele de diagnosticare. Mesajul de diagnosticare
despre crearea unei noi arhive când −c nu este specificat nu modifică starea de ieșire.

REZULTATE DOSARE

Arhivele sunt fișiere cu formate nespecificate.

EXTENDED DESCRIERE

Nici unul.

EXIT STAREA

Următoarele valori de ieșire vor fi returnate:

0 Finalizare cu succes.

>0 A apărut o eroare.

CONSECINȚE OF ERORI

Implicit.

următor secțiuni sunt informativ.

APLICARE UTILIZARE

Nici unul.

EXEMPLE

Nici unul.

FUNDAMENTARE

Formatul arhivei nu este descris. Se recunoaște că sunt mai multe cunoscute ar
formate care nu sunt compatibile. The ar utilitatea este inclusă, totuși, pentru a permite crearea
de arhive care sunt destinate utilizării numai pe o singură mașină. Arhiva este specificată ca a
fișier și poate fi mutat ca fișier. Acest lucru permite ca o arhivă să fie mutată dintr-una
mașină către o altă mașină care utilizează aceeași implementare a ar.

Utilități precum pax (și strămoșii săi gudron și cpio) oferă, de asemenea, „arhive” portabile.
Aceasta nu este o duplicare; cel ar utilitarul este inclus pentru a oferi în primul rând o interfață
pentru face și compilatorii, pe baza unui model istoric.

În implementările istorice, −q opțiunea (disponibilă pe sistemele compatibile cu XSI) este
cunoscut a executa rapid deoarece ar nu verifică dacă membrii adăugați sunt
deja în arhivă. Acest lucru este util pentru a ocoli căutarea altfel efectuată atunci când
creând o arhivă mare bucată cu bucată. Aceste observații pot, dar nu trebuie să rămână adevărate pentru a
implementare nou-nouță a acestui utilitar; prin urmare, aceste remarci au fost mutate în
RAȚIONARE.

Implementările BSD au necesitat în mod istoric aplicații pentru a oferi −s opțiune oricând
arhiva trebuia să conţină un tabel de simboluri. Ca și în acest volum al POSIX.1‐2008,
System V creează sau actualizează istoric un tabel cu simboluri de arhivă ori de câte ori un fișier obiect
este eliminat din, adăugat sau actualizat în arhivă.

Secțiunea OPERANDE necesită ceea ce ar putea părea adevărat fără a-l specifica: the
arhiva nu poate trunchia numele fișierelor sub {NAME_MAX}. Câteva implementări istorice
faceți acest lucru, totuși, provocând rezultate neașteptate pentru aplicație. Prin urmare, acest volum de
POSIX.1‐2008 explică cerința pentru a evita neînțelegerile.

Conform documentației System V, opțiunile −dmpqrtx nu sunt obligate să înceapă
cu ('-'). Acest volum al POSIX.1‐2008 necesită o aplicație conformă
folosiți liderul .

Formatul de arhivă utilizat de implementarea 4.4 BSD este documentat în prezentul MOTIV ca
un exemplu:

Un fișier creat de ar începe cu șirul ``magic'' „! \n". Restul
arhiva este alcătuită din obiecte, fiecare dintre acestea fiind compus dintr-un antet pentru un fișier, a
posibil nume de fișier și conținutul fișierului. Antetul este portabil între mașină
arhitecturi și, dacă conținutul fișierului este imprimabil, arhiva este însăși
imprimabil.

Antetul este format din șase câmpuri ASCII, urmate de un trailer cu două caractere. The
câmpurile sunt numele obiectului (16 caractere), ora ultimei modificări a fișierului (12
caractere), ID-urile utilizatorului și grupului (fiecare 6 caractere), modul fișier (8
caractere) și dimensiunea fișierului (10 caractere). Toate câmpurile numerice sunt în zecimale,
cu excepția modului fișier, care este în octal.

Ora de modificare este fișierul st_mtime camp. ID-urile utilizatorului și grupului sunt
fişier st_uid și st_gid câmpuri. Modul fișier este fișierul st_mode camp. Fișierul
dimensiunea este fișierul st_size camp. Trailerul de doi octeți este șirul „` ".

Numai câmpul nume are vreo prevedere pentru depășire. Dacă orice nume de fișier este mai mare de 16
caractere în lungime sau conține un spațiu încorporat, șirul "#1/" urmată de
lungimea ASCII a numelui este scrisă în câmpul nume. Dimensiunea fișierului (stocat
în antetul arhivei) este incrementat cu lungimea numelui. Numele este atunci
scris imediat după antetul arhivei.

Orice caracter neutilizat din oricare dintre aceste câmpuri este scris ca personaje. Dacă
orice câmpuri reprezintă numărul lor maxim de caractere în lungime, nu există
separare între câmpuri.

Obiectele din arhivă au întotdeauna un număr par de octeți; fișiere care sunt an
numărul impar de octeți lungi sunt completați cu a , deși dimensiunea în
antetul nu reflectă acest lucru.

ar descrierea utilitarului necesită ca (când toți membrii săi sunt fișiere obiect valide) ar
produce o bibliotecă de coduri obiect, pe care editorul de legături o poate folosi pentru a extrage obiectul
module. Dacă editorul de legături are nevoie de un tabel de simboluri pentru a permite accesul aleatoriu la
Arhiva, ar trebuie să-l furnizeze; in orice caz, ar nu necesită un tabel de simboluri.

BSD-ul −o opțiunea a fost omisă. Este o aplicație conformă rară care utilizează ar a extrage
cod obiect dintr-o bibliotecă cu preocupare pentru timpul de modificare, deoarece acest lucru poate fi doar
de importanță pentru face. Prin urmare, deoarece această funcționalitate nu este considerată importantă pentru
portabilitatea aplicațiilor, timpul de modificare a fișierelor extrase este setat la
ora curentă.

Există cel puțin o implementare cunoscută (pentru un computer mic) care poate găzdui
numai fișiere obiect pentru acel sistem, interzicând obiecte mixte și alte fișiere. Abilitatea
a gestiona orice tip de fișier nu este doar o practică istorică pentru majoritatea implementărilor, ci
este, de asemenea, o așteptare rezonabilă.

S-a luat în considerare modificarea formatului de ieșire al ar −tv în același format ca și
ieșire din ls −l. Acest lucru ar fi făcut analiza ieșirii de ar la fel ca cel al ls.
Acest lucru a fost respins în parte din cauza curentului ar formatul este utilizat în mod obișnuit, iar modificările ar fi
întreruperea utilizării istorice. Al doilea, ar oferă ID-ul utilizatorului și ID-ul grupului în format numeric
separate prin a . Schimbarea acestuia pentru a fi numele de utilizator și numele grupului nu ar fi
corect dacă arhiva a fost mutată pe o mașină care conținea o altă bază de date cu utilizatori.
Întrucât ar nu poate ști dacă arhiva a fost generată pe aceeași mașină, nu poate spune
ce sa raportezi.

Textul de pe −ur combinația de opțiuni este o practică istorică, deoarece un singur nume de fișier poate
reprezentați cu ușurință două fișiere diferite (de exemplu, /a/foo și /b/foo), este rezonabil să
înlocuiți fișierul din arhivă chiar și atunci când timpul de modificare în arhivă este
identic cu cel din sistemul de fișiere.

VIITOR INSTRUCTIUNI

Nici unul.

Utilizați arposix online folosind serviciile onworks.net