
                              'X-FileTools Package'
                               ~~~~~~~~~~~~~~~~~~~
                              ©1995 by Ron Klinkien


                    16 april 1995, Sliedrecht, The Netherlands.

Some Words:
~~~~~~~~~~

Hello, this time I grabbed all of my xenolink file tools together and recompiled
them with SAS/C 6.55 for Xenolink 1.95. Some are new, others are enhanced.

As always they are public domain and you can do with it whatever you want, except
selling them for loads of money without sharing it with me ;) ...

I do not take any responsibility regarding any possible damage that can occure
when using these tools on your filebase/hd ...

I have used them succesfully to move/edit/delete more than 8000 files when I was
adapting my BBS setup to work as an semi-automatic aminet-mirror ...

The following tools are all small cli-commands which you can use from shells and/or
scripts/diskmaster/dopus/whatever ...

You can type only the filename if you want to know their syntax (they _don't_ start
deleting/changing anything without any arguments ... which is quite nice ;)

Now some small info on them:

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

BulkFile V1.00: ( formerly known as RBulk )
~~~~~~~~~~~~~~

The best and smallest FileBulker for Xenolink! Ahum. :)

--- Syntax: ---

BulkFile FILEORDIR/A, S=SECTION/A, U=UPLOADER/K, D=DESCRIPTION/F


-- Examples: --

BulkFile DH3:NewStuff S=14  ( Uploads whole directory Newstuff to Section #14  )

BulkFile DH1:X-FileTools.lha S=10 U="Ron Klinkien" D=This is a great new package!
( Uploads file NewFile.lha to Section #10, uploader and Description user defined )

-- More Info: -

So, you can supply one filename to bulk one file, or a directory name to upload a
complete directory in one blow...! ( So Be carefull! )

If you don't supply a file description, the filecomments will be used (if avail. )
else < No Description Available ... > will be used.

If you don't supply a Uploader 'BulkFile' will be used.

One thing. BulkFile doesn't move files to their filecat directory.
So if you bulk-upload them from another directory than their filecat directory
copy them to the right dir after you bulked them to a filesection.

( U can check your filebase on lost files with ChkFile, more on this later ... )

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

DelFile V1.01:
~~~~~~~~~~~~~

Small command to delete file(s) from the xenolink filecatalogue and/or harddisk.
There is an option to keep the physical file on your hd.

--- Syntax: ---

DelFile FILE/A, K=KEEPFILE/S

-- Examples: --

DelFile oldfile.lha      ( to delete filecat entry AND file from disk )
DelFile oldfile.lha K    ( to delete filecat entry but keep file on disk )

-- More Info: -

You can also use it from DiskMaster 2.1 with this entry in S:Startup.DM:

--- cut ---

AddCmd DelFile, 30, StdIO "CON:0/12/640/80/DelFile Output...";
                  external XENOLINK:Utilities/3rdParty/DelFile %s;Wait;StdIO Close
--- cut ---

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

CommFile V1.00: ( formerly known as SetDOSComment )
~~~~~~~~~~~~~~

Do you have the same problem as me, that a lot of your files on disk do not have
their DOS FileComments filled anymore? Due to some strange working copies of
XYZMove or Xenolink V1.90 they have dissapeared after a file move ...

Then this is the tool for you..

It picks the FileDescription from the BBS and puts it back in the DOS FileComment
again. (ofcourse only the first 80 chars, since ADOS doesn't support more)

--- Syntax: ---

CommFile FILE/A

-- More Info: -

You can also use it from DiskMaster 2.1 with this entry in S:Startup.DM:

--- cut ---

AddCmd CommFile, 30, StdIO "CON:0/12/640/110/CommFile Output...";
                  external XENOLINK:Utilities/3rdParty/CommFile %s;Wait;
                  StdIO Close
--- cut ---

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

ChkFile V1.00: ( formerly known as CheckFileCat )
~~~~~~~~~~~~~

Did you have had some small HD crashes lately and wonder if all the files in your
filecatalogue are still on your HD?
Then you can use this tool to check it ...

--- Syntax: ---

ChkFile S=SECTION/A,SIZE=CHKSIZE/S,DEL=DELFROMDISK/S


-- Examples: --

ChkFile S=10      ( check filearea 10 for files on disk )
ChkFile S=10 DEL  ( same, but also delete filecat entries for files not on disk )
ChkFile S=20 SIZE ( check files in area 20 on incorrect filelength in filecat )

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

MoveFile V1.00: ( new command )
~~~~~~~~~~~~~~

Move files from one file section to another.

--- Syntax: ---

MoveFile FILE/A,S=SECTION/A

-- Examples: --

MoveFile test.lha S=20   ( move file test.lha to section 20 )


Nothing more to tell about it really ... ;)

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

RenFile V1.00: ( new command )
~~~~~~~~~~~~~
Thanks to Tommy Green for his ReLinkFile() routine!


With this command you can rename your files ( on disk and in filecat ).

--- Syntax: ---

RenFile FROM/A,TO/A

-- Examples: --

RenFile wrongname.lha goodname.lha

Note: It only renames the filename in your filecat and the physical file on disk.
      The upload date/time and other values in the filecat are not altered.

Any questions left? ;)

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

AmiFile V1.00: ( new command )
~~~~~~~~~~~~~

This is one of those utils that you only need to program and run once, but still
saves a hell of alot of time ;)

If you want to alter your filebase to setup an aminet mirror, ( like I did ) but
are wondering how to configure all those 175+ file areas, this is the tool for
you ...

It uses one config file 'AmiFile.map' and generates two files 'AmiFile.file' and
'AmiFile.init'.

AmiFile.map looks like this:
--- cut ---
61 biz/demo      Demo versions of commercial software
62 biz/misc      Misc business type soft
--- cut ---
^     ^             ^
|     |             Description from aminet TREE file
|     Path of aminet tree, so you get MIRROR:biz/demo/ etc.
Number of your new file area

The first output file 'AmiFile.file' can be joined with your current File.config.
( it contains all the new file areas in the same format as your current config )
It uses MIRROR: as base assign, if you want to use another simply search/replace
this with your favorite editor ofcourse ...

The second output file AmiFile.init' is an script to initialise all those areas.
( you can execute it, after double checking it's contents that is!!! )

Make a backup of your XENOLINK:FileCat/ dir before executing these ( if you have
mistyped an areanumber in AmiFile.map a current filearea can be overwritten!!! )

--- Syntax: ---

AmiFile 


-- More Info: -

Make sure you have edited AmiFile.map to suit your needs before making the final
files ...

I'm currently writing arexx scripts and menu files to complete this aminet mirror
software ...

But if you cannot wait check out MirrorManager on aminet! It can save you alot of
work ...

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

To contact me:
----------------------------------------------------------------------------------
 *** The Amiga Hardware BBS - Aminet Mirror - 1.6 Gig - 2 lines - ISDN - News ***
 ***  Line 1: +31-1840-99935  (USR DStd V34, VFC, HST & ISDN 38K4/64K now!)   ***
 ***             Line 2: +31-1840-90323  (USR DStd V32Bis, HST)               ***
 *** FidoNet: 2:285/302.0  e-mail: ron@ahwbbs.xs4all.nl  NLANet: 14:100/103.0 ***
----------------------------------------------------------------------------------

B   : Butt-head, this turd won't come out of my butt!
BH  : Have you tried using manners?
B   : Oh yeah.  Please, please come out of my butt!
Turd: Plop!
B   : Thank you, drive through!

                              --- Beavis & Butt-head.

Greetz, Ron Klinkien.
