Archive Finder version 1.25
First English version of a French
dos program designed to search files
in archives and on disk. Support for
ARJ ZIP LZH PAK ARC ZOO... Very fast,
handy and powerful. Public domain with
TP sources (v4.0 to 7.0). Try it, use
it and adopt it. A must have !

A r c h i v e F i n d e r

version 1.24

-----------------------------------------------------------------------------

Qu'est-ce ?
------------

Archive Finder (AF) est un programme qui cherche des fichiers sur un
disque ou une disquette. Comme FileFind de Peter Norton ou WhereIs,
OuEsTu, etc... On veut par exemple savoir o se trouvent tous les
fichiers *.DOC, le programme les trouve et les affiche, trs trs simple.

Mais comme l're de la compression est arrive, on a de plus en plus de
fichiers "rangs" l'interieur d'une archive. Pour les trouver, on n'a pas
vraiment d'utilitaire souple et complet (et en franais avec source en Turbo
Pascal).

C'est le travail d'Archive Finder que de retrouver tous vos fichiers ;
qu'ils soient simplement prsents sur le disque dur ou rangs dans une archive,
AF les retrouvera.
Il reconnat les fichiers .ARJ .ZIP .PAK .ARC .LZH .ZOO .SIT (la lecture de
ces derniers est trs incertaine et seuls les rcents .SIT sont peu prs
lisibles) et .TPZ

Jamais AF ne fera le moindre mal vos archives ou votre disque dur. Il
se contente de LIRE.


Oui, mais comment ?
-------------------

La syntaxe exacte d'Archive Finder est :

AF [MasqueFichiers] [-Paramtre] [/Paramtre] [...]

Les crochets [] signifient que chacun des paramtres est facultatif. On
peut donc trs bien lancer AF
Dans ce cas, AF cherchera tous les fichiers *.* se trouvant dans les
archives et sur les disques C: D: et E:.

[MasqueFichiers] reprsente la dfinition au format DOS des fichiers que vous
souhaitez rechercher. C'est dire que si l'on veut trouver tous les
*.DOC par exemple, on tape :
AF *.DOC
Si l'on omet de prciser ce masque, AF considre que l'on cherche les *.*

Vous pouvez chercher jusqu' 20 masques simultanment.
AF *.PAS *.INC *.DOC *.ZIP etc.

AF permet galement de prendre en compte un 'joker' supplmentaire. Il
s'agit du # qui remplace n'importe quel chiffre.
AF *.### trouvera COUCOU.001 BACKUP.123 A.000
mais pas COUCOU.01 BACKUP.12T A.

Depuis la version 1.14, AF accpte les masques tendus de 4DOS 3.x. C'est
dire que vous pouvez dsormais placer l'* au dbut ou l'intrieur du
nom et/ou de l'extension. Ce n'est pas trs clair ? Voyons quelques
exemples :

AF *A*.* cherche tous les fichiers contenant un A dans leur nom
identique AF *A
AF *A.* cherche tous les fichiers dont le nom finit par un A
AF A*A.* cherche tous les fichiers commenant et finissant par A
AF A*B*A.* cherche tous les fichiers commenant et finissant par A avec un
B n'importe o entre les deux.
AF A?B*A.* cherche tous les fichiers commenant et finissant par A avec un
B en troisime position

!!! ATTENTION TOUTEFOIS !!!
Cette syntaxe particulire a un effet secondaire ne pas ngliger :
Si l'on cherche par
AF DOC*.*
Archive Finder ne *TROUVERA PAS* les fichiers n'ayant pas d'extension
(et donc pas de ".")
N'ajoutez pas systmatiquement ".*" la fin des masques. Ainsi,
l'exemple prcdent s'crit plus simplement (et plus compltement) :
AF DOC*
(L'* finale n'est mme pas utile car AF l'ajoute automatiquement)
AF DOC suffit amplement.

Tout ceci est galement valable pour les extensions. Les [1-9A-Z] et autres
ajouts de 4Dos 4.0 sont l'tude. Notez que le AF.INC est le source pascal
du mcanisme de recherche de masque. Il est trs court. Etudiez-le, il vaut
le dtour.

Les Paramtres peuvent tre entrs prcds d'un "/" ou d'un "-" indiffrement.
Ils peuvent tre cumuls (dans les limites de la logique) entre eux.

[/Paramtre] ou [-Paramtre] peut tre :
/G Chercher galement les fichiers du disque. Si cette option n'est
pas prcise, AF cherchera dans les archives et sur le disque.
ATTENTION ceci est nouveau. Avant, la recherche globale tait
dsactive par dfaut. Changez donc vos .BAT et synonymes/alias/doskey.
(G pour recherche Globale).

/R Spcifier le rpertoire initial de recherche. Si cette option n'est
pas spcifie, AF cherche partir du rpertoire principal du
disque courant.
/R doit tre immdiatement suivi du nom du rpertoire o devra
commencer la recherche, sans espace ou autre caractre de sparation.
Ex: /RC:\Util
Le nom du rpertoire ne doit pas tre termin par un \ sauf s'il
s'agit du rpertoire principal (par Ex: /RD:\)

/S scruter les sous-rpertoires. Attention : par dfaut, cette option
est active. Pour la dsactiver, taper /S ou /S-

/C Ne cherche que dans le rpertoire actuel (quivalent AF /R. /S)
"." est le "rpertoire actuel" pour MsDos.
Si une option /R a dj t spcifie, /C ne la modifiera pas

/M Restreindre un masque d'archives. Si l'on ne souhaite chercher que
dans les archives FREE*.ZIP, on tape
AF /MFREE*.ZIP
Si cette option n'est pas prcise, AF cherche /M*.*

/A Ne chercher que le nom des archives. Cette option est surtout
utile quand on cherche "faire le point" sur son disque ou si
on veut faire un peu de "mnage". Elle n'indique que le nom des
archives prsentes. Cela permet de se faire une ide... On peut
coupler cette option avec /M par exemple en ne cherchant que
les *.LZH : AF /A /M*.LZH
et voir ainsi quels sont les fichiers LZH prsents sur le disque.
Dans ce mode, AF affiche galement la taille de l'archive. Cela
permet de voir celles qui prennent beaucoup de place.
Et puisque la taille de l'archive est cadre droite, on
peut trier les archives par taille : AF /A |Sort

/P Pas dans les archives. Cette option est l pour le cas o on
voudrait utiliser AF comme un simple FileFind.

/E Ecrire galement le nom des archives ne contenant pas de fichier
correspondant au masque. On pourrait remplacer le /A avec cette
option en cherchant des fichiers introuvables par exemple
AF /E ZXZXZXZX.ZXZ
(Si vous avez des fichiers ZXZXZXZX.ZXZ, ne tenez pas compte de cette
remarque)
Si les fichiers du disque sont recherchs (/G+), le nom des
rpertoires n'en contenant pas est galement affich.

/N N'afficher que le nom des fichiers. Cette option permet de se
constituer des listes qui peuvent tre rutilises dans des
programmes de compression (la boucle est boucle !)

/W Afficher 5 fichiers par ligne. Comme le DIR /W de MsDos.
Dans ce cas, le chemin des fichiers contenu dans les archives
n'est pas affich. (W pour Wide)

/T Afficher la taille occupe rellement par chaque fichier une
fois dsarchiv sur un disque. En effet, MsDos utilise l'espace
disque par granules (clusters). Ainsi, un fichier d'1 octet occupe
512 octets sur une disquette. Sur les disques durs, la taille minimum
est plus souvent de 2048 octets 8192 octets mme pour un fichier
de 1 octet ! La taille d'un granule varie d'un disque l'autre en
fonction du formattage.
En spcifiant /T immdiatement suivi du nom du lecteur sur lequel
doit s'effectuer le dsarchivage, AF vous indique la place
rellement occupe par le(s) fichier(s) sur ce disque.
/T0 signifie "disque courant".
Cette option active l'option /F (Afficher les totaux).

Par exemple:
AF /GTC /MARCHIVE.ARC *.PAS
indique la taille occupe par les fichiers *.PAS (contenus dans
l'archive ARCHIVE.ARC) une fois dsarchivs sur C:
AF /GTA /MARCHIVE.ARC *.PAS
idem, mais sur A:
AF /GT0 /MARCHIVE.ARC *.PAS
si c'est "0" (zro) qui est prcis comme nom de disque, AF
dtecte quel est le disque utiliser, tel qu'il a t prcis
par un ventuel /R
Cette particularit est surtout pratique dans les alias (voir plus
bas dans "Utilisateurs de 4Dos, Ced, DosEdit)
AF /GU /T- /MARCHIVE.ARC *.PAS
si c'est un "-" (tiret) qui est prcis comme nom de disque, AF
ne cherchera pas le taille relle. Cette option n'a de sens que
dans le cas d'un /U ou pour modifier l'xcution d'un alias (voir
plus bas)

/F Afficher les totaux. Affiche le nombre de fichiers trouvs dans des
archives et le nombre de fichiers trouvs sur le disque avec la
taille totale qu'ils occupent (et la taille relle si le paramtre
/T a t correctement spcifi). Un total des deux lignes apparatra
galement en fin de traitement.

/U Afficher uniquement les totaux. Si cette option est utilise, elle
active automatiquement les options /F+ et /T0. Il est possible de
dsactiver l'option /F en ajoutant /F- APRES /U

/* Recherche ultra-rapide. La recherche dans les sous-rpertoires
sera uniquement faite sur les rpertoires ne possdant pas
d'extension. Cela acclre terriblement la recherche. Cette
commande n'agit que si AF ne doit pas chercher dans les archives
mais dans les fichiers DOS (option /G+ /P+)

/D Permet de slectionner une date avant et/ou aprs laquelle le
fichier a t cr.
AF *.COM /d+010180 affiche tous les .COM crs aprs ou le 1-Jan-80
AF *.COM /d-010190 affiche tous les .COM crs avant ou le 1-Jan-90
AF *.COM /d=010190 affiche tous les .COM crs le 1-Jan-90
quivalent
AF *.COM /d+010190 /d-010190
Si aucune date n'est prcise aprs /D+ /D- ou /D=, c'est la date du
jour qui est prise en compte.
AF *.* /d= affiche tous les fichiers modifis ou crs aujourd'hui

/I Permet de slectionner les fichiers afficher en fonction de leur
taille.
AF *.COM /i+1024 affiche tous les .COM de plus de 1023 octets
AF *.COM /i-1024 affiche tous les .COM de moins de 1025 octets
AF *.COM /i=1024 affiche tous les .COM de 1024 octets

/L Permet de slectionner les lecteurs autoriss pendant la recherche.
Par dfaut, les lecteurs C, D et E sont essays.
AF *.COM /lABC cherchera les .COM sur A: B: et C:
L'option /L0 dcide que seul le lecteur courant est utilis

/B Archive Finder a depuis la version 1.19 une nouvelle prsentation
des fichiers, ressemblant un peu celle de SST (Supersonic Search
Tools de Keith Ledbetter). L'option /B permet de dsactiver cette
prsentation pour revenir quelque chose ressemblant ce qu'offre
le Dos.

/) Cette option permet de trouver POURQUOI une commande passe AF
ne fonctionne pas. Celui-ci affichera la liste des options avec le
signe + ou -. Si vous n'arrivez pas comprendre pourquoi AF ne
rpond pas votre demande, retapez la dernire commande DOS et
ajoutez-y -)

Ex: AF -cg-t0m* -)
/a - noms Archives seulement /b + Belle vue
/c dans Ce rpertoire /d... date (/d+311291 /d=010191)
/e - tous les noms /f + aFficher les totaux
/g - recherche Globale /i... taille (/i+1024 /i-2048)
/l... Lecteurs /m... Masque d'archives
/n - Nom complets
/p - Pas les archives /r... Rpertoire de dpart
/s - Sous-rpertoires /t... Taille relle
/u - totaux Uniquement /w - affichage 'Wide'
/* + tous les rpertoires
Masques: *

Attention: l'option /C ainsi que certaines options suivies de ... ne
sont pas affiches correctement.


Redirections
------------

AF gre la sortie redirige. C'est dire en utilisant le | ou le >
Par exemple pour sortir le fruit de la recherche dans le fichier TEMP.LST,
on ajoute >TEMP.LST
Ex: AF *.PAS >LISTEPAS
On peut aussi demander une pause entre chaque page en tapant
AF *.PAS | More
ou obtenir la liste des archives trie par taille dans le fichier LISTARCH.TXT
AF /A |Sort >LISTARCH.TXT
Etc...


Entre des paramtres
---------------------

Notez que AF peut tre paramtr en regroupant les commandes.
Exemple :
AF -cp est quivalent AF /c /p
Remarque :
Les paramtres /M... et /R... ne peuvent se trouver qu' la fin d'un tel
regroupement. Ainsi :
AF -cpm*.ZIP est valide
AF -cp*.ZIPm ne l'est pas

De plus, vous pouvez spcifier explicitement si le paramtre doit tre
activ ou non. Pour cela, ajoutez un '+' ou un '-' directement aprs
la commande (le regroupement reste possible). Cette fonctionnalit permet
de forcer un paramtre si on utilise des Batch ou des synonymes/alias.
Exemple :
AF /C+P+ est quivalent AF /cp
car -c et -p sont par dfaut sur -

En effet, les paramtres sont analyss les uns aprs les autres, de la
gauche vers la droite. Si une option apparat deux fois, AF en tient
compte.
Ainsi:
AF /P/P ne fait en ralit rien (identique AF seul)


Exemples
--------

Pour comprendre toute la puissance de AF, je vous conseille d'essayer les
exemples ci-dessous :

Chercher tous les fichiers *.DOC contenus dans des archives :
Af *.doc /G-
Chercher tous les fichiers *.DOC contenus dans des archives et galement
les fichiers du disque :
Af *.doc
Chercher tous les fichiers *.DOC contenus sur le disque et sans regarder dans
les archives :
Af *.doc /P
Chercher tous les fichiers *.DOC contenus sur le disque et sans regarder dans
les archives, en cherchant dans le rpertoire \DOS et ses sous-rpertoires :
Af *.doc /P /R\DOS
Chercher tous les fichiers *.DOC contenus sur le disque et sans regarder dans
les archives, en cherchant dans le rpertoire \DOS uniquement :
Af *.doc /P /S /R\DOS
Chercher tous les fichiers *.DOC contenus sur le disque et sans regarder dans
les archives, en cherchant dans le rpertoire courant uniquement :
Af *.doc /P /C
Chercher tous les fichiers *.DOC contenus sur le disque et sans regarder dans
les archives, en cherchant dans le rpertoire courant uniquement :
Af *.doc /P /C
Chercher tous les fichiers *.DOC contenus dans les archives *.ZIP,
en cherchant dans le rpertoire courant uniquement :
Af *.doc /G- /C /M*.ZIP

Chercher tous les fichiers *.DOC contenus dans les archives *.ZIP et sur le
disque, en affichant tous les totaux.
Af *.doc -t0fm*.ZIP
s'crit aussi
Af *.DOC /T0 /F /M*.ZIP

Chercher tous les fichiers *.DOC contenus sur le disque, en affichant
les noms complets des fichiers
Af *.doc -pn

Chercher tous les *.DOC et *.TXT sur le disque et dans les archives
Af *.doc *.txt

Chercher tous les *.DOC sur le disque C: uniquement
Af *.doc -plc

Chercher tous les *.DOC uniquement dans des archives se trouvant sur C:
Af *.doc -glc

Chercher tous les fichiers modifis ce jour (anciennement TODAY.EXE)
Af /PD=


Utilisateurs de 4Dos / CED / DosEdit / DosKey
---------------------------------------------

Il est indispensable de vous constituer des synonymes (alias pour 4Dos)
avec AF !

Par exemple la recherche type FileFind :
Syn FF AF /P /* /R%1 %2 %3 pour CED
FF=AF /P /* /R%1 pour 4Dos

Pour Visualiser une/des archives dans le rpertoire courant :
Syn V=AF /C /G /M%1 %2 %3 %4 pour CED
V=AF /C /G /M%1 pour 4Dos

Et mme un DIR ! (Af n'affichera pas les rpertoires)
DIR=AF /PC %1

Un Dir qui affiche la taille relle des fichiers :
DIR=AF -pct0f %1
p=pas dans les archives
c=dans le rpertoire courant uniquement
t0=dtecter le disque courant ou spcifi
f=afficher les totaux des fichiers du disque

Remarque: Dans les exemples de FF et de V, le premier paramtre (%1) est
pass /R ou /M. Si vous souhaitez complter la ligne de
commande par un /U par exemple, il faudra entrer :
FF .\ /U
V * /U

L'* seule est le masque le plus large pour AF. Il est l'quivalent
de *.* pour MsDos. *.* marche tout aussi bien.


Si vous avez manqu le dbut
----------------------------

- 1.00 Premire version.
Scrute les .LZH, les .ARJ, les .ZIP et les .ARC
- 1.01 Ajout des paramtres /S et /C
- 1.02 Ajout des fichiers .PAK
Acclration de la recherche (50% plus rapide en moyenne, trs efficace
sur les grosses archives (utilisation du Seek, merci Etchemait)).
Gre la redirection.
Ajout du /E /M /A et /N
Amlioration de la recherche par dfaut
- 1.03 Suppression du bug lorsqu'aucun paramtre n'est spcifi
Possibilit de remplacer le '/' par un '-'
Ajout du /G /P et /R
Modification du /S
- 1.04 Ajout des .ZOO (Merci Mr Burns --l'auteur de PibCat--)
Ajout du /W (merci Mr Buerg --l'auteur de FV et LIST entre autres--)
- 1.05 Correction de l'affichage lors d'un /G seul (sans /P)
- 1.06 Ajout de totaux sur les archives
Ajout de quelques ProcessKey pour mieux grer , et
Amlioration du /C : si un rpertoire par dfaut est prcis on
remplace le /C par un /S
Amlioration du /M : si le masque d'archives est prcd d'un chemin,
celui-ci est plac dans le /R
Suppression des '\' finaux dans les noms de rpertoire (c'est plus beau)
Possibilit de regrouper les paramtres (af -gp par exemple)
Possibilit de spcifier la valeur + ou - d'un paramtre
Ajout de certains .SIT
- 1.07 Modification mineure du /M pour raison de commodit
Ajout du /T et /F
- 1.08 Ajout du /U et du /#
Modification du /E pour inclure l'criture des rpertoires
Rparation du /R si rien n'est prcis.

Multiples modifications dans l'affichage en particulier pour la
gestion de la redirection.
- 1.09 Acclration des recherches de 28%. Quand on voit la vitesse de
"Supersonic Search Tools" on prend peur...
- 1.10 Acclration des recherches avec la recherche supersonique. 43% par
rapport la version 1.08
Ajout du /B
- 1.11 La recherche supersonique ne pouvant chercher qu' partir du
rpertoire \ et posant un problme avec le dos 4.01, elle est
laisse de ct pour le moment.
Remis en place l'usage de ProcessKey
- 1.12 Suppression dfinitive de la recherche supersonique.
Suppression du /B
Amlioration de la vitesse de 20%
- 1.13 Ajout de la recherche ultra rapide utilise par SST (l'ex rfrence)
qui peut ne chercher que les rpertoires *.
Ici, cette fonction n'est utile qu'en conjonction avec -g et -p
(recherche globale, pas dans les archives). Mais elle est TRES utile.
SST se trouve dpass. Essayez AF -GP* *.ZZZ
Ajout du /*
- 1.14 Ajout des masques tendus de 4DOS ! (AF *A*F*.*)
- 1.15 Ajout de la recherche sur la date et la taille
Ajout du /D et /I
- 1.16 Correction du bug en cas de tentative d'accs une archive ReadOnly
- 1.17 Correction mineure pour l'affichage des archives seules >= 10Mo.
Multi masques !!! (AF *.Zip *.doc *.pas ...)
Possibilit de lancer : AF \dos\*.com -p
- 1.18 Compatibilit avec MsDos 5.0 : modification de "ClusterSize".
Gre la nouvelle mthode de compression de PkZip "Extra". Bof...
- 1.19 Correction mineure pour l'affichage /Wide
Ajout du /L
Pile conomise pendant la recherche des fichiers du disque
Ajout du /B (pas la recherche supersonique mais le "Bel affichage")
Modifications diverses d'affichage des totaux.
/F dtermine prsent si il faut afficher les totaux.
/G est dsormais par dfaut sur + !!!
- 1.20 Corrections mineures et large diffusion
- 1.21 Ajout des fichiers TPZ de Patrick TEIL (merci lui)
Amlioration de ProcessKey
Lger changement de look pour le contenu des archives
Amliorations de Check. Gains de vitesse.
Ajout de l'option /) pour VOIR ce que l'on cherche faire et
trouver une erreur
- 1.22 Les fichiers .A00 .A99 sont considrs comme des archives ARJ
La recherche de fichier dans une archive ne prend plus en compte
le sous-rpertoire dans lequel se trouve le fichier (jusque l,
pour trouver le fichier UTIL\FICHIER.EXT, AF FICHIER* ne
fonctionnait pas. Il fallait faire AF *FICHIER*
- 1.23 Debug du -m qui acceptait mal les -mb:xxx
Les options /L /M et /R sont correctement affiches par l'option -)
Modifications du /a en combinaison avec un masque de fichiers et
combinaison avec /f et /n.
TRES UTILE notamment pour :
AF -AN TEASER.COM >FIC
For %a in (@FIC) do Arj d %a teaser.com

Ce petit Alias/Batch pour 4Dos fait chercher AF toutes les
archives contenant le fichier TEASER.COM et range cette liste
dans FIC. Il ne reste plus qu' dire 4Dos de lire ce fichier
FIC et pour chaque nom d'archive de supprimer le fichier en question.

Correction sur le -C qui dsormais fait un -L0 automatiquement
- 1.24 Cration de la version anglaise
- 1.25 Corrections diverses langue anglaise
Meilleure gestion des "garbages" la fin des .LZH
Changement de nom de la mthode de compactage "Deflat" pour PkZip
(anciennement "Extra compression")

Diffusion
---------

Ce programme est plac dans le domaine public avec ses sources. Tout le
monde peut utiliser, diffuser, modifier ou inclure l'intgralit ou
une partie de ce programme condition d'en citer le nom et l'auteur.
Particuliers, associations et entreprises. Sans me reverser le moindre
centime, et sans mme m'en demander l'autorisation. Par contre, il est
indispensable de citer mon nom en rcompense de mes efforts, merci.

Je vous incite donc le donner, le poster, le tlcharger, le soumettre
des services minitels, des groupements de programmes FreeWare, des
magazines, etc...


Prvisions
----------

- Ajout des autres .SIT
- Tris
- Exclure des fichiers
- Limiter les recherches n fichiers
- Execution de commandes sur les fichiers trouvs
- Sortie type dBase
- amlioration du -)
- correction du bug sur certaines recherches ayant un masque finissant par
un #
- Support des archives TPZ 2.5 (seules les 2.2 sont gres actuellement)
- Utilisation d'une variable d'environnement pour spcifier les options par
dfaut d'AF


Contact
-------

Vos suggestions, ides en bal CAT sur 3614/3615 TEASER
et 3614/3615 LEGEND

Ou sur Hermes HQ BBS (1) 69 00 76 72 JC BOGGIO
ILink PASCAL ou COMPRESS conference JC BOGGIO
Compuserve 100117,3213
Usenet [email protected]

Ou bien Jean-Christophe Boggio
8, rue de la Corne
37370 Chemill sur Dme

Merci de m'envoyer les corrections plutt que de diffuser une version
fantme.


Remerciements
-------------

JrB d'avoir ralis LhFind (qui cherche dans les .LZH de LhArc). Ce fut
l'anctre de AF.
Philip Burns, l'auteur de PibCat pour le format des .ZOO
Fox pour m'avoir upload PibCat mais qui se moque du monde avec son
ZERODEL (private joke)
Vernon Buerg pour FileViewer (qui m'a notamment donn l'ide du /W pour une
fois que je trouve cette option pratique !)
Mr Yoshizaki (l'auteur de LhArc) pour m'avoir fait adorer la compression
Mr Jung pour avoir crit le meilleur compacteur (le plus souple et le plus
puissant, j'ai nomm ARJ)
PkWare pour ses bons et loyaux services (quand il a fallu attendre la
transition de LhArc Arj, PkZip 1.xx tait le meilleur compacteur)
Patrick "Next" Teil pour TPZ et son shell pour AF
tous ceux qui m'ont signal des problmes, bugs,... (GEX, California,
Kadorbra, Next, Solex et les autres ...
vous d'utiliser Archive Finder.


Auteur: Jc Boggio Diffusion: Domaine public avec source en Turbo Pascal
Version: 1.25 Du: 2 avr 1993