This repository has been archived by the owner on Jun 2, 2020. It is now read-only.
forked from PKRoma/cntlm
-
Notifications
You must be signed in to change notification settings - Fork 0
/
README
157 lines (108 loc) · 5.1 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
Installation using packages
~~~~~~~~~~~~~~~~~~~~~~~~~~~
Most of the popular distros contain cntlm packages.n their repositories.
You can use the procedures described below to prepare a package of current cntlm
version if desired.
NOTE: generating packages traditionally requires root privileges (to be able to set
proper ownership and permissions on package members). You can overcome that using
fakeroot. However, to install your packages you have to be root.
*** SOURCE TARBALL ***
$ make tgz
or
$ make tbz2
*** DEBIAN PACKAGES ***
1) Quick way:
$ make deb
2) From Debian/Ubuntu repository:
Get these files (e.g. apt-get source cntlm):
cntlm_0.XX-X.diff.gz
cntlm_0.XX-X.dsc
cntlm_0.XX.orig.tar.gz
Compile:
$ dpkg-source -x cntlm_0.XX-Y.dsc
$ cd cntlm-0.XX/
$ dpkg-buildpackage -b -rfakeroot
Upon installation, the package takes care of creating a dedicated user for
cntlm, init script integration, manages eventual configuration file updates
with new upstream versions, things like restart of the daemon after future
updates, etc. You can later revert all these changes with one command, should
you decide to remove cntlm from your system.
*** RPM FROM SCRATCH ***
1) Quick way:
$ make rpm # you'll need root privs. or fakeroot utility
2) Detailed howto (or if make rpm doesn't work for you)
To build an RPM package from scratch, as root change to
/usr/src/[redhat|rpm|whatever]/SOURCES
Copy there all files from cntlm's rpm/ directory plus appropriate version of
the source tar.bz2 (see SOURCE TARBALL section above) and type:
$ rpmbuild -ba cntlm.spec
Shortly after, you'll have source and binary RPMs ready in your ../SRPMS, resp.
../RPMS directories.
If your build cannot find the default config file in /etc, you probably have
broken RPM build environment. You should add this to your ~/.rpmmacros:
%_sysconfdir /etc
*** RPM FROM *.src.rpm ***
If you just want to create a binary package from src.rpm, as root type:
$ rpmbuild --rebuild pkgname.src.rpm
Resulting binary RPM will be at /usr/src/..../RPMS
If your build cannot find the default config file in /etc, you probably have
broken RPM build environment. You should add this to your ~/.rpmmacros:
%_sysconfdir /etc
*** WINDOWS INSTALLER ***
Traditional compilation steps:
$ ./configure
$ make
Prepare all binaries, manuals, config templates, Start Menu links and InnoSetup
project definition file:
$ make win
Then run InnoSetup compiler to pack it all into an automatic installer EXE:
$ /your/path/to/ISCC.exe win/setup.iss
or
Open folder "win" in explorer, right click "setup.iss" and select "Compile".
Both with generate an installer in the "win" folder.
Traditional installation
~~~~~~~~~~~~~~~~~~~~~~~~
First, you have to compile cntlm. Using the Makefile, this should be very easy:
$ ./configure
$ make
$ make install
Cntlm does not require any dynamic libraries and there are no dependencies you
have to satisfy before compilation, except for libpthreads. This library is
required for all threaded applications and is very likely to be part of your
system already, because it comes with libc. Next, install cntlm onto your
system like so:
Default installation directories are /usr/sbin, /usr/share/man and /etc. Should
you want to install cntlm into a different location, change the DESTDIR
installation prefix (from "/") to add a different installation prefix (e.g.
/usr/local). To change individual directories, use BINDIR, MANDIR and
SYSCONFDIR:
$ make SYSCONFDIR=/etc BINDIR=/usr/bin MANDIR=/usr/share/man
$ make install SYSCONFDIR=/etc BINDIR=/usr/bin MANDIR=/usr/share/man
Cntlm is compiled with system-wide configuration file by default. That means
whenever you run cntlm, it looks into a hardcoded path (SYSCONFDIR) and tries
to load cntml.conf. You cannot make it not to do so, unless you use -c with an
alternative file or /dev/null. This is standard behaviour and probably what you
want. On the other hand, some of you might not want to use cntlm as a daemon
started by init scripts and you would prefer setting up everything on the
command line. This is possible, just comment out SYSCONFDIR variable definition
in the Makefile before you compile cntlm and it will remove this feature.
Installation includes the main binary, the man page (see "man cntlm") and if
the default config feature was not removed, it also installs a configuration
template. Please note that unlike bin and man targets, existing configuration
is never overwritten during installation. In the doc/ directory you can find
among other things a file called "cntlmd". It can be used as an init.d script.
Architectures
~~~~~~~~~~~~~
The build system now has an autodetection of the build arch endianness. Every
common CPU and OS out there is supported, including Windows, MacOS X, Linux,
*BSD, AIX.
Compilers
~~~~~~~~~
Cntlm is tested against GCC and IBM XL C/C++, other C compilers will work
for you too. There are no compiler specific directives and options AFAIK.
compilers might work for you (then again, they might not). Specific
Makefiles for different compilers are supported by the ./configure script
(e.g. Makefile.xlc)
Contact
~~~~~~~
David Kubicek <dave@awk.cz>