apt-file -- APT csomagkereső segédprogram -- parancssori felület
apt-file [options] search pattern
apt-file [options] show package
Az apt-file egy parancssori eszköz az APT csomagkezelő rendszer csomagjaiban lévő fájlok kereséséhez.
A keresés futtatásához néhány művelet szükséges:
Alias a kereséshez.
Sorolja fel egy csomag tartalmát. Ez a művelet nagyon közel áll a dpkg -L parancshoz, kivéve, hogy a csomagot nem kell telepíteni vagy lekérni. Alapértelmezés szerint a lista művelet úgy értelmezi a mintáját, mintha --fix-string lett volna megadva.
Sorolja fel az ismert tartalomindexeket és állapotukat ember által olvasható formátumban. Ezek az indexek a -I opcióval kereshetők (ha engedélyezve van, és az indexek lekérése után). A kimenet előzetes értesítés nélkül változhat, ezért nem alkalmas szkripthasználatra/automatizálásra. Géppel olvasható formátumok esetén (pl. automatizálás) használja az apt-config kiíratást (keresse az Acquire::IndexTargets kezdetű opciókat) és az apt-get indextargets a gyorsítótár ellenőrzéséhez (keresse a Tartalom- kezdetű Identifier mezővel rendelkező bejegyzéseket). Vegye figyelembe, hogy az egyes sources.list bejegyzések felülírhatják a globális alapértelmezést. Kérjük, tekintse meg a sources.list (5) oldalt a sources.list fájlok speciális konfigurálásával kapcsolatos további információkért.
Keresse meg, hogy egy fájl melyik csomagban található. A mintamintát tartalmazó összes csomag listája kerül visszaadásra. Mivel a Contents fájlok nem tartalmaznak könyvtárakat, a mintának meg kell egyeznie a fájlnévvel (egy részével). Alapértelmezés szerint a keresés művelet úgy értelmezi a mintáját, mintha ---substring-match lett volna megadva.
Alias a listához.
Ez a művelet csak az apt update vagy az apt-get update meghívója (attól függően, hogy elérhető-e tty). Ennek egyetlen előnye a szokásos apt frissítés vagy az apt-get update közvetlen használatával szemben abban az esetben, ha egy apt-fájl specifikus konfigurációt állított be (a Dir::Etc::apt-file-main konfigurációs lehetőség). Ebben az esetben az említett konfiguráció automatikusan bekerül.
A következő lehetőségek állnak rendelkezésre:
Ez a beállítás akkor hasznos, ha egy csomagban a rendszerére telepítetttől eltérő architektúrát keres. Ez lehet egy vesszővel elválasztott lista több architektúrán történő kereséshez.
Konfigurációs fájl; Adja meg a használni kívánt konfigurációs fájlt. A program beolvassa az alapértelmezett konfigurációs fájlt, majd ezt a konfigurációs fájlt. Ha a konfigurációs beállításokat meg kell adni az alapértelmezett konfigurációs fájlok elemzése előtt, adjon meg egy fájlt az APT_CONFIG környezeti változóval. A szintaktikai információkért lásd az apt.conf (5) fájlt. A konfigurációs fájl a parancssorban való megjelenéshez viszonyítva kerül beolvasásra, és felülírhatja az előtte megjelenő opciókat. Vegye figyelembe, hogy a konfigurációs fájlt az apt-file által meghívott összes APT-eszköz is átadja.
Használja az adott .deb archívum(ok) tartalmát mintaként. Hasznos a más csomagokkal való fájlütközések kereséséhez. -F.
Olvasson mintákat az adott fájl(ok)ból, soronként egyet. Használja a - stdin fájlnévként. Ha nem adunk meg fájlokat, akkor a lista az stdin-ből kerül beolvasásra. Ez sokkal gyorsabb, mint az apt-file többszöri meghívása.
Csak a felsorolt forrásokból (pl. Debian) származó indexeket keressen. Ez a szűrő megegyezik a kiadási fájl Origin mezőjében felsorolt névvel. Ha „*”-ra van állítva, ez a szűrő le lesz tiltva (leginkább a konfigurációs fájlban lévő beállítás felülbírálásához hasznos). Az APT konfigurációs opció álneve: apt-file::Search-Filter::Origin
Csak a felsorolt csomagokból vagy kódnevekből (pl. instabil) keressen indexeket. Ez a szűrő megfelel a kiadási fájl Kódnév és Suite mezőiben felsorolt névnek. Ez azt jelenti, hogy az instabil vagy a sid megfelel a Debian instabil programcsomagjának. Ha „*”-ra van állítva, ez a szűrő le lesz tiltva (leginkább a konfigurációs fájlban lévő beállítás felülbírálásához hasznos). Az APT konfigurációs opció álneve: apt-file::Search-Filter::Suite
Ne bontsa ki a keresési mintát általános karakterekkel a minta elején és végén. Ez az alapértelmezett a megjelenítés és a lista műveleteknél.
Csak az adott név(ek) indexében keressen. Ha az ALL speciális értékre van állítva (a kis- és nagybetűk megkülönböztetése), akkor a rendszer az összes apt-file indexet megkeresi. A név(ek)nek meg kell egyeznie az APT konfigurációban használt egy vagy több azonosítóval (kivéve a kezdő tartalom-). Példa, ha a konfiguráció a következő kódrészleteket tartalmazza:
Acquire::IndexTargets::deb::Contents-deb { ... };
Acquire::IndexTargets::deb-src::Contents-dsc { ... };
Acquire::IndexTargets::deb::Contents-udeb { ... };
Acquire::IndexTargets::deb::Contents-deb-legacy {
# Explicitly named to "Contents-deb"
Identifier "Contents-deb";
...;
};Ezután az apt-file felismeri a deb, dsc és udeb fájlokat indexnévként. Ez a beállítás alapértelmezés szerint az apt-file::Index-Names apt config beállítás értéke (vagy deb, ha kihagyjuk).
A kis- és nagybetűk figyelmen kívül hagyása a minta keresésekor.
Csak a csomagnév megjelenítése; ne jelenítse meg a fájlneveket.
Ez egy speciális felhasználási lehetőség olyan keresések kezelésére, amelyek nagyszámú egyezést (10 000+) eredményeznek és/vagy az eredmények automatizált feldolgozását. Tiltsa le a deduplikációs logikát, és azonnal küldjön eredményt, ha egyezést talál. Ez nagymértékben csökkentheti az apt-file memóriaigényét a sok egyezést tartalmazó keresések feldolgozásakor. Lecsökkenti az első egyezés kiadásáig eltelt időt is, ami hasznos lehet, ha az egyezések a felfedezésükkor feldolgozhatók, és a fogyasztó kezelni tudja a duplikált egyezéseket.
Állítson be egy konfigurációs opciót; Ez egy tetszőleges konfigurációs lehetőséget állít be. A szintaxis: -o APT::Option=Value. A -o és a --option többször használható különböző beállítások megadására. Ezzel az opcióval lehet felülírni más parancssori beállításokat (pl. -o apt-file::Search-Filter::Origin=Debian gyakorlatilag ugyanaz, mint a --filter-origins Debian). Ne feledje, hogy az ezen az opción keresztül átadott konfigurációs beállítások az apt-file által meghívott összes APT-eszköznek is átadódnak.
Egyezzen, ha az adott keresési minta egy elérési út vagy csomag részkarakterlánca. Ez az alapértelmezett a keresés és a keresés műveleteknél.
Futtassa az apt-file fájlt részletes/debug módban.
Kezelje a mintát (perl) reguláris kifejezésként. A részletekért lásd a perlreref (1) részt. E beállítás nélkül a mintát a rendszer egy keresendő karakterláncként kezeli. Vegye figyelembe, hogy ez a lehetőség meglehetősen lassú lehet. Ha a teljesítmény problémát jelent, fontolja meg az apt-fájl nem regex mintaegyeztetését, és a kimenetet a perl -ne '/
Jelenítsen meg egy rövid súgóképernyőt.
Az apt-file parancs az APT konfigurációjára támaszkodik. Nevezetesen, az alapértelmezett konfiguráció az apt tartalomfájlokat alapértelmezés szerint lekéri az apt frissítés hívása során.
Az APT beállításával kapcsolatban, hogy több vagy kevesebb tartalomfájlt kérjen le, tekintse meg a /usr/share/doc/apt-file/README.md.gz webhelyet.
A következő fájlok különösen érdekesek:
Vegye figyelembe, hogy ez az elérési út valójában a Dir::Etc::apt-file-main nevű APT-konfiguráció értékének módosításával konfigurálható. A felsorolt érték csupán az adott opció alapértelmezett értéke. Ha ez a fájl jelen van, az apt-file beolvassa ezt a fájlt az összes alapértelmezett APT konfigurációs fájl után. Minden -c konfigurációs fájl vagy opció (-o) kiértékelésre kerül előtt ez a fájl (és felülbírálhatja a benne beállított beállításokat). A fájlt az apt-file által meghívott összes APT-eszköz is továbbítja.
Kiválasztja, hogy mely tartalomfájlokat szeretné letölteni. Vegye figyelembe, hogy az apt-file csak azokat az Acquire célokat ismeri fel, amelyek a Contents- karakterrel kezdődnek.
Íme néhány apt-file 2 kapcsolódó munkafolyamat, és hogyan (majdnem) emulálhatjuk őket az apt-file 3-mal. Ezek kezdőként vannak dokumentálva. > pont azoknak, akik ezekhez kötődnek.
Előfordulhat, hogy az emuláció nem tökéletes az Ön számára. Javasoljuk, hogy a javítások frissítsék a példákat, amíg a példák triviálisak maradnak.
Csak az apt-file frissítés tartalomfájlok lekérése Ha megszokta, hogy apt frissítés nem tölti le a tartalomfájlokat, akkor futtathatja a / usr/share/doc/apt-file/examples/apt-file-2-update.sh. Ez a szkript minden erőfeszítést követően ennek megfelelően konfigurálja az apt és az apt-file fájlokat. Kérjük, olvassa el a kapott /etc/apt/apt-file.conf fájlt.
Creating/using user caches Previous versions of apt-file had a --cache option, which could be used to denote a directory to store the Contents files. This can be emulated by doing:
# Setup
$ mkdir -p ~/.cache/apt-file ~/.config
$ touch ~/.cache/apt-file/dpkg-status
$ sed '/^Dir::State/ d; /^Dir::Cache/ d;' \
/usr/share/doc/apt-file/examples/apt-file.conf \
> ~/.config/apt-file.conf
$ cat <> ~/.config/apt-file.conf
Dir::State "$HOME/.cache/apt-file";
Dir::Cache "$HOME/.cache/apt-file";
Dir::State::status "$HOME/.cache/apt-file/dpkg-status";
EOF
# Update the cache
$ apt-file -c ~/.config/apt-file.conf update
# Search using the cache
$ apt-file -c ~/.config/apt-file.conf show apt-file
# Removal of the cache + config
$ rm -fr ~/.cache/apt-file ~/.config/apt-file.conf
(You will probably want to add an alias apt-file in your ~/.bashrc) Please read the resulting ./apt-file-user-cache.conf.
Vannak ismert problémák vagy furcsaságok, amelyeket érdemes szem előtt tartani.
A tartalomfájlok nem tartalmaznak perjelet az elérési utakon. Ez azt jelenti, hogy a /bin/ls bin/ls néven szerepel a Tartalomfájlban. Ha egy felső szintű könyvtárban keres valamit, gyakran jobb, ha elhagyja a kezdő perjelet. A keresési algoritmus megpróbálja megkerülni a kezdő perjelet, de nem fog minden esetben működni. Megkerülő megoldásként próbálja meg a kezdő perjelet a reguláris kifejezések elejére húzni. Például használja a /(?:usr/bin/vim|sbin/lvm) értéket a /usr/bin/vim|/sbin/lvm helyett.
Ha új sort adtunk a sources.list listához, és az apt frissítés nem fut le, az apt-file nem nyomtat figyelmeztető üzenetet.
Alapértelmezés szerint az apt-file azt feltételezi, hogy a tartalomfájlok nem tartalmaznak leíró fejlécet (amely elmagyarázza, mi a fájl és hogyan kell értelmezni). Néhány eszköz azonban létrehozta ezeket ilyen fejléccel (például a Debian archívumának tartalomfájlok régi verzióihoz vagy a reprepro által az 5.2.0-s verzió előtt generált tartalomfájlokhoz). Ha ilyen fájlokban keres, az apt-file::Parser::Check-For-Description-Header értéket igazra kell állítania (például az /etc/apt/apt.conf. d/50apt-file.conf), hogy az apt-file megfelelően kiszűrje a fejléceket a hamis egyezések elkerülése érdekében. Nem ez az alapértelmezett oka, hogy 2-szeres rezsibe kerül, miközben a legtöbb általános tartalomfájlnak már nincs fejléce. (további részletekért lásd: #881405).
Nem minden APT-tárolóban található tartalomfájl. Nevezetesen a gyakori telepítési adathordozók (CD-k stb.) helytakarékosság céljából elhagyhatják őket. Az apt-file alapértelmezett konfigurációja a tartalomfájlokat nem kötelezőként jelöli meg, és csendben meghiúsítja a keresést az ilyen tárolókban található tartalomfájlokban.
Az apt-file a következő definiált kilépési kódokkal rendelkezik, amelyek szkriptelési célokra használhatók.
Az apt-file sikeresen visszatért. Ha a parancs keresés volt, akkor legalább egy eredmény volt.
Az apt-file sikeresen befejezte a keresést, de nem járt eredménnyel.
Hiba történt (beleértve az érvénytelen/ütköző felhasználói beállításokat).
Az apt-file nem tudta végrehajtani a parancsot, mert a gyorsítótár üres. Győződjön meg arról, hogy az indexek engedélyezve vannak az APT konfigurációjában, és futtassa az apt frissítést a lekéréshez.
Az apt-file nem tudta végrehajtani a parancsot, mert a gyorsítótárban nincs olyan fájl, amely megfelelne a korlátozásoknak. Módosítsa a korlátozásokat (pl. --index-names), vagy állítsa be az apt-t a megfelelő fájlok lekérésére, és futtassa az apt frissítést.
Belső hiba/nem elfogott kivétel volt az apt-file fájlban. Kérjük, nyújtson be hibát az apt-file ellen.
Minden más kilépési kód későbbi használatra van fenntartva.
apt (1), apt-cache (8), apt.conf (5)
The APT users guide in /usr/share/doc/apt/
The example config in /usr/share/doc/apt-file/examples
The README at /usr/share/doc/apt-file/README.md.gz