Il faut vraiment être motivé :
This README does not replace the README distributed with the Linux version. This README only covers differences between the Linux and OS X version. Please read to the other README as well as to the license agreement.
This Mac OS X version is provided "as is" and the author cannot be held responsible for any problem that could arise from its use. To the author's best knowledge, this program is stable and safe to use. If you encounter any problem, please write to
[email protected].
VERSION HISTORY FOR MACOS X:
Version 1.07: Initial release for OS X.
Version 1.08: Released on 17/03/2002. This version implements all the changes from the Linux program. Also, upload and download ratios are now available in this version.
INSTALLATION INSTRUCTIONS:
Expand the archive in a directory of your choice (will be referred to as EXPANDDIR henceforth).
Basic installation is simple. If you only want to use camlgrenouille through the Terminal, drag the file "camlgrenouille" and the file "user.config" from EXPANDDIR to a directory of your choice (will be referred to as INSTALLDIR henceforth). Edit the "user.config" file (see later) and then open the Terminal program and follow the following instructions (you must type what is in () in the Terminal):
Change to INSTALLDIR (cd INSTALLDIR)
Launch camlgrenouille (./camlgrenouille)
You may eventually specify options for the program, refer to the README for use instructions.
To install the program and to configure to start at startup, follow the following instructions:
Copy the "camlgrenouille" and the "user.config" file like in the basic installation.
Modify the "user.config" file (see below)
In the Finder, open the folder "Library" and then the folder "StartupItems". The folder "Library" is located on the disk on which you have MacOS X installed.
Create a new folder there named "CamlGrenouille" (the spelling is important)
Open that folder.
Drag the files "StartupParameters.plist" and "CamlGrenouille" from EXPANDDIR to that folder.
You will now need to edit the file "CamlGrenouille". To do so, double click on it. It should open with TextEdit, if that is not the case, go the Get Info (APPLE-I on the file) and choose "Open with Application" from the drop down menu, there, choose TextEdit (you might have to locate it, it should be in your "Applications" folder).
Once the file is open in TextEdit, locate the line that says: "cd YOUR_INSTALL_DIR"
Replace "YOUR_INSTALL_DIR" with the path to your INSTALLDIR. The format of a path is:
/Folder/Folder/Folder etc. For eg, if your INSTALLDIR is a folder named Grenouille in the Applications folder on your HD, the path is : "/Applications/Grenouille" (DO NOT PUT THE QUOTES). I do not recommend installation on a disk other than the Startup Disk.
Save the file.
Restart (logging out is not enough, you must restart for Grenouille to launch at startup).
EDITING THE "user.config" FILE
For Grenouille to function properly, you need to edit the "user.config" file to reflect your status.
Open the "user.config" file in TextEdit. To do so, follow the same procedure as the one to open "CamlGrenouille"
You need only replace "LOGIN" and "PASS" with your Grenouille login and your Grenouille password. Do not put any quotes. For example, if your username is "toto" and your password "blah" the file should read at the beginning:
# this file contain the configuration for camlgrenouille
# each line either starts with a # (a comment) or contain a pair
# of the form: parameter value (with exactly one space between them)
#
# your user name
username toto
# your password
password blah
You need not worry about the rest. You do not need to modify the "interface" parameter. I have not taken it out yet but it does not influence the program under OS X. Leave the parameter for now though. This will be fixed in a future release.
IF YOU DON'T KNOW WHAT YOU ARE DOING, DO NOT MODIFY ANYTHING ELSE.
ATTENTION UPGRADING USERS, YOU NEED TO PUT A "#" IN FRONT OF THE LINES:
"noratioul true" and "noratiodl true" if you want the new ratio ul and dl functions to work.
FINAL NOTES
Grenouille is configured to keep a log if it starts up on startup (This is due to the -t option in the "CamlGrenouille" file). This log can grow fairly big over time, please do not forget to periodically erase it (it will be recreated). If you do not want a log file you can modify the line: "./camlgrenouille -t >> grenouillelog &" to "./camlgrenouille >> /dev/null &"
I hope you enjoy the program. I would also like to thank Alan Schmitt who is the father of camlgrenouille. This OS X version is a mere re-compilation of the original program with a few modifications. The source is included, if you need to compile it, you need to download and install the cdk environment. You can find it at pauillac.inria.fr/cdk (see the README file for more information).
If you have any question or bug report, you can send me an email:
[email protected] or directly to the author :
[email protected]
If you have a problem, email me and send your "user.config" as well as the copy of the Terminal window in which you will have typed (the commands are separate, type RETURN between each of them):
which ifconfig
which awk
which grep
which cut
which ping
cd INSTALLDIR (put the actual path)
./camlgrenouille -d (and let that run for a minute or two, to stop, press CRTL-C)
You can copy the Terminal window in TextEdit. You may wish to erase your grenouille password and username (the can be found in the "user.config" file and in the output of "./camlgrenouille -d"
