I'm writing a script to compile a code. The sources are in many different directories. I'm going to release the source and I want it to be compiled by many other people. Thus in my script I use relative paths.
If someone runs the script on his machine, from the directory the script is in, like ./script everything is ok. But, if the script is being run from another directory, like ./path/to/script then the paths are not correct and the script doesn't work.
How can I overcome this?
1 Answer
A simple starting point might be to add this to the top of your script:
#!/bin/bash
scriptdir="$(dirname "$0")"
cd "$scriptdir"
All following code will occur as if it was run inside the script dir.
Note that this is about causing the script to run
- From the folder where the script is located, and
- Regardless of where the script is called from initially
Which is what I suspect you want given that it's a script for compiling, thus it would placed in a very specific folder in the src tree (like a configure script or a form of makefile for example)
Rationale
$0is the full path of the running script.- From the
bashman (my added formatting):Special Parameters
The shell treats several parameters specially. These parameters may only be referenced; assignment to them is not allowed.
....
0 Expands to the name of the shell or shell script. This is set at shell initialization.
If bash is invoked with a file of commands, $0 is set to the name of that file.
If bash is started with the-coption, then $0 is set to the first argument after
the string to be executed, if one is present. Otherwise, it is set to the file name
used to invoke bash, as given by argument zero.
- From the
dirnamereturns the path of its argumentcdchanges the current directory
Therefore, every script with this code at the top, will be running as if ./script was typed while currently in that directory.
Coming at it from another angle
For measures of quality control and redundant error checking, you may want to implement a wrapper function that checks for a specific folder structure or presence of certain files that indicates everything is correct. (Say for whatever reason that dirname and cd command didn't work - which I have an example of for Mac down the bottom of this post). This concept is two fold:
- You're doing stuff to set the current directory
- You're checking that the stuff you did, worked.
For example:
runcheck () {
versioncheck () {
head -n1 version | grep -q "### myapp V"
}
backout () {
echo "Problem verifying source paths. Are you sure your archive is complete?"
exit
}
[ -d ./src ] && [ -d ./docs ] && [ -d ../myapp ] && (versioncheck) || backout
return
}
That code would check the following:
- The directory
srcexists in the same path as the executable script - The directory
docsexists in the same path as the executable script - The directory
myappexists in the path one level down from the executable script - That there's a file called
versionin the same path as the executable script, and that it's first line contains the string### myapp V(for example, for aversionfile which might have a top line that reads:### myapp V1.4 ###)
You could then place the command runcheck at any point in your script where it's important to verify you're in the right place:
Complete implementation example:
#!/bin/bash
scriptdir="$(dirname "$0")"
cd "$scriptdir"
runcheck () {
versioncheck () {
head -n1 version | grep -q "### myapp V"
}
backout () {
echo "Problem verifying source paths. Are you sure your archive is complete?"
exit
}
[ -d ./src ] && [ -d ./docs ] && [ -d ../myapp ] && (versioncheck) || backout
return
}
runcheck #initial check at start of script
## bunch of code
## goes here
runcheck #just checking again
## bunch of code
## goes here
runcheck #final check before really doing something bad
## end of script
Side Note / Supplement: This will work for bash when no thorough checking needs to occur to account for symbolic linking of the scriptfile, etc.. (which again... in portable source code tarballs, etc, I highly doubt is the case).
I suggest reading this thread: Getting the source directory of a Bash script from within if you want or ever need a thorough understanding on this topic for more comprehensive applications of it.
Again I re-inforce using what you know tailored for what you need - for example it might be considered generally more "robust" to use dirname "$(readlink -f "$0")", however, on Mac OS X, that would give you readlink: illegal option -- f , and is of no real benefit for portable scripts but more applicable for referencing locations of installed binaries that may be symlinked and/or contained in $PATH dirs
8 Comments
scriptdir variable?$scriptdir apply only to that file. Even if for some crazy reason, $scriptdir was an exported environment variable in the parent shell, the setting of $scriptdir within the script will still update it's value for that script (not the parent shell environment)
PATHin the beginning of the script.