Manpages

NIMI

ar − luo ja muokkaa arkistoja, palauttaa arkistoista.

YLEISKATSAUS

ar [-]{dmpqrtx}[abcilosuvV] [jäsennimi] arkisto tiedostot...

KUVAUS

GNU ar-ohjelma luo ja muokkaa arkistoja ja palauttaa jäsentiedostoja arkistoista. Arkisto on tiedosto, joka pitää sisällään joukon muita tiedostoja muodossa, joka mahdollistaa tiedostojen (jäsenten) noutamisen alkuperäisessä muodossaan.

Alkuperäisten tiedostojen sisältö, oikeudet, aikaleima, omistaja sekä ryhmä säilytetään arkistossa ja ne voidaan palauttaa, kun tiedosto palautetaan arkistosta.

GNU ar voi ylläpitää arkistoja, joiden jäsenten nimet ovat mielivaltaisen pitkiä; kuitenkin, riippuen siitä, kuinka ar on konfiguroitu omassa järjestelmässäsi, jäsenten nimien pituus voi olla rajoitettu (yhteensopivuuden varmistamiseksi muiden ohjelmien arkistoformaatin kanssa). Mikäli tällainen rajoitus on olemassa, se on tyypillisesti 15 merkkiä (tyypillinen a.out-tyyppisissä formaateissa) tai 16 merkkiä (tyypillinen coff-tyyppisissä formaateissa).

ar kuuluu binääri-työkaluohjelmien joukkoon, koska arkistoja käytetään useimmiten kirjastoina, jotka sisältävät yleisesti tarvittavia aliohjelmia.

ar luo indeksin symboleihin, jotka on määritelty uudelleensijoitettavissa objektimoduuleissa, kun käytetään komentorivioptiota ’s’. Kun indeksi on kerran luotu, se päivitetään automaattisesti aina, kun ar tekee muutoksia arkiston sisältöön (paitsi käytettäessä ’q’ -komentorivioptiota päivityksen yhteydessä). Indeksoitu arkisto nopeuttaa kirjaston linkittämistä ja mahdollistaa kirjaston rutiinien keskinäiset kutsut riippumatta niiden järjestyksestä arkistossa.

Voit käyttää komentoa ’nm −s’ tai ’nm −−print−armap’ indeksitaulun listaamiseen. Jos arkistossa ei ole indeksitaulua, se voidaan lisätä jälkeenpäin ranlib -ohjelmalla.

ar vaatii vähintään kaksi argumenttia toimiakseen: yksi kirjain halutun toiminnon kuvaamiseen (sekä mahdollisesti muita kirjaimia määrittelemään optioita), sekä toiminnon kohteena olevan arkiston nimi.

Useimmat toiminnot hyväksyvät lisäksi tiedostoja argumenteiksi määrittelemään toiminnan kohteena olevia tiedostoja.

OPTIOT

GNU ar sallii toimintoa kuvaavan kirjaimen p sekä optioita kuvaavien lippujen mod antamisen missä järjestyksessä tahansa, kunhan ne ovat ensimmäisenä komentoriviargumenttina.

Halutessasi voit aloittaa ensimmäisen komentoriviargumentin viivalla (vähennysmerkki).

p-kirjain kuvaa haluttua toimintoa, ja se voi olla jokin seuraavista, mutta voit käyttää vain yhtä näistä:

d

Poistaa moduuleita arkistosta. Anna poistettavien moduulien nimet tiedostoniminä; arkistoa ei muuteta, jos et anna poistettavia tiedostonimiä.

Jos annat ’v’ -option, ar listaa kaikki arkistosta poistettavat moduulit.

m

Siirrä jäseniä arkiston sisällä.

Järjestys, jossa jäsenet ovat arkistossa, saattaa vaikuttaa ohjelman linkittämiseen kirjaston kanssa, jos symboli on määritelty useammassa kuin yhdessä jäsenessä.

Jos m -toiminnon kanssa ei anneta optioita, kaikki jäsenet, joiden nimet on annettu tiedosto-argumentteina siirretään arkiston loppuun; voit käyttää ’a’, ’b’, tai ’i’ -optiota, jos haluat siirtää jäsenen tarkemmin määriteltyyn paikkaan.

p

Tulosta annetut arkiston jäsenet. Mikäli ’v’ -optio on annettu, jäsenen nimi tulostetaan ennen sen sisällön tulostamista.

Mikäli et määrittele yhtään tiedostoa, kaikki arkiston tiedostot tulostetaan.

q

Pikalisäys; lisää tiedostoja arkiston loppuun tarkistamatta ovatko tiedostot jo arkistossa.

Optiot ’a’, ’b’ ja ’i’ eivät vaikuta tähän toimintoon; uudet jäsenet lisätään aina arkiston loppuun.

Mikäli optio ’v’ annetaan, ar listaa kaikki tiedostot, jotka se lisää arkistoon.

Koska tämän toiminnon on tarkoitus olla mahdollisimman nopea, indeksitaulua ei päivitetä vaikka se olisikin arkistossa olemassa; voit käyttää ’ar s’ tai ranlib -komentoja halutessasi päivittää symbolitaulun.

r

Lisää tiedostoja arkistoon (korvaten arkistossa jo olevat samannimiset jäsenet). Tämä toiminto eroaa toiminnosta ’q’ siten, että arkistosta poistetaan ensin jäsenet , joilla on sama nimi kuin lisättävillä tiedostoilla.

Jos jokin tiedostoniminä annetuista tiedostoista ei ole olemassa, ar tulostaa virheilmoituksen eikä poista arkistosta vastaavannimisiä jäseniä.

Oletusarvoisesti uudet jäsenet lisätään arkiston loppuun. Voit kuitenkin käyttää optioita ’a’, ’b’, tai ’i’ määritelläksesi uuden jäsenen aseman suhteessa toiseen jäseneen.

Optio ’v’ käytettynä tämän toiminnon kanssa aikaansaa jokaisen lisätyn jäsenen nimen tulostuksen, sekä lisäksi kirjaimen ’a’ tai ’r’ kuvaamaan sitä, lisättiinkö (ilman vanhan jäsenen poistamista) vai korvattiinko jäsen.

t

Tulosta taulukko, joka kuvaa arkiston sisältöä tai ne tiedostot, joiden nimet on annettu tiedostoniminä ja jotka ovat olemassa arkistossa. Normaalisti vain jäsenen nimi tulostetaan. Jos haluat nähdä myös tiedoston oikeudet, aikaleiman, omistajan, ryhmän ja koon, voit antaa toiminnolle option ’v’.

Jos et anna yhtään tiedostonnimeä, kaikki arkistossa olevat tiedostot tulostetaan.

Jos arkistossa on useampi kuin yksi samanniminen tiedosto (esim. ’huu’ arkistossa ’haa.a’), ’ar t haa.a huu’ tulostaa vain ensimmäisen löytämänsä tiedoston. Kaikkien samannimisten tiedostojen listaaminen vaatii arkiston täydellisen sisällön tulostamista, esim: ’ar t haa.a’.

x

Palauta jäseniä (nimetty tiedostoniminä) arkistosta. Voit käyttää ’v’ -optiota jos haluat, että ar listaa jokaisen palautettavan tiedoston nimen.

Jos et anna toiminnolle yhtään tiedostoa, kaikki arkistossa olevat tiedostot palautetaan.

Joukko optioita (mod) voi seurata välittömästi (ilman välilyöntiä) toimintoa kuvaavaa kirjainta p. Optioilla voi vaikuttaa toiminnon käyttäytymiseen:

a

Lisää uudet tiedostot olemassaolevan jäsenen jälkeen. Jos käytät optiota a, olemassaolevan arkiston jäsenen nimen on oltava annettu option jäsennimenä, ennen arkiston nimen antamista.

b

Lisää uudet tiedostot ennen olemassaolevaa arkiston jäsentä. Jos käytät optiota b, olemassaolevan arkiston jäsenen nimen on oltava annettu option jäsennimenä, ennen arkiston nimen antamista (sama kuin ’i’).

c

Luo arkisto. Annettu arkisto luodaan aina, jos se ei ole olemassa, kun päivitystoiminto on annettu. Tällöin tulostetaan kuitenkin varoitus ellei sitä tätä optiota käyttämällä ole nimenomaan estetty.

f

Lyhennä nimet arkistossa. ar sallii normaalisti mielivaltaisen pitkät tiedostonnimet. Tämä saattaa kuitenkin aiheuttaa sen, että luodut arkistot eivät ole yhteensopivia joidenkin järjestelmien oman ar-ohjelman kanssa. Jos tämä aiheuttaa ongelmia, f -optiota voidaan käyttää tiedostojen nimien lyhentämiseen niiden arkistoon lisäyksen yhteydessä.

i

Lisää uudet tiedostot ennen olemassaolevaa arkiston jäsentä. Jos käytät optiota b, olemassaolevan arkiston jäsenen nimen on oltava annettu option jäsennimenä, ennen arkiston nimen antamista (sama kuin ’b’).

l

Tämä optio on sallittu yhteensopivuussyistä, mutta sillä ei ole mitään vaikutusta.

o

Säilytä alkuperäiset jäsenten aikaleimat palautuksen yhteydessä. Jos tätä optiota ei anneta, arkistosta palautetut tiedostot saavat aikaleimansa palautushetken mukaan.

s

Kirjoita indeksitaulu arkistoon tai päivitä olemassaoleva taulu vaikka arkistoon ei tehtäisikään muita muutoksia. Tätä optiota voidaan käyttää yksinään tai se voidaan yhdistää johonkin toimintoon. ’ar s’ -komennon suorittaminen arkistolle vastaa toiminnoltaan ’ranlib’ -komentoa.

u

Normaalisti ar r... lisää kaikki annetut tiedostot arkistoon. Jos haluat lisätä vain ne tiedostot, jotka ovat uudempia kuin arkistossa jo olevat samannimiset jäsenet, käytä tätä optiota. ’u’-optio on sallittu vain toiminnon ’r’ (korvaa) kanssa. Erityisesti yhdistelmä ’qu’ ei ole sallittu, koska aikaleimojen tarkistaminen hävittäisi nopeushyödyn ’q’-toiminnosta.

v

Tämä optio aikaansaa sen, että ar tulostaa toimintoon liittyvää lisäinformaatiota. Esimerkiksi monet toiminnot tulostavat käsiteltävät tiedostonimet, kun niitä käytetään yhdessä option ’v’ kanssa.

V

Tämä optio tulostaa ar-ohjelman versionumeron.

COPYING

Copyright (c) 1991 Free Software Foundation, Inc.

Permission is granted to make and distribute verbatim copies of this manual provided the copyright notice and this permission notice are preserved on all copies.

Permission is granted to copy and distribute modified versions of this manual under the conditions for verbatim copying, provided that the entire resulting derived work is distributed under the terms of a permission notice identical to this one.

Permission is granted to copy and distribute translations of this manual into another language, under the above conditions for modified versions, except that this permission notice may be included in translations approved by the Free Software Foundation instead of in the original English.

KATSO MYÖS

’binutils’ info-järjestelmässä; The GNU Binary Utilities, Roland H. Pesch (October 1991), nm(1), ranlib(1)