└── README.md


/README.md:
--------------------------------------------------------------------------------
 1 | # 3ds-microsd-on-linux
 2 | This is a guide detailing how to use 3DS microSD management on Linux.
 3 | 
 4 | ## Getting started
 5 | 
 6 | This command mounts the 3DS's microSD card as a CIFS.
 7 | 
 8 | ```sh
 9 | $ sudo mount.cifs \
10 | 	//$3DS_NAME/microSD\
11 | 	-o user=$3DS_USER,\
12 | 	password=$3DS_PASS,\
13 | 	ip=$3DS_LOCALIP,\
14 | 	servern=$3DS_NAME,\
15 | 	uid=$USER,gid=users,nounix,\
16 | 	vers=1.0 /mnt
17 | ```
18 | That command will successfully mount your 3DS's microSD card to `/mnt`. Please note that `sudo` is required.
19 | 
20 | If the connection has been dropped (for example, the 3DS is not in microSD management), commands like `ls` will freeze.
21 | 
22 | 
23 | ## Connection loss
24 | 
25 | A downside of doing this is that connection is very unstable. Even a simple `ls /mnt` will cause a the filesystem to "ghost".
26 | 
27 | ## Filesystem ghosting
28 | 
29 | If you mount the share, and execute `ls`, it will seem to "empty" out the share for some reason. However, files will **still be writeable.** You just can't see them.
30 | 
31 | This is proven by the following:
32 | 
33 | ```sh
34 | [/]% ls /mnt
35 |  Directory of /mnt
36 | Total                       0 bytes
37 | Free space        59021819904 bytes (95.4%)
38 | 
39 | # Listing /mnt (the share.) Note the amount of bytes
40 | # free; "Free space"
41 | 
42 | [/]% vim /mnt/something.txt
43 | 
44 | # I open up vim and write something.
45 | 
46 | [/]% ls /mnt               
47 |  Directory of /mnt
48 | Total                       0 bytes
49 | Free space        59021787136 bytes (95.4%)
50 | 
51 | # Note that it seems empty...but the Free space has
52 | # DECREASED!
53 | [/]% 
54 | ```
55 | 
56 | The updating of "Free space" seems to be unstable, as I only wrote a few words to `/mnt/something.txt`, and the free space lowered by a lot of bytes. It got lowered by a lot of bytes because I just copied the starter kit to the SD card a few minutes ago, and I'm assuming that the remaining space had only updated just now.
57 | 


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