JFS.IFS README
beta

March 09, 2010

This README contains information about
JFS.IFS for eComStation

Contents:
* What to test
* Installation
* Commandline
* Package components
* Restrictions of JFS.IFS
* Instructions for beta-tester
* Contacts


=== What to test? ===

1) Eject flash disk with JFS filesystem
2) test long format (/L option) on disks with bad blocks.


=== Installation ===

* Backup the files from original directory,
* Copy new files (including .sym - important for debugging)
* Reboot


=== Commandline ===

Basic information:
ENG: http://www.edm2.com/index.php/The_Config.sys_Documentation_Project/IFS_Statements#IFS.3DJFS.IFS
RUS: http://ru.ecomstation.ru/showarticle.php?id=84

IFS=C:\OS2\JFS.IFS /LW:2,10,4 /AUTOCHECK:* /CACHE:32000 /P:1 /RO:G

/P:N -- use COM port N for debug output
        N = 1 or 2 for COM1 or COM2 or N = port address (i.e. 3f8)
        if /P is used then comport will be intialized with 115200 bps
/PI:N -- as well initialise N comport to 115200,8,1

/RO:*  -- All JFS disk will be read only
/RO:GF -- G: and F: disks are readonly when mounted

/ERO:* = All JFS disks are auto-readonly,
         (i.e. disks make become read only in case of errors and/or dirty flag)
/ERO:GF - G and F ared auto-readonly


=== Package components: ===

  cachejfs.exe   - query and set parameters of cache
  cstats.exe     - query usage of cache
  extendfs.exe   - for internal use
  jfs.ifs        - IFS driver
  jfschk32.exe   - chkdsk launcher during boot (can be used instead of chkdsk)

  dll\
    ujfs.dll     - used by utilities: format, sys, chkdsk

  bugtracker\    - tools for beta-tester
    chklgjfs.exe - show results of last chkdsk
    dumpfs.exe   - dump internal structure of JFS
    logdump.exe  - dump current state of log to \JFSLOG.DMP
    validfs.exe  - show current state of JFS
    xchkdmp.exe  - show results from chkdsk.new
    xchklog.exe  - dump results of last chkdsk to \chkdsk.new
    xpeek.exe    - utility for interactive work with structure of JFS


=== Restrictions of JFS.IFS ===

Attention:
* Bootable JFS is not able load drivers larger than 2 Gb (gigabytes) ?????? not verified information
* Size of cluster must be: 4096 bytes
* Size of sector: 512 bytes
* You can't use Bootable JFS with SCSI (can't boot from JFS)

Other restrictions:
1) possible troubles on some notebooks/brand computers; may be overcommed.
2) you should install it on the first hard disk,
3) you should install boojfs on the first partition after MBR,
4) create two or more JFS partitions
5) can't be expanded


=== Instructions for beta-tester: ===

If you have a trap then you can collect logs.

Post bug-report:
http://trac.ecomstation.ru/JRescuer/report/1
-> [New ticket]
(login: ecotrac, password: nhfrerth)


1) How to catch log via COM-port:

To catch logs you need NULL-modem cable, the 2-nd computer,
run terminal utility there.

  a) Enable debug mode in command line of JFS.IFS

  b) There are some terminal utilities:
    * comTerm  -- http://ecomstation.ru/projects/developer/downloads/comterm-20090620.zip
         How to use? run t.cmd
    * ZOC  -- http://www.emtec.com/download.html
      Terminal settings (???):
        115200,8,N,1  HW flow support.
        (ZOC: [x] RTS, [x] CD)
    * dtrem terminal program

  c) Notes:
     * Attach the second connector to turned off PC else COM-port may burn.
     * If PC hangs then try boot again 1-2 times


2) Creating a dump:

  If you find a bug, please
   *) run

        xchklog.exe v:

      where "v" is drive letter

   *) run

        logdump.exe v:

      where "v" is drive letter

   *) Send these files to developer:

      \chkdsk.new
      \JFSLOG.DMP



=== Contacts ===

eCo Software: http://ecomstation.ru/ecosoft
Homepage of JFS: http://ecomstation.ru/jfs




