            *** FSJ : File Splitter and Joiner - version 1.0 ***

               (c) 16 Jun 2006 - Alessandro Felice Cantatore

Introduction
------------

FSJ dcoupe un fichier en plusieurs parties ou recompose plusieurs
fichiers en un fichier unique. 


Syntaxe
-------

Le programme prend un premier argument (commande) obligatoire dfinissant
le mode opratoire (aide, dcoupage ou recomposition) puis, dans quelque
ordre que ce soit, les autres paramtres et options : 

   FSJ <commande[:paramtres de commande]> [nomfichier] ... [nomfichier] [options]

La 'commande' n'est pas sensible  la casse et, dans certains cas, prend
des sous-paramtres spars par le caractre "deux points" (':'). 
Les commandes correctes sont : 

   H ou ?   affiche l'aide du programme,
   S        scinde un fichier,
   J        recompose plusieurs fichier en un seul. 

Les options ne sont pas sensibles  la casse et peuvent tre introduites
par une barre oblique ('/') ou par un tiret ('-'). 
Les options qui prennent des paramtres utilisent le caractre "deux
points" (':') comme sparateur (exemple : "/O:fichier????.txt"). 
Les multiples options sans paramtres ne peuvent pas tre regroups
(exemple : "/PCW" est incorrect puisque chaque option doit tre prfixe
par une barre oblique ou un tiret : "/p /c /w" ou "-p -c -w"). 


Tutiorel pour une utilisation de base
-------------------------------------

Pour dcouper le fichier :
   'c:\dev\prj\gros.ext'
en 10 fichiers, tapez :
   FSJ S:10 c:\dev\prj\gros.ext
les diffrents fichiers prendront les noms par dfaut : 
   'pie00001.fsj' ... 'pie00010.fsj'

Pour indiquer un chemin de sortie prcis (exemple : 'c:\tlchargement')
pour les parties du fichier, utilisez l'option /O ("output") et
ajoutez une barre oblique vers la gauche au chemin : 
   FSJ S:10 c:\dev\prj\gros.ext /O:c:\tlchargement\

Pour indiquer le chemin et le nom (ou juste le nom si le chemin de sortie
correspond au rpertoire courant) des parties du fichier, ajoutez un
masque de fichier '?' remplaant les chiffres composant le numro des
parties. Par exemple, pour obtenir 10 parties nommes : 
   'pf001.part' ... 'pf010.part'
tapez :
   FSJ S:10 c:\dev\prj\gros.ext /O:pf???.part

Lorsque le chemin ou les noms de fichiers contiennent des espaces,
placez-le paramtre entier ou juste le nom de fichier entre guillemets : 
   "/O:c:\ tlcharger\pf???.part"
   or
   /O:"c:\ tlcharger\pf???.part"

Pour un dcoupage en fonction la taille plutot qu'en nombre de fichiers,
utilisez une unit de mesure aprs l'indication de la taille : 
   S:10B      (la taille de chaque partie est de 10 octets)
   S:10K      (la taille de chaque partie est de 10 * 1000 octets)
   S:10Ki     (la taille de chaque partie est de 10 * 1024 octets)
   les autres multiplicateurs pour l'unit de mesure sont M, Mi, G et Gi. 

Exemples : 
   FSJ S:10500B divise un fichier en parties de 10 500 octets chacune
Le caractre soulign ('_') peut tre inclus comme sparateur des
milliers : 
   FSJ S:10_500B divise un fichier en parties de 10 500 octets chacune

Pour recomposer les fichiers 'alfa.txt', 'beta.bin' et 'gamma.res' en
un unique fichier appel 'truc.divers', vous pouvez utiliser : 
   FSJ J:truc.divers alfa.txt beta.bin gamma.res

Lorsqu'il y a trop de fichiers  entrer comme paramtres, vous pouvez les
lister dans un fichier texte (un par ligne) et indiquant le nom de ce
dernier derrire l'option /F : 
   FSJ J:truc.divers /F:C:\un_chemin\liste.fichiers

Lorsque tous les fichiers  concatner sont dans un mme emplacement,
plutt que d'indiquer le chemin de fichier complet de chaque fichier,
vous pouvez utiliser l'option /D ("Directory") pour indiquer le chemin
commun, puis utilisez juste les noms de fichiers : 
   FSJ J:truc.divers /D:"g:\dvd\chemin commun" alfa.txt beta.bin gamma.res
or
   FSJ J:truc.divers /D:"g:\dvd\chemin commun" /F:C:\un_chemin\liste.fichiers

Lorsque les noms de fichiers sont dtermins par l'ordinal de chaque
partie (exemple : 'part001.fich', 'part002.fich' ... 'part149.fich'), il
est possible de juste utiliser l'option /I en donnant le nombre total de
fichiers et un masque de fichier : 
   FSJ J:truc.divers /I:149:part???.fich

Si vous voulez amliorer la vitesse d'excution et avoir suffisamment de
mmoire libre, vous pouvez accrotre la taille du tampon de
lecture/criture (qui est de 1Mo par dfaut) via l'option /B ("Buffer"). 
Par exemple, "/B:256" paramtre le tampon de lecture/criture  256 Mo. 
Pour paramtrer le tampon  sa taille minimum (64 ko) indiquez juste
"B/:0". 

L'option /L ("log") permet de gnrer un rapport complet le l'opration
de dcoupage/recomposition dans un fichier : 
   /L:"c:\chemin rapport\dcoupage.log"

Pour afficher une barre de progression, utilisez l'option /P
("Progression"). 

Si vous ne voulez aucun message affich  l'cran, utilisez l'option
/Q ("Quiet"). 

Lorsque les fichiers  concatner doivent tre lus ou crits depuis/vers
des supports amovibles multiples, vous pouvez indique l'option /W
("Wait") pour faire en sorte que FSJ fasse une pause avant chaque
opration de lecture/criture. 
Avant de dcouper ou recomposer des fichiers, le programme calcule
l'espace disque utilis par le(s) fichier(s)  crer. 
Lors de la recomposition de plusieurs fichiers situs sur diffrents
supports amovibles, l'option /W:1 permet de ne juste vrifier la taille
que du premier fichier (supposant que tous les fichiers ont  peu prs la
mme taille) pour calculer la taille totale du fichier rsultant de la
concatnation des diffrentes parties. L'option /W:N au contraire vite
toute vrification de taille de fichier (et dsactive la barre de
progression). 

Lorsque le programme doit tre lanc sans intervention de l'utilisateur,
indiquez l'option /U ("Unattended"). Dans ce cas, toutes les erreurs sont
considres comme critiques et autre question n'est pose  l'utilisateur. 


Rfrence
---------
Mode aide
---------

La commande d'aide est invoque  l'aide de l'un des caractres 'h', 'H'
ou '?'. 

Syntaxe :
   SPLIT H
   ou
   SPLIT ?
      affiche les information au sujet de l'utilisation de FSJ dans une
      fentre de texte  dfilement. 


Mode Dcoupage
--------------

La commande de dcoupage est invoque  l'aide de l'un des caractres 's'
ou 'S'. 

Syntaxe:
   FSJ S:mmm[unit] <nomfich> [/C[:nomfich.cmd]] [/O:specfich] [/B:nnn]
                   [/U | /W[:N|1]] [/Q] [/P] [/L[:fichrapp]]

      dcoupe 'nomfich' en 'mmm' fichiers ou en fichier de 'mmm' units
      de taille. 

Paramtres de la commande de dcoupage : 
   :mmm[unit]
            indique la taille d'une partie du fichier  dcouper ou le
            nombre de fichiers pour le dcoupage. 'unit' indique si
            'mmm' (qui doit tre un nombre entier) est le nombre de
            fichiers ou la taille de chacun d'eux en Octets (B), ko
            (KB), Mo (MB) ou Go (GB). 

            unit         dcoupage en

            aucune ou P   nombre de fichiers
            B             taille de fichier (en octets)
            K             taille de fichier (en ko  - 1 000 o)
            KI            taille de fichier (en Kio - 1 024 o)
            M             taille de fichier (en Mo  - 1 000 000 o)
            MI            taille de fichier (en Mio - 1 048 576 o)
            G             taille de fichier (en Go  - 1 000 000 000 o)
            GI            taille de fichier (en Gio - 1 073 741 824 o)

            Des caractres souligns ('_') sont permis pour indiquer le
            nombre de fichier ou la taille de chacun (exemple : 
            "S:3_000M" produit des fichiers de 3 000 000 octets). 

            Remarques
            Lors d'un dcoupage en nombre de fichiers, la taille de chacun
            est calcule en divisant la taille du fichier  dcouper par
            le nombre de fichiers. Les tailles de fichier ne peuvent tre
            que des nombres entiers. souvent les tailles des parties
            doivent tre arrondies au suprieur. Pour cette raison,
            lorsque le nombre de parties est plus grand que la taille en
            octets d'une seule, le nombre rel de parties du fichier peut
            tre infrieur au nombre entr. 

<nomfich>
            indique le nom du fichier  dcouper. Les jokers ne sont pas
            permis. Il peut tre plac  n'importe quelle position aprs
            le paramtre de commande 'S'. 

Options de dcoupage : 
   /C[:nomfich.cmd]
            cre un fichier batch permettant de recomposer le fichier
            complet  partir des diffrents fichiers. 
            Le fichier batch est nomm join.cmd  moins que l'utilisateur
            n'indique un nom diffrent. 
            Le fichier batch peut tre modifi  votre convenance si les
            parties du fichier sont places dans un chemin diffrent ou
            si le fichier recompos ne doit pas tre cr dans le
            rpertoire de travail. 
            Lorsque que le chemin du fichier batch n'est pas prcis, il
            est crit au mme endroit que les parties de fichiers. 
            Exemples:
            FSJ S:3 /C monDVD.iso
               cre un fichier batch par dfaut nomm join.cmd.
            FSJ S:5 -c:F:\parties\monDVD\creerDVD.cmd monDVD.iso
               cre un fichier batch par nomm creerDVD.cmd

   /O[:specfich]
            prcise le chemin et/ou le nom des parties du fichier en
            sortie. Lorsque l'option est omise, les fichiers sont crs
            dans le chemin en cours en utilisant le nom par dfaut de
            pie?????.fsj o ????? est remplac par le numro du fichier
            (exemple : si un fichier est scind en 5 parties, ces
            dernires seront nommes de pie00001.fsj  pie00005.fsj). 

            Pour indiquer juste un chemin de sortie (en utilisant les
            noms de fichier par dfaut) 'specfich' doit se terminer par
            une barre oblique vers la gauche '\' (exemple : 
            "/O:d:\GraverSurCD\"). 

            Dans les noms de parties du fichier, le point d'interrogation
            ('?') est utilis  la place de chaque chiffre qui compose le
            "numro d'index" de chaque partie. 
            Par exemple, la commande : 
            FSJ S:3 /O:monCD???.part
            produit : monCD001.part, monCD002.part et monCD003.part.
            Lorsque cela est ncessaire, le nombre de chiffres est
            automatiquement augment pour permettre un nommage correct de
            chaque partie du fichier. Ainsi, s'il y a 100 lments et
            que le masque de fichier n'est que 'abc?.ext', il sera
            automatiquement transform en abc???.ext. 

   Les autres options communes sont dcrites aprs la commande de
   recomposition. 


Mode recomposition
------------------

La commande de recomposition est invoque  l'aide de l'un des caractres
'j' or 'J'. Les noms des fichiers  recomposer en un unique fichier
peuvent tre indiqus de trois faons diffrentes : 

-1) comme une liste explicite de parties du fichier :
   FSJ J[:sortie] <PartieFichier_1> ... <PartieFichier_n> [/D:chemin]
                  [/B:nnn] [/U | /W[:N|1]] [/Q] [/P] [/L[:Rapport]]

-2) les parties du fichier sont listes dans un fichier texte (un par
    ligne) :
   FSJ J[:sortie] [/F:ListeFichiers] [/D:chemin]
                  [/B:nnn] [/U | /W[:N|1]] [/Q] [/P] [/L[:Rapport]]

-3) les parties du fichier sont indiques selon leur nombre et un masque
    de fichiers o le point d'interrogation ('?') est utilis  la place
    de chaque chiffre qui compose le "numro d'index" de chaque partie : 
   FSJ J[:sortie] [/I:nombre:SpecFich]
                  [/B:nnn] [/U | /W[:N|1]] [/Q] [/P] [/L[:Rapport]]

Paramtres de la commande de recomposition : 
   :sortie
            prcise le nom du fichier  crer en rassemblant ses
            difrentes parties. 
            Lorsque ce paramtre est omis, le nom par dfaut
            ("wholefil.fsj") est utilis. 

<PartieFichier_1> ... <PartieFichier_n>
            sont les noms des parties du fichier entrs comme argument de
            ligne de commandes. Ces paramtres sont incompatibles avec les
            options /F ou /I. 

Options de recomposition : 
   /D:chemin
            indique le chemin d'accs commun  toutes les parties du
            fichier. Cette option n'est valide que lorsque les noms des
            parties du fichier sont entrs en paramtre de ligne de
            commandes ou quand elles sont listes dans un fichier texte. 

   /F:ListeFichiers
            indique le nom d'un fichier texte contenant (dans l'ordre
            appropri) les noms des parties du fichier, un par ligne. 
            Le fichier peut prsenter des lignes vides mais il ne doit
            pas dbuter ou finir par des espaces,  moiuns qu'ils ne
            fassent partie d'un nom de fichier. 

   /I:nombre:SpecFich
            'nombre' est un nombre entier dterminant le nombre de
            parties du fichier; 'SpecFich' est un nom de fichier
            comportant des points d'interrogation dfinissant le
            nombre de chiffres du numro d'index de chaque partie. Par
            exemple : /I:3:Partie???.iso recompose les 3 fichiers
            Partie001.iso, Partie002.iso et Partie003.iso. 
            Lorsque cela est ncessaire, le nombre de chiffres est
            automatiquement augment pour permettre un nommage correct de
            chaque partie du fichier. Ainsi, s'il y a 100 lments et
            que le masque de fichier n'est que 'abc?.ext', il sera
            automatiquement transform en abc???.ext. 
            Lorsque les fichiers  rassembler ne se trouvent pas dans le
            rpertoire courant, 'SpecFich' doit faire figurer le chemin
            d'accs vers les fichiers. Par exemple : 
            /I:3:d:\tlchargement\Partie???.iso

   Les autres options communes sont dcrites ci-dessous. 


Options communes
----------------

   /B:nnn
            taille en Mio du tampon utilis pour la lecture et l'criture
            des fichiers, o nnn est un nombre compris entre 0 et 1024. 
            Lorsque l'option est omise, la taille du tampon est
            paramtre  1Mio? Lorsque la valeur est  0 ('/B:0'), la
            taille du tampon est alors de 64kio. 
            Si the noyau prend en charge les gros objets mmoire, le
            tampon est allou au-dessus des 512Mo de mmoire. 
            S'il n'y a pas assez de mmoire, la taille de tampon est
            automatiquement rduite au maximum de la mmoire disponible. 
            Si la taille de tampon excde la taille des parties du
            fichier, elle est automatiquement aligne sur un multiple de
            la taille de l'une de ces parties. 

   /U
            ("Unattended") lance le programme en mode sans intervention,
            vitant toute demande de confirmation provoque par des
            erreurs non critiques. Chaque condition d'erreur est
            considre comme critique et provoquera l'arrt de
            l'excution du programme. 
            Cette option est incompatible avec l'option /W. Si les deux
            options sont indiques, le programme s'interrompt avec un
            message d'erreur. 

   /W
            ("Wait") fait une pause avant d'crire (mode dcoupage) ou de
            lire (mode recomposition) chaque partie du fichier de manire
             autoriser le changement de support amovible. 

            Lors de la recomposition de parties du fichier final depuis
            un support amovible, avant de dbuter l'opration de
            recomposition, FSJ essaie d'accder  toutes les parties du
            fichier pour calculer la taille du fichier rsultant. 
            Il est possible de forcer ce comportement en ajoutant le
            paramtre spocifique /W : 
            /W:1   ne fait vrifier par FSJ uniquement que la taille de
                   la premire des parties du fichier. La taille totale
                   du fichier  crer est calcule en multipliant la
                   taille de cette premire partie par le nombre total de
                   parties. Dans ce cas, la barre de progression affiche
                    l'cran peut ne pas tre trs exacte.                    
            /W:N   vite toute vrification de taille. L'affichage de la
                   barre de progression est dsactive. 

            Cette option est incompatible avec l'option /W. Si les deux
            options sont indiques, le programme s'interrompt avec un
            message d'erreur. 

   /Q
            ("Quiet") n'affiche aucune information  l'cran. 

   /P
            affiche une barre de progression. 

   /R       ("Run") sert  accrotre ou diminuer la priorit d'excution
            du programme : 
            /R+    force l'excution en priorit serveur au premier-plan,
            /R-    force l'excution en priorit basse. 

   /L[:Rapport]
            les messages de travail et d'erreur sont crits  l'cran
            (si l'option /Q n'a pas t spcifie) et vers le fichier de
            rapport indiqu. Si le fichier de rapport n'est pas donn, un
            fichier fsj.log est cr dans le chemin %LOGFILE% s'il existe
            ou dans le rpertoire de travail en cours sinon. 

   /V       ("Verbose") donne des dtails sur toutes les opration d'E/S
            sur les fichiers. /Q ("Quiet") prend le pas sur l'option /V. 


Remarques
---------

* Le dcoupage et la recomposition de fichier est limite  maximum de
  99 999 parties. 


Support :
---------
Page WWW : http://xoomer.virgilio.it/acantato
Ml      : acantatore@tin.it

  [ Traduction franaise : Guillaume Gay <guillaume.gay@bigfoot.com> ]
