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.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.

PERMISSION  UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP     NAME
---------- ----------- ------- ------- ------ ---------- ------------ ----------
[unknown]                  857    1591  53.9% -lh5- a180 Sep 28 14:31 Anaiis_functions/xmass/anaiis_xmass.readme
[unknown]                  746    2503  29.8% -lh5- 404a Apr 20  2024 Anaiis_functions/xmass/args.c
[unknown]                  258     478  54.0% -lh5- 5091 Sep 28 14:28 Anaiis_functions/xmass/args.c.info
[unknown]                   45      45 100.0% -lh0- 363d Sep 11  2023 Anaiis_functions/xmass/args.h
[unknown]                  215     478  45.0% -lh5- b4e9 Sep 28 14:28 Anaiis_functions/xmass/args.h.info
[unknown]                   70     115  60.9% -lh5- fc64 Sep 11  2023 Anaiis_functions/xmass/config.h
[unknown]                  215     478  45.0% -lh5- af3d Sep 28 14:28 Anaiis_functions/xmass/config.h.info
[unknown]                 1562    8651  18.1% -lh5- 9734 Sep 30 20:22 Anaiis_functions/xmass/dump.c
[unknown]                  260     478  54.4% -lh5- 405f Sep 28 14:28 Anaiis_functions/xmass/dump.c.info
[unknown]                   82     120  68.3% -lh5- 417b Sep 28 14:14 Anaiis_functions/xmass/dump.h
[unknown]                  214     478  44.8% -lh5- 1b73 Sep 28 14:28 Anaiis_functions/xmass/dump.h.info
[unknown]                  269     628  42.8% -lh5- 5b8f Sep 28 14:28 Anaiis_functions/xmass/gcc.info
[unknown]                  256     628  40.8% -lh5- 958c Sep 11  2023 Anaiis_functions/xmass/gcc/bin.info
[unknown]                12630   25052  50.4% -lh5- d51a Sep 30 20:24 Anaiis_functions/xmass/gcc/bin/xmass
[unknown]                  415     854  48.6% -lh5- 1434 Mar 25  2024 Anaiis_functions/xmass/gcc/bin/xmass.info
[unknown]                    5       5 100.0% -lh0- be68 Sep 11  2023 Anaiis_functions/xmass/gcc/build
[unknown]                  482     834  57.8% -lh5- c94b Sep 11  2023 Anaiis_functions/xmass/gcc/Build.info
[unknown]                  315    1169  26.9% -lh5- 79ea Sep 28 14:25 Anaiis_functions/xmass/gcc/makefile
[unknown]                  188     830  22.7% -lh5- 8e52 Mar 25  2024 Anaiis_functions/xmass/gcc/makefile.info
[unknown]                  259     628  41.2% -lh5- 127b Sep 11  2023 Anaiis_functions/xmass/gcc/obj.info
[unknown]                  842    1863  45.2% -lh5- 071a Apr 23  2024 Anaiis_functions/xmass/gcc/obj/args.o
[unknown]                 1326    3675  36.1% -lh5- 7c94 Sep 30 20:24 Anaiis_functions/xmass/gcc/obj/dump.o
[unknown]                  184     285  64.6% -lh5- 1a5c Apr 23  2024 Anaiis_functions/xmass/gcc/obj/libs.o
[unknown]                 2217    5007  44.3% -lh5- e617 Sep 28 14:25 Anaiis_functions/xmass/gcc/obj/main.o
[unknown]                 1629    4100  39.7% -lh5- 68c3 Apr 23  2024 Anaiis_functions/xmass/gcc/obj/mass_storage.o
[unknown]                 2982    6214  48.0% -lh5- 042a Sep 28 14:25 Anaiis_functions/xmass/gcc/obj/usb_device.o
[unknown]                  252     628  40.1% -lh5- 6ff8 Sep 11  2023 Anaiis_functions/xmass/gcc/res.info
[unknown]                  415     854  48.6% -lh5- 1434 Mar 25  2024 Anaiis_functions/xmass/gcc/res/xmass.info
[unknown]                  257     628  40.9% -lh5- 6afc Sep 28 14:28 Anaiis_functions/xmass/include.info
[unknown]                  153     266  57.5% -lh5- 8ef7 Sep 11  2023 Anaiis_functions/xmass/include/clib/usbfd_protos.h
[unknown]                  270     869  31.1% -lh5- 968f Sep 11  2023 Anaiis_functions/xmass/include/clib/usbhcd_protos.h
[unknown]                  348     732  47.5% -lh5- 9ca1 Sep 11  2023 Anaiis_functions/xmass/include/clib/usbresource_protos.h
[unknown]                  996    5749  17.3% -lh5- 578e Sep 11  2023 Anaiis_functions/xmass/include/clib/usbsys_protos.h
[unknown]                 1647   10034  16.4% -lh5- 2d6c Sep 11  2023 Anaiis_functions/xmass/include/inline/usbsys.h
[unknown]                  307     784  39.2% -lh5- fa72 Sep 11  2023 Anaiis_functions/xmass/include/pragmas/usbfd_pragmas.h
[unknown]                  455    1677  27.1% -lh5- 4e4e Sep 11  2023 Anaiis_functions/xmass/include/pragmas/usbhcd_pragmas.h
[unknown]                  387    1381  28.0% -lh5- 13be Sep 11  2023 Anaiis_functions/xmass/include/pragmas/usbresource_pragmas.h
[unknown]                 1199    6858  17.5% -lh5- 67a8 Sep 11  2023 Anaiis_functions/xmass/include/pragmas/usbsys_pragmas.h
[unknown]                  487    1482  32.9% -lh5- 9caf Sep 11  2023 Anaiis_functions/xmass/include/proto/usbfd.h
[unknown]                  517    1563  33.1% -lh5- 4907 Sep 11  2023 Anaiis_functions/xmass/include/proto/usbhcd.h
[unknown]                  542    1710  31.7% -lh5- 6bf1 Sep 11  2023 Anaiis_functions/xmass/include/proto/usbresource.h
[unknown]                  492    1501  32.8% -lh5- 965f Sep 11  2023 Anaiis_functions/xmass/include/proto/usbsys.h
[unknown]                  187     404  46.3% -lh5- bb81 Sep 11  2023 Anaiis_functions/xmass/include/readme
[unknown]                  473    1099  43.0% -lh5- 1697 Sep 11  2023 Anaiis_functions/xmass/include/usb/devclasses.h
[unknown]                 2000    6157  32.5% -lh5- 90da Sep 11  2023 Anaiis_functions/xmass/include/usb/hub.h
[unknown]                 5330   18860  28.3% -lh5- c9b5 Sep 11  2023 Anaiis_functions/xmass/include/usb/system.h
[unknown]                 2603    8294  31.4% -lh5- 951d Sep 11  2023 Anaiis_functions/xmass/include/usb/usb.h
[unknown]                  637    1714  37.2% -lh5- f031 Sep 11  2023 Anaiis_functions/xmass/include/usb/usbtags.h
[unknown]                   95     135  70.4% -lh5- 1305 Apr 23  2024 Anaiis_functions/xmass/libs.c
[unknown]                  260     478  54.4% -lh5- 56c7 Sep 28 14:28 Anaiis_functions/xmass/libs.c.info
[unknown]                   91     124  73.4% -lh5- 7829 Apr 23  2024 Anaiis_functions/xmass/libs.h
[unknown]                  210     478  43.9% -lh5- d029 Sep 28 14:28 Anaiis_functions/xmass/libs.h.info
[unknown]                 2127    8073  26.3% -lh5- e6ec Sep 28 14:20 Anaiis_functions/xmass/main.c
[unknown]                  260     478  54.4% -lh5- 405f Sep 28 14:28 Anaiis_functions/xmass/main.c.info
[unknown]                 1623    7865  20.6% -lh5- df97 Apr 21  2024 Anaiis_functions/xmass/mass_storage.c
[unknown]                  259     478  54.2% -lh5- 6741 Sep 28 14:28 Anaiis_functions/xmass/mass_storage.c.info
[unknown]                  474    1177  40.3% -lh5- c55e Mar 18  2024 Anaiis_functions/xmass/mass_storage.h
[unknown]                  214     478  44.8% -lh5- 1b73 Sep 28 14:28 Anaiis_functions/xmass/mass_storage.h.info
[unknown]                  269     628  42.8% -lh5- 5b8f Sep 28 14:28 Anaiis_functions/xmass/sas.info
[unknown]                  271     628  43.2% -lh5- 3296 Sep 11  2023 Anaiis_functions/xmass/sas/bin.info
[unknown]                12271   21020  58.4% -lh5- 8842 Sep 30 20:22 Anaiis_functions/xmass/sas/bin/xmass
[unknown]                  419     854  49.1% -lh5- b276 Apr 14  2024 Anaiis_functions/xmass/sas/bin/xmass.info
[unknown]                  491     837  58.7% -lh5- 6e53 Sep 11  2023 Anaiis_functions/xmass/sas/Build.info
[unknown]                 1711    2632  65.0% -lh5- a81a Sep 11  2023 Anaiis_functions/xmass/sas/Debug
[unknown]                  363     822  44.2% -lh5- 24e5 Sep 11  2023 Anaiis_functions/xmass/sas/Debug.info
[unknown]                  536     834  64.3% -lh5- 4a5c Sep 11  2023 Anaiis_functions/xmass/sas/Edit.info
[unknown]                  439     838  52.4% -lh5- 1c20 Sep 11  2023 Anaiis_functions/xmass/sas/Find.info
[unknown]                  412    1235  33.4% -lh5- 45d8 Sep 28 11:26 Anaiis_functions/xmass/sas/makefile
[unknown]                  197     834  23.6% -lh5- 9141 Sep 11  2023 Anaiis_functions/xmass/sas/makefile.info
[unknown]                  271     628  43.2% -lh5- 018e Sep 11  2023 Anaiis_functions/xmass/sas/obj.info
[unknown]                  770    1376  56.0% -lh5- 0635 Apr 23  2024 Anaiis_functions/xmass/sas/obj/args.o
[unknown]                 1350    2676  50.4% -lh5- 3d11 Sep 30 20:22 Anaiis_functions/xmass/sas/obj/dump.o
[unknown]                  207     284  72.9% -lh5- c0d6 Apr 23  2024 Anaiis_functions/xmass/sas/obj/libs.o
[unknown]                 1960    3628  54.0% -lh5- ecac Sep 28 14:20 Anaiis_functions/xmass/sas/obj/main.o
[unknown]                 1693    3612  46.9% -lh5- 960c Apr 23  2024 Anaiis_functions/xmass/sas/obj/mass_storage.o
[unknown]                 2394    4188  57.2% -lh5- c2e2 Apr 23  2024 Anaiis_functions/xmass/sas/obj/usb_device.o
[unknown]                  445    2950  15.1% -lh5- 8fc0 Sep 11  2023 Anaiis_functions/xmass/sas/SCoptions.info
[unknown]                 5001   20032  25.0% -lh5- 6743 Apr 23  2024 Anaiis_functions/xmass/usb_device.c
[unknown]                  256     478  53.6% -lh5- 9400 Sep 28 14:28 Anaiis_functions/xmass/usb_device.c.info
[unknown]                  325     689  47.2% -lh5- 7d2f Mar 24  2024 Anaiis_functions/xmass/usb_device.h
[unknown]                  214     478  44.8% -lh5- 859f Sep 28 14:28 Anaiis_functions/xmass/usb_device.h.info
---------- ----------- ------- ------- ------ ---------- ------------ ----------
 Total        81 files   86355  232376  37.2%            Oct  1 03:52