diff options
author | Emanuel Haupt <ehaupt@FreeBSD.org> | 2016-08-19 16:15:17 +0000 |
---|---|---|
committer | Emanuel Haupt <ehaupt@FreeBSD.org> | 2016-08-19 16:15:17 +0000 |
commit | 7640c426a52b0b6bc3e505af73191283385c942e (patch) | |
tree | cb43a62168c4c3318be5abf15366462ee3023cdd /net/tsocks/files/patch-INSTALL | |
parent | - Add missing USES=execinfo, fixing build on 9.x (diff) |
- Install inspectsocks and validateconf which are mentioned in the manpage
- Add license
- Use SUB_FILES for pkg-message
- Use DISTVERSION instead of PORTVERSION
- Recreate patch files to satisfy portlint
- Reformat pkg-message to what the PHB (section 8.5) defines as a good format
- Bump PORTREVISION
- Take maintainership
Notes
Notes:
svn path=/head/; revision=420478
Diffstat (limited to 'net/tsocks/files/patch-INSTALL')
-rw-r--r-- | net/tsocks/files/patch-INSTALL | 113 |
1 files changed, 113 insertions, 0 deletions
diff --git a/net/tsocks/files/patch-INSTALL b/net/tsocks/files/patch-INSTALL new file mode 100644 index 000000000000..65c3898cb7a8 --- /dev/null +++ b/net/tsocks/files/patch-INSTALL @@ -0,0 +1,113 @@ +--- INSTALL.orig 2002-05-18 02:12:30 UTC ++++ INSTALL +@@ -1,12 +1,7 @@ +-Quick Installation Instructions ++Quick Instructions + ------------------------------- + +-1. Unpack the archive (though if you're reading this you've already +-achieved that) +- +- tar -zxvf tsocks-<version>.tar.gx +- +-2. Run ./configure, options which might be of interest (and that are ++1. Explenations of the ./configure options which might be of interest (and that are + specific to tsocks include): + --enable-socksdns This option causes tsocks to intercept + DNS lookups and attempt to force them +@@ -39,55 +34,31 @@ achieved that) + Other standard autoconf options are provided by typing './configure + --help' + +-NOTE: The install path for the library is _NOT_ prefixed with --prefix, +-this is because it is strongly recommended that tsocks is installed into +-/lib (and not /usr/lib). This is important if tsocks is put into +-/etc/ld.so.preload since /usr is not mounted on many systems at boot +-time, meaning that programs running before /usr is mounted will try to +-preload tsocks, fail to find it and die, making the machine unusable. If +-you really wish to install the library into some other path use --libdir. +- +-3. Compile the code by typing: +- +- make ++2. Created files: + +-This should result in the creation of the following: + - libtsocks.so - the libtsocks library + - validateconf - a utility to verify the tsocks configuration file + - inspectsocks - a utility to determine the version of a socks server + - saveme - a statically linked utility to remove /etc/ld.so.preload + if it becomes corrupt ++ - man pages - tsocks(8), tsocks(1) and tsocks.conf(5) + +-4. If you experience any errors at this step and don't know how to fix +-them, seek help using the contacts listed on +-http://tsocks.sourceforge.net/contact.php +- +-5. Install the compiled library. You can skip this step if you only plan +-to use the library for personal use. If you want all users on the machine +-to be able to use it however, su to root then type +- +- make install +- +-This will install the library, the tsocks script and its man pages +-(tsocks(8), tsocks(1) and tsocks.conf(5)) to the paths specified to +-configure. +- +-Note that by default the library is installed to /lib and that the +-configure --prefix is IGNORED. See above for more detail. ++3. Configuration + +-6. At this point you'll need to create the tsocks configuration file. +-There are two samples provided in the build directory called ++You'll need to create the tsocks configuration file. ++There are two samples provided in the build directory and ++/usr/local/share/examples/tsocks called + tsocks.conf.simple.example and tsocks.conf.complex.example. + Documentation on the configuration file format is provided in the + tsocks.conf man page ('man tsocks.conf'). + +-7. Having created the tsocks.conf file you should verify it using ++4. Having created the tsocks.conf file you should verify it using + validateconf (some detail on validateconf can be found in the tsocks.conf + man page). Normally validateconf is run without arguments + ('./validateconf'). Any errors which are displayed by validateconf need + to be rectified before tsocks will function correctly. + +-8. You can now choose to make the library affect all users or just those ++5. You can now choose to make the library affect all users or just those + who choose to use it. If you want users to use it themselves, they can + simply use the tsocks(1) shell script to run programs (see 'man tsocks') + or do the following in their shell before running applications that need +@@ -97,25 +68,15 @@ to be transparently proxied: + + (in CSH) setenv LD_PRELOAD <path to library> + +- <path to library> = e.g /lib/libtsocks.so.1.8 +- +-If you want all users to pick up the library, place the full path to the +-full library in the file /etc/ld.so.preload (e.g "/lib/libtsocks.so"). Be +-EXTREMELY careful if you do this, if you mistype it or in some way get it +-wrong this will make your machine UNUSABLE. Also, if you do this, make +-sure the directory you put the library in is in the root of the +-filesystem, if the library is not available at boot time, again, your +-machine will be UNUSABLE. ++ <path to library> = e.g /usr/local/lib/tsocks/libtsocks.so.1.8 + +-9. Go ahead and use it! At this point everything should work. Again, if ++6. Go ahead and use it! At this point everything should work. Again, if + you experience any problems, use the contact points listed at +-http://tsocks.sourceforge.net/contact.php. If you do happen to break your +-machine with /etc/ld.so.preload, the build process creates a statically +-linked executable called saveme in the build directory. This executable +-simply unlinks /etc/ld.so.preload, this may or may not save you so give +-it a try. If it fails, you'll need to switch off the machine and get a +-rescue disk (e.g tomsrtbt) mount the disk and remove the file manually. ++http://tsocks.sourceforge.net/contact.php. + + Thats it, + + Thanks, Shaun Clowes (delius@progsoc.org) ++ ++ ++Adapted for FreeBSD by Marcin Jessa (yazzy@yazzy.org) |