Introduction
~~~~~~~~~~~~
Proof of concept, an educational way to approach a difficult subject: 
Why my USB stick doesn't want to work ?

Sample program to access an USB mass storage device through libusb on Linux 
based on the work of Hiroka Ihara
https://github.com/ihr486/libusb-msdbot  

Compiler needed
~~~~~~~~~~~~~~~
gcc (ADE) and sasc 6.58
ADE can be found here https://aminet.net/package/dev/gcc/ADE

The files
~~~~~~~~~
main.c           the main program
usb_device.h
usb_device.c     how to access to usb device, adapted to the ANAIIS/Sirion stack
mass_storage.h
mass_storage.c   some handy functions to manage the bulk only protocol

and other files
config.h
args.h
args.c           Amiga specific, CLI Workbench icon parameters
libs.h
libs.c           Amiga specific, something to delay
dump.h
dump.c           MBR/BPB dump

Future
~~~~~~
- read RDB or MBR to detect the filesystem to use.


Steps
~~~~~
V0.04 14-May-2025 Fix testunitready
      27-Sep-2024 Complete MBR/BPB dump

V0.03 28-Sep-2024 block zero dump

V0.02 23-Apr-2024 bump release

V0.01 03-Sep-2023 basic checks
      02-Sep-2023 gcc version
      01-Sep-2023 CLI/WB arguments
      31-Jul-2023 Adapt libusb code to ANAIIS


Contact address
~~~~~~~~~~~~~~~
Any mail, comments, suggestions, documentations are welcome!

Please send a mail with the title "ANAIIS" at the following mail address
gilles dot pelletier at live dot fr

Many thanks.

 PERMSSN    UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[Amiga]                    895    1668  53.7% -lh5- 4f1b May  8  2025 Anaiis_functions/xmass/anaiis_xmass.readme
[Amiga]                    746    2503  29.8% -lh5- 404a Apr 20  2024 Anaiis_functions/xmass/args.c
[Amiga]                    258     478  54.0% -lh5- 5091 Sep 28  2024 Anaiis_functions/xmass/args.c.info
[Amiga]                     45      45 100.0% -lh0- 363d Sep 11  2023 Anaiis_functions/xmass/args.h
[Amiga]                    215     478  45.0% -lh5- b4e9 Sep 28  2024 Anaiis_functions/xmass/args.h.info
[Amiga]                     70     115  60.9% -lh5- fc64 Sep 11  2023 Anaiis_functions/xmass/config.h
[Amiga]                    215     478  45.0% -lh5- af3d Sep 28  2024 Anaiis_functions/xmass/config.h.info
[Amiga]                   1528    8577  17.8% -lh5- 58f5 Mar 14  2025 Anaiis_functions/xmass/dump.c
[Amiga]                    260     478  54.4% -lh5- 405f Sep 28  2024 Anaiis_functions/xmass/dump.c.info
[Amiga]                    117     193  60.6% -lh5- 19ee Mar 14  2025 Anaiis_functions/xmass/dump.h
[Amiga]                    214     478  44.8% -lh5- 1b73 Sep 28  2024 Anaiis_functions/xmass/dump.h.info
[Amiga]                    269     628  42.8% -lh5- 5b8f Sep 28  2024 Anaiis_functions/xmass/gcc.info
[Amiga]                    256     628  40.8% -lh5- 958c Sep 11  2023 Anaiis_functions/xmass/gcc/bin.info
[Amiga]                  12557   23100  54.4% -lh5- 1eca Sep  1 20:05 Anaiis_functions/xmass/gcc/bin/xmass
[Amiga]                    415     854  48.6% -lh5- 1434 Mar 25  2024 Anaiis_functions/xmass/gcc/bin/xmass.info
[Amiga]                      5       5 100.0% -lh0- be68 Sep 11  2023 Anaiis_functions/xmass/gcc/build
[Amiga]                    482     834  57.8% -lh5- c94b Sep 11  2023 Anaiis_functions/xmass/gcc/Build.info
[Amiga]                    336    1344  25.0% -lh5- d1b0 Jun  8  2025 Anaiis_functions/xmass/gcc/makefile
[Amiga]                    188     830  22.7% -lh5- 8e52 Mar 25  2024 Anaiis_functions/xmass/gcc/makefile.info
[Amiga]                    259     628  41.2% -lh5- 127b Sep 11  2023 Anaiis_functions/xmass/gcc/obj.info
[Amiga]                    842    1863  45.2% -lh5- 071a Apr 23  2024 Anaiis_functions/xmass/gcc/obj/args.o
[Amiga]                   1188    2450  48.5% -lh5- 32e3 Sep  1 20:04 Anaiis_functions/xmass/gcc/obj/dump.o
[Amiga]                    166     261  63.6% -lh5- 2be4 Sep  1 20:04 Anaiis_functions/xmass/gcc/obj/libs.o
[Amiga]                   2384    5209  45.8% -lh5- dab9 Sep  1 20:04 Anaiis_functions/xmass/gcc/obj/main.o
[Amiga]                   1597    3305  48.3% -lh5- 1bc2 Sep  1 20:04 Anaiis_functions/xmass/gcc/obj/mass_storage.o
[Amiga]                   2982    6214  48.0% -lh5- 042a Sep 28  2024 Anaiis_functions/xmass/gcc/obj/usb_device.o
[Amiga]                    252     628  40.1% -lh5- 6ff8 Sep 11  2023 Anaiis_functions/xmass/gcc/res.info
[Amiga]                    415     854  48.6% -lh5- 1434 Mar 25  2024 Anaiis_functions/xmass/gcc/res/xmass.info
[Amiga]                    257     628  40.9% -lh5- 6afc Sep 28  2024 Anaiis_functions/xmass/include.info
[Amiga]                    153     266  57.5% -lh5- 8ef7 Sep 11  2023 Anaiis_functions/xmass/include/clib/usbfd_protos.h
[Amiga]                    270     869  31.1% -lh5- 968f Sep 11  2023 Anaiis_functions/xmass/include/clib/usbhcd_protos.h
[Amiga]                    348     732  47.5% -lh5- 9ca1 Sep 11  2023 Anaiis_functions/xmass/include/clib/usbresource_protos.h
[Amiga]                    996    5749  17.3% -lh5- 578e Sep 11  2023 Anaiis_functions/xmass/include/clib/usbsys_protos.h
[Amiga]                   1647   10034  16.4% -lh5- 2d6c Sep 11  2023 Anaiis_functions/xmass/include/inline/usbsys.h
[Amiga]                    307     784  39.2% -lh5- fa72 Sep 11  2023 Anaiis_functions/xmass/include/pragmas/usbfd_pragmas.h
[Amiga]                    455    1677  27.1% -lh5- 4e4e Sep 11  2023 Anaiis_functions/xmass/include/pragmas/usbhcd_pragmas.h
[Amiga]                    387    1381  28.0% -lh5- 13be Sep 11  2023 Anaiis_functions/xmass/include/pragmas/usbresource_pragmas.h
[Amiga]                   1199    6858  17.5% -lh5- 67a8 Sep 11  2023 Anaiis_functions/xmass/include/pragmas/usbsys_pragmas.h
[Amiga]                    487    1482  32.9% -lh5- 9caf Sep 11  2023 Anaiis_functions/xmass/include/proto/usbfd.h
[Amiga]                    517    1563  33.1% -lh5- 4907 Sep 11  2023 Anaiis_functions/xmass/include/proto/usbhcd.h
[Amiga]                    542    1710  31.7% -lh5- 6bf1 Sep 11  2023 Anaiis_functions/xmass/include/proto/usbresource.h
[Amiga]                    492    1501  32.8% -lh5- 965f Sep 11  2023 Anaiis_functions/xmass/include/proto/usbsys.h
[Amiga]                    187     404  46.3% -lh5- bb81 Sep 11  2023 Anaiis_functions/xmass/include/readme
[Amiga]                    473    1099  43.0% -lh5- 1697 Sep 11  2023 Anaiis_functions/xmass/include/usb/devclasses.h
[Amiga]                   2000    6157  32.5% -lh5- 90da Sep 11  2023 Anaiis_functions/xmass/include/usb/hub.h
[Amiga]                   5330   18860  28.3% -lh5- c9b5 Sep 11  2023 Anaiis_functions/xmass/include/usb/system.h
[Amiga]                   2603    8294  31.4% -lh5- 951d Sep 11  2023 Anaiis_functions/xmass/include/usb/usb.h
[Amiga]                    637    1714  37.2% -lh5- f031 Sep 11  2023 Anaiis_functions/xmass/include/usb/usbtags.h
[Amiga]                     79     111  71.2% -lh5- 0413 Jun  8  2025 Anaiis_functions/xmass/libs.c
[Amiga]                    260     478  54.4% -lh5- 56c7 Sep 28  2024 Anaiis_functions/xmass/libs.c.info
[Amiga]                    116     174  66.7% -lh5- d1d6 Jun  8  2025 Anaiis_functions/xmass/libs.h
[Amiga]                    210     478  43.9% -lh5- d029 Sep 28  2024 Anaiis_functions/xmass/libs.h.info
[Amiga]                   2469   10468  23.6% -lh5- aa0a Jun  9  2025 Anaiis_functions/xmass/main.c
[Amiga]                    260     478  54.4% -lh5- 405f Sep 28  2024 Anaiis_functions/xmass/main.c.info
[Amiga]                   1727    8636  20.0% -lh5- 27b3 May  4  2025 Anaiis_functions/xmass/mass_storage.c
[Amiga]                    259     478  54.2% -lh5- 6741 Sep 28  2024 Anaiis_functions/xmass/mass_storage.c.info
[Amiga]                    492    1275  38.6% -lh5- aeb8 May  4  2025 Anaiis_functions/xmass/mass_storage.h
[Amiga]                    214     478  44.8% -lh5- 1b73 Sep 28  2024 Anaiis_functions/xmass/mass_storage.h.info
[Amiga]                    269     628  42.8% -lh5- 5b8f Sep 28  2024 Anaiis_functions/xmass/sas.info
[Amiga]                    271     628  43.2% -lh5- 3296 Sep 11  2023 Anaiis_functions/xmass/sas/bin.info
[Amiga]                  12717   22144  57.4% -lh5- 6bfa Sep  1 19:14 Anaiis_functions/xmass/sas/bin/xmass
[Amiga]                    419     854  49.1% -lh5- b276 Apr 14  2024 Anaiis_functions/xmass/sas/bin/xmass.info
[Amiga]                    491     837  58.7% -lh5- 6e53 Sep 11  2023 Anaiis_functions/xmass/sas/Build.info
[Amiga]                   1711    2632  65.0% -lh5- a81a Sep 11  2023 Anaiis_functions/xmass/sas/Debug
[Amiga]                    363     822  44.2% -lh5- 24e5 Sep 11  2023 Anaiis_functions/xmass/sas/Debug.info
[Amiga]                    536     834  64.3% -lh5- 4a5c Sep 11  2023 Anaiis_functions/xmass/sas/Edit.info
[Amiga]                    439     838  52.4% -lh5- 1c20 Sep 11  2023 Anaiis_functions/xmass/sas/Find.info
[Amiga]                    412    1235  33.4% -lh5- 45d8 Sep 28  2024 Anaiis_functions/xmass/sas/makefile
[Amiga]                    197     834  23.6% -lh5- 9141 Sep 11  2023 Anaiis_functions/xmass/sas/makefile.info
[Amiga]                    271     628  43.2% -lh5- 018e Sep 11  2023 Anaiis_functions/xmass/sas/obj.info
[Amiga]                    770    1376  56.0% -lh5- 0635 Apr 23  2024 Anaiis_functions/xmass/sas/obj/args.o
[Amiga]                   1350    2676  50.4% -lh5- 3d11 May  4  2025 Anaiis_functions/xmass/sas/obj/dump.o
[Amiga]                    207     284  72.9% -lh5- c0d6 Sep  1 19:14 Anaiis_functions/xmass/sas/obj/libs.o
[Amiga]                   2393    4752  50.4% -lh5- 6b16 Sep  1 19:14 Anaiis_functions/xmass/sas/obj/main.o
[Amiga]                   1767    3808  46.4% -lh5- 1812 May  4  2025 Anaiis_functions/xmass/sas/obj/mass_storage.o
[Amiga]                   2394    4188  57.2% -lh5- c2e2 Apr 23  2024 Anaiis_functions/xmass/sas/obj/usb_device.o
[Amiga]                    445    2950  15.1% -lh5- 8fc0 Sep 11  2023 Anaiis_functions/xmass/sas/SCoptions.info
[Amiga]                   5001   20032  25.0% -lh5- 6743 Apr 23  2024 Anaiis_functions/xmass/usb_device.c
[Amiga]                    256     478  53.6% -lh5- 9400 Sep 28  2024 Anaiis_functions/xmass/usb_device.c.info
[Amiga]                    325     689  47.2% -lh5- 7d2f Mar 24  2024 Anaiis_functions/xmass/usb_device.h
[Amiga]                    214     478  44.8% -lh5- 859f Sep 28  2024 Anaiis_functions/xmass/usb_device.h.info
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total        81 files   87747  234567  37.4%            Jan 21 01:44