Please note that as of October 24, 2014, the Nokia Developer Wiki will no longer be accepting user contributions, including new entries, edits and comments, as we begin transitioning to our new home, in the Windows Phone Development Wiki. We plan to move over the majority of the existing entries over the next few weeks. Thanks for all your past and future contributions.

The use of subst command

From Wiki
Jump to: navigation, search
Article Metadata
Created: vin2ktalks (30 Mar 2007)
Last edited: hamishwillee (30 May 2013)



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:

 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:\>cd S60Ex\helloworldbasic\group
Z:\>set EPOCROOT=\
Z:\S60Ex\helloworldbasic\group>devices -setdefault
Z:\S60Ex\helloworldbasic\group>bldmake bldfiles

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:

This page was last modified on 30 May 2013, at 04:36.
93 page views in the last 30 days.

Was this page helpful?

Your feedback about this content is important. Let us know what you think.


Thank you!

We appreciate your feedback.