The use of subst command
SUBST is basically a dos command which is used to associates a path with a drive letter. Using this command you can create/delete the virtual drive from an existing physical folder.
With the use of Subst command we can avoid the situation of increasing the total character of the project path. Normally if the path character count increases more than 255 then the Symbian Tool Chain which is based on perl scripts will fail.
SUBST [drive1: [drive2:]path]
For example, suppose you've installed the 3rd Ed. SDK on your systems C: drive, the following command can be used for substituting the EPOCROOT to say drive Z: like this:
C:\>SUBST Z: C:\Symbian\9.1\S60_3rd
This will create a new virtual drive called Z: on your PC. Please note that this drive will disappear when ever you reboot the system.
Now if you move to the Z: drive from dos and enter dir:
Z:\>dir Volume in drive Z is DISC1_VOL3 Volume Serial Number is 4148-4821 Directory of Z:\ 03/02/2007 07:39 PM <DIR> . 03/02/2007 07:39 PM <DIR> .. 03/02/2007 07:39 PM <DIR> Epoc32 03/02/2007 07:46 PM <DIR> S60Ex 03/02/2007 07:46 PM <DIR> Examples 03/02/2007 07:47 PM <DIR> S60Doc 03/02/2007 07:47 PM <DIR> S60Tools 0 File(s) 0 bytes 7 Dir(s) 11,321,311,232 bytes free
So you can access the helloworldbasic example like this:
Z:\S60Ex\helloworldbasic\group>devices -setdefault @S60_3rd:com.nokia.s60
Here note one thing that before using the Symbian Tool Chain set the EPOCROOT environment variable to "\" and select the correct devices (here it should be 3rd Ed device as we started substituting based on 3rd Ed. SDK folder.
Display current substitution
You can display the current substituted drives with the use of this command:
Y:\: => C:\Symbian\9.2\S60_3rd_FP1\
Z:\: => C:\Symbian\9.1\S60_3rd
Remove a substitution
You may remove the substitution for a particular drive which you've earlier created lik this:
C:\>SUBST /D Z: