This is ReadMe.rtf in view mode; [Download] [Up]
Copyright 1993 Jeremy Slade. You are free to use all or any parts of the Bypass project however you wish, just give credit where credit is due. The author (Jeremy Slade) shall not be held responsible for any damages that result out of use or misuse of any part of this project. Bypass by Jeremy Slade Tue May 11 12:01:12 MDT 1993 Overview Bypass is a very simple program that can be set up to circumvent your Dock, keeping your auto-launch applications from being launched when you log in. This is useful when you want to quickly log in, such as to perform some minor task. Bypass will temporarily disable all of the apps on the Dock (except the Workspace Manager), so the log in process will be much faster. When you log back out, the Dock will be restored to its original state. Bypass works by acting as your LoginHook and LogoutHook (see below for more info). Immediately after you type your password to log in, Bypass will be exectuted. At this point, Bypass checks to see if either mouse button is being held down (it will allow about 2 seconds for this to happen). If the mouse is down, then it disables the Dock by turning off all of the Workspace Manager's Dock-launch preferences. When you log out, Bypass will again be run, and this time it will restore the Dock-launch preferences to the original setting it they were disabled for this session. How Does It Work? Bypass must be run as the loginwindow's LoginHook and LogoutHook in order to perform its function. This is best performed by using the LoginHook and LogoutHook programs, also by Jeremy Slade. When it is set up in this manner, it will get executed before the user is actually logged in, which means, before any of the applications in the Dock get launched. It then gets executed again as soon as the user is logged out. At login, Bypass checks if the mouse is down, and if it is, it turns off the Workspace Manager's preferences setting that specifies which Apps on the Dock will be auto-launched. This is the DockLaunchFlags setting, owned by Workspace. This preference is actually a bit mask representing which items in the dock will be auto-launched. Bypass sets this preferencce to "1", which indicates that only the Workspace will be auto-launched. Bypass stores the original value in its own preference setting, also called DockLaunchFlags, but owned by Bypass. When the Dock is reenabled, this Workspace flag is set to the orginal value as stored by Bypass. Setting Up Bypass Bypass must be set up to run as the loginwindow's LoginHook and LogoutHook programs, but you probably won't want to do this directly since the LoginHook and LogoutHook get run as the super-user (root), and therefore Bypass would not function properly. The proper setup is to have some other program that then calls Bypass after first su'ing to the correct user ( the user who is logging in ). This can be done using the LoginHook and LogoutHook programs supplied with Bypass. The following instructions assume that you will be installing these programs along with Bypass: 1.) Make Bypass, LoginHook, and LogoutHook 2.) Follow instructions about customizing the loginwindow to install LogHook (found in /NextLibrary/Documentation/NextAdmin/09_StartShut/03_CustomizingLoginAndLogout.rtf and the loginwindow man page). In short, /etc/ttys should have a line that looks something like this (comment out the original line for console): console "/usr/lib/NextStep/loginwindow -LoginHook /LocalApps/LoginHook -LogoutHook /LocalApps/LogoutHook" NeXT on secure window=/usr/lib/NextStep/WindowServer onoption="/usr/etc/getty std.9600" (this is one continuous line). This setup assumes that you have installed LoginHook and LogoutHook in /LocalApps. 3.) Assuming Bypass is in ~/Apps, add the following line to your ~/.LoginHook script: ~/Apps/Bypass Disable 4.) Add the following line to your ~./LogoutHook script: ~/Apps/Bypass Enable 5.) Logout and log back in to test Bypass. In Summary I have found Bypass very useful when I need to log in very quickly and don't want to wait for all of my apps to finish launching. I hope you find it useful, too. Make any changes you wish, but remember that this program is completely unsupported. Send all comments, suggestions, etc, to: /dev/null.
These are the contents of the former NiCE NeXT User Group NeXTSTEP/OpenStep software archive, currently hosted by Netfuture.ch.