The use of subst command

Comments

(no comments yet)

Log in or Join to leave comments.

Article Metadata

---

Article

Created: vin2ktalks (30 Mar 2007)

Last edited: hamishwillee (26 Jul 2012)

Overview

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.

Usage

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:\>cd S60Ex\helloworldbasic\group
 
Z:\>set EPOCROOT=\
 
Z:\S60Ex\helloworldbasic\group>devices -setdefault @S60_3rd:com.nokia.s60
 
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:

C:\>SUBST
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: