https://wiki.yobi.be/api.php?action=feedcontributions&feedformat=atom&user=TwalrantYobiWiki - User contributions [en]2026-05-26T00:18:41ZUser contributionsMediaWiki 1.43.8https://wiki.yobi.be/index.php?title=Server_Dell_PowerEdge_T410&diff=6909Server Dell PowerEdge T4102010-11-30T07:33:54Z<p>Twalrant: /* XEN quickref */</p>
<hr />
<div>==Manuals==<br />
* [http://support.dell.com/support/edocs/systems/peT410/ here], online version of the main manual [http://support.dell.com/support/edocs/systems/peT410/en/HOM/html/index.htm here] with chapter on LED status [http://support.dell.com/support/edocs/systems/peT410/en/HOM/html/about.htm#wp1194212 here]<br />
<br />
==Install notes==<br />
===BIOS===<br />
** Activate Virtualization support<br />
** Power Management -> OS Control<br />
** Report kbd errors: NO<br />
===Debian Squeeze===<br />
Still testing at time of writing but frozen so almost stable ;-)<br />
* Installing squeeze [http://cdimage.debian.org/cdimage/daily-builds/daily/arch-latest/amd64/iso-cd/debian-testing-amd64-netinst.iso from daily image] (17/08/2010)<br />
** Complains about missing bnx2/bnx2-mips-09-5.0.0.j3.fw & bnx2/bnx2-rv2p-09-5.0.0.j3.fw<br />
*** Get it on another machine and put it on USB stick: aptitude install firmware-bnx2 ; cp /lib/firmware/bnx2/bnx2-*-09-5.0.0.j3.fw /media/XXXX<br />
*** Actually I had also an additional Intel network card so I could have skipped this step...<br />
** Partitionning: <br>there is a first primary partition for Dell Utilities (FAT16), I left it just in case...; <br>there is also a second primary partition: 2Gb of FAT32, empty, so I deleted it. <br>partition #2: primary 10Gb ext3 / label=ROOT<br>partition #3: primary 16Gb swap<br>partition #5: logical 2Tb physical volume for LVM<br>Configure LVM / ok to write table / Create VG with sda5, called vg0 (will be used by XEN)<br />
** Tasksel: SSH & standard utilities<br />
** Reboot<br />
* SSH: PermitRootLogin no / ssh-copy-id ...<br />
* Install mc, screen, sudo (adduser xxx sudo)<br />
* Renaming interfaces (always easier to remember what's plugged where...)<br />
** à la ifrename<br />
*** aptitude install ifrename<br />
*** Create /etc/iftab then reboot<br />
intelG mac 00:1b:21:xx:xx:xx<br />
intelD mac 00:1b:21:xx:xx:xx<br />
bcm1 mac 84:2b:2b:xx:xx:xx<br />
bcm2 mac 84:2b:2b:xx:xx:xx<br />
** à la udev<br />
*** actually we don't need ifrename because udev is now doing the same, see /etc/udev/rules.d/70-persistent-net.rules, you can simply change the NAME key<br />
** Be sure the old name is not used anywhere else in your config, typically in /etc/network/interfaces<br />
<br />
===XEN: installation===<br />
* see [http://wiki.debian.org/Xen notes on Debian wiki]<br />
* aptitude install xen-linux-image-2.6.32-5-xen-amd64 xen-tools xen-utils<br />
* backup /etc/xen/xend-config.sxp<br />
* edit /etc/xen/xend-config.sxp, and uncomment line "(network-script network-bridge)" or for a non-default interface ethX:<br />
(network-script 'network-bridge netdev=ethX bridge=xenbr0')<br />
* reboot<br />
* aptitude remove --purge linux-image-2.6.32-5-amd64 linux-image-2.6-amd64<br />
* /etc/default/grub => GRUB_DEFAULT=2<br />
* update-grub<br />
* reboot<br />
* cat /proc/xen/capabilities #(to check xend is running)<br />
<br />
===XEN: guest creation===<br />
* If you've a proxy it's much easier to have it defined in the environment variables:<br />
** Edit /etc/environment<br />
http_proxy=http://myproxy:port<br />
** Logout/login<br />
* Edit the config file for creating images (/etc/xen-tools/xen-tools.conf) to your needs:<br />
<source lang=diff><br />
--- xen-tools.conf.orig 2010-05-30 22:42:25.000000000 +0200<br />
+++ xen-tools.conf 2010-08-17 17:47:35.000000000 +0200<br />
@@ -52,7 +52,7 @@<br />
# LVM volume group here instead<br />
#<br />
##<br />
-# lvm = vg0<br />
+lvm = vg0<br />
<br />
<br />
#<br />
@@ -125,12 +125,12 @@<br />
# Disk and Sizing options.<br />
##<br />
#<br />
-size = 4Gb # Disk image size.<br />
+size = 8Gb # Disk image size.<br />
memory = 128Mb # Memory size<br />
swap = 128Mb # Swap size<br />
# noswap = 1 # Don't use swap at all for the new system.<br />
fs = ext3 # use the EXT3 filesystem for the disk image.<br />
-dist = `xt-guess-suite-and-mirror -s` # Default distribution to install.<br />
+dist = squeeze # Default distribution to install.<br />
image = sparse # Specify sparse vs. full disk images.<br />
<br />
#<br />
@@ -166,7 +166,7 @@<br />
#<br />
# Uncomment this if you wish the images to use DHCP<br />
#<br />
-# dhcp = 1<br />
+dhcp = 1<br />
<br />
<br />
##<br />
@@ -184,7 +184,7 @@<br />
# Uncomment the following line if you wish to interactively setup<br />
# a new root password for images.<br />
#<br />
-# passwd = 1<br />
+passwd = 1<br />
<br />
#<br />
# If you'd like all accounts on your host system which are not present<br />
@@ -254,10 +254,10 @@<br />
#<br />
# You may specify the things to use here:<br />
#<br />
-# serial_device = hvc0 #default<br />
+serial_device = hvc0 #default<br />
# serial_device = tty1<br />
#<br />
-# disk_device = xvda #default<br />
+disk_device = xvda #default<br />
# disk_device = sda<br />
#<br />
</source><br />
<br />
==XEN quickref==<br />
[http://xen-tools.org/software/xen-tools/ Xen Tools], [http://xen-tools.org/software/xen-shell Xen Shell]<br />
<br />
See also [http://www.howtoforge.com/virtualization-with-xen-on-debian-lenny-amd64-p2 here] and [http://www.howtoforge.com/xen_tools_xen_shell_argo here]<br />
<br />
* xen-create-image --hostname=mynewguest<br />
* xen-delete-image<br />
* xen-list-images<br />
* xen-update-image # apt-get update; apt-get upgrade in the guest, !!! only if guest is NOT running<br />
* xm create /etc/xen/mynewguest.cfg<br />
* xm list # Show running xen guests<br />
* xm info # Show xen version and many other info<br />
* xm console mynewguest<br />
** CTRL+] to detach<br />
* xm shutdown mynewguest<br />
* xm destroy mynewguest<br />
<br />
If you want xen1.example.com to start automatically at the next boot of the system, then do this:<br />
<br />
ln -s /etc/xen/xen1.example.com.cfg /etc/xen/auto<br />
<br />
==Sagemath guest==<br />
* xen-create-image --hostname=sagemath --memory=12288 --swap=12288 --vcpus=20<br />
* WARNING strangely the default root password was disabled with a '*' in /etc/shadow so impossible to log in. I had to mount manually the lv (/dev/vg0/sagemath-disk) to remove the '*'<br>One may prefer to setup the password interactively when creating the image with xen-create-image ... --passwd (or setup passwd=1 in /etc/xen-tools/xen-tools.conf as I've now shown in the above diff file)<br />
* lvm> lvcreate -L 1000G -n sagemath-data vg0<br />
* /etc/xen/sagemath.cfg: add data volume:<br />
root = '/dev/xvda2 ro'<br />
disk = [<br />
'phy:/dev/vg0/sagemath-disk,xvda2,w',<br />
'phy:/dev/vg0/sagemath-swap,xvda1,w',<br />
'phy:/dev/vg0/sagemath-data,xvda3,w',<br />
]<br />
<br />
* xm create -c /etc/xen/sagemath.cfg<br />
* Hook the data drive as /home<br />
** mkfs.ext4 /dev/xvda3<br />
** In /etc/fstab: /dev/xvda3 /home ext4 noatime,nodiratime,errors=remount-ro 0 1<br />
** mount /home<br />
* Install sage<br />
** apt-get install aria2<br />
** cd /opt<br />
** aria2c http://www.sagemath.org/mirror/linux/64bit/meta/sage-4.5.2-linux-64bit-ubuntu_10.04_lts-x86_64-Linux.tar.lzma.metalink<br />
** tar x --lzma -f sage-4.5.2-linux-64bit-ubuntu_10.04_lts-x86_64-Linux.tar.lzma<br />
** cd sage-4.5.2-linux-64bit-ubuntu_10.04_lts-x86_64-Linux<br />
** Edit sage and set SAGE_ROOT="/opt/sage-4.5.2-linux-64bit-ubuntu_10.04_lts-x86_64-Linux"<br />
** ./sage<br />
** sage> notebook.setup()<br>Provide FQDN for TLS certificate generation<br />
==Misc notes==<br />
===Boot & DHCP===<br />
I've still sometimes some issues at boot time when the xenbr0 bridge doesn't catch its IP...<br />
<br>In those cases I find dhclient still hooked to the non-existing bnx1 IF (which was renamed pbnx1 by XEN). I've to kill it and start a similar dhclient on IF xenbr0.<br />
<br>Finally I renamed the default interface as eth0 and called the xen bridge script without parameters: (network-script network-bridge)<br />
<br />
===Allocating too much memory===<br />
I tried to create two guests with each 12Gb of RAM while the host had only 16Gb in total. I would have expected a nice handling of the error but it froze xend and I could even not shutdown properly.<br />
<br>And, oh, BTW, no, [http://blog.coparsystems.com/?p=36&more=1&c=1&tb=1&pb=1 xen doesn't support memory overcommitment]<br />
<br />
===Hyperthreading===<br />
I'm not sure if in the long run it'll help but given that there are already 12 CPUs, I've disabled the logical CPU support in the BIOS.</div>Twalranthttps://wiki.yobi.be/index.php?title=OutlookGnuPG&diff=6022OutlookGnuPG2009-11-07T19:23:44Z<p>Twalrant: </p>
<hr />
<div>OutlookGnuPG is now hosted at GitHub, see http://wiki.github.com/twalrant/OutlookGnuPG</div>Twalranthttps://wiki.yobi.be/index.php?title=OutlookGnuPG&diff=6006OutlookGnuPG2009-11-02T18:59:04Z<p>Twalrant: Created page with 'Placeholder for a fork of the OutlookGnuPG add-in originally developped by [http://blog.cumps.be/gpg-in-outlook-2007-outlookgnupg/ David Cumps]. Source available at [http://git.…'</p>
<hr />
<div>Placeholder for a fork of the OutlookGnuPG add-in originally developped by [http://blog.cumps.be/gpg-in-outlook-2007-outlookgnupg/ David Cumps].<br />
<br />
Source available at [http://git.yobi.be/?p=OutlookGnuPG.git;a=summary OutlookGnuPG]</div>Twalranthttps://wiki.yobi.be/index.php?title=Virtual_Private_Networks&diff=5339Virtual Private Networks2009-01-06T09:51:44Z<p>Twalrant: /* Setup on the Linux server */</p>
<hr />
<div>==[http://openvpn.net/ OpenVPN]==<br />
===Intro===<br />
* [http://openvpn.net/howto.html Reference: OpenVPN Howto]<br />
* [http://openvpn.se/ OpenVPN GUI for Windows]<br />
* apt-get install openvpn<br />
* transport is done with TLS over tcp or udp, default port 1194<br />
<br />
=== Setup of a VPN server for multiple dynamic clients with certificates===<br />
Thanks to Thierry Walrant for his contribution!<br />
====Characteristics of this setup====<br />
* Ethernet tunneling (tap) over TCP port 1194<br />
* Full redirection of the traffic (redirection of the default gateway and DNS server), NATed by server towards Internet<br />
* Security by certificates<br />
* Works with Linux or Windows clients<br />
* Dynamic handling (à la DHCP) of the clients<br />
* Allows other ipsec VPN softwares to run on top (e.g. enterprise ipsec VPN for Windows)<br />
====Setup of the Certificate Authority (CA)====<br />
The CA should be another computer than the server!<br />
cp -a /usr/share/doc/openvpn/examples/easy-rsa /etc/openvpn<br />
cd /etc/openvpn/easy-rsa<br />
Edit the file called vars and adapt the last KEY_xxx vars to your needs<br />
. vars<br />
./clean-all<br />
./build-ca<br />
To create a certificate and sign it in one single step (do that only if the certificate can be transferred to the client via a secure channel, otherwise generate the certificate and the request on the client and sign it on the CA), without password:<br />
*For the server, use (don't forget to give a Common Name):<br />
./build-key-server ''server-cert''<br />
*For a client: (don't forget to give a Common Name)<br />
./build-key ''client-cert''<br />
For other situations, see easy-rsa/README.gz<br />
<br>To see content of a certificate:<br />
openssl x509 -in cert.crt -text<br />
====Setup on the Linux server====<br />
Setup of ip forward<br />
* Uncomment the following line in /etc/sysctl.conf<br />
net/ipv4/ip_forward=1<br />
* To try immediately<br />
echo 1 >/proc/sys/net/ipv4/ip_forward<br />
Import the server certificate and its key (securely!) as well as the CA certificate<br />
* CA:/etc/openvpn/easy-rsa/keys/ca.crt -> server:/etc/openvpn/ca.crt<br />
* CA:/etc/openvpn/easy-rsa/keys/''server-cert''.crt -> server:/etc/openvpn/''server-cert''.crt<br />
* CA:/etc/openvpn/easy-rsa/keys/''server-cert''.key -> server:/etc/openvpn/''server-cert''.key<br />
Create the DH keys via etc-rsa/build-dh or directly with<br />
openssl dhparam -out dh2048.pem 2048<br />
Create /etc/openvpn/iptables.up and make it executable:<br />
#!/bin/sh<br />
SOURCE=$1<br />
DEV=$2<br />
# establishing Source NATing (hiding source address)<br />
/sbin/iptables -t nat -A POSTROUTING -s $SOURCE -d 0.0.0.0/0 -j SNAT --to-source=<ext_ip><br />
# allowing explicitely to forward traffic from NATed interface in Netfilter (not needed if your policy allows all by default)<br />
/sbin/iptables -I FORWARD -i <ext_if> -o $DEV -m state --state ESTABLISHED,RELATED -j ACCEPT<br />
/sbin/iptables -I FORWARD -i $DEV -o <ext_if> -j ACCEPT<br />
Create /etc/openvpn/iptables.down and make it executable:<br />
#!/bin/sh<br />
SOURCE=$1<br />
DEV=$2<br />
/sbin/iptables -D FORWARD -i $DEV -o <ext_if> -j ACCEPT<br />
/sbin/iptables -D FORWARD -i <ext_if> -o $DEV -m state --state ESTABLISHED,RELATED -j ACCEPT<br />
/sbin/iptables -t nat -D POSTROUTING -s $SOURCE -d 0.0.0.0/0 -j SNAT --to-source=<ext_ip><br />
Create /etc/openvpn/server.conf:<br />
<pre><br />
proto tcp<br />
dev tap0<br />
ca /etc/openvpn/ca.crt<br />
cert /etc/openvpn/server-cert.crt<br />
key /etc/openvpn/server-cert.key<br />
dh /etc/openvpn/dh2048.pem<br />
server 172.16.0.0 255.255.0.0<br />
ifconfig-pool-persist /etc/openvpn/ipp.txt<br />
push "redirect-gateway"<br />
push "dhcp-option DNS <primary_DNS>"<br />
push "dhcp-option DNS <secondary_DNS>"<br />
keepalive 10 120<br />
comp-lzo<br />
max-clients 10<br />
status /var/log/openvpn-status.log<br />
verb 3<br />
mute 20<br />
up "/etc/openvpn/iptables.up 172.16.0.0/16"<br />
down "/etc/openvpn/iptables.down 172.16.0.0/16"<br />
</pre><br />
It will start at boot time, for a first try: /etc/init.d/openvpn start<br />
<br />
With option ifconfig-pool-persist, clients will always get the same IP.<br />
<br>IPs are stored in /etc/openvpn/ipp.txt<br />
<br>You can modify IP attributions by editing the file after having stopped the openvpn daemon, this is very important otherwise openvpn will overwrite your changes when it's stopped.<br />
<br />
====Setup on a Windows client====<br />
* [http://openvpn.net/download.html Download] the windows installer and run it.<br />
* You can try the [http://openvpn.se/ GUI]<br />
====Setup on a Linux client====<br />
To avoid automatic starting of the tunnel at boot time, edit /etc/default/openvpn: <br />
AUTOSTART="none"<br />
Bring the needed certificate files in e.g.:<br />
* /etc/openvpn/cacerts/cacert.pem<br />
* /etc/openvpn/certs/openvpn-myclient.crt.pem<br />
* /etc/openvpn/private/openvpn-myclient.key.pem<br />
Give read access to them only to root, especially the key file!<br />
<br>Create a configuration file to join the server "''myserver''": /etc/openvpn/''myserver''.conf<br>See the [http://openvpn.net/howto.html howto] for an explanation of the different options.<br />
<pre><br />
client<br />
proto tcp<br />
remote <IP_or_FQDN_of_myserver> 1194<br />
dev tap<br />
resolv-retry infinite<br />
nobind<br />
http-proxy-retry<br />
http-proxy <local_http_proxy_we_have_to_passthrough> <proxy_port><br />
ca /etc/openvpn/cacerts/cacert.pem<br />
cert /etc/openvpn/certs/openvpn-myclient.crt.pem<br />
key /etc/openvpn/private/openvpn-myclient.key.pem<br />
ns-cert-type server<br />
comp-lzo<br />
verb 3<br />
status /var/log/openvpn.log<br />
</pre><br />
To run it manually<br />
/etc/init.d/openvpn start ''myserver''<br />
There is no automatic redefinition of the DNS servers under Linux, so we need a little trick (as [http://www.smop.co.uk/node/69 seen here]):<br />
<br>Be sure to have the resolvconf package.<br />
<br>Add the following to the config file of the client:<br />
up /etc/openvpn/domain.up<br />
plugin /usr/lib/openvpn/openvpn-down-root.so /etc/openvpn/domain.down<br />
# this is required for new openvpn versions >= 2.1~rc9<br />
script-security 2<br />
Create /etc/openvpn/domain.up and make it executable:<br />
<pre><br />
#!/bin/sh<br />
# really naff script to add nameserver entry on up<br />
DEV=$1<br />
set | sed -n "<br />
s/^foreign_option_.* DNS \(.*\)'/nameserver \1/; T next; p;<br />
:next; s/^foreign_option_.* DOMAIN \(.*\)'/domain \1/; T; p;<br />
" | resolvconf -a $DEV<br />
resolvconf -u<br />
</pre><br />
Create /etc/openvpn/domain.down and make it executable:<br />
<pre><br />
#!/bin/sh<br />
# really naff script to delete nameserver entry on down<br />
DEV=$1<br />
resolvconf -d $DEV<br />
resolvconf -u<br />
</pre><br />
If you are not using Debian, see http://forums.gentoo.org/viewtopic-t-233080.html#1655552<br />
<br />
=== Setup of a VPN server in a vserver===<br />
*cf http://linux-vserver.org/Frequently_Asked_Questions#Can_I_run_an_OpenVPN_Server_in_a_guest.3F<br />
*You've to use persistent tun/tap, cf [[Vserver administration]]<br />
*You cannot dynamically modify iptables, this has to be done on the host.<br />
*You've to create manually /dev/net/tun in the vserver:<br />
cd <vserver>/dev; ./MAKEDEV tun<br />
*I had also to give NET_ADMIN [http://linux-vserver.org/Capabilities_and_Flags capability] to the vserver<br />
echo NET_ADMIN >> /etc/vservers/<vserver>/bcapabilities<br />
=== Using CACert certificates with OpenVPN===<br />
Instead of creating your own CA you can rely on e.g. the CACert one.<br />
====Server side====<br />
Create a server certificate and get it signed by CACert<br />
<br>server.conf will contain:<br />
ca /etc/openvpn/CAcert_chain.pem<br />
cert /etc/openvpn/your_server.pem<br />
key /etc/openvpn/your_privatekey.pem<br />
tls-verify /etc/openvpn/verify-cn<br />
We don't want to accept ALL CACert signed certificate therefore verify-cn is a little script which is called every time to check a client certificat, cf man openvpn:<br />
--tls-verify cmd<br />
Execute shell command cmd to verify the X509 name of a pending TLS<br />
connection that has otherwise passed all other tests of certifica-<br />
tion (except for revocation via --crl-verify directive; the revoca-<br />
tion test occurs after the --tls-verify test).<br />
<br />
cmd should return 0 to allow the TLS handshake to proceed, or 1 to fail. cmd is executed as<br />
<br />
cmd certificate_depth X509_NAME_oneline<br />
[{{#file:verify-cn}} verify-cn]:<br />
<source lang=bash><br />
#!/bin/bash <br />
<br />
# clients file must contain one client subject per line (grep regexp actually)<br />
<br />
logfile=/etc/openvpn/verify-cn.log<br />
clients=/etc/openvpn/verify-cn.allow<br />
<br />
CA="/O=Root_CA/OU=http://www.cacert.org/CN=CA_Cert_Signing_Authority/emailAddress=support@cacert.org"<br />
<br />
case "$1" in<br />
1)<br />
[ "$2" == "$CA" ] && exit 0<br />
;;<br />
0)<br />
echo $2 | grep -q -f $clients && exit 0;<br />
;;<br />
esac<br />
<br />
echo "$(date +%Y%m%d-%H%M%S) FAILED: $*" >> $logfile<br />
exit 1<br />
</source><br />
Example of verify_cn.allow:<br />
/CN=CAcert_WoT_User/emailAddress=my@email.org<br />
<br />
====Client side====<br />
Create a client certificate and get it signed by CACert<br />
<br>openvpn connection .conf will contain:<br />
ca /etc/openvpn/cacerts/CAcert_chain.pem<br />
cert /etc/openvpn/certs/my@email.org.crt.pem<br />
key /etc/openvpn/private/my@email.org.key.pem<br />
tls-remote /CN=myvpn.mydomain.be<br />
#Fails on CACert certificates:<br />
#ns-cert-type server<br />
We don't want to accept ALL CACert signed certificate for the servers therefore we use the --tls-remote option and we specify the subject line of the server certificate we expect.<br />
<br>Note that normally specifying the common_name instead of the subject line should be enough but this does not work on CACert certificates, cf my [http://bugs.debian.org/483472 bugreport]<br />
<br>Note that we cannot use the --ns-cert-type option anymore as it also fails on CACert certificates, cf my other [http://bugs.debian.org/483473 bugreport]<br />
<br />
==[http://vtun.sourceforge.net/ vtun]==<br />
<br />
Older and with less features than openvpn but very easy to use for basic tunneling (tun or tap)<br />
<br />
* apt-get install vtun<br />
* transport is done over tcp or udp, default port 5000</div>Twalranthttps://wiki.yobi.be/index.php?title=Courier-Cygwin&diff=5290Courier-Cygwin2008-11-06T10:07:59Z<p>Twalrant: /* Offlineimap */</p>
<hr />
<div>=Pre-requisite=<br />
<br />
Courier-IMAP requires the installation of the [http://www.courier-mta.org/authlib/ Courier Authentication Library] and the following cygwin tools and packages<br />
<br />
* patch, tar, make, gcc<br />
* crypt<br />
* libgdbm-devel<br />
* libtool<br />
* inetutils<br />
* cygrunsrv<br />
<br />
Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install the required packages.<br />
<br />
=Courier Authentication Library=<br />
<br />
Installation of Courier Authentication Library using the module userdb to manage mail accounts. All other modules are disabled.<br />
<br />
==Compilation and installation==<br />
<br />
Download and untar [http://www.courier-mta.org/download.php#authlib courier-authlib] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-authlib-0.61.0.tar.bz2 0.61.0]<br />
<br />
Apply the [{{#file:courier-authlib-0.61.0-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# add libtool flag (-no-undefined) required for DLL creation<br />
# add missing dependencies<br />
# add PATH in start script to access new DLL (installed in a different directory)<br />
<br />
Solution source: http://lists.cairographics.org/archives/cairo/2004-April/001125.html<br />
<br />
<source lang=diff><br />
--- courier-authlib-0.61.0/makedat/Makefile.in 2008-05-24 16:21:09.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/makedat/Makefile.in 2008-10-21 16:02:38.709166700 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-authlib-0.61.0/Makefile.in 2008-07-12 21:41:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/Makefile.in 2008-10-23 22:59:03.843750000 +0200<br />
@@ -213,9 +213,10 @@<br />
LTCOMPILE = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
--mode=compile $(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) \<br />
$(AM_CPPFLAGS) $(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS)<br />
-CCLD = $(CC)<br />
+CCLD = $(CC) -no-undefined<br />
+CCLDEXE = $(CC)<br />
LINK = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
- --mode=link $(CCLD) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
+ --mode=link $(CCLDEXE) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
$(LDFLAGS) -o $@<br />
SOURCES = $(libauthcustom_la_SOURCES) $(libauthldap_la_SOURCES) \<br />
$(libauthmysql_la_SOURCES) $(libauthpam_la_SOURCES) \<br />
@@ -452,9 +453,9 @@<br />
README.authdebug.html<br />
<br />
DISTCLEANFILES = dbobj.config README_authlib.html<br />
-commonlibdep = libcourierauthcommon.la<br />
+commonlibdep = libcourierauthcommon.la libcourierauth.la<br />
commonldflags = -module -rpath $(pkglibdir) -export-symbols-regex 'courier_auth.*_init' -avoid-version<br />
-commonlibadd = libcourierauthcommon.la<br />
+commonlibadd = libcourierauthcommon.la libcourierauth.la<br />
libcourierauthcommon_t = @CRYPTLIBS@<br />
libcourierauthcommon_la_SOURCES = \<br />
auth.h courierauth.h \<br />
--- courier-authlib-0.61.0/authdaemond.in 2005-07-05 14:25:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/authdaemond.in 2008-10-25 12:03:32.140625000 +0200<br />
@@ -15,4 +15,10 @@<br />
set -a<br />
. @authdaemonrc@<br />
<br />
+# Some shared libraries (DLL) are installed in @libdir@/bin<br />
+# instead of @libdir@/@PACKAGE@<br />
+# Setting LD_LIBRARY_PATH at runtime or LR_RUN_PATH at linktime doesn't<br />
+# work in cygwin, only setting PATH works. <br />
+export PATH=$PATH:@libdir@/bin<br />
+<br />
exec ${sbindir}/courierlogger -pid=@authdaemonvar@/pid $LOGGEROPTS -$1 @libexecdir@/courier-authlib/authdaemond<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courier-authlib-0.61.0-cygwin.patch<br />
<br />
Configure the package without most authentication modules, keeping only ''userdb''.<br />
<br />
'''Note''': replace ''mailuser'' by an existing user name (in your /etc/passwd file). I used my own username.<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait --without-authpam --without-authldap --without-authpwd \<br />
--without-authshadow --without-authcustom --without-authpipe --without-authmysql --without-authpgsql --with-mailuser=mailuser \<br />
--with-mailgroup=mkgroup-l-d<br />
<br />
Take a long pause... and when ready execute the following command.<br />
<br />
$ make<br />
<br />
Take again a long pause... then check the result and install the libraries<br />
<br />
$ make check<br />
$ make install<br />
<br />
'''NOTES''': list of related topics found during investigation for compilation<br />
* authldap: configure: error: -lresolve is needed for res_query... http://www.cygwin.com/ml/cygwin/2005-04/msg00419.html<br />
<br />
==Configuration==<br />
<br />
Create authdaemonrc file: /usr/local/etc/authlib/authdaemonrc<br />
<br />
$ cp /usr/local/etc/authlib/authdaemonrc.dist /usr/local/etc/authlib/authdaemonrc<br />
<br />
Change number of daemons (I use three) and enable DEBUG_LOGIN<br />
<br />
<source lang=text><br />
# The number of daemon processes that are started.<br />
daemons=3<br />
<br />
# DEBUG_LOGIN=2 - turn on debugging + log passwords too<br />
DEBUG_LOGIN=2<br />
</source><br />
<br />
See http://www.courier-mta.org/authlib/README.authdebug.html for details.<br />
<br />
==IMAP accounts==<br />
<br />
User accounts and settings are managed by ''userdb''. See [http://linux.die.net/man/8/makeuserdb makeuserdb] man page for details, or used the freshly new install man page - man makeuserdb<br />
<br />
Assuming ''username'' is your username, 1001 and 10545 are respectively the UID and GID of an existing user (part of your /etc/passwd and /etc/group). I use my own UID and GID. Create the mailuser home directory, if required, and create Maildir folder.<br />
<br />
$ mkdir -p /home/username<br />
$ cd /home/username<br />
$ /usr/lib/courier-imap/bin/maildirmake Maildir<br />
<br />
Create the userdb text file /usr/local/etc/authlib/userdb<br />
<br />
$ touch /usr/local/etc/authlib/userdb<br />
$ chmod 700 /usr/local/etc/authlib/userdb<br />
<br />
Edit /usr/local/etc/authlib/userdb, one line per account<br />
<br />
<source lang=text><br />
username[TAB]uid=1001|gid=10111|home=/home/username|mail=/home/username/Maildir|systempw=XXXXXX<br />
</source><br />
<br />
where XXXXXX is the encrypted password created with<br />
<br />
$ /usr/local/sbin/userdbpw.exe<br />
<br />
Create the (binary) userdb<br />
<br />
$ /usr/local/sbin/makeuserdb<br />
<br />
You should now have the following files created:<br />
<br />
* /usr/local/etc/authlib/userdb.dat<br />
* /usr/local/etc/authlib/userdbshadow.dat<br />
<br />
==Running==<br />
<br />
Install and configure syslogd. Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install inetutils (contains syslogd). Configure syslogd with the following command. It will create the /etc/syslogd.conf file and install a windows service using cygrunsrv<br />
<br />
$ syslogd-config<br />
<br />
Start the authlib daemon with the following command:<br />
<br />
$ /usr/local/sbin/authdaemon start<br />
<br />
Stop the daemon with the following command:<br />
<br />
$ /usr/local/sbin/authdaemon stop<br />
<br />
You'll find log messages in /var/log/messages (default target file as specified in /etc/syslogd.conf)<br />
<br />
==Testing authlib==<br />
<br />
$ /usr/local/sbin/authtest username CCCCCC<br />
Authentication succeeded.<br />
<br />
Authenticated: username (uid 1001, gid 10545)<br />
Home Directory: /home/username<br />
Maildir: /home/username/Maildir<br />
Quota: (none)<br />
Encrypted Password: XXXXXX<br />
Cleartext Password: CCCCCC<br />
Options: (none)<br />
<br />
where username is your user name and XXXXXX is your encrypted password as provided in ''/usr/local/etc/authlib/userdb''. CCCCCC is your password in clear.<br />
<br />
==Troubleshooting==<br />
<br />
Should you have a doubt on the execution of a command (ie: no output) you can check if the application is able to load required DLL. This error is not reported. Using ''strace'', windows will complain about DLL not found, if any. To solve this problem you may need to add some path in your PATH. For example, in order to test authlib with authtest:<br />
<br />
$ strace /usr/local/sbin/authtest<br />
# This will open a dialog box to complain about DLL.<br />
$ export PATH=$PATH:/usr/local/lib/bin<br />
$ /usr/local/sbin/authtest ausername<br />
<br />
==Courier Authentication Config==<br />
<br />
$ /usr/local/bin/courierauthconfig.exe --version<br />
$ /usr/local/bin/courierauthconfig.exe --ldflags<br />
$ /usr/local/bin/courierauthconfig.exe --cppflags<br />
$ /usr/local/bin/courierauthconfig.exe --configfiles<br />
<br />
=Courier-IMAP=<br />
==Compilation and installation==<br />
<br />
Download and untar package [http://www.courier-mta.org/download.php#imap courier-imap] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-imap-4.4.1.tar.bz2 4.4.1.20080920]<br />
<br />
Apply the [{{#file:courier-imap-4.4.1-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# incorrect usage of EXTEXT in main ''Makefile''<br />
# remove usage of /usr/lib/env in start/stop script (/usr/lib/env does not seem to work under Cygwin)<br />
<br />
<source lang=diff><br />
--- courier-imap-4.4.1.20080920/makedat/Makefile.in 2008-08-24 19:52:51.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/makedat/Makefile.in 2008-10-21 20:43:27.500000000 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-imap-4.4.1.20080920/Makefile.in 2008-09-20 14:48:46.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/Makefile.in 2008-10-21 20:59:45.156250000 +0200<br />
@@ -247,9 +247,9 @@<br />
CLEANFILES = $(databin_SCRIPTS) $(man_MANS) $(sysconf_DATA) $(sbin_SCRIPTS)<br />
databindir = $(datadir)<br />
databin_SCRIPTS = mkimapdcert mkpop3dcert<br />
-binPROGRAMS = imapd pop3d maildirmake maildiracl deliverquota maildirkw<br />
-sbinPROGRAMS = imaplogin pop3login<br />
-libexecPROGRAMS = makedatprog couriertcpd<br />
+binPROGRAMS = imapd$(EXEEXT) pop3d$(EXEEXT) maildirmake$(EXEEXT) maildiracl$(EXEEXT) deliverquota$(EXEEXT) maildirkw$(EXEEXT)<br />
+sbinPROGRAMS = imaplogin$(EXEEXT) pop3login$(EXEEXT)<br />
+libexecPROGRAMS = makedatprog$(EXEEXT) couriertcpd$(EXEEXT)<br />
bin_PROGRAMS = @binPROGRAMS_exec@<br />
sbin_PROGRAMS = @sbinPROGRAMS_exec@<br />
libexec_PROGRAMS = @libexecPROGRAMS_exec@<br />
--- courier-imap-4.4.1.20080920/imapd.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/imapd.rc.in 2008-10-26 10:17:51.359375000 +0100<br />
@@ -22,6 +22,15 @@<br />
exit 1<br />
fi<br />
<br />
+# Location for some shared libraries (cygcourierauth*.dll) from authlib<br />
+AUTHLIBDIR=/usr/local<br />
+if test ! -f $AUTHLIBDIR/lib/bin/cygcourierauth.dll<br />
+then<br />
+ echo "$AUTHLIBDIR/lib/bin/cygcourierauth.dll not found."<br />
+ exit 1<br />
+fi<br />
+export PATH=$PATH:$AUTHLIBDIR/lib/bin<br />
+<br />
TLS_CACHEFILE=""<br />
. @sysconfdir@/imapd-ssl<br />
. @sysconfdir@/imapd<br />
@@ -35,7 +44,7 @@<br />
<br />
umask $IMAP_UMASK<br />
@ULIMIT@ $IMAP_ULIMITD<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
--- courier-imap-4.4.1.20080920/pop3d.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/pop3d.rc.in 2008-10-26 10:18:02.187500000 +0100<br />
@@ -22,12 +22,21 @@<br />
exit 1<br />
fi<br />
<br />
+# Location for some shared libraries (cygcourierauth*.dll) from authlib<br />
+AUTHLIBDIR=/usr/local<br />
+if test ! -f $AUTHLIBDIR/lib/bin/cygcourierauth.dll<br />
+then<br />
+ echo "$AUTHLIBDIR/lib/bin/cygcourierauth.dll not found."<br />
+ exit 1<br />
+fi<br />
+export PATH=$PATH:$AUTHLIBDIR/lib/bin<br />
+<br />
. @sysconfdir@/pop3d-ssl<br />
. @sysconfdir@/pop3d<br />
<br />
case $1 in<br />
start)<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courier-imap-4.4.1-cygwin.patch<br />
<br />
Configure the package<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait<br />
<br />
Take a walk... and when ready execute the following command to build the package.<br />
<br />
$ make<br />
<br />
Time to go for some coffee... and then install the package with the usual<br />
<br />
$ make install<br />
$ make install-configure<br />
<br />
==Configuration==<br />
<br />
Setup courier-imap: $prefix/etc/imapd (where $prefix=/usr/lib/courier-imap)<br />
<br />
Set ADDRESS to a valid value (0 or 127.0.0.1) and change IMAP_ULIMITD to a value accepted by the command ulimit. I simply used the existing value returned by<br />
<br />
$ ulimit -v<br />
<br />
==Running==<br />
<br />
Syslogd service and authdaemond should be started. See above.<br />
<br />
Start the imap daemon with the following command:<br />
<br />
$ /usr/lib/courier-imap/libexec/imapd.rc start<br />
<br />
Stop the daemon with the following command:<br />
<br />
$ /usr/lib/courier-imap/libexec/imapd.rc stop<br />
<br />
You'll find log messages in /var/log/messages (default target file as specified in /etc/syslogd.conf)<br />
<br />
==Testing==<br />
When authdaemond and imapd are running you can do a simple login test:<br />
<br />
$ telnet localhost 143<br />
<br />
and type the login command<br />
<br />
a login <username> <password><br />
<br />
the server should reply<br />
<br />
a OK LOGIN Ok.<br />
<br />
to which you can reply with a logout<br />
<br />
a logout<br />
<br />
the session is terminated by the server<br />
<br />
* BYE Courier-IMAP server shutting down<br />
a OK LOGOUT completed<br />
Connection closed by foreign host.<br />
<br />
'''Hint:''' if the connection is immediately closed by foreign host it probably means that ''imapd'' does not have access to all required DLLs. Check your PATH.<br />
<br />
==All in one==<br />
If everything works fine you can use the following [{{#file:imapd}} startup script] to launch or stop imap and authlib daemons. It can be saved in /usr/local/sbin.<br />
<br />
<source lang=bash><br />
#! /bin/sh<br />
#<br />
# Courier imap daemon startup script.<br />
<br />
authlib=/usr/local/sbin/authdaemond<br />
imapd=/usr/lib/courier-imap/libexec/imapd.rc<br />
<br />
test ! -f $authlib && echo "File not found: $authlib" && exit 1;<br />
test ! -f $imapd && echo "File not found: $imapd" && exit 1;<br />
<br />
case $1 in<br />
start)<br />
$authlib start<br />
$imapd start<br />
;;<br />
stop)<br />
$imapd stop<br />
$authlib stop<br />
;;<br />
*)<br />
echo "Usage: $0 <start|stop>"<br />
;;<br />
esac<br />
</source><br />
<br />
==Cygwin service==<br />
Create the [{{#file:imapd-srv.sh}} service script]<br />
<br />
<source lang=bash><br />
#!/bin/sh<br />
# File: imapd-service.sh<br />
# Purpose: Courier imap daemon service script.<br />
#<br />
# NOTE: This script must be excutable by SYSTEM<br />
username=username # <<<< Change me !!!<br />
pidsleep=''<br />
<br />
# Function to handle QUIT signal.<br />
# Stop imapd daemon and kill background sleep.<br />
function handleQuit<br />
{<br />
echo "STOPPING: /usr/local/sbin/imapd"<br />
su $username -c "/usr/local/sbin/imapd stop"<br />
test -n "$pidsleep" && kill -9 $pidsleep<br />
exit<br />
}<br />
<br />
# Interruptible sleep<br />
# Note: sleep is an external command (not builtin command), hence<br />
# not interruptible by the QUIT signal.<br />
function intsleep<br />
{<br />
sleep $1 &<br />
pidsleep=$!<br />
wait $pidsleep<br />
}<br />
<br />
echo "STARTING: /usr/local/sbin/imapd as $username at "`date`<br />
su $username -c "/usr/local/sbin/imapd start"<br />
<br />
trap "handleQuit" SIGQUIT<br />
<br />
echo "WAITING: "$$<br />
while true; do intsleep 1d; done<br />
</source><br />
<br />
Change username and save it to your favorite location, says /usr/local/sbin. The service script must be executable by SYSTEM, ie: the user that run the windows services.<br />
<br />
$ chmod +rx /usr/local/sbin/imapd-service.sh<br />
<br />
Install the new service with the following command.<br />
<br />
$ cygrunsrv --install imapd --desc "Courier IMAP daemon" --disp "CYGWIN imapd" \<br />
--path /usr/local/sbin/imapd-service.sh --termsig QUIT --type auto --shutdown<br />
<br />
Finally, just start the service<br />
<br />
$ cygrunsrv --start imapd<br />
or<br />
$ net start imapd<br />
<br />
You should now have couple of processes related to courier-imap<br />
<br />
$ ps -a<br />
<br />
'''NOTES''':<br />
* If the service could not be started, it's probably because the service script is not executable by SYSTEM<br />
<br />
$ net start imapd<br />
The CYGWIN imapd service is starting.<br />
The CYGWIN imapd service could not be started. <br />
<br />
The service did not report an error.<br />
<br />
More help is available by typing NET HELPMSG 3534.<br />
<br />
* The combination of background sleep and builtin wait command is used to make the waiting statment interruptible. The original script found on the net, was simply using a 'sleep 1' which turned to consume ~10% of the CPU.<br />
<br />
=Maildir=<br />
'''maildirmake''' is part of the courier-imap package<br />
<br />
$ /usr/lib/courier-imap/bin/maildirmake<br />
<br />
=Mairix - index and search mail folders=<br />
Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install the package mairix.<br />
<br />
Create the configuration file in your home directory: ~/.mairixrc<br />
<br />
base=/home/username<br />
maildir=Maildir...<br />
omit=Maildir/.Mairix**<br />
mfolder=Maildir/.Mairix<br />
database=/home/username/.mairix_database<br />
<br />
The create the mairix index<br />
<br />
$ mairix<br />
and<br />
$ mairix --fast-index # on daily base<br />
<br />
See [[Mail_Tips]] for additional details.<br />
<br />
=Offlineimap=<br />
Requires python, so run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install the package python.<br />
<br />
Download offlineimap [http://software.complete.org/software/projects/list_files/offlineimap here]. I use [http://software.complete.org/software/versions/download/242?attachment_id=334 version 6.0.3]. Extract files in you favorite sandbox.<br />
<br />
$ tar xvfz offlineimap_6.0.3.tar.gz<br />
$ cd offlineimap<br />
<br />
Apply the following [{{#file:offlineimap_6.0.3-cygwin.patch}} patch] to correct the following issues:<br />
<br />
* [http://en.wikipedia.org/wiki/Maildir#Windows_software Suffix separator] character colon (:) is not allowed in Windows. Courier-imap for cygwin is using (!)<br />
* While used by courier-imap for cygwin Maildir mail files should not use CRLF, rather only LF. The issue appears only in mail with attachment, that is the raw message is not interpreted and displayed as it in the mail body (under Thunderbird).<br />
<br />
<source lang=diff><br />
--- offlineimap.conf 2008-08-13 20:56:04.000000000 +0200<br />
+++ offlineimap-cygwin.conf 2008-11-06 10:44:31.066750700 +0100<br />
@@ -215,6 +215,19 @@<br />
<br />
restoreatime = no<br />
<br />
+# Cygwin/Windows users may have issues with the Maildir mail filename<br />
+# containing the suffix separator character (:). In this case, they<br />
+# could change the suffix separator character to whatever required.<br />
+# For example, Courier-IMAP for Cygwin is using (!)<br />
+<br />
+# suffixsep = !<br />
+<br />
+# Cygwin/Windows users may need to create Maildir mail filename in<br />
+# binary mode. In this case, set the 'filemode' to 'binary'. Default is<br />
+# 'text'. Courier-IMAP for Cygwin works better with binary mode.<br />
+<br />
+# filemode = binary<br />
+<br />
[Repository RemoteExample]<br />
<br />
# And this is the remote repository. We only support IMAP or Gmail here.<br />
--- offlineimap/folder/Maildir.py 2008-08-13 20:55:48.000000000 +0200<br />
+++ offlineimap/folder/Maildir-cygwin.py 2008-11-06 10:44:05.344202700 +0100<br />
@@ -23,7 +23,6 @@<br />
import os.path, os, re, time, socket, md5<br />
<br />
uidmatchre = re.compile(',U=(\d+)')<br />
-flagmatchre = re.compile(':.*2,([A-Z]+)')<br />
<br />
timeseq = 0<br />
lasttime = long(0)<br />
@@ -54,6 +53,12 @@<br />
self.messagelist = None<br />
self.repository = repository<br />
self.accountname = accountname<br />
+ self.filemode = {<br />
+ 'binary': 'wb',<br />
+ 'text': 'wt',<br />
+ }[repository.getconf("filemode", 'text')]<br />
+ self.suffixsep = repository.getconf("suffixsep",':')<br />
+ self.flagmatchre = re.compile('%s.*2,([A-Z]+)' % self.suffixsep)<br />
BaseFolder.__init__(self)<br />
<br />
def getaccountname(self):<br />
@@ -102,7 +107,7 @@<br />
nouidcounter -= 1<br />
else:<br />
uid = long(uidmatch.group(1))<br />
- flagmatch = flagmatchre.search(messagename)<br />
+ flagmatch = self.flagmatchre.search(messagename)<br />
flags = []<br />
if flagmatch:<br />
flags = [x for x in flagmatch.group(1)]<br />
@@ -180,7 +185,7 @@<br />
break<br />
tmpmessagename = messagename.split(',')[0]<br />
ui.debug('maildir', 'savemessage: using temporary name %s' % tmpmessagename)<br />
- file = open(os.path.join(tmpdir, tmpmessagename), "wt")<br />
+ file = open(os.path.join(tmpdir, tmpmessagename), self.filemode)<br />
file.write(content)<br />
<br />
# Make sure the data hits the disk<br />
@@ -226,11 +231,11 @@<br />
newpath = os.path.join(self.getfullname(), 'cur')<br />
else:<br />
newpath = os.path.join(self.getfullname(), 'new')<br />
- infostr = ':'<br />
- infomatch = re.search('(:.*)$', newname)<br />
+ infostr = self.suffixsep<br />
+ infomatch = re.search('(%s.*)$' % self.suffixsep, newname)<br />
if infomatch: # If the info string is present..<br />
infostr = infomatch.group(1)<br />
- newname = newname.split(':')[0] # Strip off the info string.<br />
+ newname = newname.split(self.suffixsep)[0] # Strip off the info string.<br />
infostr = re.sub('2,[A-Z]*', '', infostr)<br />
flags.sort()<br />
infostr += '2,' + ''.join(flags)<br />
</source><br />
<br />
$ patch -Np0 < offlineimap_6.0.3-cygwin.patch<br />
<br />
Install offlineimap<br />
<br />
$ python setup.py install<br />
<br />
Configure offlineimap as described in [[Offlineimap]] and launch offlineimap. '''CAUTION:''' Add the NEW suffixsep and filemode options in the Maildir repository section of the configuration file.<br />
<br />
$ offlineimap<br />
or<br />
$ offlineimap -1 -o -u Noninteractive.Basic<br />
or<br />
$ offlineimap -c /home/username/offlineimap.conf<br />
<br />
Here is a simple [{{#file:offlineimap.conf}} offlineimap configuration file].<br />
<br />
<source lang=text><br />
[general]<br />
metadata = /home/username/.offlineimap<br />
accounts = Test<br />
maxsyncaccounts = 1<br />
ui = Curses.Blinkenlights, TTY.TTYUI,<br />
Noninteractive.Basic, Noninteractive.Quiet<br />
ignore-readonly = no<br />
<br />
[mbnames]<br />
enabled = no<br />
<br />
[ui.Curses.Blinkenlights]<br />
statuschar = .<br />
<br />
[Account Test]<br />
localrepository = LocalExample<br />
remoterepository = RemoteExample<br />
<br />
[Repository LocalExample]<br />
type = Maildir<br />
localfolders = /home/username/Maildir<br />
sep = .<br />
restoreatime = no<br />
<br />
suffixsep = ! # <<< NEW<br />
filemode = binary # <<< NEW<br />
<br />
[Repository RemoteExample]<br />
type = IMAP<br />
remotehost = imapserver<br />
ssl = no<br />
remoteport = 143<br />
remoteuser = username<br />
remotepass = XXXXXX<br />
maxconnections = 1<br />
holdconnectionopen = no<br />
nametrans = lambda foldername: re.sub('^INBOX\.*', '.', foldername)<br />
folderfilter = lambda foldername: not re.search('(SPAM$|Mairix)', foldername)<br />
</source></div>Twalranthttps://wiki.yobi.be/index.php?title=Courier-Cygwin&diff=5289Courier-Cygwin2008-11-06T10:06:19Z<p>Twalrant: /* Offlineimap */</p>
<hr />
<div>=Pre-requisite=<br />
<br />
Courier-IMAP requires the installation of the [http://www.courier-mta.org/authlib/ Courier Authentication Library] and the following cygwin tools and packages<br />
<br />
* patch, tar, make, gcc<br />
* crypt<br />
* libgdbm-devel<br />
* libtool<br />
* inetutils<br />
* cygrunsrv<br />
<br />
Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install the required packages.<br />
<br />
=Courier Authentication Library=<br />
<br />
Installation of Courier Authentication Library using the module userdb to manage mail accounts. All other modules are disabled.<br />
<br />
==Compilation and installation==<br />
<br />
Download and untar [http://www.courier-mta.org/download.php#authlib courier-authlib] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-authlib-0.61.0.tar.bz2 0.61.0]<br />
<br />
Apply the [{{#file:courier-authlib-0.61.0-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# add libtool flag (-no-undefined) required for DLL creation<br />
# add missing dependencies<br />
# add PATH in start script to access new DLL (installed in a different directory)<br />
<br />
Solution source: http://lists.cairographics.org/archives/cairo/2004-April/001125.html<br />
<br />
<source lang=diff><br />
--- courier-authlib-0.61.0/makedat/Makefile.in 2008-05-24 16:21:09.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/makedat/Makefile.in 2008-10-21 16:02:38.709166700 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-authlib-0.61.0/Makefile.in 2008-07-12 21:41:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/Makefile.in 2008-10-23 22:59:03.843750000 +0200<br />
@@ -213,9 +213,10 @@<br />
LTCOMPILE = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
--mode=compile $(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) \<br />
$(AM_CPPFLAGS) $(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS)<br />
-CCLD = $(CC)<br />
+CCLD = $(CC) -no-undefined<br />
+CCLDEXE = $(CC)<br />
LINK = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
- --mode=link $(CCLD) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
+ --mode=link $(CCLDEXE) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
$(LDFLAGS) -o $@<br />
SOURCES = $(libauthcustom_la_SOURCES) $(libauthldap_la_SOURCES) \<br />
$(libauthmysql_la_SOURCES) $(libauthpam_la_SOURCES) \<br />
@@ -452,9 +453,9 @@<br />
README.authdebug.html<br />
<br />
DISTCLEANFILES = dbobj.config README_authlib.html<br />
-commonlibdep = libcourierauthcommon.la<br />
+commonlibdep = libcourierauthcommon.la libcourierauth.la<br />
commonldflags = -module -rpath $(pkglibdir) -export-symbols-regex 'courier_auth.*_init' -avoid-version<br />
-commonlibadd = libcourierauthcommon.la<br />
+commonlibadd = libcourierauthcommon.la libcourierauth.la<br />
libcourierauthcommon_t = @CRYPTLIBS@<br />
libcourierauthcommon_la_SOURCES = \<br />
auth.h courierauth.h \<br />
--- courier-authlib-0.61.0/authdaemond.in 2005-07-05 14:25:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/authdaemond.in 2008-10-25 12:03:32.140625000 +0200<br />
@@ -15,4 +15,10 @@<br />
set -a<br />
. @authdaemonrc@<br />
<br />
+# Some shared libraries (DLL) are installed in @libdir@/bin<br />
+# instead of @libdir@/@PACKAGE@<br />
+# Setting LD_LIBRARY_PATH at runtime or LR_RUN_PATH at linktime doesn't<br />
+# work in cygwin, only setting PATH works. <br />
+export PATH=$PATH:@libdir@/bin<br />
+<br />
exec ${sbindir}/courierlogger -pid=@authdaemonvar@/pid $LOGGEROPTS -$1 @libexecdir@/courier-authlib/authdaemond<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courier-authlib-0.61.0-cygwin.patch<br />
<br />
Configure the package without most authentication modules, keeping only ''userdb''.<br />
<br />
'''Note''': replace ''mailuser'' by an existing user name (in your /etc/passwd file). I used my own username.<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait --without-authpam --without-authldap --without-authpwd \<br />
--without-authshadow --without-authcustom --without-authpipe --without-authmysql --without-authpgsql --with-mailuser=mailuser \<br />
--with-mailgroup=mkgroup-l-d<br />
<br />
Take a long pause... and when ready execute the following command.<br />
<br />
$ make<br />
<br />
Take again a long pause... then check the result and install the libraries<br />
<br />
$ make check<br />
$ make install<br />
<br />
'''NOTES''': list of related topics found during investigation for compilation<br />
* authldap: configure: error: -lresolve is needed for res_query... http://www.cygwin.com/ml/cygwin/2005-04/msg00419.html<br />
<br />
==Configuration==<br />
<br />
Create authdaemonrc file: /usr/local/etc/authlib/authdaemonrc<br />
<br />
$ cp /usr/local/etc/authlib/authdaemonrc.dist /usr/local/etc/authlib/authdaemonrc<br />
<br />
Change number of daemons (I use three) and enable DEBUG_LOGIN<br />
<br />
<source lang=text><br />
# The number of daemon processes that are started.<br />
daemons=3<br />
<br />
# DEBUG_LOGIN=2 - turn on debugging + log passwords too<br />
DEBUG_LOGIN=2<br />
</source><br />
<br />
See http://www.courier-mta.org/authlib/README.authdebug.html for details.<br />
<br />
==IMAP accounts==<br />
<br />
User accounts and settings are managed by ''userdb''. See [http://linux.die.net/man/8/makeuserdb makeuserdb] man page for details, or used the freshly new install man page - man makeuserdb<br />
<br />
Assuming ''username'' is your username, 1001 and 10545 are respectively the UID and GID of an existing user (part of your /etc/passwd and /etc/group). I use my own UID and GID. Create the mailuser home directory, if required, and create Maildir folder.<br />
<br />
$ mkdir -p /home/username<br />
$ cd /home/username<br />
$ /usr/lib/courier-imap/bin/maildirmake Maildir<br />
<br />
Create the userdb text file /usr/local/etc/authlib/userdb<br />
<br />
$ touch /usr/local/etc/authlib/userdb<br />
$ chmod 700 /usr/local/etc/authlib/userdb<br />
<br />
Edit /usr/local/etc/authlib/userdb, one line per account<br />
<br />
<source lang=text><br />
username[TAB]uid=1001|gid=10111|home=/home/username|mail=/home/username/Maildir|systempw=XXXXXX<br />
</source><br />
<br />
where XXXXXX is the encrypted password created with<br />
<br />
$ /usr/local/sbin/userdbpw.exe<br />
<br />
Create the (binary) userdb<br />
<br />
$ /usr/local/sbin/makeuserdb<br />
<br />
You should now have the following files created:<br />
<br />
* /usr/local/etc/authlib/userdb.dat<br />
* /usr/local/etc/authlib/userdbshadow.dat<br />
<br />
==Running==<br />
<br />
Install and configure syslogd. Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install inetutils (contains syslogd). Configure syslogd with the following command. It will create the /etc/syslogd.conf file and install a windows service using cygrunsrv<br />
<br />
$ syslogd-config<br />
<br />
Start the authlib daemon with the following command:<br />
<br />
$ /usr/local/sbin/authdaemon start<br />
<br />
Stop the daemon with the following command:<br />
<br />
$ /usr/local/sbin/authdaemon stop<br />
<br />
You'll find log messages in /var/log/messages (default target file as specified in /etc/syslogd.conf)<br />
<br />
==Testing authlib==<br />
<br />
$ /usr/local/sbin/authtest username CCCCCC<br />
Authentication succeeded.<br />
<br />
Authenticated: username (uid 1001, gid 10545)<br />
Home Directory: /home/username<br />
Maildir: /home/username/Maildir<br />
Quota: (none)<br />
Encrypted Password: XXXXXX<br />
Cleartext Password: CCCCCC<br />
Options: (none)<br />
<br />
where username is your user name and XXXXXX is your encrypted password as provided in ''/usr/local/etc/authlib/userdb''. CCCCCC is your password in clear.<br />
<br />
==Troubleshooting==<br />
<br />
Should you have a doubt on the execution of a command (ie: no output) you can check if the application is able to load required DLL. This error is not reported. Using ''strace'', windows will complain about DLL not found, if any. To solve this problem you may need to add some path in your PATH. For example, in order to test authlib with authtest:<br />
<br />
$ strace /usr/local/sbin/authtest<br />
# This will open a dialog box to complain about DLL.<br />
$ export PATH=$PATH:/usr/local/lib/bin<br />
$ /usr/local/sbin/authtest ausername<br />
<br />
==Courier Authentication Config==<br />
<br />
$ /usr/local/bin/courierauthconfig.exe --version<br />
$ /usr/local/bin/courierauthconfig.exe --ldflags<br />
$ /usr/local/bin/courierauthconfig.exe --cppflags<br />
$ /usr/local/bin/courierauthconfig.exe --configfiles<br />
<br />
=Courier-IMAP=<br />
==Compilation and installation==<br />
<br />
Download and untar package [http://www.courier-mta.org/download.php#imap courier-imap] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-imap-4.4.1.tar.bz2 4.4.1.20080920]<br />
<br />
Apply the [{{#file:courier-imap-4.4.1-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# incorrect usage of EXTEXT in main ''Makefile''<br />
# remove usage of /usr/lib/env in start/stop script (/usr/lib/env does not seem to work under Cygwin)<br />
<br />
<source lang=diff><br />
--- courier-imap-4.4.1.20080920/makedat/Makefile.in 2008-08-24 19:52:51.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/makedat/Makefile.in 2008-10-21 20:43:27.500000000 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-imap-4.4.1.20080920/Makefile.in 2008-09-20 14:48:46.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/Makefile.in 2008-10-21 20:59:45.156250000 +0200<br />
@@ -247,9 +247,9 @@<br />
CLEANFILES = $(databin_SCRIPTS) $(man_MANS) $(sysconf_DATA) $(sbin_SCRIPTS)<br />
databindir = $(datadir)<br />
databin_SCRIPTS = mkimapdcert mkpop3dcert<br />
-binPROGRAMS = imapd pop3d maildirmake maildiracl deliverquota maildirkw<br />
-sbinPROGRAMS = imaplogin pop3login<br />
-libexecPROGRAMS = makedatprog couriertcpd<br />
+binPROGRAMS = imapd$(EXEEXT) pop3d$(EXEEXT) maildirmake$(EXEEXT) maildiracl$(EXEEXT) deliverquota$(EXEEXT) maildirkw$(EXEEXT)<br />
+sbinPROGRAMS = imaplogin$(EXEEXT) pop3login$(EXEEXT)<br />
+libexecPROGRAMS = makedatprog$(EXEEXT) couriertcpd$(EXEEXT)<br />
bin_PROGRAMS = @binPROGRAMS_exec@<br />
sbin_PROGRAMS = @sbinPROGRAMS_exec@<br />
libexec_PROGRAMS = @libexecPROGRAMS_exec@<br />
--- courier-imap-4.4.1.20080920/imapd.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/imapd.rc.in 2008-10-26 10:17:51.359375000 +0100<br />
@@ -22,6 +22,15 @@<br />
exit 1<br />
fi<br />
<br />
+# Location for some shared libraries (cygcourierauth*.dll) from authlib<br />
+AUTHLIBDIR=/usr/local<br />
+if test ! -f $AUTHLIBDIR/lib/bin/cygcourierauth.dll<br />
+then<br />
+ echo "$AUTHLIBDIR/lib/bin/cygcourierauth.dll not found."<br />
+ exit 1<br />
+fi<br />
+export PATH=$PATH:$AUTHLIBDIR/lib/bin<br />
+<br />
TLS_CACHEFILE=""<br />
. @sysconfdir@/imapd-ssl<br />
. @sysconfdir@/imapd<br />
@@ -35,7 +44,7 @@<br />
<br />
umask $IMAP_UMASK<br />
@ULIMIT@ $IMAP_ULIMITD<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
--- courier-imap-4.4.1.20080920/pop3d.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/pop3d.rc.in 2008-10-26 10:18:02.187500000 +0100<br />
@@ -22,12 +22,21 @@<br />
exit 1<br />
fi<br />
<br />
+# Location for some shared libraries (cygcourierauth*.dll) from authlib<br />
+AUTHLIBDIR=/usr/local<br />
+if test ! -f $AUTHLIBDIR/lib/bin/cygcourierauth.dll<br />
+then<br />
+ echo "$AUTHLIBDIR/lib/bin/cygcourierauth.dll not found."<br />
+ exit 1<br />
+fi<br />
+export PATH=$PATH:$AUTHLIBDIR/lib/bin<br />
+<br />
. @sysconfdir@/pop3d-ssl<br />
. @sysconfdir@/pop3d<br />
<br />
case $1 in<br />
start)<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courier-imap-4.4.1-cygwin.patch<br />
<br />
Configure the package<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait<br />
<br />
Take a walk... and when ready execute the following command to build the package.<br />
<br />
$ make<br />
<br />
Time to go for some coffee... and then install the package with the usual<br />
<br />
$ make install<br />
$ make install-configure<br />
<br />
==Configuration==<br />
<br />
Setup courier-imap: $prefix/etc/imapd (where $prefix=/usr/lib/courier-imap)<br />
<br />
Set ADDRESS to a valid value (0 or 127.0.0.1) and change IMAP_ULIMITD to a value accepted by the command ulimit. I simply used the existing value returned by<br />
<br />
$ ulimit -v<br />
<br />
==Running==<br />
<br />
Syslogd service and authdaemond should be started. See above.<br />
<br />
Start the imap daemon with the following command:<br />
<br />
$ /usr/lib/courier-imap/libexec/imapd.rc start<br />
<br />
Stop the daemon with the following command:<br />
<br />
$ /usr/lib/courier-imap/libexec/imapd.rc stop<br />
<br />
You'll find log messages in /var/log/messages (default target file as specified in /etc/syslogd.conf)<br />
<br />
==Testing==<br />
When authdaemond and imapd are running you can do a simple login test:<br />
<br />
$ telnet localhost 143<br />
<br />
and type the login command<br />
<br />
a login <username> <password><br />
<br />
the server should reply<br />
<br />
a OK LOGIN Ok.<br />
<br />
to which you can reply with a logout<br />
<br />
a logout<br />
<br />
the session is terminated by the server<br />
<br />
* BYE Courier-IMAP server shutting down<br />
a OK LOGOUT completed<br />
Connection closed by foreign host.<br />
<br />
'''Hint:''' if the connection is immediately closed by foreign host it probably means that ''imapd'' does not have access to all required DLLs. Check your PATH.<br />
<br />
==All in one==<br />
If everything works fine you can use the following [{{#file:imapd}} startup script] to launch or stop imap and authlib daemons. It can be saved in /usr/local/sbin.<br />
<br />
<source lang=bash><br />
#! /bin/sh<br />
#<br />
# Courier imap daemon startup script.<br />
<br />
authlib=/usr/local/sbin/authdaemond<br />
imapd=/usr/lib/courier-imap/libexec/imapd.rc<br />
<br />
test ! -f $authlib && echo "File not found: $authlib" && exit 1;<br />
test ! -f $imapd && echo "File not found: $imapd" && exit 1;<br />
<br />
case $1 in<br />
start)<br />
$authlib start<br />
$imapd start<br />
;;<br />
stop)<br />
$imapd stop<br />
$authlib stop<br />
;;<br />
*)<br />
echo "Usage: $0 <start|stop>"<br />
;;<br />
esac<br />
</source><br />
<br />
==Cygwin service==<br />
Create the [{{#file:imapd-srv.sh}} service script]<br />
<br />
<source lang=bash><br />
#!/bin/sh<br />
# File: imapd-service.sh<br />
# Purpose: Courier imap daemon service script.<br />
#<br />
# NOTE: This script must be excutable by SYSTEM<br />
username=username # <<<< Change me !!!<br />
pidsleep=''<br />
<br />
# Function to handle QUIT signal.<br />
# Stop imapd daemon and kill background sleep.<br />
function handleQuit<br />
{<br />
echo "STOPPING: /usr/local/sbin/imapd"<br />
su $username -c "/usr/local/sbin/imapd stop"<br />
test -n "$pidsleep" && kill -9 $pidsleep<br />
exit<br />
}<br />
<br />
# Interruptible sleep<br />
# Note: sleep is an external command (not builtin command), hence<br />
# not interruptible by the QUIT signal.<br />
function intsleep<br />
{<br />
sleep $1 &<br />
pidsleep=$!<br />
wait $pidsleep<br />
}<br />
<br />
echo "STARTING: /usr/local/sbin/imapd as $username at "`date`<br />
su $username -c "/usr/local/sbin/imapd start"<br />
<br />
trap "handleQuit" SIGQUIT<br />
<br />
echo "WAITING: "$$<br />
while true; do intsleep 1d; done<br />
</source><br />
<br />
Change username and save it to your favorite location, says /usr/local/sbin. The service script must be executable by SYSTEM, ie: the user that run the windows services.<br />
<br />
$ chmod +rx /usr/local/sbin/imapd-service.sh<br />
<br />
Install the new service with the following command.<br />
<br />
$ cygrunsrv --install imapd --desc "Courier IMAP daemon" --disp "CYGWIN imapd" \<br />
--path /usr/local/sbin/imapd-service.sh --termsig QUIT --type auto --shutdown<br />
<br />
Finally, just start the service<br />
<br />
$ cygrunsrv --start imapd<br />
or<br />
$ net start imapd<br />
<br />
You should now have couple of processes related to courier-imap<br />
<br />
$ ps -a<br />
<br />
'''NOTES''':<br />
* If the service could not be started, it's probably because the service script is not executable by SYSTEM<br />
<br />
$ net start imapd<br />
The CYGWIN imapd service is starting.<br />
The CYGWIN imapd service could not be started. <br />
<br />
The service did not report an error.<br />
<br />
More help is available by typing NET HELPMSG 3534.<br />
<br />
* The combination of background sleep and builtin wait command is used to make the waiting statment interruptible. The original script found on the net, was simply using a 'sleep 1' which turned to consume ~10% of the CPU.<br />
<br />
=Maildir=<br />
'''maildirmake''' is part of the courier-imap package<br />
<br />
$ /usr/lib/courier-imap/bin/maildirmake<br />
<br />
=Mairix - index and search mail folders=<br />
Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install the package mairix.<br />
<br />
Create the configuration file in your home directory: ~/.mairixrc<br />
<br />
base=/home/username<br />
maildir=Maildir...<br />
omit=Maildir/.Mairix**<br />
mfolder=Maildir/.Mairix<br />
database=/home/username/.mairix_database<br />
<br />
The create the mairix index<br />
<br />
$ mairix<br />
and<br />
$ mairix --fast-index # on daily base<br />
<br />
See [[Mail_Tips]] for additional details.<br />
<br />
=Offlineimap=<br />
Requires python, so run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install the package python.<br />
<br />
Download offlineimap [http://software.complete.org/software/projects/list_files/offlineimap here]. I use [http://software.complete.org/software/versions/download/242?attachment_id=334 version 6.0.3]. Extract files in you favorite sandbox.<br />
<br />
$ tar xvfz offlineimap_6.0.3.tar.gz<br />
$ cd offlineimap<br />
<br />
Apply the following [{{#file:offlineimap_6.0.3-cygwin.patch}} patch] to correct the following issues:<br />
<br />
* [http://en.wikipedia.org/wiki/Maildir#Windows_software Suffix separator] character colon (:) is not allowed in Windows. Courier-imap for cygwin is using (!)<br />
* While used by courier-imap for cygwin Maildir mail files should not use CRLF, rather only LF. The issue appears only in mail with attachment, that is the raw message is not interpreted and displayed as it in the mail body (under Thunderbird).<br />
<br />
<source lang=diff><br />
--- offlineimap.conf 2008-08-13 20:56:04.000000000 +0200<br />
+++ offlineimap-cygwin.conf 2008-11-06 10:44:31.066750700 +0100<br />
@@ -215,6 +215,19 @@<br />
<br />
restoreatime = no<br />
<br />
+# Cygwin/Windows users may have issues with the Maildir mail filename<br />
+# containing the suffix separator character (:). In this case, they<br />
+# could change the suffix separator character to whatever required.<br />
+# For example, Courier-IMAP for Cygwin is using (!)<br />
+<br />
+# suffixsep = !<br />
+<br />
+# Cygwin/Windows users may need to create Maildir mail filename in<br />
+# binary mode. In this case, set the 'filemode' to 'binary'. Default is<br />
+# 'text'. Courier-IMAP for Cygwin works better with binary mode.<br />
+<br />
+# filemode = binary<br />
+<br />
[Repository RemoteExample]<br />
<br />
# And this is the remote repository. We only support IMAP or Gmail here.<br />
--- offlineimap/folder/Maildir.py 2008-08-13 20:55:48.000000000 +0200<br />
+++ offlineimap/folder/Maildir-cygwin.py 2008-11-06 10:44:05.344202700 +0100<br />
@@ -23,7 +23,6 @@<br />
import os.path, os, re, time, socket, md5<br />
<br />
uidmatchre = re.compile(',U=(\d+)')<br />
-flagmatchre = re.compile(':.*2,([A-Z]+)')<br />
<br />
timeseq = 0<br />
lasttime = long(0)<br />
@@ -54,6 +53,12 @@<br />
self.messagelist = None<br />
self.repository = repository<br />
self.accountname = accountname<br />
+ self.filemode = {<br />
+ 'binary': 'wb',<br />
+ 'text': 'wt',<br />
+ }[repository.getconf("filemode", 'text')]<br />
+ self.suffixsep = repository.getconf("suffixsep",':')<br />
+ self.flagmatchre = re.compile('%s.*2,([A-Z]+)' % self.suffixsep)<br />
BaseFolder.__init__(self)<br />
<br />
def getaccountname(self):<br />
@@ -102,7 +107,7 @@<br />
nouidcounter -= 1<br />
else:<br />
uid = long(uidmatch.group(1))<br />
- flagmatch = flagmatchre.search(messagename)<br />
+ flagmatch = self.flagmatchre.search(messagename)<br />
flags = []<br />
if flagmatch:<br />
flags = [x for x in flagmatch.group(1)]<br />
@@ -180,7 +185,7 @@<br />
break<br />
tmpmessagename = messagename.split(',')[0]<br />
ui.debug('maildir', 'savemessage: using temporary name %s' % tmpmessagename)<br />
- file = open(os.path.join(tmpdir, tmpmessagename), "wt")<br />
+ file = open(os.path.join(tmpdir, tmpmessagename), self.filemode)<br />
file.write(content)<br />
<br />
# Make sure the data hits the disk<br />
@@ -226,11 +231,11 @@<br />
newpath = os.path.join(self.getfullname(), 'cur')<br />
else:<br />
newpath = os.path.join(self.getfullname(), 'new')<br />
- infostr = ':'<br />
- infomatch = re.search('(:.*)$', newname)<br />
+ infostr = self.suffixsep<br />
+ infomatch = re.search('(%s.*)$' % self.suffixsep, newname)<br />
if infomatch: # If the info string is present..<br />
infostr = infomatch.group(1)<br />
- newname = newname.split(':')[0] # Strip off the info string.<br />
+ newname = newname.split(self.suffixsep)[0] # Strip off the info string.<br />
infostr = re.sub('2,[A-Z]*', '', infostr)<br />
flags.sort()<br />
infostr += '2,' + ''.join(flags)<br />
</source><br />
<br />
$ patch -Np0 < ../../offlineimap_6.0.3-cygwin.patch<br />
<br />
Install offlineimap<br />
<br />
$ python setup.py install<br />
<br />
Configure offlineimap as described in [[Offlineimap]] and launch offlineimap. '''CAUTION:''' Add the NEW suffixsep and filemode options in the Maildir repository section of the configuration file.<br />
<br />
$ offlineimap<br />
or<br />
$ offlineimap -1 -o -u Noninteractive.Basic<br />
or<br />
$ offlineimap -c /home/username/offlineimap.conf<br />
<br />
Here is a simple [{{#file:offlineimap.conf}} offlineimap configuration file].<br />
<br />
<source lang=text><br />
[general]<br />
metadata = /home/username/.offlineimap<br />
accounts = Test<br />
maxsyncaccounts = 1<br />
ui = Curses.Blinkenlights, TTY.TTYUI,<br />
Noninteractive.Basic, Noninteractive.Quiet<br />
ignore-readonly = no<br />
<br />
[mbnames]<br />
enabled = no<br />
<br />
[ui.Curses.Blinkenlights]<br />
statuschar = .<br />
<br />
[Account Test]<br />
localrepository = LocalExample<br />
remoterepository = RemoteExample<br />
<br />
[Repository LocalExample]<br />
type = Maildir<br />
localfolders = /home/username/Maildir<br />
sep = .<br />
restoreatime = no<br />
<br />
suffixsep = ! # <<< NEW<br />
filemode = binary # <<< NEW<br />
<br />
[Repository RemoteExample]<br />
type = IMAP<br />
remotehost = imapserver<br />
ssl = no<br />
remoteport = 143<br />
remoteuser = username<br />
remotepass = XXXXXX<br />
maxconnections = 1<br />
holdconnectionopen = no<br />
nametrans = lambda foldername: re.sub('^INBOX\.*', '.', foldername)<br />
folderfilter = lambda foldername: not re.search('(SPAM$|Mairix)', foldername)<br />
</source></div>Twalranthttps://wiki.yobi.be/index.php?title=Courier-Cygwin&diff=5281Courier-Cygwin2008-11-04T09:18:18Z<p>Twalrant: /* Offlineimap */</p>
<hr />
<div>=Pre-requisite=<br />
<br />
Courier-IMAP requires the installation of the [http://www.courier-mta.org/authlib/ Courier Authentication Library] and the following cygwin tools and packages<br />
<br />
* patch, tar, make, gcc<br />
* crypt<br />
* libgdbm-devel<br />
* libtool<br />
* inetutils<br />
* cygrunsrv<br />
<br />
Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install the required packages.<br />
<br />
=Courier Authentication Library=<br />
<br />
Installation of Courier Authentication Library using the module userdb to manage mail accounts. All other modules are disabled.<br />
<br />
==Compilation and installation==<br />
<br />
Download and untar [http://www.courier-mta.org/download.php#authlib courier-authlib] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-authlib-0.61.0.tar.bz2 0.61.0]<br />
<br />
Apply the [{{#file:courrier-authlib-0.61.0-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# add libtool flag (-no-undefined) required for DLL creation<br />
# add missing dependencies<br />
# add PATH in start script to access new DLL (installed in a different directory)<br />
<br />
Solution source: http://lists.cairographics.org/archives/cairo/2004-April/001125.html<br />
<br />
<source lang=diff><br />
--- courier-authlib-0.61.0/makedat/Makefile.in 2008-05-24 16:21:09.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/makedat/Makefile.in 2008-10-21 16:02:38.709166700 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-authlib-0.61.0/Makefile.in 2008-07-12 21:41:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/Makefile.in 2008-10-23 22:59:03.843750000 +0200<br />
@@ -213,9 +213,10 @@<br />
LTCOMPILE = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
--mode=compile $(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) \<br />
$(AM_CPPFLAGS) $(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS)<br />
-CCLD = $(CC)<br />
+CCLD = $(CC) -no-undefined<br />
+CCLDEXE = $(CC)<br />
LINK = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
- --mode=link $(CCLD) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
+ --mode=link $(CCLDEXE) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
$(LDFLAGS) -o $@<br />
SOURCES = $(libauthcustom_la_SOURCES) $(libauthldap_la_SOURCES) \<br />
$(libauthmysql_la_SOURCES) $(libauthpam_la_SOURCES) \<br />
@@ -452,9 +453,9 @@<br />
README.authdebug.html<br />
<br />
DISTCLEANFILES = dbobj.config README_authlib.html<br />
-commonlibdep = libcourierauthcommon.la<br />
+commonlibdep = libcourierauthcommon.la libcourierauth.la<br />
commonldflags = -module -rpath $(pkglibdir) -export-symbols-regex 'courier_auth.*_init' -avoid-version<br />
-commonlibadd = libcourierauthcommon.la<br />
+commonlibadd = libcourierauthcommon.la libcourierauth.la<br />
libcourierauthcommon_t = @CRYPTLIBS@<br />
libcourierauthcommon_la_SOURCES = \<br />
auth.h courierauth.h \<br />
--- courier-authlib-0.61.0/authdaemond.in 2005-07-05 14:25:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/authdaemond.in 2008-10-25 12:03:32.140625000 +0200<br />
@@ -15,4 +15,10 @@<br />
set -a<br />
. @authdaemonrc@<br />
<br />
+# Some shared libraries (DLL) are installed in @libdir@/bin<br />
+# instead of @libdir@/@PACKAGE@<br />
+# Setting LD_LIBRARY_PATH at runtime or LR_RUN_PATH at linktime doesn't<br />
+# work in cygwin, only setting PATH works. <br />
+export PATH=$PATH:@libdir@/bin<br />
+<br />
exec ${sbindir}/courierlogger -pid=@authdaemonvar@/pid $LOGGEROPTS -$1 @libexecdir@/courier-authlib/authdaemond<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-authlib-0.61.0-cygwin.patch<br />
<br />
Configure the package without most authentication modules, keeping only ''userdb''.<br />
<br />
'''Note''': replace ''mailuser'' by an existing user name (in your /etc/passwd file). I used my own username.<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait --without-authpam --without-authldap --without-authpwd \<br />
--without-authshadow --without-authcustom --without-authpipe --without-authmysql --without-authpgsql --with-mailuser=mailuser \<br />
--with-mailgroup=mkgroup-l-d<br />
<br />
Take a long pause... and when ready execute the following command.<br />
<br />
$ make<br />
<br />
Take again a long pause... then check the result and install the libraries<br />
<br />
$ make check<br />
$ make install<br />
<br />
'''NOTES''': list of related topics found during investigation for compilation<br />
* authldap: configure: error: -lresolve is needed for res_query... http://www.cygwin.com/ml/cygwin/2005-04/msg00419.html<br />
<br />
==Configuration==<br />
<br />
Create authdaemonrc file: /usr/local/etc/authlib/authdaemonrc<br />
<br />
$ cp /usr/local/etc/authlib/authdaemonrc.dist /usr/local/etc/authlib/authdaemonrc<br />
<br />
Change number of daemons (I use three) and enable DEBUG_LOGIN<br />
<br />
<source lang=text><br />
# The number of daemon processes that are started.<br />
daemons=3<br />
<br />
# DEBUG_LOGIN=2 - turn on debugging + log passwords too<br />
DEBUG_LOGIN=2<br />
</source><br />
<br />
See http://www.courier-mta.org/authlib/README.authdebug.html for details.<br />
<br />
==IMAP accounts==<br />
<br />
User accounts and settings are managed by ''userdb''. See [http://linux.die.net/man/8/makeuserdb makeuserdb] man page for details, or used the freshly new install man page - man makeuserdb<br />
<br />
Assuming ''username'' is your username, 1001 and 10545 are respectively the UID and GID of an existing user (part of your /etc/passwd and /etc/group). I use my own UID and GID. Create the mailuser home directory, if required, and create Maildir folder.<br />
<br />
$ mkdir -p /home/username<br />
$ cd /home/username<br />
$ /usr/lib/courier-imap/bin/maildirmake Maildir<br />
<br />
Create the userdb text file /usr/local/etc/authlib/userdb<br />
<br />
$ touch /usr/local/etc/authlib/userdb<br />
$ chmod 700 /usr/local/etc/authlib/userdb<br />
<br />
Edit /usr/local/etc/authlib/userdb, one line per account<br />
<br />
<source lang=text><br />
username[TAB]uid=1001|gid=10111|home=/home/username|mail=/home/username/Maildir|systempw=XXXXXX<br />
</source><br />
<br />
where XXXXXX is the encrypted password created with<br />
<br />
$ /usr/local/sbin/userdbpw.exe<br />
<br />
Create the (binary) userdb<br />
<br />
$ /usr/local/sbin/makeuserdb<br />
<br />
You should now have the following files created:<br />
<br />
* /usr/local/etc/authlib/userdb.dat<br />
* /usr/local/etc/authlib/userdbshadow.dat<br />
<br />
==Running==<br />
<br />
Install and configure syslogd. Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install inetutils (contains syslogd). Configure syslogd with the following command. It will create the /etc/syslogd.conf file and install a windows service using cygrunsrv<br />
<br />
$ syslogd-config<br />
<br />
Start the authlib daemon with the following command:<br />
<br />
$ /usr/local/sbin/authdaemon start<br />
<br />
Stop the daemon with the following command:<br />
<br />
$ /usr/local/sbin/authdaemon stop<br />
<br />
You'll find log messages in /var/log/messages (default target file as specified in /etc/syslogd.conf)<br />
<br />
==Testing authlib==<br />
<br />
$ /usr/local/sbin/authtest username CCCCCC<br />
Authentication succeeded.<br />
<br />
Authenticated: username (uid 1001, gid 10545)<br />
Home Directory: /home/username<br />
Maildir: /home/username/Maildir<br />
Quota: (none)<br />
Encrypted Password: XXXXXX<br />
Cleartext Password: CCCCCC<br />
Options: (none)<br />
<br />
where username is your user name and XXXXXX is your encrypted password as provided in ''/usr/local/etc/authlib/userdb''. CCCCCC is your password in clear.<br />
<br />
==Troubleshooting==<br />
<br />
Should you have a doubt on the execution of a command (ie: no output) you can check if the application is able to load required DLL. This error is not reported. Using ''strace'', windows will complain about DLL not found, if any. To solve this problem you may need to add some path in your PATH. For example, in order to test authlib with authtest:<br />
<br />
$ strace /usr/local/sbin/authtest<br />
# This will open a dialog box to complain about DLL.<br />
$ export PATH=$PATH:/usr/local/lib/bin<br />
$ /usr/local/sbin/authtest ausername<br />
<br />
==Courier Authentication Config==<br />
<br />
$ /usr/local/bin/courierauthconfig.exe --version<br />
$ /usr/local/bin/courierauthconfig.exe --ldflags<br />
$ /usr/local/bin/courierauthconfig.exe --cppflags<br />
$ /usr/local/bin/courierauthconfig.exe --configfiles<br />
<br />
=Courier-IMAP=<br />
==Compilation and installation==<br />
<br />
Download and untar package [http://www.courier-mta.org/download.php#imap courier-imap] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-imap-4.4.1.tar.bz2 4.4.1.20080920]<br />
<br />
Apply the [{{#file:courrier-imap-4.4.1-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# incorrect usage of EXTEXT in main ''Makefile''<br />
# remove usage of /usr/lib/env in start/stop script (/usr/lib/env does not seem to work under Cygwin)<br />
<br />
<source lang=diff><br />
--- courier-imap-4.4.1.20080920/makedat/Makefile.in 2008-08-24 19:52:51.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/makedat/Makefile.in 2008-10-21 20:43:27.500000000 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-imap-4.4.1.20080920/Makefile.in 2008-09-20 14:48:46.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/Makefile.in 2008-10-21 20:59:45.156250000 +0200<br />
@@ -247,9 +247,9 @@<br />
CLEANFILES = $(databin_SCRIPTS) $(man_MANS) $(sysconf_DATA) $(sbin_SCRIPTS)<br />
databindir = $(datadir)<br />
databin_SCRIPTS = mkimapdcert mkpop3dcert<br />
-binPROGRAMS = imapd pop3d maildirmake maildiracl deliverquota maildirkw<br />
-sbinPROGRAMS = imaplogin pop3login<br />
-libexecPROGRAMS = makedatprog couriertcpd<br />
+binPROGRAMS = imapd$(EXEEXT) pop3d$(EXEEXT) maildirmake$(EXEEXT) maildiracl$(EXEEXT) deliverquota$(EXEEXT) maildirkw$(EXEEXT)<br />
+sbinPROGRAMS = imaplogin$(EXEEXT) pop3login$(EXEEXT)<br />
+libexecPROGRAMS = makedatprog$(EXEEXT) couriertcpd$(EXEEXT)<br />
bin_PROGRAMS = @binPROGRAMS_exec@<br />
sbin_PROGRAMS = @sbinPROGRAMS_exec@<br />
libexec_PROGRAMS = @libexecPROGRAMS_exec@<br />
--- courier-imap-4.4.1.20080920/imapd.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/imapd.rc.in 2008-10-26 10:17:51.359375000 +0100<br />
@@ -22,6 +22,15 @@<br />
exit 1<br />
fi<br />
<br />
+# Location for some shared libraries (cygcourierauth*.dll) from authlib<br />
+AUTHLIBDIR=/usr/local<br />
+if test ! -f $AUTHLIBDIR/lib/bin/cygcourierauth.dll<br />
+then<br />
+ echo "$AUTHLIBDIR/lib/bin/cygcourierauth.dll not found."<br />
+ exit 1<br />
+fi<br />
+export PATH=$PATH:$AUTHLIBDIR/lib/bin<br />
+<br />
TLS_CACHEFILE=""<br />
. @sysconfdir@/imapd-ssl<br />
. @sysconfdir@/imapd<br />
@@ -35,7 +44,7 @@<br />
<br />
umask $IMAP_UMASK<br />
@ULIMIT@ $IMAP_ULIMITD<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
--- courier-imap-4.4.1.20080920/pop3d.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/pop3d.rc.in 2008-10-26 10:18:02.187500000 +0100<br />
@@ -22,12 +22,21 @@<br />
exit 1<br />
fi<br />
<br />
+# Location for some shared libraries (cygcourierauth*.dll) from authlib<br />
+AUTHLIBDIR=/usr/local<br />
+if test ! -f $AUTHLIBDIR/lib/bin/cygcourierauth.dll<br />
+then<br />
+ echo "$AUTHLIBDIR/lib/bin/cygcourierauth.dll not found."<br />
+ exit 1<br />
+fi<br />
+export PATH=$PATH:$AUTHLIBDIR/lib/bin<br />
+<br />
. @sysconfdir@/pop3d-ssl<br />
. @sysconfdir@/pop3d<br />
<br />
case $1 in<br />
start)<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-imap-4.4.1-cygwin.patch<br />
<br />
Configure the package<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait<br />
<br />
Take a walk... and when ready execute the following command to build the package.<br />
<br />
$ make<br />
<br />
Time to go for some coffee... and then install the package with the usual<br />
<br />
$ make install<br />
$ make install-configure<br />
<br />
==Configuration==<br />
<br />
Setup courier-imap: $prefix/etc/imapd (where $prefix=/usr/lib/courier-imap)<br />
<br />
Set ADDRESS to a valid value (0 or 127.0.0.1) and change IMAP_ULIMITD to a value accepted by the command ulimit. I simply used the existing value returned by<br />
<br />
$ ulimit -v<br />
<br />
==Running==<br />
<br />
Syslogd service and authdaemond should be started. See above.<br />
<br />
Start the imap daemon with the following command:<br />
<br />
$ /usr/lib/courier-imap/libexec/imapd.rc start<br />
<br />
Stop the daemon with the following command:<br />
<br />
$ /usr/lib/courier-imap/libexec/imapd.rc stop<br />
<br />
You'll find log messages in /var/log/messages (default target file as specified in /etc/syslogd.conf)<br />
<br />
==Testing==<br />
When authdaemond and imapd are running you can do a simple login test:<br />
<br />
$ telnet localhost 143<br />
<br />
and type the login command<br />
<br />
a login <username> <password><br />
<br />
the server should reply<br />
<br />
a OK LOGIN Ok.<br />
<br />
to which you can reply with a logout<br />
<br />
a logout<br />
<br />
the session is terminated by the server<br />
<br />
* BYE Courier-IMAP server shutting down<br />
a OK LOGOUT completed<br />
Connection closed by foreign host.<br />
<br />
'''Hint:''' if the connection is immediately closed by foreign host it probably means that ''imapd'' does not have access to all required DLLs. Check your PATH.<br />
<br />
==All in one==<br />
If everything works fine you can use the following [{{#file:imapd}} startup script] to launch or stop imap and authlib daemons. It can be saved in /usr/local/sbin.<br />
<br />
<source lang=bash><br />
#! /bin/sh<br />
#<br />
# Courier imap daemon startup script.<br />
<br />
authlib=/usr/local/sbin/authdaemond<br />
imapd=/usr/lib/courier-imap/libexec/imapd.rc<br />
<br />
test ! -f $authlib && echo "File not found: $authlib" && exit 1;<br />
test ! -f $imapd && echo "File not found: $imapd" && exit 1;<br />
<br />
case $1 in<br />
start)<br />
$authlib start<br />
$imapd start<br />
;;<br />
stop)<br />
$imapd stop<br />
$authlib stop<br />
;;<br />
*)<br />
echo "Usage: $0 <start|stop>"<br />
;;<br />
esac<br />
</source><br />
<br />
==Cygwin service==<br />
Create the [{{#file:imapd-srv.sh}} service script]<br />
<br />
<source lang=bash><br />
#!/bin/sh<br />
# File: imapd-service.sh<br />
# Purpose: Courier imap daemon service script.<br />
#<br />
# NOTE: This script must be excutable by SYSTEM<br />
username=username # <<<< Change me !!!<br />
pidsleep=''<br />
<br />
# Function to handle QUIT signal.<br />
# Stop imapd daemon and kill background sleep.<br />
function handleQuit<br />
{<br />
echo "STOPPING: /usr/local/sbin/imapd"<br />
su $username -c "/usr/local/sbin/imapd stop"<br />
test -n "$pidsleep" && kill -9 $pidsleep<br />
exit<br />
}<br />
<br />
# Interruptible sleep<br />
# Note: sleep is an external command (not builtin command), hence<br />
# not interruptible by the QUIT signal.<br />
function intsleep<br />
{<br />
sleep $1 &<br />
pidsleep=$!<br />
wait $pidsleep<br />
}<br />
<br />
echo "STARTING: /usr/local/sbin/imapd as $username at "`date`<br />
su $username -c "/usr/local/sbin/imapd start"<br />
<br />
trap "handleQuit" SIGQUIT<br />
<br />
echo "WAITING: "$$<br />
while true; do intsleep 1d; done<br />
</source><br />
<br />
Change username and save it to your favorite location, says /usr/local/sbin. The service script must be executable by SYSTEM, ie: the user that run the windows services.<br />
<br />
$ chmod +rx /usr/local/sbin/imapd-service.sh<br />
<br />
Install the new service with the following command.<br />
<br />
$ cygrunsrv --install imapd --desc "Courier IMAP daemon" --disp "CYGWIN imapd" \<br />
--path /usr/local/sbin/imapd-service.sh --termsig QUIT --type auto --shutdown<br />
<br />
Finally, just start the service<br />
<br />
$ cygrunsrv --start imapd<br />
or<br />
$ net start imapd<br />
<br />
You should now have couple of processes related to courier-imap<br />
<br />
$ ps -a<br />
<br />
'''NOTES''':<br />
* If the service could not be started, it's probably because the service script is not executable by SYSTEM<br />
<br />
$ net start imapd<br />
The CYGWIN imapd service is starting.<br />
The CYGWIN imapd service could not be started. <br />
<br />
The service did not report an error.<br />
<br />
More help is available by typing NET HELPMSG 3534.<br />
<br />
* The combination of background sleep and builtin wait command is used to make the waiting statment interruptible. The original script found on the net, was simply using a 'sleep 1' which turned to consume ~10% of the CPU.<br />
<br />
=Maildir=<br />
'''maildirmake''' is part of the courier-imap package<br />
<br />
$ /usr/lib/courier-imap/bin/maildirmake<br />
<br />
=Mairix - index and search mail folders=<br />
Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install the package mairix.<br />
<br />
Create the configuration file in your home directory: ~/.mairixrc<br />
<br />
base=/home/username<br />
maildir=Maildir...<br />
omit=Maildir/.Mairix**<br />
mfolder=Maildir/.Mairix<br />
database=/home/username/.mairix_database<br />
<br />
The create the mairix index<br />
<br />
$ mairix<br />
and<br />
$ mairix --fast-index # on daily base<br />
<br />
See [[Mail_Tips]] for additional details.<br />
<br />
=Offlineimap=<br />
Requires python, so run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install the package python.<br />
<br />
Download offlineimap [http://software.complete.org/software/projects/list_files/offlineimap here]. I use [http://software.complete.org/software/versions/download/242?attachment_id=334 version 6.0.3]. Extract files in you favorite sandbox.<br />
<br />
$ tar xvfz offlineimap_6.0.3.tar.gz<br />
$ cd offlineimap<br />
<br />
Apply the following [{{#file:offlineimap_6.0.3-cygwin.patch}} patch] to correct the following issues:<br />
<br />
* [http://en.wikipedia.org/wiki/Maildir#Windows_software Suffix separator character] (:) is not allowed in Windows. Courier-imap for cygwin is using (!)<br />
* While used by courier-imap for cygwin Maildir mail files should not use CRLF, rather only LF. The issue appears only in mail with attachment, that is the raw message is not interpreted and displayed as it in the mail body (under Thunderbird).<br />
<br />
<source lang=diff><br />
--- offlineimap/folder/Maildir.py 2008-11-01 20:49:30.843750000 +0100<br />
+++ offlineimap/folder/Maildir-cygwin.py 2008-11-03 22:54:51.437500000 +0100<br />
@@ -23,7 +23,7 @@<br />
import os.path, os, re, time, socket, md5<br />
<br />
uidmatchre = re.compile(',U=(\d+)')<br />
-flagmatchre = re.compile(':.*2,([A-Z]+)')<br />
+flagmatchre = re.compile('!.*2,([A-Z]+)')<br />
<br />
timeseq = 0<br />
lasttime = long(0)<br />
@@ -180,7 +180,7 @@<br />
break<br />
tmpmessagename = messagename.split(',')[0]<br />
ui.debug('maildir', 'savemessage: using temporary name %s' % tmpmessagename)<br />
- file = open(os.path.join(tmpdir, tmpmessagename), "wt")<br />
+ file = open(os.path.join(tmpdir, tmpmessagename), "wb")<br />
file.write(content)<br />
<br />
# Make sure the data hits the disk<br />
@@ -226,11 +226,11 @@<br />
newpath = os.path.join(self.getfullname(), 'cur')<br />
else:<br />
newpath = os.path.join(self.getfullname(), 'new')<br />
- infostr = ':'<br />
- infomatch = re.search('(:.*)$', newname)<br />
+ infostr = '!'<br />
+ infomatch = re.search('(!.*)$', newname)<br />
if infomatch: # If the info string is present..<br />
infostr = infomatch.group(1)<br />
- newname = newname.split(':')[0] # Strip off the info string.<br />
+ newname = newname.split('!')[0] # Strip off the info string.<br />
infostr = re.sub('2,[A-Z]*', '', infostr)<br />
flags.sort()<br />
infostr += '2,' + ''.join(flags)<br />
</source><br />
<br />
$ cd offlineimap/folder<br />
$ patch -Np2 < ../../offlineimap_6.0.3-cygwin.patch<br />
$ cd ../..<br />
<br />
Install offlineimap<br />
<br />
$ python setup.py install<br />
<br />
Configure offlineimap as described in [[Offlineimap]] and launch offlineimap<br />
<br />
$ offlineimap<br />
or<br />
$ offlineimap -1 -o -u Noninteractive.Basic<br />
or<br />
$ offlineimap -c /home/username/offlineimap.conf<br />
<br />
Here is a simple [{{#file:offlineimap.conf}} offlineimap configuration file].<br />
<br />
<source lang=text><br />
[general]<br />
metadata = /home/username/.offlineimap<br />
accounts = Test<br />
maxsyncaccounts = 1<br />
ui = Curses.Blinkenlights, TTY.TTYUI,<br />
Noninteractive.Basic, Noninteractive.Quiet<br />
ignore-readonly = no<br />
<br />
[mbnames]<br />
enabled = no<br />
<br />
[ui.Curses.Blinkenlights]<br />
statuschar = .<br />
<br />
[Account Test]<br />
localrepository = LocalExample<br />
remoterepository = RemoteExample<br />
<br />
[Repository LocalExample]<br />
type = Maildir<br />
localfolders = /home/username/Maildir<br />
sep = .<br />
restoreatime = no<br />
<br />
[Repository RemoteExample]<br />
type = IMAP<br />
remotehost = imapserver<br />
ssl = no<br />
remoteport = 143<br />
remoteuser = username<br />
remotepass = XXXXXX<br />
maxconnections = 1<br />
holdconnectionopen = no<br />
nametrans = lambda foldername: re.sub('^INBOX\.*', '.', foldername)<br />
folderfilter = lambda foldername: not re.search('(SPAM$|Mairix)', foldername)<br />
</source></div>Twalranthttps://wiki.yobi.be/index.php?title=Courier-Cygwin&diff=5280Courier-Cygwin2008-11-04T08:57:18Z<p>Twalrant: /* Offlineimap */</p>
<hr />
<div>=Pre-requisite=<br />
<br />
Courier-IMAP requires the installation of the [http://www.courier-mta.org/authlib/ Courier Authentication Library] and the following cygwin tools and packages<br />
<br />
* patch, tar, make, gcc<br />
* crypt<br />
* libgdbm-devel<br />
* libtool<br />
* inetutils<br />
* cygrunsrv<br />
<br />
Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install the required packages.<br />
<br />
=Courier Authentication Library=<br />
<br />
Installation of Courier Authentication Library using the module userdb to manage mail accounts. All other modules are disabled.<br />
<br />
==Compilation and installation==<br />
<br />
Download and untar [http://www.courier-mta.org/download.php#authlib courier-authlib] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-authlib-0.61.0.tar.bz2 0.61.0]<br />
<br />
Apply the [{{#file:courrier-authlib-0.61.0-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# add libtool flag (-no-undefined) required for DLL creation<br />
# add missing dependencies<br />
# add PATH in start script to access new DLL (installed in a different directory)<br />
<br />
Solution source: http://lists.cairographics.org/archives/cairo/2004-April/001125.html<br />
<br />
<source lang=diff><br />
--- courier-authlib-0.61.0/makedat/Makefile.in 2008-05-24 16:21:09.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/makedat/Makefile.in 2008-10-21 16:02:38.709166700 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-authlib-0.61.0/Makefile.in 2008-07-12 21:41:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/Makefile.in 2008-10-23 22:59:03.843750000 +0200<br />
@@ -213,9 +213,10 @@<br />
LTCOMPILE = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
--mode=compile $(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) \<br />
$(AM_CPPFLAGS) $(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS)<br />
-CCLD = $(CC)<br />
+CCLD = $(CC) -no-undefined<br />
+CCLDEXE = $(CC)<br />
LINK = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
- --mode=link $(CCLD) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
+ --mode=link $(CCLDEXE) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
$(LDFLAGS) -o $@<br />
SOURCES = $(libauthcustom_la_SOURCES) $(libauthldap_la_SOURCES) \<br />
$(libauthmysql_la_SOURCES) $(libauthpam_la_SOURCES) \<br />
@@ -452,9 +453,9 @@<br />
README.authdebug.html<br />
<br />
DISTCLEANFILES = dbobj.config README_authlib.html<br />
-commonlibdep = libcourierauthcommon.la<br />
+commonlibdep = libcourierauthcommon.la libcourierauth.la<br />
commonldflags = -module -rpath $(pkglibdir) -export-symbols-regex 'courier_auth.*_init' -avoid-version<br />
-commonlibadd = libcourierauthcommon.la<br />
+commonlibadd = libcourierauthcommon.la libcourierauth.la<br />
libcourierauthcommon_t = @CRYPTLIBS@<br />
libcourierauthcommon_la_SOURCES = \<br />
auth.h courierauth.h \<br />
--- courier-authlib-0.61.0/authdaemond.in 2005-07-05 14:25:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/authdaemond.in 2008-10-25 12:03:32.140625000 +0200<br />
@@ -15,4 +15,10 @@<br />
set -a<br />
. @authdaemonrc@<br />
<br />
+# Some shared libraries (DLL) are installed in @libdir@/bin<br />
+# instead of @libdir@/@PACKAGE@<br />
+# Setting LD_LIBRARY_PATH at runtime or LR_RUN_PATH at linktime doesn't<br />
+# work in cygwin, only setting PATH works. <br />
+export PATH=$PATH:@libdir@/bin<br />
+<br />
exec ${sbindir}/courierlogger -pid=@authdaemonvar@/pid $LOGGEROPTS -$1 @libexecdir@/courier-authlib/authdaemond<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-authlib-0.61.0-cygwin.patch<br />
<br />
Configure the package without most authentication modules, keeping only ''userdb''.<br />
<br />
'''Note''': replace ''mailuser'' by an existing user name (in your /etc/passwd file). I used my own username.<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait --without-authpam --without-authldap --without-authpwd \<br />
--without-authshadow --without-authcustom --without-authpipe --without-authmysql --without-authpgsql --with-mailuser=mailuser \<br />
--with-mailgroup=mkgroup-l-d<br />
<br />
Take a long pause... and when ready execute the following command.<br />
<br />
$ make<br />
<br />
Take again a long pause... then check the result and install the libraries<br />
<br />
$ make check<br />
$ make install<br />
<br />
'''NOTES''': list of related topics found during investigation for compilation<br />
* authldap: configure: error: -lresolve is needed for res_query... http://www.cygwin.com/ml/cygwin/2005-04/msg00419.html<br />
<br />
==Configuration==<br />
<br />
Create authdaemonrc file: /usr/local/etc/authlib/authdaemonrc<br />
<br />
$ cp /usr/local/etc/authlib/authdaemonrc.dist /usr/local/etc/authlib/authdaemonrc<br />
<br />
Change number of daemons (I use three) and enable DEBUG_LOGIN<br />
<br />
<source lang=text><br />
# The number of daemon processes that are started.<br />
daemons=3<br />
<br />
# DEBUG_LOGIN=2 - turn on debugging + log passwords too<br />
DEBUG_LOGIN=2<br />
</source><br />
<br />
See http://www.courier-mta.org/authlib/README.authdebug.html for details.<br />
<br />
==IMAP accounts==<br />
<br />
User accounts and settings are managed by ''userdb''. See [http://linux.die.net/man/8/makeuserdb makeuserdb] man page for details, or used the freshly new install man page - man makeuserdb<br />
<br />
Assuming ''username'' is your username, 1001 and 10545 are respectively the UID and GID of an existing user (part of your /etc/passwd and /etc/group). I use my own UID and GID. Create the mailuser home directory, if required, and create Maildir folder.<br />
<br />
$ mkdir -p /home/username<br />
$ cd /home/username<br />
$ /usr/lib/courier-imap/bin/maildirmake Maildir<br />
<br />
Create the userdb text file /usr/local/etc/authlib/userdb<br />
<br />
$ touch /usr/local/etc/authlib/userdb<br />
$ chmod 700 /usr/local/etc/authlib/userdb<br />
<br />
Edit /usr/local/etc/authlib/userdb, one line per account<br />
<br />
<source lang=text><br />
username[TAB]uid=1001|gid=10111|home=/home/username|mail=/home/username/Maildir|systempw=XXXXXX<br />
</source><br />
<br />
where XXXXXX is the encrypted password created with<br />
<br />
$ /usr/local/sbin/userdbpw.exe<br />
<br />
Create the (binary) userdb<br />
<br />
$ /usr/local/sbin/makeuserdb<br />
<br />
You should now have the following files created:<br />
<br />
* /usr/local/etc/authlib/userdb.dat<br />
* /usr/local/etc/authlib/userdbshadow.dat<br />
<br />
==Running==<br />
<br />
Install and configure syslogd. Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install inetutils (contains syslogd). Configure syslogd with the following command. It will create the /etc/syslogd.conf file and install a windows service using cygrunsrv<br />
<br />
$ syslogd-config<br />
<br />
Start the authlib daemon with the following command:<br />
<br />
$ /usr/local/sbin/authdaemon start<br />
<br />
Stop the daemon with the following command:<br />
<br />
$ /usr/local/sbin/authdaemon stop<br />
<br />
You'll find log messages in /var/log/messages (default target file as specified in /etc/syslogd.conf)<br />
<br />
==Testing authlib==<br />
<br />
$ /usr/local/sbin/authtest username CCCCCC<br />
Authentication succeeded.<br />
<br />
Authenticated: username (uid 1001, gid 10545)<br />
Home Directory: /home/username<br />
Maildir: /home/username/Maildir<br />
Quota: (none)<br />
Encrypted Password: XXXXXX<br />
Cleartext Password: CCCCCC<br />
Options: (none)<br />
<br />
where username is your user name and XXXXXX is your encrypted password as provided in ''/usr/local/etc/authlib/userdb''. CCCCCC is your password in clear.<br />
<br />
==Troubleshooting==<br />
<br />
Should you have a doubt on the execution of a command (ie: no output) you can check if the application is able to load required DLL. This error is not reported. Using ''strace'', windows will complain about DLL not found, if any. To solve this problem you may need to add some path in your PATH. For example, in order to test authlib with authtest:<br />
<br />
$ strace /usr/local/sbin/authtest<br />
# This will open a dialog box to complain about DLL.<br />
$ export PATH=$PATH:/usr/local/lib/bin<br />
$ /usr/local/sbin/authtest ausername<br />
<br />
==Courier Authentication Config==<br />
<br />
$ /usr/local/bin/courierauthconfig.exe --version<br />
$ /usr/local/bin/courierauthconfig.exe --ldflags<br />
$ /usr/local/bin/courierauthconfig.exe --cppflags<br />
$ /usr/local/bin/courierauthconfig.exe --configfiles<br />
<br />
=Courier-IMAP=<br />
==Compilation and installation==<br />
<br />
Download and untar package [http://www.courier-mta.org/download.php#imap courier-imap] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-imap-4.4.1.tar.bz2 4.4.1.20080920]<br />
<br />
Apply the [{{#file:courrier-imap-4.4.1-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# incorrect usage of EXTEXT in main ''Makefile''<br />
# remove usage of /usr/lib/env in start/stop script (/usr/lib/env does not seem to work under Cygwin)<br />
<br />
<source lang=diff><br />
--- courier-imap-4.4.1.20080920/makedat/Makefile.in 2008-08-24 19:52:51.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/makedat/Makefile.in 2008-10-21 20:43:27.500000000 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-imap-4.4.1.20080920/Makefile.in 2008-09-20 14:48:46.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/Makefile.in 2008-10-21 20:59:45.156250000 +0200<br />
@@ -247,9 +247,9 @@<br />
CLEANFILES = $(databin_SCRIPTS) $(man_MANS) $(sysconf_DATA) $(sbin_SCRIPTS)<br />
databindir = $(datadir)<br />
databin_SCRIPTS = mkimapdcert mkpop3dcert<br />
-binPROGRAMS = imapd pop3d maildirmake maildiracl deliverquota maildirkw<br />
-sbinPROGRAMS = imaplogin pop3login<br />
-libexecPROGRAMS = makedatprog couriertcpd<br />
+binPROGRAMS = imapd$(EXEEXT) pop3d$(EXEEXT) maildirmake$(EXEEXT) maildiracl$(EXEEXT) deliverquota$(EXEEXT) maildirkw$(EXEEXT)<br />
+sbinPROGRAMS = imaplogin$(EXEEXT) pop3login$(EXEEXT)<br />
+libexecPROGRAMS = makedatprog$(EXEEXT) couriertcpd$(EXEEXT)<br />
bin_PROGRAMS = @binPROGRAMS_exec@<br />
sbin_PROGRAMS = @sbinPROGRAMS_exec@<br />
libexec_PROGRAMS = @libexecPROGRAMS_exec@<br />
--- courier-imap-4.4.1.20080920/imapd.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/imapd.rc.in 2008-10-26 10:17:51.359375000 +0100<br />
@@ -22,6 +22,15 @@<br />
exit 1<br />
fi<br />
<br />
+# Location for some shared libraries (cygcourierauth*.dll) from authlib<br />
+AUTHLIBDIR=/usr/local<br />
+if test ! -f $AUTHLIBDIR/lib/bin/cygcourierauth.dll<br />
+then<br />
+ echo "$AUTHLIBDIR/lib/bin/cygcourierauth.dll not found."<br />
+ exit 1<br />
+fi<br />
+export PATH=$PATH:$AUTHLIBDIR/lib/bin<br />
+<br />
TLS_CACHEFILE=""<br />
. @sysconfdir@/imapd-ssl<br />
. @sysconfdir@/imapd<br />
@@ -35,7 +44,7 @@<br />
<br />
umask $IMAP_UMASK<br />
@ULIMIT@ $IMAP_ULIMITD<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
--- courier-imap-4.4.1.20080920/pop3d.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/pop3d.rc.in 2008-10-26 10:18:02.187500000 +0100<br />
@@ -22,12 +22,21 @@<br />
exit 1<br />
fi<br />
<br />
+# Location for some shared libraries (cygcourierauth*.dll) from authlib<br />
+AUTHLIBDIR=/usr/local<br />
+if test ! -f $AUTHLIBDIR/lib/bin/cygcourierauth.dll<br />
+then<br />
+ echo "$AUTHLIBDIR/lib/bin/cygcourierauth.dll not found."<br />
+ exit 1<br />
+fi<br />
+export PATH=$PATH:$AUTHLIBDIR/lib/bin<br />
+<br />
. @sysconfdir@/pop3d-ssl<br />
. @sysconfdir@/pop3d<br />
<br />
case $1 in<br />
start)<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-imap-4.4.1-cygwin.patch<br />
<br />
Configure the package<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait<br />
<br />
Take a walk... and when ready execute the following command to build the package.<br />
<br />
$ make<br />
<br />
Time to go for some coffee... and then install the package with the usual<br />
<br />
$ make install<br />
$ make install-configure<br />
<br />
==Configuration==<br />
<br />
Setup courier-imap: $prefix/etc/imapd (where $prefix=/usr/lib/courier-imap)<br />
<br />
Set ADDRESS to a valid value (0 or 127.0.0.1) and change IMAP_ULIMITD to a value accepted by the command ulimit. I simply used the existing value returned by<br />
<br />
$ ulimit -v<br />
<br />
==Running==<br />
<br />
Syslogd service and authdaemond should be started. See above.<br />
<br />
Start the imap daemon with the following command:<br />
<br />
$ /usr/lib/courier-imap/libexec/imapd.rc start<br />
<br />
Stop the daemon with the following command:<br />
<br />
$ /usr/lib/courier-imap/libexec/imapd.rc stop<br />
<br />
You'll find log messages in /var/log/messages (default target file as specified in /etc/syslogd.conf)<br />
<br />
==Testing==<br />
When authdaemond and imapd are running you can do a simple login test:<br />
<br />
$ telnet localhost 143<br />
<br />
and type the login command<br />
<br />
a login <username> <password><br />
<br />
the server should reply<br />
<br />
a OK LOGIN Ok.<br />
<br />
to which you can reply with a logout<br />
<br />
a logout<br />
<br />
the session is terminated by the server<br />
<br />
* BYE Courier-IMAP server shutting down<br />
a OK LOGOUT completed<br />
Connection closed by foreign host.<br />
<br />
'''Hint:''' if the connection is immediately closed by foreign host it probably means that ''imapd'' does not have access to all required DLLs. Check your PATH.<br />
<br />
==All in one==<br />
If everything works fine you can use the following [{{#file:imapd}} startup script] to launch or stop imap and authlib daemons. It can be saved in /usr/local/sbin.<br />
<br />
<source lang=bash><br />
#! /bin/sh<br />
#<br />
# Courier imap daemon startup script.<br />
<br />
authlib=/usr/local/sbin/authdaemond<br />
imapd=/usr/lib/courier-imap/libexec/imapd.rc<br />
<br />
test ! -f $authlib && echo "File not found: $authlib" && exit 1;<br />
test ! -f $imapd && echo "File not found: $imapd" && exit 1;<br />
<br />
case $1 in<br />
start)<br />
$authlib start<br />
$imapd start<br />
;;<br />
stop)<br />
$imapd stop<br />
$authlib stop<br />
;;<br />
*)<br />
echo "Usage: $0 <start|stop>"<br />
;;<br />
esac<br />
</source><br />
<br />
==Cygwin service==<br />
Create the [{{#file:imapd-srv.sh}} service script]<br />
<br />
<source lang=bash><br />
#!/bin/sh<br />
# File: imapd-service.sh<br />
# Purpose: Courier imap daemon service script.<br />
#<br />
# NOTE: This script must be excutable by SYSTEM<br />
username=username # <<<< Change me !!!<br />
pidsleep=''<br />
<br />
# Function to handle QUIT signal.<br />
# Stop imapd daemon and kill background sleep.<br />
function handleQuit<br />
{<br />
echo "STOPPING: /usr/local/sbin/imapd"<br />
su $username -c "/usr/local/sbin/imapd stop"<br />
test -n "$pidsleep" && kill -9 $pidsleep<br />
exit<br />
}<br />
<br />
# Interruptible sleep<br />
# Note: sleep is an external command (not builtin command), hence<br />
# not interruptible by the QUIT signal.<br />
function intsleep<br />
{<br />
sleep $1 &<br />
pidsleep=$!<br />
wait $pidsleep<br />
}<br />
<br />
echo "STARTING: /usr/local/sbin/imapd as $username at "`date`<br />
su $username -c "/usr/local/sbin/imapd start"<br />
<br />
trap "handleQuit" SIGQUIT<br />
<br />
echo "WAITING: "$$<br />
while true; do intsleep 1d; done<br />
</source><br />
<br />
Change username and save it to your favorite location, says /usr/local/sbin. The service script must be executable by SYSTEM, ie: the user that run the windows services.<br />
<br />
$ chmod +rx /usr/local/sbin/imapd-service.sh<br />
<br />
Install the new service with the following command.<br />
<br />
$ cygrunsrv --install imapd --desc "Courier IMAP daemon" --disp "CYGWIN imapd" \<br />
--path /usr/local/sbin/imapd-service.sh --termsig QUIT --type auto --shutdown<br />
<br />
Finally, just start the service<br />
<br />
$ cygrunsrv --start imapd<br />
or<br />
$ net start imapd<br />
<br />
You should now have couple of processes related to courier-imap<br />
<br />
$ ps -a<br />
<br />
'''NOTES''':<br />
* If the service could not be started, it's probably because the service script is not executable by SYSTEM<br />
<br />
$ net start imapd<br />
The CYGWIN imapd service is starting.<br />
The CYGWIN imapd service could not be started. <br />
<br />
The service did not report an error.<br />
<br />
More help is available by typing NET HELPMSG 3534.<br />
<br />
* The combination of background sleep and builtin wait command is used to make the waiting statment interruptible. The original script found on the net, was simply using a 'sleep 1' which turned to consume ~10% of the CPU.<br />
<br />
=Maildir=<br />
'''maildirmake''' is part of the courier-imap package<br />
<br />
$ /usr/lib/courier-imap/bin/maildirmake<br />
<br />
=Mairix - index and search mail folders=<br />
Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install the package mairix.<br />
<br />
Create the configuration file in your home directory: ~/.mairixrc<br />
<br />
base=/home/username<br />
maildir=Maildir...<br />
omit=Maildir/.Mairix**<br />
mfolder=Maildir/.Mairix<br />
database=/home/username/.mairix_database<br />
<br />
The create the mairix index<br />
<br />
$ mairix<br />
and<br />
$ mairix --fast-index # on daily base<br />
<br />
See [[Mail_Tips]] for additional details.<br />
<br />
=Offlineimap=<br />
Requires python, so run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install the package python.<br />
<br />
Download offlineimap [http://software.complete.org/software/projects/list_files/offlineimap here]. I use [http://software.complete.org/software/versions/download/242?attachment_id=334 version 6.0.3]. Extract files in you favorite sandbox.<br />
<br />
$ tar xvfz offlineimap_6.0.3.tar.gz<br />
$ cd offlineimap<br />
<br />
Apply the following [{{#file:offlineimap_6.0.3-cygwin.patch}} patch] to correct the following issues:<br />
<br />
* [http://en.wikipedia.org/wiki/Maildir#Windows_software Suffix separator character] (:) is not allowed in Windows. Courier-imap for cygwin is using (!)<br />
* While used by courier-imap for cygwin Maildir mail files should not use CRLF, rather only LF. The issue appears only in mail with attachment, that is the raw message is not interpreted and displayed as it in the mail body (under Thunderbird).<br />
<br />
<source lang=diff><br />
--- offlineimap/folder/Maildir.py 2008-11-01 20:49:30.843750000 +0100<br />
+++ offlineimap/folder/Maildir-cygwin.py 2008-11-03 22:54:51.437500000 +0100<br />
@@ -23,7 +23,7 @@<br />
import os.path, os, re, time, socket, md5<br />
<br />
uidmatchre = re.compile(',U=(\d+)')<br />
-flagmatchre = re.compile(':.*2,([A-Z]+)')<br />
+flagmatchre = re.compile('!.*2,([A-Z]+)')<br />
<br />
timeseq = 0<br />
lasttime = long(0)<br />
@@ -180,7 +180,7 @@<br />
break<br />
tmpmessagename = messagename.split(',')[0]<br />
ui.debug('maildir', 'savemessage: using temporary name %s' % tmpmessagename)<br />
- file = open(os.path.join(tmpdir, tmpmessagename), "wt")<br />
+ file = open(os.path.join(tmpdir, tmpmessagename), "wb")<br />
file.write(content)<br />
<br />
# Make sure the data hits the disk<br />
@@ -226,11 +226,11 @@<br />
newpath = os.path.join(self.getfullname(), 'cur')<br />
else:<br />
newpath = os.path.join(self.getfullname(), 'new')<br />
- infostr = ':'<br />
- infomatch = re.search('(:.*)$', newname)<br />
+ infostr = '!'<br />
+ infomatch = re.search('(!.*)$', newname)<br />
if infomatch: # If the info string is present..<br />
infostr = infomatch.group(1)<br />
- newname = newname.split(':')[0] # Strip off the info string.<br />
+ newname = newname.split('!')[0] # Strip off the info string.<br />
infostr = re.sub('2,[A-Z]*', '', infostr)<br />
flags.sort()<br />
infostr += '2,' + ''.join(flags)<br />
</source><br />
<br />
$ cd offlineimap/folder<br />
$ patch -Np2 < ../../offlineimap-cygwin_6.0.3.patch<br />
$ cd ../..<br />
<br />
Install offlineimap<br />
<br />
$ python setup.py install<br />
<br />
Configure offlineimap as described in [[Offlineimap]] and launch offlineimap<br />
<br />
$ offlineimap<br />
or<br />
$ offlineimap -1 -o -u Noninteractive.Basic<br />
or<br />
$ offlineimap -c /home/username/offlineimap.conf<br />
<br />
Here is a simple [{{#file:offlineimap.conf}} offlineimap configuration file].<br />
<br />
<source lang=text><br />
[general]<br />
metadata = /home/username/.offlineimap<br />
accounts = Test<br />
maxsyncaccounts = 1<br />
ui = Curses.Blinkenlights, TTY.TTYUI,<br />
Noninteractive.Basic, Noninteractive.Quiet<br />
ignore-readonly = no<br />
<br />
[mbnames]<br />
enabled = no<br />
<br />
[ui.Curses.Blinkenlights]<br />
statuschar = .<br />
<br />
[Account Test]<br />
localrepository = LocalExample<br />
remoterepository = RemoteExample<br />
<br />
[Repository LocalExample]<br />
type = Maildir<br />
localfolders = /home/username/Maildir<br />
sep = .<br />
restoreatime = no<br />
<br />
[Repository RemoteExample]<br />
type = IMAP<br />
remotehost = imapserver<br />
ssl = no<br />
remoteport = 143<br />
remoteuser = username<br />
remotepass = XXXXXX<br />
maxconnections = 1<br />
holdconnectionopen = no<br />
nametrans = lambda foldername: re.sub('^INBOX\.*', '.', foldername)<br />
folderfilter = lambda foldername: not re.search('(SPAM$|Mairix)', foldername)<br />
</source></div>Twalranthttps://wiki.yobi.be/index.php?title=Courier-Cygwin&diff=5279Courier-Cygwin2008-11-04T08:55:30Z<p>Twalrant: /* Offlineimap */</p>
<hr />
<div>=Pre-requisite=<br />
<br />
Courier-IMAP requires the installation of the [http://www.courier-mta.org/authlib/ Courier Authentication Library] and the following cygwin tools and packages<br />
<br />
* patch, tar, make, gcc<br />
* crypt<br />
* libgdbm-devel<br />
* libtool<br />
* inetutils<br />
* cygrunsrv<br />
<br />
Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install the required packages.<br />
<br />
=Courier Authentication Library=<br />
<br />
Installation of Courier Authentication Library using the module userdb to manage mail accounts. All other modules are disabled.<br />
<br />
==Compilation and installation==<br />
<br />
Download and untar [http://www.courier-mta.org/download.php#authlib courier-authlib] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-authlib-0.61.0.tar.bz2 0.61.0]<br />
<br />
Apply the [{{#file:courrier-authlib-0.61.0-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# add libtool flag (-no-undefined) required for DLL creation<br />
# add missing dependencies<br />
# add PATH in start script to access new DLL (installed in a different directory)<br />
<br />
Solution source: http://lists.cairographics.org/archives/cairo/2004-April/001125.html<br />
<br />
<source lang=diff><br />
--- courier-authlib-0.61.0/makedat/Makefile.in 2008-05-24 16:21:09.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/makedat/Makefile.in 2008-10-21 16:02:38.709166700 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-authlib-0.61.0/Makefile.in 2008-07-12 21:41:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/Makefile.in 2008-10-23 22:59:03.843750000 +0200<br />
@@ -213,9 +213,10 @@<br />
LTCOMPILE = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
--mode=compile $(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) \<br />
$(AM_CPPFLAGS) $(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS)<br />
-CCLD = $(CC)<br />
+CCLD = $(CC) -no-undefined<br />
+CCLDEXE = $(CC)<br />
LINK = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
- --mode=link $(CCLD) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
+ --mode=link $(CCLDEXE) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
$(LDFLAGS) -o $@<br />
SOURCES = $(libauthcustom_la_SOURCES) $(libauthldap_la_SOURCES) \<br />
$(libauthmysql_la_SOURCES) $(libauthpam_la_SOURCES) \<br />
@@ -452,9 +453,9 @@<br />
README.authdebug.html<br />
<br />
DISTCLEANFILES = dbobj.config README_authlib.html<br />
-commonlibdep = libcourierauthcommon.la<br />
+commonlibdep = libcourierauthcommon.la libcourierauth.la<br />
commonldflags = -module -rpath $(pkglibdir) -export-symbols-regex 'courier_auth.*_init' -avoid-version<br />
-commonlibadd = libcourierauthcommon.la<br />
+commonlibadd = libcourierauthcommon.la libcourierauth.la<br />
libcourierauthcommon_t = @CRYPTLIBS@<br />
libcourierauthcommon_la_SOURCES = \<br />
auth.h courierauth.h \<br />
--- courier-authlib-0.61.0/authdaemond.in 2005-07-05 14:25:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/authdaemond.in 2008-10-25 12:03:32.140625000 +0200<br />
@@ -15,4 +15,10 @@<br />
set -a<br />
. @authdaemonrc@<br />
<br />
+# Some shared libraries (DLL) are installed in @libdir@/bin<br />
+# instead of @libdir@/@PACKAGE@<br />
+# Setting LD_LIBRARY_PATH at runtime or LR_RUN_PATH at linktime doesn't<br />
+# work in cygwin, only setting PATH works. <br />
+export PATH=$PATH:@libdir@/bin<br />
+<br />
exec ${sbindir}/courierlogger -pid=@authdaemonvar@/pid $LOGGEROPTS -$1 @libexecdir@/courier-authlib/authdaemond<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-authlib-0.61.0-cygwin.patch<br />
<br />
Configure the package without most authentication modules, keeping only ''userdb''.<br />
<br />
'''Note''': replace ''mailuser'' by an existing user name (in your /etc/passwd file). I used my own username.<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait --without-authpam --without-authldap --without-authpwd \<br />
--without-authshadow --without-authcustom --without-authpipe --without-authmysql --without-authpgsql --with-mailuser=mailuser \<br />
--with-mailgroup=mkgroup-l-d<br />
<br />
Take a long pause... and when ready execute the following command.<br />
<br />
$ make<br />
<br />
Take again a long pause... then check the result and install the libraries<br />
<br />
$ make check<br />
$ make install<br />
<br />
'''NOTES''': list of related topics found during investigation for compilation<br />
* authldap: configure: error: -lresolve is needed for res_query... http://www.cygwin.com/ml/cygwin/2005-04/msg00419.html<br />
<br />
==Configuration==<br />
<br />
Create authdaemonrc file: /usr/local/etc/authlib/authdaemonrc<br />
<br />
$ cp /usr/local/etc/authlib/authdaemonrc.dist /usr/local/etc/authlib/authdaemonrc<br />
<br />
Change number of daemons (I use three) and enable DEBUG_LOGIN<br />
<br />
<source lang=text><br />
# The number of daemon processes that are started.<br />
daemons=3<br />
<br />
# DEBUG_LOGIN=2 - turn on debugging + log passwords too<br />
DEBUG_LOGIN=2<br />
</source><br />
<br />
See http://www.courier-mta.org/authlib/README.authdebug.html for details.<br />
<br />
==IMAP accounts==<br />
<br />
User accounts and settings are managed by ''userdb''. See [http://linux.die.net/man/8/makeuserdb makeuserdb] man page for details, or used the freshly new install man page - man makeuserdb<br />
<br />
Assuming ''username'' is your username, 1001 and 10545 are respectively the UID and GID of an existing user (part of your /etc/passwd and /etc/group). I use my own UID and GID. Create the mailuser home directory, if required, and create Maildir folder.<br />
<br />
$ mkdir -p /home/username<br />
$ cd /home/username<br />
$ /usr/lib/courier-imap/bin/maildirmake Maildir<br />
<br />
Create the userdb text file /usr/local/etc/authlib/userdb<br />
<br />
$ touch /usr/local/etc/authlib/userdb<br />
$ chmod 700 /usr/local/etc/authlib/userdb<br />
<br />
Edit /usr/local/etc/authlib/userdb, one line per account<br />
<br />
<source lang=text><br />
username[TAB]uid=1001|gid=10111|home=/home/username|mail=/home/username/Maildir|systempw=XXXXXX<br />
</source><br />
<br />
where XXXXXX is the encrypted password created with<br />
<br />
$ /usr/local/sbin/userdbpw.exe<br />
<br />
Create the (binary) userdb<br />
<br />
$ /usr/local/sbin/makeuserdb<br />
<br />
You should now have the following files created:<br />
<br />
* /usr/local/etc/authlib/userdb.dat<br />
* /usr/local/etc/authlib/userdbshadow.dat<br />
<br />
==Running==<br />
<br />
Install and configure syslogd. Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install inetutils (contains syslogd). Configure syslogd with the following command. It will create the /etc/syslogd.conf file and install a windows service using cygrunsrv<br />
<br />
$ syslogd-config<br />
<br />
Start the authlib daemon with the following command:<br />
<br />
$ /usr/local/sbin/authdaemon start<br />
<br />
Stop the daemon with the following command:<br />
<br />
$ /usr/local/sbin/authdaemon stop<br />
<br />
You'll find log messages in /var/log/messages (default target file as specified in /etc/syslogd.conf)<br />
<br />
==Testing authlib==<br />
<br />
$ /usr/local/sbin/authtest username CCCCCC<br />
Authentication succeeded.<br />
<br />
Authenticated: username (uid 1001, gid 10545)<br />
Home Directory: /home/username<br />
Maildir: /home/username/Maildir<br />
Quota: (none)<br />
Encrypted Password: XXXXXX<br />
Cleartext Password: CCCCCC<br />
Options: (none)<br />
<br />
where username is your user name and XXXXXX is your encrypted password as provided in ''/usr/local/etc/authlib/userdb''. CCCCCC is your password in clear.<br />
<br />
==Troubleshooting==<br />
<br />
Should you have a doubt on the execution of a command (ie: no output) you can check if the application is able to load required DLL. This error is not reported. Using ''strace'', windows will complain about DLL not found, if any. To solve this problem you may need to add some path in your PATH. For example, in order to test authlib with authtest:<br />
<br />
$ strace /usr/local/sbin/authtest<br />
# This will open a dialog box to complain about DLL.<br />
$ export PATH=$PATH:/usr/local/lib/bin<br />
$ /usr/local/sbin/authtest ausername<br />
<br />
==Courier Authentication Config==<br />
<br />
$ /usr/local/bin/courierauthconfig.exe --version<br />
$ /usr/local/bin/courierauthconfig.exe --ldflags<br />
$ /usr/local/bin/courierauthconfig.exe --cppflags<br />
$ /usr/local/bin/courierauthconfig.exe --configfiles<br />
<br />
=Courier-IMAP=<br />
==Compilation and installation==<br />
<br />
Download and untar package [http://www.courier-mta.org/download.php#imap courier-imap] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-imap-4.4.1.tar.bz2 4.4.1.20080920]<br />
<br />
Apply the [{{#file:courrier-imap-4.4.1-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# incorrect usage of EXTEXT in main ''Makefile''<br />
# remove usage of /usr/lib/env in start/stop script (/usr/lib/env does not seem to work under Cygwin)<br />
<br />
<source lang=diff><br />
--- courier-imap-4.4.1.20080920/makedat/Makefile.in 2008-08-24 19:52:51.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/makedat/Makefile.in 2008-10-21 20:43:27.500000000 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-imap-4.4.1.20080920/Makefile.in 2008-09-20 14:48:46.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/Makefile.in 2008-10-21 20:59:45.156250000 +0200<br />
@@ -247,9 +247,9 @@<br />
CLEANFILES = $(databin_SCRIPTS) $(man_MANS) $(sysconf_DATA) $(sbin_SCRIPTS)<br />
databindir = $(datadir)<br />
databin_SCRIPTS = mkimapdcert mkpop3dcert<br />
-binPROGRAMS = imapd pop3d maildirmake maildiracl deliverquota maildirkw<br />
-sbinPROGRAMS = imaplogin pop3login<br />
-libexecPROGRAMS = makedatprog couriertcpd<br />
+binPROGRAMS = imapd$(EXEEXT) pop3d$(EXEEXT) maildirmake$(EXEEXT) maildiracl$(EXEEXT) deliverquota$(EXEEXT) maildirkw$(EXEEXT)<br />
+sbinPROGRAMS = imaplogin$(EXEEXT) pop3login$(EXEEXT)<br />
+libexecPROGRAMS = makedatprog$(EXEEXT) couriertcpd$(EXEEXT)<br />
bin_PROGRAMS = @binPROGRAMS_exec@<br />
sbin_PROGRAMS = @sbinPROGRAMS_exec@<br />
libexec_PROGRAMS = @libexecPROGRAMS_exec@<br />
--- courier-imap-4.4.1.20080920/imapd.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/imapd.rc.in 2008-10-26 10:17:51.359375000 +0100<br />
@@ -22,6 +22,15 @@<br />
exit 1<br />
fi<br />
<br />
+# Location for some shared libraries (cygcourierauth*.dll) from authlib<br />
+AUTHLIBDIR=/usr/local<br />
+if test ! -f $AUTHLIBDIR/lib/bin/cygcourierauth.dll<br />
+then<br />
+ echo "$AUTHLIBDIR/lib/bin/cygcourierauth.dll not found."<br />
+ exit 1<br />
+fi<br />
+export PATH=$PATH:$AUTHLIBDIR/lib/bin<br />
+<br />
TLS_CACHEFILE=""<br />
. @sysconfdir@/imapd-ssl<br />
. @sysconfdir@/imapd<br />
@@ -35,7 +44,7 @@<br />
<br />
umask $IMAP_UMASK<br />
@ULIMIT@ $IMAP_ULIMITD<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
--- courier-imap-4.4.1.20080920/pop3d.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/pop3d.rc.in 2008-10-26 10:18:02.187500000 +0100<br />
@@ -22,12 +22,21 @@<br />
exit 1<br />
fi<br />
<br />
+# Location for some shared libraries (cygcourierauth*.dll) from authlib<br />
+AUTHLIBDIR=/usr/local<br />
+if test ! -f $AUTHLIBDIR/lib/bin/cygcourierauth.dll<br />
+then<br />
+ echo "$AUTHLIBDIR/lib/bin/cygcourierauth.dll not found."<br />
+ exit 1<br />
+fi<br />
+export PATH=$PATH:$AUTHLIBDIR/lib/bin<br />
+<br />
. @sysconfdir@/pop3d-ssl<br />
. @sysconfdir@/pop3d<br />
<br />
case $1 in<br />
start)<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-imap-4.4.1-cygwin.patch<br />
<br />
Configure the package<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait<br />
<br />
Take a walk... and when ready execute the following command to build the package.<br />
<br />
$ make<br />
<br />
Time to go for some coffee... and then install the package with the usual<br />
<br />
$ make install<br />
$ make install-configure<br />
<br />
==Configuration==<br />
<br />
Setup courier-imap: $prefix/etc/imapd (where $prefix=/usr/lib/courier-imap)<br />
<br />
Set ADDRESS to a valid value (0 or 127.0.0.1) and change IMAP_ULIMITD to a value accepted by the command ulimit. I simply used the existing value returned by<br />
<br />
$ ulimit -v<br />
<br />
==Running==<br />
<br />
Syslogd service and authdaemond should be started. See above.<br />
<br />
Start the imap daemon with the following command:<br />
<br />
$ /usr/lib/courier-imap/libexec/imapd.rc start<br />
<br />
Stop the daemon with the following command:<br />
<br />
$ /usr/lib/courier-imap/libexec/imapd.rc stop<br />
<br />
You'll find log messages in /var/log/messages (default target file as specified in /etc/syslogd.conf)<br />
<br />
==Testing==<br />
When authdaemond and imapd are running you can do a simple login test:<br />
<br />
$ telnet localhost 143<br />
<br />
and type the login command<br />
<br />
a login <username> <password><br />
<br />
the server should reply<br />
<br />
a OK LOGIN Ok.<br />
<br />
to which you can reply with a logout<br />
<br />
a logout<br />
<br />
the session is terminated by the server<br />
<br />
* BYE Courier-IMAP server shutting down<br />
a OK LOGOUT completed<br />
Connection closed by foreign host.<br />
<br />
'''Hint:''' if the connection is immediately closed by foreign host it probably means that ''imapd'' does not have access to all required DLLs. Check your PATH.<br />
<br />
==All in one==<br />
If everything works fine you can use the following [{{#file:imapd}} startup script] to launch or stop imap and authlib daemons. It can be saved in /usr/local/sbin.<br />
<br />
<source lang=bash><br />
#! /bin/sh<br />
#<br />
# Courier imap daemon startup script.<br />
<br />
authlib=/usr/local/sbin/authdaemond<br />
imapd=/usr/lib/courier-imap/libexec/imapd.rc<br />
<br />
test ! -f $authlib && echo "File not found: $authlib" && exit 1;<br />
test ! -f $imapd && echo "File not found: $imapd" && exit 1;<br />
<br />
case $1 in<br />
start)<br />
$authlib start<br />
$imapd start<br />
;;<br />
stop)<br />
$imapd stop<br />
$authlib stop<br />
;;<br />
*)<br />
echo "Usage: $0 <start|stop>"<br />
;;<br />
esac<br />
</source><br />
<br />
==Cygwin service==<br />
Create the [{{#file:imapd-srv.sh}} service script]<br />
<br />
<source lang=bash><br />
#!/bin/sh<br />
# File: imapd-service.sh<br />
# Purpose: Courier imap daemon service script.<br />
#<br />
# NOTE: This script must be excutable by SYSTEM<br />
username=username # <<<< Change me !!!<br />
pidsleep=''<br />
<br />
# Function to handle QUIT signal.<br />
# Stop imapd daemon and kill background sleep.<br />
function handleQuit<br />
{<br />
echo "STOPPING: /usr/local/sbin/imapd"<br />
su $username -c "/usr/local/sbin/imapd stop"<br />
test -n "$pidsleep" && kill -9 $pidsleep<br />
exit<br />
}<br />
<br />
# Interruptible sleep<br />
# Note: sleep is an external command (not builtin command), hence<br />
# not interruptible by the QUIT signal.<br />
function intsleep<br />
{<br />
sleep $1 &<br />
pidsleep=$!<br />
wait $pidsleep<br />
}<br />
<br />
echo "STARTING: /usr/local/sbin/imapd as $username at "`date`<br />
su $username -c "/usr/local/sbin/imapd start"<br />
<br />
trap "handleQuit" SIGQUIT<br />
<br />
echo "WAITING: "$$<br />
while true; do intsleep 1d; done<br />
</source><br />
<br />
Change username and save it to your favorite location, says /usr/local/sbin. The service script must be executable by SYSTEM, ie: the user that run the windows services.<br />
<br />
$ chmod +rx /usr/local/sbin/imapd-service.sh<br />
<br />
Install the new service with the following command.<br />
<br />
$ cygrunsrv --install imapd --desc "Courier IMAP daemon" --disp "CYGWIN imapd" \<br />
--path /usr/local/sbin/imapd-service.sh --termsig QUIT --type auto --shutdown<br />
<br />
Finally, just start the service<br />
<br />
$ cygrunsrv --start imapd<br />
or<br />
$ net start imapd<br />
<br />
You should now have couple of processes related to courier-imap<br />
<br />
$ ps -a<br />
<br />
'''NOTES''':<br />
* If the service could not be started, it's probably because the service script is not executable by SYSTEM<br />
<br />
$ net start imapd<br />
The CYGWIN imapd service is starting.<br />
The CYGWIN imapd service could not be started. <br />
<br />
The service did not report an error.<br />
<br />
More help is available by typing NET HELPMSG 3534.<br />
<br />
* The combination of background sleep and builtin wait command is used to make the waiting statment interruptible. The original script found on the net, was simply using a 'sleep 1' which turned to consume ~10% of the CPU.<br />
<br />
=Maildir=<br />
'''maildirmake''' is part of the courier-imap package<br />
<br />
$ /usr/lib/courier-imap/bin/maildirmake<br />
<br />
=Mairix - index and search mail folders=<br />
Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install the package mairix.<br />
<br />
Create the configuration file in your home directory: ~/.mairixrc<br />
<br />
base=/home/username<br />
maildir=Maildir...<br />
omit=Maildir/.Mairix**<br />
mfolder=Maildir/.Mairix<br />
database=/home/username/.mairix_database<br />
<br />
The create the mairix index<br />
<br />
$ mairix<br />
and<br />
$ mairix --fast-index # on daily base<br />
<br />
See [[Mail_Tips]] for additional details.<br />
<br />
=Offlineimap=<br />
Requires python, so run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install the package python.<br />
<br />
Download offlineimap [http://software.complete.org/software/projects/list_files/offlineimap here]. I use [http://software.complete.org/software/versions/download/242?attachment_id=334 version 6.0.3]. Extract files in you favorite sandbox.<br />
<br />
$ tar xvfz offlineimap_6.0.3.tar.gz<br />
$ cd offlineimap<br />
<br />
Apply the following [{{#file:offlineimap_6.0.3-cygwin.patch}} patch] to correct the following issues:<br />
<br />
* [http://en.wikipedia.org/wiki/Maildir#Windows_software Suffix separator character] (:) is not allowed in Windows. Courier-imap for cygwin is using (!)<br />
* While used by courier-imap for cygwin Maildir mail files should not use CRLF, rather only LF. The issue appears only in mail with attachment, that is the raw message is not interpreted and displayed as it in the mail body (under Thunderbird).<br />
<br />
<source lang=diff><br />
--- offlineimap/folder/Maildir.py 2008-11-01 20:49:30.843750000 +0100<br />
+++ offlineimap/folder/Maildir-cygwin.py 2008-11-03 22:54:51.437500000 +0100<br />
@@ -23,7 +23,7 @@<br />
import os.path, os, re, time, socket, md5<br />
<br />
uidmatchre = re.compile(',U=(\d+)')<br />
-flagmatchre = re.compile(':.*2,([A-Z]+)')<br />
+flagmatchre = re.compile('!.*2,([A-Z]+)')<br />
<br />
timeseq = 0<br />
lasttime = long(0)<br />
@@ -180,7 +180,7 @@<br />
break<br />
tmpmessagename = messagename.split(',')[0]<br />
ui.debug('maildir', 'savemessage: using temporary name %s' % tmpmessagename)<br />
- file = open(os.path.join(tmpdir, tmpmessagename), "wt")<br />
+ file = open(os.path.join(tmpdir, tmpmessagename), "wb")<br />
file.write(content)<br />
<br />
# Make sure the data hits the disk<br />
@@ -226,11 +226,11 @@<br />
newpath = os.path.join(self.getfullname(), 'cur')<br />
else:<br />
newpath = os.path.join(self.getfullname(), 'new')<br />
- infostr = ':'<br />
- infomatch = re.search('(:.*)$', newname)<br />
+ infostr = '!'<br />
+ infomatch = re.search('(!.*)$', newname)<br />
if infomatch: # If the info string is present..<br />
infostr = infomatch.group(1)<br />
- newname = newname.split(':')[0] # Strip off the info string.<br />
+ newname = newname.split('!')[0] # Strip off the info string.<br />
infostr = re.sub('2,[A-Z]*', '', infostr)<br />
flags.sort()<br />
infostr += '2,' + ''.join(flags)<br />
</source><br />
<br />
$ cd offlineimap/folder<br />
$ patch -Np2 < ../../offlineimap-cygwin_6.0.3.patch<br />
$ cd ../..<br />
<br />
Install offlineimap<br />
<br />
$ python setup.py install<br />
<br />
Configure offlineimap as described in [[Offlineimap]] and launch offlineimap<br />
<br />
$ offlineimap<br />
or<br />
$ offlineimap -1 -o -u Noninteractive.Basic<br />
or<br />
$ offlineimap -c /home/username/offlineimap.conf<br />
<br />
Here is a simple [{{#file:offlineimap.conf}} offlineimap configuration file].<br />
<br />
<source lang=conf><br />
[general]<br />
metadata = /home/username/.offlineimap<br />
accounts = Test<br />
maxsyncaccounts = 1<br />
ui = Curses.Blinkenlights, TTY.TTYUI,<br />
Noninteractive.Basic, Noninteractive.Quiet<br />
ignore-readonly = no<br />
[mbnames]<br />
enabled = no<br />
[ui.Curses.Blinkenlights]<br />
statuschar = .<br />
[Account Test]<br />
localrepository = LocalExample<br />
remoterepository = RemoteExample<br />
[Repository LocalExample]<br />
type = Maildir<br />
localfolders = /home/username/Maildir<br />
sep = .<br />
restoreatime = no<br />
[Repository RemoteExample]<br />
type = IMAP<br />
remotehost = imapserver<br />
ssl = no<br />
remoteport = 143<br />
remoteuser = username<br />
remotepass = XXXXXX<br />
maxconnections = 1<br />
holdconnectionopen = no<br />
nametrans = lambda foldername: re.sub('^INBOX\.*', '.', foldername)<br />
folderfilter = lambda foldername: not re.search('(SPAM$|Mairix)', foldername)<br />
</source></div>Twalranthttps://wiki.yobi.be/index.php?title=Courier-Cygwin&diff=5278Courier-Cygwin2008-11-04T08:50:27Z<p>Twalrant: /* Offlineimap */</p>
<hr />
<div>=Pre-requisite=<br />
<br />
Courier-IMAP requires the installation of the [http://www.courier-mta.org/authlib/ Courier Authentication Library] and the following cygwin tools and packages<br />
<br />
* patch, tar, make, gcc<br />
* crypt<br />
* libgdbm-devel<br />
* libtool<br />
* inetutils<br />
* cygrunsrv<br />
<br />
Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install the required packages.<br />
<br />
=Courier Authentication Library=<br />
<br />
Installation of Courier Authentication Library using the module userdb to manage mail accounts. All other modules are disabled.<br />
<br />
==Compilation and installation==<br />
<br />
Download and untar [http://www.courier-mta.org/download.php#authlib courier-authlib] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-authlib-0.61.0.tar.bz2 0.61.0]<br />
<br />
Apply the [{{#file:courrier-authlib-0.61.0-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# add libtool flag (-no-undefined) required for DLL creation<br />
# add missing dependencies<br />
# add PATH in start script to access new DLL (installed in a different directory)<br />
<br />
Solution source: http://lists.cairographics.org/archives/cairo/2004-April/001125.html<br />
<br />
<source lang=diff><br />
--- courier-authlib-0.61.0/makedat/Makefile.in 2008-05-24 16:21:09.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/makedat/Makefile.in 2008-10-21 16:02:38.709166700 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-authlib-0.61.0/Makefile.in 2008-07-12 21:41:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/Makefile.in 2008-10-23 22:59:03.843750000 +0200<br />
@@ -213,9 +213,10 @@<br />
LTCOMPILE = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
--mode=compile $(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) \<br />
$(AM_CPPFLAGS) $(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS)<br />
-CCLD = $(CC)<br />
+CCLD = $(CC) -no-undefined<br />
+CCLDEXE = $(CC)<br />
LINK = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
- --mode=link $(CCLD) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
+ --mode=link $(CCLDEXE) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
$(LDFLAGS) -o $@<br />
SOURCES = $(libauthcustom_la_SOURCES) $(libauthldap_la_SOURCES) \<br />
$(libauthmysql_la_SOURCES) $(libauthpam_la_SOURCES) \<br />
@@ -452,9 +453,9 @@<br />
README.authdebug.html<br />
<br />
DISTCLEANFILES = dbobj.config README_authlib.html<br />
-commonlibdep = libcourierauthcommon.la<br />
+commonlibdep = libcourierauthcommon.la libcourierauth.la<br />
commonldflags = -module -rpath $(pkglibdir) -export-symbols-regex 'courier_auth.*_init' -avoid-version<br />
-commonlibadd = libcourierauthcommon.la<br />
+commonlibadd = libcourierauthcommon.la libcourierauth.la<br />
libcourierauthcommon_t = @CRYPTLIBS@<br />
libcourierauthcommon_la_SOURCES = \<br />
auth.h courierauth.h \<br />
--- courier-authlib-0.61.0/authdaemond.in 2005-07-05 14:25:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/authdaemond.in 2008-10-25 12:03:32.140625000 +0200<br />
@@ -15,4 +15,10 @@<br />
set -a<br />
. @authdaemonrc@<br />
<br />
+# Some shared libraries (DLL) are installed in @libdir@/bin<br />
+# instead of @libdir@/@PACKAGE@<br />
+# Setting LD_LIBRARY_PATH at runtime or LR_RUN_PATH at linktime doesn't<br />
+# work in cygwin, only setting PATH works. <br />
+export PATH=$PATH:@libdir@/bin<br />
+<br />
exec ${sbindir}/courierlogger -pid=@authdaemonvar@/pid $LOGGEROPTS -$1 @libexecdir@/courier-authlib/authdaemond<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-authlib-0.61.0-cygwin.patch<br />
<br />
Configure the package without most authentication modules, keeping only ''userdb''.<br />
<br />
'''Note''': replace ''mailuser'' by an existing user name (in your /etc/passwd file). I used my own username.<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait --without-authpam --without-authldap --without-authpwd \<br />
--without-authshadow --without-authcustom --without-authpipe --without-authmysql --without-authpgsql --with-mailuser=mailuser \<br />
--with-mailgroup=mkgroup-l-d<br />
<br />
Take a long pause... and when ready execute the following command.<br />
<br />
$ make<br />
<br />
Take again a long pause... then check the result and install the libraries<br />
<br />
$ make check<br />
$ make install<br />
<br />
'''NOTES''': list of related topics found during investigation for compilation<br />
* authldap: configure: error: -lresolve is needed for res_query... http://www.cygwin.com/ml/cygwin/2005-04/msg00419.html<br />
<br />
==Configuration==<br />
<br />
Create authdaemonrc file: /usr/local/etc/authlib/authdaemonrc<br />
<br />
$ cp /usr/local/etc/authlib/authdaemonrc.dist /usr/local/etc/authlib/authdaemonrc<br />
<br />
Change number of daemons (I use three) and enable DEBUG_LOGIN<br />
<br />
<source lang=text><br />
# The number of daemon processes that are started.<br />
daemons=3<br />
<br />
# DEBUG_LOGIN=2 - turn on debugging + log passwords too<br />
DEBUG_LOGIN=2<br />
</source><br />
<br />
See http://www.courier-mta.org/authlib/README.authdebug.html for details.<br />
<br />
==IMAP accounts==<br />
<br />
User accounts and settings are managed by ''userdb''. See [http://linux.die.net/man/8/makeuserdb makeuserdb] man page for details, or used the freshly new install man page - man makeuserdb<br />
<br />
Assuming ''username'' is your username, 1001 and 10545 are respectively the UID and GID of an existing user (part of your /etc/passwd and /etc/group). I use my own UID and GID. Create the mailuser home directory, if required, and create Maildir folder.<br />
<br />
$ mkdir -p /home/username<br />
$ cd /home/username<br />
$ /usr/lib/courier-imap/bin/maildirmake Maildir<br />
<br />
Create the userdb text file /usr/local/etc/authlib/userdb<br />
<br />
$ touch /usr/local/etc/authlib/userdb<br />
$ chmod 700 /usr/local/etc/authlib/userdb<br />
<br />
Edit /usr/local/etc/authlib/userdb, one line per account<br />
<br />
<source lang=text><br />
username[TAB]uid=1001|gid=10111|home=/home/username|mail=/home/username/Maildir|systempw=XXXXXX<br />
</source><br />
<br />
where XXXXXX is the encrypted password created with<br />
<br />
$ /usr/local/sbin/userdbpw.exe<br />
<br />
Create the (binary) userdb<br />
<br />
$ /usr/local/sbin/makeuserdb<br />
<br />
You should now have the following files created:<br />
<br />
* /usr/local/etc/authlib/userdb.dat<br />
* /usr/local/etc/authlib/userdbshadow.dat<br />
<br />
==Running==<br />
<br />
Install and configure syslogd. Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install inetutils (contains syslogd). Configure syslogd with the following command. It will create the /etc/syslogd.conf file and install a windows service using cygrunsrv<br />
<br />
$ syslogd-config<br />
<br />
Start the authlib daemon with the following command:<br />
<br />
$ /usr/local/sbin/authdaemon start<br />
<br />
Stop the daemon with the following command:<br />
<br />
$ /usr/local/sbin/authdaemon stop<br />
<br />
You'll find log messages in /var/log/messages (default target file as specified in /etc/syslogd.conf)<br />
<br />
==Testing authlib==<br />
<br />
$ /usr/local/sbin/authtest username CCCCCC<br />
Authentication succeeded.<br />
<br />
Authenticated: username (uid 1001, gid 10545)<br />
Home Directory: /home/username<br />
Maildir: /home/username/Maildir<br />
Quota: (none)<br />
Encrypted Password: XXXXXX<br />
Cleartext Password: CCCCCC<br />
Options: (none)<br />
<br />
where username is your user name and XXXXXX is your encrypted password as provided in ''/usr/local/etc/authlib/userdb''. CCCCCC is your password in clear.<br />
<br />
==Troubleshooting==<br />
<br />
Should you have a doubt on the execution of a command (ie: no output) you can check if the application is able to load required DLL. This error is not reported. Using ''strace'', windows will complain about DLL not found, if any. To solve this problem you may need to add some path in your PATH. For example, in order to test authlib with authtest:<br />
<br />
$ strace /usr/local/sbin/authtest<br />
# This will open a dialog box to complain about DLL.<br />
$ export PATH=$PATH:/usr/local/lib/bin<br />
$ /usr/local/sbin/authtest ausername<br />
<br />
==Courier Authentication Config==<br />
<br />
$ /usr/local/bin/courierauthconfig.exe --version<br />
$ /usr/local/bin/courierauthconfig.exe --ldflags<br />
$ /usr/local/bin/courierauthconfig.exe --cppflags<br />
$ /usr/local/bin/courierauthconfig.exe --configfiles<br />
<br />
=Courier-IMAP=<br />
==Compilation and installation==<br />
<br />
Download and untar package [http://www.courier-mta.org/download.php#imap courier-imap] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-imap-4.4.1.tar.bz2 4.4.1.20080920]<br />
<br />
Apply the [{{#file:courrier-imap-4.4.1-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# incorrect usage of EXTEXT in main ''Makefile''<br />
# remove usage of /usr/lib/env in start/stop script (/usr/lib/env does not seem to work under Cygwin)<br />
<br />
<source lang=diff><br />
--- courier-imap-4.4.1.20080920/makedat/Makefile.in 2008-08-24 19:52:51.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/makedat/Makefile.in 2008-10-21 20:43:27.500000000 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-imap-4.4.1.20080920/Makefile.in 2008-09-20 14:48:46.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/Makefile.in 2008-10-21 20:59:45.156250000 +0200<br />
@@ -247,9 +247,9 @@<br />
CLEANFILES = $(databin_SCRIPTS) $(man_MANS) $(sysconf_DATA) $(sbin_SCRIPTS)<br />
databindir = $(datadir)<br />
databin_SCRIPTS = mkimapdcert mkpop3dcert<br />
-binPROGRAMS = imapd pop3d maildirmake maildiracl deliverquota maildirkw<br />
-sbinPROGRAMS = imaplogin pop3login<br />
-libexecPROGRAMS = makedatprog couriertcpd<br />
+binPROGRAMS = imapd$(EXEEXT) pop3d$(EXEEXT) maildirmake$(EXEEXT) maildiracl$(EXEEXT) deliverquota$(EXEEXT) maildirkw$(EXEEXT)<br />
+sbinPROGRAMS = imaplogin$(EXEEXT) pop3login$(EXEEXT)<br />
+libexecPROGRAMS = makedatprog$(EXEEXT) couriertcpd$(EXEEXT)<br />
bin_PROGRAMS = @binPROGRAMS_exec@<br />
sbin_PROGRAMS = @sbinPROGRAMS_exec@<br />
libexec_PROGRAMS = @libexecPROGRAMS_exec@<br />
--- courier-imap-4.4.1.20080920/imapd.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/imapd.rc.in 2008-10-26 10:17:51.359375000 +0100<br />
@@ -22,6 +22,15 @@<br />
exit 1<br />
fi<br />
<br />
+# Location for some shared libraries (cygcourierauth*.dll) from authlib<br />
+AUTHLIBDIR=/usr/local<br />
+if test ! -f $AUTHLIBDIR/lib/bin/cygcourierauth.dll<br />
+then<br />
+ echo "$AUTHLIBDIR/lib/bin/cygcourierauth.dll not found."<br />
+ exit 1<br />
+fi<br />
+export PATH=$PATH:$AUTHLIBDIR/lib/bin<br />
+<br />
TLS_CACHEFILE=""<br />
. @sysconfdir@/imapd-ssl<br />
. @sysconfdir@/imapd<br />
@@ -35,7 +44,7 @@<br />
<br />
umask $IMAP_UMASK<br />
@ULIMIT@ $IMAP_ULIMITD<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
--- courier-imap-4.4.1.20080920/pop3d.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/pop3d.rc.in 2008-10-26 10:18:02.187500000 +0100<br />
@@ -22,12 +22,21 @@<br />
exit 1<br />
fi<br />
<br />
+# Location for some shared libraries (cygcourierauth*.dll) from authlib<br />
+AUTHLIBDIR=/usr/local<br />
+if test ! -f $AUTHLIBDIR/lib/bin/cygcourierauth.dll<br />
+then<br />
+ echo "$AUTHLIBDIR/lib/bin/cygcourierauth.dll not found."<br />
+ exit 1<br />
+fi<br />
+export PATH=$PATH:$AUTHLIBDIR/lib/bin<br />
+<br />
. @sysconfdir@/pop3d-ssl<br />
. @sysconfdir@/pop3d<br />
<br />
case $1 in<br />
start)<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-imap-4.4.1-cygwin.patch<br />
<br />
Configure the package<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait<br />
<br />
Take a walk... and when ready execute the following command to build the package.<br />
<br />
$ make<br />
<br />
Time to go for some coffee... and then install the package with the usual<br />
<br />
$ make install<br />
$ make install-configure<br />
<br />
==Configuration==<br />
<br />
Setup courier-imap: $prefix/etc/imapd (where $prefix=/usr/lib/courier-imap)<br />
<br />
Set ADDRESS to a valid value (0 or 127.0.0.1) and change IMAP_ULIMITD to a value accepted by the command ulimit. I simply used the existing value returned by<br />
<br />
$ ulimit -v<br />
<br />
==Running==<br />
<br />
Syslogd service and authdaemond should be started. See above.<br />
<br />
Start the imap daemon with the following command:<br />
<br />
$ /usr/lib/courier-imap/libexec/imapd.rc start<br />
<br />
Stop the daemon with the following command:<br />
<br />
$ /usr/lib/courier-imap/libexec/imapd.rc stop<br />
<br />
You'll find log messages in /var/log/messages (default target file as specified in /etc/syslogd.conf)<br />
<br />
==Testing==<br />
When authdaemond and imapd are running you can do a simple login test:<br />
<br />
$ telnet localhost 143<br />
<br />
and type the login command<br />
<br />
a login <username> <password><br />
<br />
the server should reply<br />
<br />
a OK LOGIN Ok.<br />
<br />
to which you can reply with a logout<br />
<br />
a logout<br />
<br />
the session is terminated by the server<br />
<br />
* BYE Courier-IMAP server shutting down<br />
a OK LOGOUT completed<br />
Connection closed by foreign host.<br />
<br />
'''Hint:''' if the connection is immediately closed by foreign host it probably means that ''imapd'' does not have access to all required DLLs. Check your PATH.<br />
<br />
==All in one==<br />
If everything works fine you can use the following [{{#file:imapd}} startup script] to launch or stop imap and authlib daemons. It can be saved in /usr/local/sbin.<br />
<br />
<source lang=bash><br />
#! /bin/sh<br />
#<br />
# Courier imap daemon startup script.<br />
<br />
authlib=/usr/local/sbin/authdaemond<br />
imapd=/usr/lib/courier-imap/libexec/imapd.rc<br />
<br />
test ! -f $authlib && echo "File not found: $authlib" && exit 1;<br />
test ! -f $imapd && echo "File not found: $imapd" && exit 1;<br />
<br />
case $1 in<br />
start)<br />
$authlib start<br />
$imapd start<br />
;;<br />
stop)<br />
$imapd stop<br />
$authlib stop<br />
;;<br />
*)<br />
echo "Usage: $0 <start|stop>"<br />
;;<br />
esac<br />
</source><br />
<br />
==Cygwin service==<br />
Create the [{{#file:imapd-srv.sh}} service script]<br />
<br />
<source lang=bash><br />
#!/bin/sh<br />
# File: imapd-service.sh<br />
# Purpose: Courier imap daemon service script.<br />
#<br />
# NOTE: This script must be excutable by SYSTEM<br />
username=username # <<<< Change me !!!<br />
pidsleep=''<br />
<br />
# Function to handle QUIT signal.<br />
# Stop imapd daemon and kill background sleep.<br />
function handleQuit<br />
{<br />
echo "STOPPING: /usr/local/sbin/imapd"<br />
su $username -c "/usr/local/sbin/imapd stop"<br />
test -n "$pidsleep" && kill -9 $pidsleep<br />
exit<br />
}<br />
<br />
# Interruptible sleep<br />
# Note: sleep is an external command (not builtin command), hence<br />
# not interruptible by the QUIT signal.<br />
function intsleep<br />
{<br />
sleep $1 &<br />
pidsleep=$!<br />
wait $pidsleep<br />
}<br />
<br />
echo "STARTING: /usr/local/sbin/imapd as $username at "`date`<br />
su $username -c "/usr/local/sbin/imapd start"<br />
<br />
trap "handleQuit" SIGQUIT<br />
<br />
echo "WAITING: "$$<br />
while true; do intsleep 1d; done<br />
</source><br />
<br />
Change username and save it to your favorite location, says /usr/local/sbin. The service script must be executable by SYSTEM, ie: the user that run the windows services.<br />
<br />
$ chmod +rx /usr/local/sbin/imapd-service.sh<br />
<br />
Install the new service with the following command.<br />
<br />
$ cygrunsrv --install imapd --desc "Courier IMAP daemon" --disp "CYGWIN imapd" \<br />
--path /usr/local/sbin/imapd-service.sh --termsig QUIT --type auto --shutdown<br />
<br />
Finally, just start the service<br />
<br />
$ cygrunsrv --start imapd<br />
or<br />
$ net start imapd<br />
<br />
You should now have couple of processes related to courier-imap<br />
<br />
$ ps -a<br />
<br />
'''NOTES''':<br />
* If the service could not be started, it's probably because the service script is not executable by SYSTEM<br />
<br />
$ net start imapd<br />
The CYGWIN imapd service is starting.<br />
The CYGWIN imapd service could not be started. <br />
<br />
The service did not report an error.<br />
<br />
More help is available by typing NET HELPMSG 3534.<br />
<br />
* The combination of background sleep and builtin wait command is used to make the waiting statment interruptible. The original script found on the net, was simply using a 'sleep 1' which turned to consume ~10% of the CPU.<br />
<br />
=Maildir=<br />
'''maildirmake''' is part of the courier-imap package<br />
<br />
$ /usr/lib/courier-imap/bin/maildirmake<br />
<br />
=Mairix - index and search mail folders=<br />
Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install the package mairix.<br />
<br />
Create the configuration file in your home directory: ~/.mairixrc<br />
<br />
base=/home/username<br />
maildir=Maildir...<br />
omit=Maildir/.Mairix**<br />
mfolder=Maildir/.Mairix<br />
database=/home/username/.mairix_database<br />
<br />
The create the mairix index<br />
<br />
$ mairix<br />
and<br />
$ mairix --fast-index # on daily base<br />
<br />
See [[Mail_Tips]] for additional details.<br />
<br />
=Offlineimap=<br />
Requires python, so run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install the package python.<br />
<br />
Download offlineimap [http://software.complete.org/software/projects/list_files/offlineimap here]. I use [http://software.complete.org/software/versions/download/242?attachment_id=334 version 6.0.3]. Extract files in you favorite sandbox.<br />
<br />
$ tar xvfz offlineimap_6.0.3.tar.gz<br />
$ cd offlineimap<br />
<br />
Apply the following [{{#file:offlineimap_6.0.3-cygwin.patch}} patch] to correct the following issues:<br />
<br />
* [http://en.wikipedia.org/wiki/Maildir#Windows_software Suffix separator character] (:) is not allowed in Windows. Courier-imap for cygwin is using (!)<br />
* While used by courier-imap for cygwin Maildir mail files should not use CRLF, rather only LF. The issue appears only in mail with attachment, that is the raw message is not interpreted and displayed as it in the mail body (under Thunderbird).<br />
<br />
<source lang=diff><br />
--- offlineimap/folder/Maildir.py 2008-11-01 20:49:30.843750000 +0100<br />
+++ offlineimap/folder/Maildir-cygwin.py 2008-11-03 22:54:51.437500000 +0100<br />
@@ -23,7 +23,7 @@<br />
import os.path, os, re, time, socket, md5<br />
<br />
uidmatchre = re.compile(',U=(\d+)')<br />
-flagmatchre = re.compile(':.*2,([A-Z]+)')<br />
+flagmatchre = re.compile('!.*2,([A-Z]+)')<br />
<br />
timeseq = 0<br />
lasttime = long(0)<br />
@@ -180,7 +180,7 @@<br />
break<br />
tmpmessagename = messagename.split(',')[0]<br />
ui.debug('maildir', 'savemessage: using temporary name %s' % tmpmessagename)<br />
- file = open(os.path.join(tmpdir, tmpmessagename), "wt")<br />
+ file = open(os.path.join(tmpdir, tmpmessagename), "wb")<br />
file.write(content)<br />
<br />
# Make sure the data hits the disk<br />
@@ -226,11 +226,11 @@<br />
newpath = os.path.join(self.getfullname(), 'cur')<br />
else:<br />
newpath = os.path.join(self.getfullname(), 'new')<br />
- infostr = ':'<br />
- infomatch = re.search('(:.*)$', newname)<br />
+ infostr = '!'<br />
+ infomatch = re.search('(!.*)$', newname)<br />
if infomatch: # If the info string is present..<br />
infostr = infomatch.group(1)<br />
- newname = newname.split(':')[0] # Strip off the info string.<br />
+ newname = newname.split('!')[0] # Strip off the info string.<br />
infostr = re.sub('2,[A-Z]*', '', infostr)<br />
flags.sort()<br />
infostr += '2,' + ''.join(flags)<br />
</source><br />
<br />
$ cd offlineimap/folder<br />
$ patch -Np2 < ../../offlineimap-cygwin_6.0.3.patch<br />
$ cd ../..<br />
<br />
Install offlineimap<br />
<br />
$ python setup.py install<br />
<br />
Configure offlineimap as described in [[Offlineimap]] and launch offlineimap<br />
<br />
$ offlineimap<br />
or<br />
$ offlineimap -1 -o -u Noninteractive.Basic<br />
or<br />
$ offlineimap -c /home/username/offlineimap.conf</div>Twalranthttps://wiki.yobi.be/index.php?title=Courier-Cygwin&diff=5277Courier-Cygwin2008-11-04T08:47:21Z<p>Twalrant: /* Offlineimap */</p>
<hr />
<div>=Pre-requisite=<br />
<br />
Courier-IMAP requires the installation of the [http://www.courier-mta.org/authlib/ Courier Authentication Library] and the following cygwin tools and packages<br />
<br />
* patch, tar, make, gcc<br />
* crypt<br />
* libgdbm-devel<br />
* libtool<br />
* inetutils<br />
* cygrunsrv<br />
<br />
Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install the required packages.<br />
<br />
=Courier Authentication Library=<br />
<br />
Installation of Courier Authentication Library using the module userdb to manage mail accounts. All other modules are disabled.<br />
<br />
==Compilation and installation==<br />
<br />
Download and untar [http://www.courier-mta.org/download.php#authlib courier-authlib] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-authlib-0.61.0.tar.bz2 0.61.0]<br />
<br />
Apply the [{{#file:courrier-authlib-0.61.0-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# add libtool flag (-no-undefined) required for DLL creation<br />
# add missing dependencies<br />
# add PATH in start script to access new DLL (installed in a different directory)<br />
<br />
Solution source: http://lists.cairographics.org/archives/cairo/2004-April/001125.html<br />
<br />
<source lang=diff><br />
--- courier-authlib-0.61.0/makedat/Makefile.in 2008-05-24 16:21:09.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/makedat/Makefile.in 2008-10-21 16:02:38.709166700 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-authlib-0.61.0/Makefile.in 2008-07-12 21:41:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/Makefile.in 2008-10-23 22:59:03.843750000 +0200<br />
@@ -213,9 +213,10 @@<br />
LTCOMPILE = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
--mode=compile $(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) \<br />
$(AM_CPPFLAGS) $(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS)<br />
-CCLD = $(CC)<br />
+CCLD = $(CC) -no-undefined<br />
+CCLDEXE = $(CC)<br />
LINK = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
- --mode=link $(CCLD) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
+ --mode=link $(CCLDEXE) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
$(LDFLAGS) -o $@<br />
SOURCES = $(libauthcustom_la_SOURCES) $(libauthldap_la_SOURCES) \<br />
$(libauthmysql_la_SOURCES) $(libauthpam_la_SOURCES) \<br />
@@ -452,9 +453,9 @@<br />
README.authdebug.html<br />
<br />
DISTCLEANFILES = dbobj.config README_authlib.html<br />
-commonlibdep = libcourierauthcommon.la<br />
+commonlibdep = libcourierauthcommon.la libcourierauth.la<br />
commonldflags = -module -rpath $(pkglibdir) -export-symbols-regex 'courier_auth.*_init' -avoid-version<br />
-commonlibadd = libcourierauthcommon.la<br />
+commonlibadd = libcourierauthcommon.la libcourierauth.la<br />
libcourierauthcommon_t = @CRYPTLIBS@<br />
libcourierauthcommon_la_SOURCES = \<br />
auth.h courierauth.h \<br />
--- courier-authlib-0.61.0/authdaemond.in 2005-07-05 14:25:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/authdaemond.in 2008-10-25 12:03:32.140625000 +0200<br />
@@ -15,4 +15,10 @@<br />
set -a<br />
. @authdaemonrc@<br />
<br />
+# Some shared libraries (DLL) are installed in @libdir@/bin<br />
+# instead of @libdir@/@PACKAGE@<br />
+# Setting LD_LIBRARY_PATH at runtime or LR_RUN_PATH at linktime doesn't<br />
+# work in cygwin, only setting PATH works. <br />
+export PATH=$PATH:@libdir@/bin<br />
+<br />
exec ${sbindir}/courierlogger -pid=@authdaemonvar@/pid $LOGGEROPTS -$1 @libexecdir@/courier-authlib/authdaemond<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-authlib-0.61.0-cygwin.patch<br />
<br />
Configure the package without most authentication modules, keeping only ''userdb''.<br />
<br />
'''Note''': replace ''mailuser'' by an existing user name (in your /etc/passwd file). I used my own username.<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait --without-authpam --without-authldap --without-authpwd \<br />
--without-authshadow --without-authcustom --without-authpipe --without-authmysql --without-authpgsql --with-mailuser=mailuser \<br />
--with-mailgroup=mkgroup-l-d<br />
<br />
Take a long pause... and when ready execute the following command.<br />
<br />
$ make<br />
<br />
Take again a long pause... then check the result and install the libraries<br />
<br />
$ make check<br />
$ make install<br />
<br />
'''NOTES''': list of related topics found during investigation for compilation<br />
* authldap: configure: error: -lresolve is needed for res_query... http://www.cygwin.com/ml/cygwin/2005-04/msg00419.html<br />
<br />
==Configuration==<br />
<br />
Create authdaemonrc file: /usr/local/etc/authlib/authdaemonrc<br />
<br />
$ cp /usr/local/etc/authlib/authdaemonrc.dist /usr/local/etc/authlib/authdaemonrc<br />
<br />
Change number of daemons (I use three) and enable DEBUG_LOGIN<br />
<br />
<source lang=text><br />
# The number of daemon processes that are started.<br />
daemons=3<br />
<br />
# DEBUG_LOGIN=2 - turn on debugging + log passwords too<br />
DEBUG_LOGIN=2<br />
</source><br />
<br />
See http://www.courier-mta.org/authlib/README.authdebug.html for details.<br />
<br />
==IMAP accounts==<br />
<br />
User accounts and settings are managed by ''userdb''. See [http://linux.die.net/man/8/makeuserdb makeuserdb] man page for details, or used the freshly new install man page - man makeuserdb<br />
<br />
Assuming ''username'' is your username, 1001 and 10545 are respectively the UID and GID of an existing user (part of your /etc/passwd and /etc/group). I use my own UID and GID. Create the mailuser home directory, if required, and create Maildir folder.<br />
<br />
$ mkdir -p /home/username<br />
$ cd /home/username<br />
$ /usr/lib/courier-imap/bin/maildirmake Maildir<br />
<br />
Create the userdb text file /usr/local/etc/authlib/userdb<br />
<br />
$ touch /usr/local/etc/authlib/userdb<br />
$ chmod 700 /usr/local/etc/authlib/userdb<br />
<br />
Edit /usr/local/etc/authlib/userdb, one line per account<br />
<br />
<source lang=text><br />
username[TAB]uid=1001|gid=10111|home=/home/username|mail=/home/username/Maildir|systempw=XXXXXX<br />
</source><br />
<br />
where XXXXXX is the encrypted password created with<br />
<br />
$ /usr/local/sbin/userdbpw.exe<br />
<br />
Create the (binary) userdb<br />
<br />
$ /usr/local/sbin/makeuserdb<br />
<br />
You should now have the following files created:<br />
<br />
* /usr/local/etc/authlib/userdb.dat<br />
* /usr/local/etc/authlib/userdbshadow.dat<br />
<br />
==Running==<br />
<br />
Install and configure syslogd. Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install inetutils (contains syslogd). Configure syslogd with the following command. It will create the /etc/syslogd.conf file and install a windows service using cygrunsrv<br />
<br />
$ syslogd-config<br />
<br />
Start the authlib daemon with the following command:<br />
<br />
$ /usr/local/sbin/authdaemon start<br />
<br />
Stop the daemon with the following command:<br />
<br />
$ /usr/local/sbin/authdaemon stop<br />
<br />
You'll find log messages in /var/log/messages (default target file as specified in /etc/syslogd.conf)<br />
<br />
==Testing authlib==<br />
<br />
$ /usr/local/sbin/authtest username CCCCCC<br />
Authentication succeeded.<br />
<br />
Authenticated: username (uid 1001, gid 10545)<br />
Home Directory: /home/username<br />
Maildir: /home/username/Maildir<br />
Quota: (none)<br />
Encrypted Password: XXXXXX<br />
Cleartext Password: CCCCCC<br />
Options: (none)<br />
<br />
where username is your user name and XXXXXX is your encrypted password as provided in ''/usr/local/etc/authlib/userdb''. CCCCCC is your password in clear.<br />
<br />
==Troubleshooting==<br />
<br />
Should you have a doubt on the execution of a command (ie: no output) you can check if the application is able to load required DLL. This error is not reported. Using ''strace'', windows will complain about DLL not found, if any. To solve this problem you may need to add some path in your PATH. For example, in order to test authlib with authtest:<br />
<br />
$ strace /usr/local/sbin/authtest<br />
# This will open a dialog box to complain about DLL.<br />
$ export PATH=$PATH:/usr/local/lib/bin<br />
$ /usr/local/sbin/authtest ausername<br />
<br />
==Courier Authentication Config==<br />
<br />
$ /usr/local/bin/courierauthconfig.exe --version<br />
$ /usr/local/bin/courierauthconfig.exe --ldflags<br />
$ /usr/local/bin/courierauthconfig.exe --cppflags<br />
$ /usr/local/bin/courierauthconfig.exe --configfiles<br />
<br />
=Courier-IMAP=<br />
==Compilation and installation==<br />
<br />
Download and untar package [http://www.courier-mta.org/download.php#imap courier-imap] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-imap-4.4.1.tar.bz2 4.4.1.20080920]<br />
<br />
Apply the [{{#file:courrier-imap-4.4.1-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# incorrect usage of EXTEXT in main ''Makefile''<br />
# remove usage of /usr/lib/env in start/stop script (/usr/lib/env does not seem to work under Cygwin)<br />
<br />
<source lang=diff><br />
--- courier-imap-4.4.1.20080920/makedat/Makefile.in 2008-08-24 19:52:51.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/makedat/Makefile.in 2008-10-21 20:43:27.500000000 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-imap-4.4.1.20080920/Makefile.in 2008-09-20 14:48:46.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/Makefile.in 2008-10-21 20:59:45.156250000 +0200<br />
@@ -247,9 +247,9 @@<br />
CLEANFILES = $(databin_SCRIPTS) $(man_MANS) $(sysconf_DATA) $(sbin_SCRIPTS)<br />
databindir = $(datadir)<br />
databin_SCRIPTS = mkimapdcert mkpop3dcert<br />
-binPROGRAMS = imapd pop3d maildirmake maildiracl deliverquota maildirkw<br />
-sbinPROGRAMS = imaplogin pop3login<br />
-libexecPROGRAMS = makedatprog couriertcpd<br />
+binPROGRAMS = imapd$(EXEEXT) pop3d$(EXEEXT) maildirmake$(EXEEXT) maildiracl$(EXEEXT) deliverquota$(EXEEXT) maildirkw$(EXEEXT)<br />
+sbinPROGRAMS = imaplogin$(EXEEXT) pop3login$(EXEEXT)<br />
+libexecPROGRAMS = makedatprog$(EXEEXT) couriertcpd$(EXEEXT)<br />
bin_PROGRAMS = @binPROGRAMS_exec@<br />
sbin_PROGRAMS = @sbinPROGRAMS_exec@<br />
libexec_PROGRAMS = @libexecPROGRAMS_exec@<br />
--- courier-imap-4.4.1.20080920/imapd.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/imapd.rc.in 2008-10-26 10:17:51.359375000 +0100<br />
@@ -22,6 +22,15 @@<br />
exit 1<br />
fi<br />
<br />
+# Location for some shared libraries (cygcourierauth*.dll) from authlib<br />
+AUTHLIBDIR=/usr/local<br />
+if test ! -f $AUTHLIBDIR/lib/bin/cygcourierauth.dll<br />
+then<br />
+ echo "$AUTHLIBDIR/lib/bin/cygcourierauth.dll not found."<br />
+ exit 1<br />
+fi<br />
+export PATH=$PATH:$AUTHLIBDIR/lib/bin<br />
+<br />
TLS_CACHEFILE=""<br />
. @sysconfdir@/imapd-ssl<br />
. @sysconfdir@/imapd<br />
@@ -35,7 +44,7 @@<br />
<br />
umask $IMAP_UMASK<br />
@ULIMIT@ $IMAP_ULIMITD<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
--- courier-imap-4.4.1.20080920/pop3d.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/pop3d.rc.in 2008-10-26 10:18:02.187500000 +0100<br />
@@ -22,12 +22,21 @@<br />
exit 1<br />
fi<br />
<br />
+# Location for some shared libraries (cygcourierauth*.dll) from authlib<br />
+AUTHLIBDIR=/usr/local<br />
+if test ! -f $AUTHLIBDIR/lib/bin/cygcourierauth.dll<br />
+then<br />
+ echo "$AUTHLIBDIR/lib/bin/cygcourierauth.dll not found."<br />
+ exit 1<br />
+fi<br />
+export PATH=$PATH:$AUTHLIBDIR/lib/bin<br />
+<br />
. @sysconfdir@/pop3d-ssl<br />
. @sysconfdir@/pop3d<br />
<br />
case $1 in<br />
start)<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-imap-4.4.1-cygwin.patch<br />
<br />
Configure the package<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait<br />
<br />
Take a walk... and when ready execute the following command to build the package.<br />
<br />
$ make<br />
<br />
Time to go for some coffee... and then install the package with the usual<br />
<br />
$ make install<br />
$ make install-configure<br />
<br />
==Configuration==<br />
<br />
Setup courier-imap: $prefix/etc/imapd (where $prefix=/usr/lib/courier-imap)<br />
<br />
Set ADDRESS to a valid value (0 or 127.0.0.1) and change IMAP_ULIMITD to a value accepted by the command ulimit. I simply used the existing value returned by<br />
<br />
$ ulimit -v<br />
<br />
==Running==<br />
<br />
Syslogd service and authdaemond should be started. See above.<br />
<br />
Start the imap daemon with the following command:<br />
<br />
$ /usr/lib/courier-imap/libexec/imapd.rc start<br />
<br />
Stop the daemon with the following command:<br />
<br />
$ /usr/lib/courier-imap/libexec/imapd.rc stop<br />
<br />
You'll find log messages in /var/log/messages (default target file as specified in /etc/syslogd.conf)<br />
<br />
==Testing==<br />
When authdaemond and imapd are running you can do a simple login test:<br />
<br />
$ telnet localhost 143<br />
<br />
and type the login command<br />
<br />
a login <username> <password><br />
<br />
the server should reply<br />
<br />
a OK LOGIN Ok.<br />
<br />
to which you can reply with a logout<br />
<br />
a logout<br />
<br />
the session is terminated by the server<br />
<br />
* BYE Courier-IMAP server shutting down<br />
a OK LOGOUT completed<br />
Connection closed by foreign host.<br />
<br />
'''Hint:''' if the connection is immediately closed by foreign host it probably means that ''imapd'' does not have access to all required DLLs. Check your PATH.<br />
<br />
==All in one==<br />
If everything works fine you can use the following [{{#file:imapd}} startup script] to launch or stop imap and authlib daemons. It can be saved in /usr/local/sbin.<br />
<br />
<source lang=bash><br />
#! /bin/sh<br />
#<br />
# Courier imap daemon startup script.<br />
<br />
authlib=/usr/local/sbin/authdaemond<br />
imapd=/usr/lib/courier-imap/libexec/imapd.rc<br />
<br />
test ! -f $authlib && echo "File not found: $authlib" && exit 1;<br />
test ! -f $imapd && echo "File not found: $imapd" && exit 1;<br />
<br />
case $1 in<br />
start)<br />
$authlib start<br />
$imapd start<br />
;;<br />
stop)<br />
$imapd stop<br />
$authlib stop<br />
;;<br />
*)<br />
echo "Usage: $0 <start|stop>"<br />
;;<br />
esac<br />
</source><br />
<br />
==Cygwin service==<br />
Create the [{{#file:imapd-srv.sh}} service script]<br />
<br />
<source lang=bash><br />
#!/bin/sh<br />
# File: imapd-service.sh<br />
# Purpose: Courier imap daemon service script.<br />
#<br />
# NOTE: This script must be excutable by SYSTEM<br />
username=username # <<<< Change me !!!<br />
pidsleep=''<br />
<br />
# Function to handle QUIT signal.<br />
# Stop imapd daemon and kill background sleep.<br />
function handleQuit<br />
{<br />
echo "STOPPING: /usr/local/sbin/imapd"<br />
su $username -c "/usr/local/sbin/imapd stop"<br />
test -n "$pidsleep" && kill -9 $pidsleep<br />
exit<br />
}<br />
<br />
# Interruptible sleep<br />
# Note: sleep is an external command (not builtin command), hence<br />
# not interruptible by the QUIT signal.<br />
function intsleep<br />
{<br />
sleep $1 &<br />
pidsleep=$!<br />
wait $pidsleep<br />
}<br />
<br />
echo "STARTING: /usr/local/sbin/imapd as $username at "`date`<br />
su $username -c "/usr/local/sbin/imapd start"<br />
<br />
trap "handleQuit" SIGQUIT<br />
<br />
echo "WAITING: "$$<br />
while true; do intsleep 1d; done<br />
</source><br />
<br />
Change username and save it to your favorite location, says /usr/local/sbin. The service script must be executable by SYSTEM, ie: the user that run the windows services.<br />
<br />
$ chmod +rx /usr/local/sbin/imapd-service.sh<br />
<br />
Install the new service with the following command.<br />
<br />
$ cygrunsrv --install imapd --desc "Courier IMAP daemon" --disp "CYGWIN imapd" \<br />
--path /usr/local/sbin/imapd-service.sh --termsig QUIT --type auto --shutdown<br />
<br />
Finally, just start the service<br />
<br />
$ cygrunsrv --start imapd<br />
or<br />
$ net start imapd<br />
<br />
You should now have couple of processes related to courier-imap<br />
<br />
$ ps -a<br />
<br />
'''NOTES''':<br />
* If the service could not be started, it's probably because the service script is not executable by SYSTEM<br />
<br />
$ net start imapd<br />
The CYGWIN imapd service is starting.<br />
The CYGWIN imapd service could not be started. <br />
<br />
The service did not report an error.<br />
<br />
More help is available by typing NET HELPMSG 3534.<br />
<br />
* The combination of background sleep and builtin wait command is used to make the waiting statment interruptible. The original script found on the net, was simply using a 'sleep 1' which turned to consume ~10% of the CPU.<br />
<br />
=Maildir=<br />
'''maildirmake''' is part of the courier-imap package<br />
<br />
$ /usr/lib/courier-imap/bin/maildirmake<br />
<br />
=Mairix - index and search mail folders=<br />
Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install the package mairix.<br />
<br />
Create the configuration file in your home directory: ~/.mairixrc<br />
<br />
base=/home/username<br />
maildir=Maildir...<br />
omit=Maildir/.Mairix**<br />
mfolder=Maildir/.Mairix<br />
database=/home/username/.mairix_database<br />
<br />
The create the mairix index<br />
<br />
$ mairix<br />
and<br />
$ mairix --fast-index # on daily base<br />
<br />
See [[Mail_Tips]] for additional details.<br />
<br />
=Offlineimap=<br />
Requires python, so run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install the package python.<br />
<br />
Download offlineimap [http://software.complete.org/software/projects/list_files/offlineimap here]. I use [http://software.complete.org/software/versions/download/242?attachment_id=334 version 6.0.3]. Extract files in you favorite sandbox.<br />
<br />
$ tar xvfz offlineimap_6.0.3.tar.gz<br />
$ cd offlineimap<br />
<br />
Apply the following [{{#file:offlineimap_6.0.3-cygwin.patch}} patch] to correct the following issues:<br />
<br />
* [http://en.wikipedia.org/wiki/Maildir#Windows_software Suffix separator character] (:) is not allowed in Windows. Courier-imap for cygwin is using (!)<br />
* While used by courier-imap for cygwin Maildir mail files should not use CRLF, rather only LF. The issue appears only in mail with attachment.<br />
<br />
<source lang=diff><br />
--- offlineimap/folder/Maildir.py 2008-11-01 20:49:30.843750000 +0100<br />
+++ offlineimap/folder/Maildir-cygwin.py 2008-11-03 22:54:51.437500000 +0100<br />
@@ -23,7 +23,7 @@<br />
import os.path, os, re, time, socket, md5<br />
<br />
uidmatchre = re.compile(',U=(\d+)')<br />
-flagmatchre = re.compile(':.*2,([A-Z]+)')<br />
+flagmatchre = re.compile('!.*2,([A-Z]+)')<br />
<br />
timeseq = 0<br />
lasttime = long(0)<br />
@@ -180,7 +180,7 @@<br />
break<br />
tmpmessagename = messagename.split(',')[0]<br />
ui.debug('maildir', 'savemessage: using temporary name %s' % tmpmessagename)<br />
- file = open(os.path.join(tmpdir, tmpmessagename), "wt")<br />
+ file = open(os.path.join(tmpdir, tmpmessagename), "wb")<br />
file.write(content)<br />
<br />
# Make sure the data hits the disk<br />
@@ -226,11 +226,11 @@<br />
newpath = os.path.join(self.getfullname(), 'cur')<br />
else:<br />
newpath = os.path.join(self.getfullname(), 'new')<br />
- infostr = ':'<br />
- infomatch = re.search('(:.*)$', newname)<br />
+ infostr = '!'<br />
+ infomatch = re.search('(!.*)$', newname)<br />
if infomatch: # If the info string is present..<br />
infostr = infomatch.group(1)<br />
- newname = newname.split(':')[0] # Strip off the info string.<br />
+ newname = newname.split('!')[0] # Strip off the info string.<br />
infostr = re.sub('2,[A-Z]*', '', infostr)<br />
flags.sort()<br />
infostr += '2,' + ''.join(flags)<br />
</source><br />
<br />
$ cd offlineimap/folder<br />
$ patch -Np2 < ../../offlineimap-cygwin_6.0.3.patch<br />
$ cd ../..<br />
<br />
Install offlineimap<br />
<br />
$ python setup.py install<br />
<br />
Configure offlineimap as described in [[Offlineimap]] and launch offlineimap<br />
<br />
$ offlineimap<br />
or<br />
$ offlineimap -1 -o -u Noninteractive.Basic<br />
or<br />
$ offlineimap -c /home/username/offlineimap.conf</div>Twalranthttps://wiki.yobi.be/index.php?title=Courier-Cygwin&diff=5276Courier-Cygwin2008-11-04T08:45:29Z<p>Twalrant: /* Offlineimap */</p>
<hr />
<div>=Pre-requisite=<br />
<br />
Courier-IMAP requires the installation of the [http://www.courier-mta.org/authlib/ Courier Authentication Library] and the following cygwin tools and packages<br />
<br />
* patch, tar, make, gcc<br />
* crypt<br />
* libgdbm-devel<br />
* libtool<br />
* inetutils<br />
* cygrunsrv<br />
<br />
Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install the required packages.<br />
<br />
=Courier Authentication Library=<br />
<br />
Installation of Courier Authentication Library using the module userdb to manage mail accounts. All other modules are disabled.<br />
<br />
==Compilation and installation==<br />
<br />
Download and untar [http://www.courier-mta.org/download.php#authlib courier-authlib] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-authlib-0.61.0.tar.bz2 0.61.0]<br />
<br />
Apply the [{{#file:courrier-authlib-0.61.0-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# add libtool flag (-no-undefined) required for DLL creation<br />
# add missing dependencies<br />
# add PATH in start script to access new DLL (installed in a different directory)<br />
<br />
Solution source: http://lists.cairographics.org/archives/cairo/2004-April/001125.html<br />
<br />
<source lang=diff><br />
--- courier-authlib-0.61.0/makedat/Makefile.in 2008-05-24 16:21:09.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/makedat/Makefile.in 2008-10-21 16:02:38.709166700 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-authlib-0.61.0/Makefile.in 2008-07-12 21:41:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/Makefile.in 2008-10-23 22:59:03.843750000 +0200<br />
@@ -213,9 +213,10 @@<br />
LTCOMPILE = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
--mode=compile $(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) \<br />
$(AM_CPPFLAGS) $(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS)<br />
-CCLD = $(CC)<br />
+CCLD = $(CC) -no-undefined<br />
+CCLDEXE = $(CC)<br />
LINK = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
- --mode=link $(CCLD) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
+ --mode=link $(CCLDEXE) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
$(LDFLAGS) -o $@<br />
SOURCES = $(libauthcustom_la_SOURCES) $(libauthldap_la_SOURCES) \<br />
$(libauthmysql_la_SOURCES) $(libauthpam_la_SOURCES) \<br />
@@ -452,9 +453,9 @@<br />
README.authdebug.html<br />
<br />
DISTCLEANFILES = dbobj.config README_authlib.html<br />
-commonlibdep = libcourierauthcommon.la<br />
+commonlibdep = libcourierauthcommon.la libcourierauth.la<br />
commonldflags = -module -rpath $(pkglibdir) -export-symbols-regex 'courier_auth.*_init' -avoid-version<br />
-commonlibadd = libcourierauthcommon.la<br />
+commonlibadd = libcourierauthcommon.la libcourierauth.la<br />
libcourierauthcommon_t = @CRYPTLIBS@<br />
libcourierauthcommon_la_SOURCES = \<br />
auth.h courierauth.h \<br />
--- courier-authlib-0.61.0/authdaemond.in 2005-07-05 14:25:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/authdaemond.in 2008-10-25 12:03:32.140625000 +0200<br />
@@ -15,4 +15,10 @@<br />
set -a<br />
. @authdaemonrc@<br />
<br />
+# Some shared libraries (DLL) are installed in @libdir@/bin<br />
+# instead of @libdir@/@PACKAGE@<br />
+# Setting LD_LIBRARY_PATH at runtime or LR_RUN_PATH at linktime doesn't<br />
+# work in cygwin, only setting PATH works. <br />
+export PATH=$PATH:@libdir@/bin<br />
+<br />
exec ${sbindir}/courierlogger -pid=@authdaemonvar@/pid $LOGGEROPTS -$1 @libexecdir@/courier-authlib/authdaemond<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-authlib-0.61.0-cygwin.patch<br />
<br />
Configure the package without most authentication modules, keeping only ''userdb''.<br />
<br />
'''Note''': replace ''mailuser'' by an existing user name (in your /etc/passwd file). I used my own username.<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait --without-authpam --without-authldap --without-authpwd \<br />
--without-authshadow --without-authcustom --without-authpipe --without-authmysql --without-authpgsql --with-mailuser=mailuser \<br />
--with-mailgroup=mkgroup-l-d<br />
<br />
Take a long pause... and when ready execute the following command.<br />
<br />
$ make<br />
<br />
Take again a long pause... then check the result and install the libraries<br />
<br />
$ make check<br />
$ make install<br />
<br />
'''NOTES''': list of related topics found during investigation for compilation<br />
* authldap: configure: error: -lresolve is needed for res_query... http://www.cygwin.com/ml/cygwin/2005-04/msg00419.html<br />
<br />
==Configuration==<br />
<br />
Create authdaemonrc file: /usr/local/etc/authlib/authdaemonrc<br />
<br />
$ cp /usr/local/etc/authlib/authdaemonrc.dist /usr/local/etc/authlib/authdaemonrc<br />
<br />
Change number of daemons (I use three) and enable DEBUG_LOGIN<br />
<br />
<source lang=text><br />
# The number of daemon processes that are started.<br />
daemons=3<br />
<br />
# DEBUG_LOGIN=2 - turn on debugging + log passwords too<br />
DEBUG_LOGIN=2<br />
</source><br />
<br />
See http://www.courier-mta.org/authlib/README.authdebug.html for details.<br />
<br />
==IMAP accounts==<br />
<br />
User accounts and settings are managed by ''userdb''. See [http://linux.die.net/man/8/makeuserdb makeuserdb] man page for details, or used the freshly new install man page - man makeuserdb<br />
<br />
Assuming ''username'' is your username, 1001 and 10545 are respectively the UID and GID of an existing user (part of your /etc/passwd and /etc/group). I use my own UID and GID. Create the mailuser home directory, if required, and create Maildir folder.<br />
<br />
$ mkdir -p /home/username<br />
$ cd /home/username<br />
$ /usr/lib/courier-imap/bin/maildirmake Maildir<br />
<br />
Create the userdb text file /usr/local/etc/authlib/userdb<br />
<br />
$ touch /usr/local/etc/authlib/userdb<br />
$ chmod 700 /usr/local/etc/authlib/userdb<br />
<br />
Edit /usr/local/etc/authlib/userdb, one line per account<br />
<br />
<source lang=text><br />
username[TAB]uid=1001|gid=10111|home=/home/username|mail=/home/username/Maildir|systempw=XXXXXX<br />
</source><br />
<br />
where XXXXXX is the encrypted password created with<br />
<br />
$ /usr/local/sbin/userdbpw.exe<br />
<br />
Create the (binary) userdb<br />
<br />
$ /usr/local/sbin/makeuserdb<br />
<br />
You should now have the following files created:<br />
<br />
* /usr/local/etc/authlib/userdb.dat<br />
* /usr/local/etc/authlib/userdbshadow.dat<br />
<br />
==Running==<br />
<br />
Install and configure syslogd. Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install inetutils (contains syslogd). Configure syslogd with the following command. It will create the /etc/syslogd.conf file and install a windows service using cygrunsrv<br />
<br />
$ syslogd-config<br />
<br />
Start the authlib daemon with the following command:<br />
<br />
$ /usr/local/sbin/authdaemon start<br />
<br />
Stop the daemon with the following command:<br />
<br />
$ /usr/local/sbin/authdaemon stop<br />
<br />
You'll find log messages in /var/log/messages (default target file as specified in /etc/syslogd.conf)<br />
<br />
==Testing authlib==<br />
<br />
$ /usr/local/sbin/authtest username CCCCCC<br />
Authentication succeeded.<br />
<br />
Authenticated: username (uid 1001, gid 10545)<br />
Home Directory: /home/username<br />
Maildir: /home/username/Maildir<br />
Quota: (none)<br />
Encrypted Password: XXXXXX<br />
Cleartext Password: CCCCCC<br />
Options: (none)<br />
<br />
where username is your user name and XXXXXX is your encrypted password as provided in ''/usr/local/etc/authlib/userdb''. CCCCCC is your password in clear.<br />
<br />
==Troubleshooting==<br />
<br />
Should you have a doubt on the execution of a command (ie: no output) you can check if the application is able to load required DLL. This error is not reported. Using ''strace'', windows will complain about DLL not found, if any. To solve this problem you may need to add some path in your PATH. For example, in order to test authlib with authtest:<br />
<br />
$ strace /usr/local/sbin/authtest<br />
# This will open a dialog box to complain about DLL.<br />
$ export PATH=$PATH:/usr/local/lib/bin<br />
$ /usr/local/sbin/authtest ausername<br />
<br />
==Courier Authentication Config==<br />
<br />
$ /usr/local/bin/courierauthconfig.exe --version<br />
$ /usr/local/bin/courierauthconfig.exe --ldflags<br />
$ /usr/local/bin/courierauthconfig.exe --cppflags<br />
$ /usr/local/bin/courierauthconfig.exe --configfiles<br />
<br />
=Courier-IMAP=<br />
==Compilation and installation==<br />
<br />
Download and untar package [http://www.courier-mta.org/download.php#imap courier-imap] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-imap-4.4.1.tar.bz2 4.4.1.20080920]<br />
<br />
Apply the [{{#file:courrier-imap-4.4.1-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# incorrect usage of EXTEXT in main ''Makefile''<br />
# remove usage of /usr/lib/env in start/stop script (/usr/lib/env does not seem to work under Cygwin)<br />
<br />
<source lang=diff><br />
--- courier-imap-4.4.1.20080920/makedat/Makefile.in 2008-08-24 19:52:51.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/makedat/Makefile.in 2008-10-21 20:43:27.500000000 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-imap-4.4.1.20080920/Makefile.in 2008-09-20 14:48:46.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/Makefile.in 2008-10-21 20:59:45.156250000 +0200<br />
@@ -247,9 +247,9 @@<br />
CLEANFILES = $(databin_SCRIPTS) $(man_MANS) $(sysconf_DATA) $(sbin_SCRIPTS)<br />
databindir = $(datadir)<br />
databin_SCRIPTS = mkimapdcert mkpop3dcert<br />
-binPROGRAMS = imapd pop3d maildirmake maildiracl deliverquota maildirkw<br />
-sbinPROGRAMS = imaplogin pop3login<br />
-libexecPROGRAMS = makedatprog couriertcpd<br />
+binPROGRAMS = imapd$(EXEEXT) pop3d$(EXEEXT) maildirmake$(EXEEXT) maildiracl$(EXEEXT) deliverquota$(EXEEXT) maildirkw$(EXEEXT)<br />
+sbinPROGRAMS = imaplogin$(EXEEXT) pop3login$(EXEEXT)<br />
+libexecPROGRAMS = makedatprog$(EXEEXT) couriertcpd$(EXEEXT)<br />
bin_PROGRAMS = @binPROGRAMS_exec@<br />
sbin_PROGRAMS = @sbinPROGRAMS_exec@<br />
libexec_PROGRAMS = @libexecPROGRAMS_exec@<br />
--- courier-imap-4.4.1.20080920/imapd.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/imapd.rc.in 2008-10-26 10:17:51.359375000 +0100<br />
@@ -22,6 +22,15 @@<br />
exit 1<br />
fi<br />
<br />
+# Location for some shared libraries (cygcourierauth*.dll) from authlib<br />
+AUTHLIBDIR=/usr/local<br />
+if test ! -f $AUTHLIBDIR/lib/bin/cygcourierauth.dll<br />
+then<br />
+ echo "$AUTHLIBDIR/lib/bin/cygcourierauth.dll not found."<br />
+ exit 1<br />
+fi<br />
+export PATH=$PATH:$AUTHLIBDIR/lib/bin<br />
+<br />
TLS_CACHEFILE=""<br />
. @sysconfdir@/imapd-ssl<br />
. @sysconfdir@/imapd<br />
@@ -35,7 +44,7 @@<br />
<br />
umask $IMAP_UMASK<br />
@ULIMIT@ $IMAP_ULIMITD<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
--- courier-imap-4.4.1.20080920/pop3d.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/pop3d.rc.in 2008-10-26 10:18:02.187500000 +0100<br />
@@ -22,12 +22,21 @@<br />
exit 1<br />
fi<br />
<br />
+# Location for some shared libraries (cygcourierauth*.dll) from authlib<br />
+AUTHLIBDIR=/usr/local<br />
+if test ! -f $AUTHLIBDIR/lib/bin/cygcourierauth.dll<br />
+then<br />
+ echo "$AUTHLIBDIR/lib/bin/cygcourierauth.dll not found."<br />
+ exit 1<br />
+fi<br />
+export PATH=$PATH:$AUTHLIBDIR/lib/bin<br />
+<br />
. @sysconfdir@/pop3d-ssl<br />
. @sysconfdir@/pop3d<br />
<br />
case $1 in<br />
start)<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-imap-4.4.1-cygwin.patch<br />
<br />
Configure the package<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait<br />
<br />
Take a walk... and when ready execute the following command to build the package.<br />
<br />
$ make<br />
<br />
Time to go for some coffee... and then install the package with the usual<br />
<br />
$ make install<br />
$ make install-configure<br />
<br />
==Configuration==<br />
<br />
Setup courier-imap: $prefix/etc/imapd (where $prefix=/usr/lib/courier-imap)<br />
<br />
Set ADDRESS to a valid value (0 or 127.0.0.1) and change IMAP_ULIMITD to a value accepted by the command ulimit. I simply used the existing value returned by<br />
<br />
$ ulimit -v<br />
<br />
==Running==<br />
<br />
Syslogd service and authdaemond should be started. See above.<br />
<br />
Start the imap daemon with the following command:<br />
<br />
$ /usr/lib/courier-imap/libexec/imapd.rc start<br />
<br />
Stop the daemon with the following command:<br />
<br />
$ /usr/lib/courier-imap/libexec/imapd.rc stop<br />
<br />
You'll find log messages in /var/log/messages (default target file as specified in /etc/syslogd.conf)<br />
<br />
==Testing==<br />
When authdaemond and imapd are running you can do a simple login test:<br />
<br />
$ telnet localhost 143<br />
<br />
and type the login command<br />
<br />
a login <username> <password><br />
<br />
the server should reply<br />
<br />
a OK LOGIN Ok.<br />
<br />
to which you can reply with a logout<br />
<br />
a logout<br />
<br />
the session is terminated by the server<br />
<br />
* BYE Courier-IMAP server shutting down<br />
a OK LOGOUT completed<br />
Connection closed by foreign host.<br />
<br />
'''Hint:''' if the connection is immediately closed by foreign host it probably means that ''imapd'' does not have access to all required DLLs. Check your PATH.<br />
<br />
==All in one==<br />
If everything works fine you can use the following [{{#file:imapd}} startup script] to launch or stop imap and authlib daemons. It can be saved in /usr/local/sbin.<br />
<br />
<source lang=bash><br />
#! /bin/sh<br />
#<br />
# Courier imap daemon startup script.<br />
<br />
authlib=/usr/local/sbin/authdaemond<br />
imapd=/usr/lib/courier-imap/libexec/imapd.rc<br />
<br />
test ! -f $authlib && echo "File not found: $authlib" && exit 1;<br />
test ! -f $imapd && echo "File not found: $imapd" && exit 1;<br />
<br />
case $1 in<br />
start)<br />
$authlib start<br />
$imapd start<br />
;;<br />
stop)<br />
$imapd stop<br />
$authlib stop<br />
;;<br />
*)<br />
echo "Usage: $0 <start|stop>"<br />
;;<br />
esac<br />
</source><br />
<br />
==Cygwin service==<br />
Create the [{{#file:imapd-srv.sh}} service script]<br />
<br />
<source lang=bash><br />
#!/bin/sh<br />
# File: imapd-service.sh<br />
# Purpose: Courier imap daemon service script.<br />
#<br />
# NOTE: This script must be excutable by SYSTEM<br />
username=username # <<<< Change me !!!<br />
pidsleep=''<br />
<br />
# Function to handle QUIT signal.<br />
# Stop imapd daemon and kill background sleep.<br />
function handleQuit<br />
{<br />
echo "STOPPING: /usr/local/sbin/imapd"<br />
su $username -c "/usr/local/sbin/imapd stop"<br />
test -n "$pidsleep" && kill -9 $pidsleep<br />
exit<br />
}<br />
<br />
# Interruptible sleep<br />
# Note: sleep is an external command (not builtin command), hence<br />
# not interruptible by the QUIT signal.<br />
function intsleep<br />
{<br />
sleep $1 &<br />
pidsleep=$!<br />
wait $pidsleep<br />
}<br />
<br />
echo "STARTING: /usr/local/sbin/imapd as $username at "`date`<br />
su $username -c "/usr/local/sbin/imapd start"<br />
<br />
trap "handleQuit" SIGQUIT<br />
<br />
echo "WAITING: "$$<br />
while true; do intsleep 1d; done<br />
</source><br />
<br />
Change username and save it to your favorite location, says /usr/local/sbin. The service script must be executable by SYSTEM, ie: the user that run the windows services.<br />
<br />
$ chmod +rx /usr/local/sbin/imapd-service.sh<br />
<br />
Install the new service with the following command.<br />
<br />
$ cygrunsrv --install imapd --desc "Courier IMAP daemon" --disp "CYGWIN imapd" \<br />
--path /usr/local/sbin/imapd-service.sh --termsig QUIT --type auto --shutdown<br />
<br />
Finally, just start the service<br />
<br />
$ cygrunsrv --start imapd<br />
or<br />
$ net start imapd<br />
<br />
You should now have couple of processes related to courier-imap<br />
<br />
$ ps -a<br />
<br />
'''NOTES''':<br />
* If the service could not be started, it's probably because the service script is not executable by SYSTEM<br />
<br />
$ net start imapd<br />
The CYGWIN imapd service is starting.<br />
The CYGWIN imapd service could not be started. <br />
<br />
The service did not report an error.<br />
<br />
More help is available by typing NET HELPMSG 3534.<br />
<br />
* The combination of background sleep and builtin wait command is used to make the waiting statment interruptible. The original script found on the net, was simply using a 'sleep 1' which turned to consume ~10% of the CPU.<br />
<br />
=Maildir=<br />
'''maildirmake''' is part of the courier-imap package<br />
<br />
$ /usr/lib/courier-imap/bin/maildirmake<br />
<br />
=Mairix - index and search mail folders=<br />
Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install the package mairix.<br />
<br />
Create the configuration file in your home directory: ~/.mairixrc<br />
<br />
base=/home/username<br />
maildir=Maildir...<br />
omit=Maildir/.Mairix**<br />
mfolder=Maildir/.Mairix<br />
database=/home/username/.mairix_database<br />
<br />
The create the mairix index<br />
<br />
$ mairix<br />
and<br />
$ mairix --fast-index # on daily base<br />
<br />
See [[Mail_Tips]] for additional details.<br />
<br />
=Offlineimap=<br />
Requires python, so run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install the package python.<br />
<br />
Download offlineimap [http://software.complete.org/software/projects/list_files/offlineimap here]. I use [http://software.complete.org/software/versions/download/242?attachment_id=334 version 6.0.3]. Extract files in you favorite sandbox.<br />
<br />
$ tar xvfz offlineimap_6.0.3.tar.gz<br />
$ cd offlineimap<br />
<br />
Apply the following [{{#file:offlineimap_6.0.3-cygwin.patch}} patch] to correct the following issues:<br />
<br />
* [http://en.wikipedia.org/wiki/Maildir#Windows_software Suffix separator character] (:) is not allowed in Windows. Courier-imap for cygwin is using (!)<br />
* While used by courier-imap for cygwin Maildir mail files should not use CRLF, rather only LF. The issue appears only in mail with attachment.<br />
<br />
<source lang=diff><br />
--- offlineimap/folder/Maildir.py 2008-11-01 20:49:30.843750000 +0100<br />
+++ offlineimap/folder/Maildir-cygwin.py 2008-11-03 22:54:51.437500000 +0100<br />
@@ -23,7 +23,7 @@<br />
import os.path, os, re, time, socket, md5<br />
<br />
uidmatchre = re.compile(',U=(\d+)')<br />
-flagmatchre = re.compile(':.*2,([A-Z]+)')<br />
+flagmatchre = re.compile('!.*2,([A-Z]+)')<br />
<br />
timeseq = 0<br />
lasttime = long(0)<br />
@@ -180,7 +180,7 @@<br />
break<br />
tmpmessagename = messagename.split(',')[0]<br />
ui.debug('maildir', 'savemessage: using temporary name %s' % tmpmessagename)<br />
- file = open(os.path.join(tmpdir, tmpmessagename), "wt")<br />
+ file = open(os.path.join(tmpdir, tmpmessagename), "wb")<br />
file.write(content)<br />
<br />
# Make sure the data hits the disk<br />
@@ -226,11 +226,11 @@<br />
newpath = os.path.join(self.getfullname(), 'cur')<br />
else:<br />
newpath = os.path.join(self.getfullname(), 'new')<br />
- infostr = ':'<br />
- infomatch = re.search('(:.*)$', newname)<br />
+ infostr = '!'<br />
+ infomatch = re.search('(!.*)$', newname)<br />
if infomatch: # If the info string is present..<br />
infostr = infomatch.group(1)<br />
- newname = newname.split(':')[0] # Strip off the info string.<br />
+ newname = newname.split('!')[0] # Strip off the info string.<br />
infostr = re.sub('2,[A-Z]*', '', infostr)<br />
flags.sort()<br />
infostr += '2,' + ''.join(flags)<br />
</source><br />
<br />
$ cd offlineimap/folder<br />
$ patch -Np2 < ../../offlineimap-cygwin_6.0.3.patch<br />
$ cd ../..<br />
<br />
Install offlineimap<br />
<br />
$ python setup.py install<br />
<br />
Configure offlineimap as described in [[Offlineimap]]</div>Twalranthttps://wiki.yobi.be/index.php?title=Courier-Cygwin&diff=5275Courier-Cygwin2008-11-04T08:42:29Z<p>Twalrant: /* Mairix - index and search mail folders */</p>
<hr />
<div>=Pre-requisite=<br />
<br />
Courier-IMAP requires the installation of the [http://www.courier-mta.org/authlib/ Courier Authentication Library] and the following cygwin tools and packages<br />
<br />
* patch, tar, make, gcc<br />
* crypt<br />
* libgdbm-devel<br />
* libtool<br />
* inetutils<br />
* cygrunsrv<br />
<br />
Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install the required packages.<br />
<br />
=Courier Authentication Library=<br />
<br />
Installation of Courier Authentication Library using the module userdb to manage mail accounts. All other modules are disabled.<br />
<br />
==Compilation and installation==<br />
<br />
Download and untar [http://www.courier-mta.org/download.php#authlib courier-authlib] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-authlib-0.61.0.tar.bz2 0.61.0]<br />
<br />
Apply the [{{#file:courrier-authlib-0.61.0-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# add libtool flag (-no-undefined) required for DLL creation<br />
# add missing dependencies<br />
# add PATH in start script to access new DLL (installed in a different directory)<br />
<br />
Solution source: http://lists.cairographics.org/archives/cairo/2004-April/001125.html<br />
<br />
<source lang=diff><br />
--- courier-authlib-0.61.0/makedat/Makefile.in 2008-05-24 16:21:09.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/makedat/Makefile.in 2008-10-21 16:02:38.709166700 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-authlib-0.61.0/Makefile.in 2008-07-12 21:41:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/Makefile.in 2008-10-23 22:59:03.843750000 +0200<br />
@@ -213,9 +213,10 @@<br />
LTCOMPILE = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
--mode=compile $(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) \<br />
$(AM_CPPFLAGS) $(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS)<br />
-CCLD = $(CC)<br />
+CCLD = $(CC) -no-undefined<br />
+CCLDEXE = $(CC)<br />
LINK = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
- --mode=link $(CCLD) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
+ --mode=link $(CCLDEXE) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
$(LDFLAGS) -o $@<br />
SOURCES = $(libauthcustom_la_SOURCES) $(libauthldap_la_SOURCES) \<br />
$(libauthmysql_la_SOURCES) $(libauthpam_la_SOURCES) \<br />
@@ -452,9 +453,9 @@<br />
README.authdebug.html<br />
<br />
DISTCLEANFILES = dbobj.config README_authlib.html<br />
-commonlibdep = libcourierauthcommon.la<br />
+commonlibdep = libcourierauthcommon.la libcourierauth.la<br />
commonldflags = -module -rpath $(pkglibdir) -export-symbols-regex 'courier_auth.*_init' -avoid-version<br />
-commonlibadd = libcourierauthcommon.la<br />
+commonlibadd = libcourierauthcommon.la libcourierauth.la<br />
libcourierauthcommon_t = @CRYPTLIBS@<br />
libcourierauthcommon_la_SOURCES = \<br />
auth.h courierauth.h \<br />
--- courier-authlib-0.61.0/authdaemond.in 2005-07-05 14:25:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/authdaemond.in 2008-10-25 12:03:32.140625000 +0200<br />
@@ -15,4 +15,10 @@<br />
set -a<br />
. @authdaemonrc@<br />
<br />
+# Some shared libraries (DLL) are installed in @libdir@/bin<br />
+# instead of @libdir@/@PACKAGE@<br />
+# Setting LD_LIBRARY_PATH at runtime or LR_RUN_PATH at linktime doesn't<br />
+# work in cygwin, only setting PATH works. <br />
+export PATH=$PATH:@libdir@/bin<br />
+<br />
exec ${sbindir}/courierlogger -pid=@authdaemonvar@/pid $LOGGEROPTS -$1 @libexecdir@/courier-authlib/authdaemond<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-authlib-0.61.0-cygwin.patch<br />
<br />
Configure the package without most authentication modules, keeping only ''userdb''.<br />
<br />
'''Note''': replace ''mailuser'' by an existing user name (in your /etc/passwd file). I used my own username.<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait --without-authpam --without-authldap --without-authpwd \<br />
--without-authshadow --without-authcustom --without-authpipe --without-authmysql --without-authpgsql --with-mailuser=mailuser \<br />
--with-mailgroup=mkgroup-l-d<br />
<br />
Take a long pause... and when ready execute the following command.<br />
<br />
$ make<br />
<br />
Take again a long pause... then check the result and install the libraries<br />
<br />
$ make check<br />
$ make install<br />
<br />
'''NOTES''': list of related topics found during investigation for compilation<br />
* authldap: configure: error: -lresolve is needed for res_query... http://www.cygwin.com/ml/cygwin/2005-04/msg00419.html<br />
<br />
==Configuration==<br />
<br />
Create authdaemonrc file: /usr/local/etc/authlib/authdaemonrc<br />
<br />
$ cp /usr/local/etc/authlib/authdaemonrc.dist /usr/local/etc/authlib/authdaemonrc<br />
<br />
Change number of daemons (I use three) and enable DEBUG_LOGIN<br />
<br />
<source lang=text><br />
# The number of daemon processes that are started.<br />
daemons=3<br />
<br />
# DEBUG_LOGIN=2 - turn on debugging + log passwords too<br />
DEBUG_LOGIN=2<br />
</source><br />
<br />
See http://www.courier-mta.org/authlib/README.authdebug.html for details.<br />
<br />
==IMAP accounts==<br />
<br />
User accounts and settings are managed by ''userdb''. See [http://linux.die.net/man/8/makeuserdb makeuserdb] man page for details, or used the freshly new install man page - man makeuserdb<br />
<br />
Assuming ''username'' is your username, 1001 and 10545 are respectively the UID and GID of an existing user (part of your /etc/passwd and /etc/group). I use my own UID and GID. Create the mailuser home directory, if required, and create Maildir folder.<br />
<br />
$ mkdir -p /home/username<br />
$ cd /home/username<br />
$ /usr/lib/courier-imap/bin/maildirmake Maildir<br />
<br />
Create the userdb text file /usr/local/etc/authlib/userdb<br />
<br />
$ touch /usr/local/etc/authlib/userdb<br />
$ chmod 700 /usr/local/etc/authlib/userdb<br />
<br />
Edit /usr/local/etc/authlib/userdb, one line per account<br />
<br />
<source lang=text><br />
username[TAB]uid=1001|gid=10111|home=/home/username|mail=/home/username/Maildir|systempw=XXXXXX<br />
</source><br />
<br />
where XXXXXX is the encrypted password created with<br />
<br />
$ /usr/local/sbin/userdbpw.exe<br />
<br />
Create the (binary) userdb<br />
<br />
$ /usr/local/sbin/makeuserdb<br />
<br />
You should now have the following files created:<br />
<br />
* /usr/local/etc/authlib/userdb.dat<br />
* /usr/local/etc/authlib/userdbshadow.dat<br />
<br />
==Running==<br />
<br />
Install and configure syslogd. Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install inetutils (contains syslogd). Configure syslogd with the following command. It will create the /etc/syslogd.conf file and install a windows service using cygrunsrv<br />
<br />
$ syslogd-config<br />
<br />
Start the authlib daemon with the following command:<br />
<br />
$ /usr/local/sbin/authdaemon start<br />
<br />
Stop the daemon with the following command:<br />
<br />
$ /usr/local/sbin/authdaemon stop<br />
<br />
You'll find log messages in /var/log/messages (default target file as specified in /etc/syslogd.conf)<br />
<br />
==Testing authlib==<br />
<br />
$ /usr/local/sbin/authtest username CCCCCC<br />
Authentication succeeded.<br />
<br />
Authenticated: username (uid 1001, gid 10545)<br />
Home Directory: /home/username<br />
Maildir: /home/username/Maildir<br />
Quota: (none)<br />
Encrypted Password: XXXXXX<br />
Cleartext Password: CCCCCC<br />
Options: (none)<br />
<br />
where username is your user name and XXXXXX is your encrypted password as provided in ''/usr/local/etc/authlib/userdb''. CCCCCC is your password in clear.<br />
<br />
==Troubleshooting==<br />
<br />
Should you have a doubt on the execution of a command (ie: no output) you can check if the application is able to load required DLL. This error is not reported. Using ''strace'', windows will complain about DLL not found, if any. To solve this problem you may need to add some path in your PATH. For example, in order to test authlib with authtest:<br />
<br />
$ strace /usr/local/sbin/authtest<br />
# This will open a dialog box to complain about DLL.<br />
$ export PATH=$PATH:/usr/local/lib/bin<br />
$ /usr/local/sbin/authtest ausername<br />
<br />
==Courier Authentication Config==<br />
<br />
$ /usr/local/bin/courierauthconfig.exe --version<br />
$ /usr/local/bin/courierauthconfig.exe --ldflags<br />
$ /usr/local/bin/courierauthconfig.exe --cppflags<br />
$ /usr/local/bin/courierauthconfig.exe --configfiles<br />
<br />
=Courier-IMAP=<br />
==Compilation and installation==<br />
<br />
Download and untar package [http://www.courier-mta.org/download.php#imap courier-imap] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-imap-4.4.1.tar.bz2 4.4.1.20080920]<br />
<br />
Apply the [{{#file:courrier-imap-4.4.1-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# incorrect usage of EXTEXT in main ''Makefile''<br />
# remove usage of /usr/lib/env in start/stop script (/usr/lib/env does not seem to work under Cygwin)<br />
<br />
<source lang=diff><br />
--- courier-imap-4.4.1.20080920/makedat/Makefile.in 2008-08-24 19:52:51.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/makedat/Makefile.in 2008-10-21 20:43:27.500000000 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-imap-4.4.1.20080920/Makefile.in 2008-09-20 14:48:46.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/Makefile.in 2008-10-21 20:59:45.156250000 +0200<br />
@@ -247,9 +247,9 @@<br />
CLEANFILES = $(databin_SCRIPTS) $(man_MANS) $(sysconf_DATA) $(sbin_SCRIPTS)<br />
databindir = $(datadir)<br />
databin_SCRIPTS = mkimapdcert mkpop3dcert<br />
-binPROGRAMS = imapd pop3d maildirmake maildiracl deliverquota maildirkw<br />
-sbinPROGRAMS = imaplogin pop3login<br />
-libexecPROGRAMS = makedatprog couriertcpd<br />
+binPROGRAMS = imapd$(EXEEXT) pop3d$(EXEEXT) maildirmake$(EXEEXT) maildiracl$(EXEEXT) deliverquota$(EXEEXT) maildirkw$(EXEEXT)<br />
+sbinPROGRAMS = imaplogin$(EXEEXT) pop3login$(EXEEXT)<br />
+libexecPROGRAMS = makedatprog$(EXEEXT) couriertcpd$(EXEEXT)<br />
bin_PROGRAMS = @binPROGRAMS_exec@<br />
sbin_PROGRAMS = @sbinPROGRAMS_exec@<br />
libexec_PROGRAMS = @libexecPROGRAMS_exec@<br />
--- courier-imap-4.4.1.20080920/imapd.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/imapd.rc.in 2008-10-26 10:17:51.359375000 +0100<br />
@@ -22,6 +22,15 @@<br />
exit 1<br />
fi<br />
<br />
+# Location for some shared libraries (cygcourierauth*.dll) from authlib<br />
+AUTHLIBDIR=/usr/local<br />
+if test ! -f $AUTHLIBDIR/lib/bin/cygcourierauth.dll<br />
+then<br />
+ echo "$AUTHLIBDIR/lib/bin/cygcourierauth.dll not found."<br />
+ exit 1<br />
+fi<br />
+export PATH=$PATH:$AUTHLIBDIR/lib/bin<br />
+<br />
TLS_CACHEFILE=""<br />
. @sysconfdir@/imapd-ssl<br />
. @sysconfdir@/imapd<br />
@@ -35,7 +44,7 @@<br />
<br />
umask $IMAP_UMASK<br />
@ULIMIT@ $IMAP_ULIMITD<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
--- courier-imap-4.4.1.20080920/pop3d.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/pop3d.rc.in 2008-10-26 10:18:02.187500000 +0100<br />
@@ -22,12 +22,21 @@<br />
exit 1<br />
fi<br />
<br />
+# Location for some shared libraries (cygcourierauth*.dll) from authlib<br />
+AUTHLIBDIR=/usr/local<br />
+if test ! -f $AUTHLIBDIR/lib/bin/cygcourierauth.dll<br />
+then<br />
+ echo "$AUTHLIBDIR/lib/bin/cygcourierauth.dll not found."<br />
+ exit 1<br />
+fi<br />
+export PATH=$PATH:$AUTHLIBDIR/lib/bin<br />
+<br />
. @sysconfdir@/pop3d-ssl<br />
. @sysconfdir@/pop3d<br />
<br />
case $1 in<br />
start)<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-imap-4.4.1-cygwin.patch<br />
<br />
Configure the package<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait<br />
<br />
Take a walk... and when ready execute the following command to build the package.<br />
<br />
$ make<br />
<br />
Time to go for some coffee... and then install the package with the usual<br />
<br />
$ make install<br />
$ make install-configure<br />
<br />
==Configuration==<br />
<br />
Setup courier-imap: $prefix/etc/imapd (where $prefix=/usr/lib/courier-imap)<br />
<br />
Set ADDRESS to a valid value (0 or 127.0.0.1) and change IMAP_ULIMITD to a value accepted by the command ulimit. I simply used the existing value returned by<br />
<br />
$ ulimit -v<br />
<br />
==Running==<br />
<br />
Syslogd service and authdaemond should be started. See above.<br />
<br />
Start the imap daemon with the following command:<br />
<br />
$ /usr/lib/courier-imap/libexec/imapd.rc start<br />
<br />
Stop the daemon with the following command:<br />
<br />
$ /usr/lib/courier-imap/libexec/imapd.rc stop<br />
<br />
You'll find log messages in /var/log/messages (default target file as specified in /etc/syslogd.conf)<br />
<br />
==Testing==<br />
When authdaemond and imapd are running you can do a simple login test:<br />
<br />
$ telnet localhost 143<br />
<br />
and type the login command<br />
<br />
a login <username> <password><br />
<br />
the server should reply<br />
<br />
a OK LOGIN Ok.<br />
<br />
to which you can reply with a logout<br />
<br />
a logout<br />
<br />
the session is terminated by the server<br />
<br />
* BYE Courier-IMAP server shutting down<br />
a OK LOGOUT completed<br />
Connection closed by foreign host.<br />
<br />
'''Hint:''' if the connection is immediately closed by foreign host it probably means that ''imapd'' does not have access to all required DLLs. Check your PATH.<br />
<br />
==All in one==<br />
If everything works fine you can use the following [{{#file:imapd}} startup script] to launch or stop imap and authlib daemons. It can be saved in /usr/local/sbin.<br />
<br />
<source lang=bash><br />
#! /bin/sh<br />
#<br />
# Courier imap daemon startup script.<br />
<br />
authlib=/usr/local/sbin/authdaemond<br />
imapd=/usr/lib/courier-imap/libexec/imapd.rc<br />
<br />
test ! -f $authlib && echo "File not found: $authlib" && exit 1;<br />
test ! -f $imapd && echo "File not found: $imapd" && exit 1;<br />
<br />
case $1 in<br />
start)<br />
$authlib start<br />
$imapd start<br />
;;<br />
stop)<br />
$imapd stop<br />
$authlib stop<br />
;;<br />
*)<br />
echo "Usage: $0 <start|stop>"<br />
;;<br />
esac<br />
</source><br />
<br />
==Cygwin service==<br />
Create the [{{#file:imapd-srv.sh}} service script]<br />
<br />
<source lang=bash><br />
#!/bin/sh<br />
# File: imapd-service.sh<br />
# Purpose: Courier imap daemon service script.<br />
#<br />
# NOTE: This script must be excutable by SYSTEM<br />
username=username # <<<< Change me !!!<br />
pidsleep=''<br />
<br />
# Function to handle QUIT signal.<br />
# Stop imapd daemon and kill background sleep.<br />
function handleQuit<br />
{<br />
echo "STOPPING: /usr/local/sbin/imapd"<br />
su $username -c "/usr/local/sbin/imapd stop"<br />
test -n "$pidsleep" && kill -9 $pidsleep<br />
exit<br />
}<br />
<br />
# Interruptible sleep<br />
# Note: sleep is an external command (not builtin command), hence<br />
# not interruptible by the QUIT signal.<br />
function intsleep<br />
{<br />
sleep $1 &<br />
pidsleep=$!<br />
wait $pidsleep<br />
}<br />
<br />
echo "STARTING: /usr/local/sbin/imapd as $username at "`date`<br />
su $username -c "/usr/local/sbin/imapd start"<br />
<br />
trap "handleQuit" SIGQUIT<br />
<br />
echo "WAITING: "$$<br />
while true; do intsleep 1d; done<br />
</source><br />
<br />
Change username and save it to your favorite location, says /usr/local/sbin. The service script must be executable by SYSTEM, ie: the user that run the windows services.<br />
<br />
$ chmod +rx /usr/local/sbin/imapd-service.sh<br />
<br />
Install the new service with the following command.<br />
<br />
$ cygrunsrv --install imapd --desc "Courier IMAP daemon" --disp "CYGWIN imapd" \<br />
--path /usr/local/sbin/imapd-service.sh --termsig QUIT --type auto --shutdown<br />
<br />
Finally, just start the service<br />
<br />
$ cygrunsrv --start imapd<br />
or<br />
$ net start imapd<br />
<br />
You should now have couple of processes related to courier-imap<br />
<br />
$ ps -a<br />
<br />
'''NOTES''':<br />
* If the service could not be started, it's probably because the service script is not executable by SYSTEM<br />
<br />
$ net start imapd<br />
The CYGWIN imapd service is starting.<br />
The CYGWIN imapd service could not be started. <br />
<br />
The service did not report an error.<br />
<br />
More help is available by typing NET HELPMSG 3534.<br />
<br />
* The combination of background sleep and builtin wait command is used to make the waiting statment interruptible. The original script found on the net, was simply using a 'sleep 1' which turned to consume ~10% of the CPU.<br />
<br />
=Maildir=<br />
'''maildirmake''' is part of the courier-imap package<br />
<br />
$ /usr/lib/courier-imap/bin/maildirmake<br />
<br />
=Mairix - index and search mail folders=<br />
Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install the package mairix.<br />
<br />
Create the configuration file in your home directory: ~/.mairixrc<br />
<br />
base=/home/username<br />
maildir=Maildir...<br />
omit=Maildir/.Mairix**<br />
mfolder=Maildir/.Mairix<br />
database=/home/username/.mairix_database<br />
<br />
The create the mairix index<br />
<br />
$ mairix<br />
and<br />
$ mairix --fast-index # on daily base<br />
<br />
See [[Mail_Tips]] for additional details.<br />
<br />
=Offlineimap=<br />
Requires python, so run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install the package python.<br />
<br />
Download offlineimap [http://software.complete.org/software/projects/list_files/offlineimap here]. I use [http://software.complete.org/software/versions/download/242?attachment_id=334 version 6.0.3]. Extract files in you favorite sandbox.<br />
<br />
$ tar xvfz offlineimap_6.0.3.tar.gz<br />
$ cd offlineimap<br />
<br />
Apply the following patch to correct the following issues:<br />
<br />
* Suffix separator character (:) is not allowed in Windows. Courier-imap for cygwin is using (!)<br />
* While used by courier-imap for cygwin Maildir mail files should not use CRLF, rather only LF. The issue appears only in mail with attachment.<br />
<br />
<source lang=diff><br />
--- offlineimap/folder/Maildir.py 2008-11-01 20:49:30.843750000 +0100<br />
+++ offlineimap/folder/Maildir-cygwin.py 2008-11-03 22:54:51.437500000 +0100<br />
@@ -23,7 +23,7 @@<br />
import os.path, os, re, time, socket, md5<br />
<br />
uidmatchre = re.compile(',U=(\d+)')<br />
-flagmatchre = re.compile(':.*2,([A-Z]+)')<br />
+flagmatchre = re.compile('!.*2,([A-Z]+)')<br />
<br />
timeseq = 0<br />
lasttime = long(0)<br />
@@ -180,7 +180,7 @@<br />
break<br />
tmpmessagename = messagename.split(',')[0]<br />
ui.debug('maildir', 'savemessage: using temporary name %s' % tmpmessagename)<br />
- file = open(os.path.join(tmpdir, tmpmessagename), "wt")<br />
+ file = open(os.path.join(tmpdir, tmpmessagename), "wb")<br />
file.write(content)<br />
<br />
# Make sure the data hits the disk<br />
@@ -226,11 +226,11 @@<br />
newpath = os.path.join(self.getfullname(), 'cur')<br />
else:<br />
newpath = os.path.join(self.getfullname(), 'new')<br />
- infostr = ':'<br />
- infomatch = re.search('(:.*)$', newname)<br />
+ infostr = '!'<br />
+ infomatch = re.search('(!.*)$', newname)<br />
if infomatch: # If the info string is present..<br />
infostr = infomatch.group(1)<br />
- newname = newname.split(':')[0] # Strip off the info string.<br />
+ newname = newname.split('!')[0] # Strip off the info string.<br />
infostr = re.sub('2,[A-Z]*', '', infostr)<br />
flags.sort()<br />
infostr += '2,' + ''.join(flags)<br />
</source><br />
<br />
$ cd offlineimap/folders<br />
$ patch -Np1 < ../../offlineimap-cygwin.patch<br />
$ cd ../..<br />
<br />
Install offlineimap<br />
<br />
$ python setup.py install<br />
<br />
Configure offlineimap</div>Twalranthttps://wiki.yobi.be/index.php?title=Courier-Cygwin&diff=5273Courier-Cygwin2008-11-01T16:08:38Z<p>Twalrant: /* Mairix - index and search mail folders */</p>
<hr />
<div>=Pre-requisite=<br />
<br />
Courier-IMAP requires the installation of the [http://www.courier-mta.org/authlib/ Courier Authentication Library] and the following cygwin tools and packages<br />
<br />
* patch, tar, make, gcc<br />
* crypt<br />
* libgdbm-devel<br />
* libtool<br />
* inetutils<br />
* cygrunsrv<br />
<br />
Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install the required packages.<br />
<br />
=Courier Authentication Library=<br />
<br />
Installation of Courier Authentication Library using the module userdb to manage mail accounts. All other modules are disabled.<br />
<br />
==Compilation and installation==<br />
<br />
Download and untar [http://www.courier-mta.org/download.php#authlib courier-authlib] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-authlib-0.61.0.tar.bz2 0.61.0]<br />
<br />
Apply the [{{#file:courrier-authlib-0.61.0-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# add libtool flag (-no-undefined) required for DLL creation<br />
# add missing dependencies<br />
# add PATH in start script to access new DLL (installed in a different directory)<br />
<br />
Solution source: http://lists.cairographics.org/archives/cairo/2004-April/001125.html<br />
<br />
<source lang=diff><br />
--- courier-authlib-0.61.0/makedat/Makefile.in 2008-05-24 16:21:09.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/makedat/Makefile.in 2008-10-21 16:02:38.709166700 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-authlib-0.61.0/Makefile.in 2008-07-12 21:41:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/Makefile.in 2008-10-23 22:59:03.843750000 +0200<br />
@@ -213,9 +213,10 @@<br />
LTCOMPILE = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
--mode=compile $(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) \<br />
$(AM_CPPFLAGS) $(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS)<br />
-CCLD = $(CC)<br />
+CCLD = $(CC) -no-undefined<br />
+CCLDEXE = $(CC)<br />
LINK = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
- --mode=link $(CCLD) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
+ --mode=link $(CCLDEXE) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
$(LDFLAGS) -o $@<br />
SOURCES = $(libauthcustom_la_SOURCES) $(libauthldap_la_SOURCES) \<br />
$(libauthmysql_la_SOURCES) $(libauthpam_la_SOURCES) \<br />
@@ -452,9 +453,9 @@<br />
README.authdebug.html<br />
<br />
DISTCLEANFILES = dbobj.config README_authlib.html<br />
-commonlibdep = libcourierauthcommon.la<br />
+commonlibdep = libcourierauthcommon.la libcourierauth.la<br />
commonldflags = -module -rpath $(pkglibdir) -export-symbols-regex 'courier_auth.*_init' -avoid-version<br />
-commonlibadd = libcourierauthcommon.la<br />
+commonlibadd = libcourierauthcommon.la libcourierauth.la<br />
libcourierauthcommon_t = @CRYPTLIBS@<br />
libcourierauthcommon_la_SOURCES = \<br />
auth.h courierauth.h \<br />
--- courier-authlib-0.61.0/authdaemond.in 2005-07-05 14:25:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/authdaemond.in 2008-10-25 12:03:32.140625000 +0200<br />
@@ -15,4 +15,10 @@<br />
set -a<br />
. @authdaemonrc@<br />
<br />
+# Some shared libraries (DLL) are installed in @libdir@/bin<br />
+# instead of @libdir@/@PACKAGE@<br />
+# Setting LD_LIBRARY_PATH at runtime or LR_RUN_PATH at linktime doesn't<br />
+# work in cygwin, only setting PATH works. <br />
+export PATH=$PATH:@libdir@/bin<br />
+<br />
exec ${sbindir}/courierlogger -pid=@authdaemonvar@/pid $LOGGEROPTS -$1 @libexecdir@/courier-authlib/authdaemond<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-authlib-0.61.0-cygwin.patch<br />
<br />
Configure the package without most authentication modules, keeping only ''userdb''.<br />
<br />
'''Note''': replace ''mailuser'' by an existing user name (in your /etc/passwd file). I used my own username.<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait --without-authpam --without-authldap --without-authpwd \<br />
--without-authshadow --without-authcustom --without-authpipe --without-authmysql --without-authpgsql --with-mailuser=mailuser \<br />
--with-mailgroup=mkgroup-l-d<br />
<br />
Take a long pause... and when ready execute the following command.<br />
<br />
$ make<br />
<br />
Take again a long pause... then check the result and install the libraries<br />
<br />
$ make check<br />
$ make install<br />
<br />
'''NOTES''': list of related topics found during investigation for compilation<br />
* authldap: configure: error: -lresolve is needed for res_query... http://www.cygwin.com/ml/cygwin/2005-04/msg00419.html<br />
<br />
==Configuration==<br />
<br />
Create authdaemonrc file: /usr/local/etc/authlib/authdaemonrc<br />
<br />
$ cp /usr/local/etc/authlib/authdaemonrc.dist /usr/local/etc/authlib/authdaemonrc<br />
<br />
Change number of daemons (I use three) and enable DEBUG_LOGIN<br />
<br />
<source lang=text><br />
# The number of daemon processes that are started.<br />
daemons=3<br />
<br />
# DEBUG_LOGIN=2 - turn on debugging + log passwords too<br />
DEBUG_LOGIN=2<br />
</source><br />
<br />
See http://www.courier-mta.org/authlib/README.authdebug.html for details.<br />
<br />
==IMAP accounts==<br />
<br />
User accounts and settings are managed by ''userdb''. See [http://linux.die.net/man/8/makeuserdb makeuserdb] man page for details, or used the freshly new install man page - man makeuserdb<br />
<br />
Assuming ''username'' is your username, 1001 and 10545 are respectively the UID and GID of an existing user (part of your /etc/passwd and /etc/group). I use my own UID and GID. Create the mailuser home directory, if required, and create Maildir folder.<br />
<br />
$ mkdir -p /home/username<br />
$ cd /home/username<br />
$ /usr/lib/courier-imap/bin/maildirmake Maildir<br />
<br />
Create the userdb text file /usr/local/etc/authlib/userdb<br />
<br />
$ touch /usr/local/etc/authlib/userdb<br />
$ chmod 700 /usr/local/etc/authlib/userdb<br />
<br />
Edit /usr/local/etc/authlib/userdb, one line per account<br />
<br />
<source lang=text><br />
username[TAB]uid=1001|gid=10111|home=/home/username|mail=/home/username/Maildir|systempw=XXXXXX<br />
</source><br />
<br />
where XXXXXX is the encrypted password created with<br />
<br />
$ /usr/local/sbin/userdbpw.exe<br />
<br />
Create the (binary) userdb<br />
<br />
$ /usr/local/sbin/makeuserdb<br />
<br />
You should now have the following files created:<br />
<br />
* /usr/local/etc/authlib/userdb.dat<br />
* /usr/local/etc/authlib/userdbshadow.dat<br />
<br />
==Running==<br />
<br />
Install and configure syslogd. Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install inetutils (contains syslogd). Configure syslogd with the following command. It will create the /etc/syslogd.conf file and install a windows service using cygrunsrv<br />
<br />
$ syslogd-config<br />
<br />
Start the authlib daemon with the following command:<br />
<br />
$ /usr/local/sbin/authdaemon start<br />
<br />
Stop the daemon with the following command:<br />
<br />
$ /usr/local/sbin/authdaemon stop<br />
<br />
You'll find log messages in /var/log/messages (default target file as specified in /etc/syslogd.conf)<br />
<br />
==Testing authlib==<br />
<br />
$ /usr/local/sbin/authtest username CCCCCC<br />
Authentication succeeded.<br />
<br />
Authenticated: username (uid 1001, gid 10545)<br />
Home Directory: /home/username<br />
Maildir: /home/username/Maildir<br />
Quota: (none)<br />
Encrypted Password: XXXXXX<br />
Cleartext Password: CCCCCC<br />
Options: (none)<br />
<br />
where username is your user name and XXXXXX is your encrypted password as provided in ''/usr/local/etc/authlib/userdb''. CCCCCC is your password in clear.<br />
<br />
==Troubleshooting==<br />
<br />
Should you have a doubt on the execution of a command (ie: no output) you can check if the application is able to load required DLL. This error is not reported. Using ''strace'', windows will complain about DLL not found, if any. To solve this problem you may need to add some path in your PATH. For example, in order to test authlib with authtest:<br />
<br />
$ strace /usr/local/sbin/authtest<br />
# This will open a dialog box to complain about DLL.<br />
$ export PATH=$PATH:/usr/local/lib/bin<br />
$ /usr/local/sbin/authtest ausername<br />
<br />
==Courier Authentication Config==<br />
<br />
$ /usr/local/bin/courierauthconfig.exe --version<br />
$ /usr/local/bin/courierauthconfig.exe --ldflags<br />
$ /usr/local/bin/courierauthconfig.exe --cppflags<br />
$ /usr/local/bin/courierauthconfig.exe --configfiles<br />
<br />
=Courier-IMAP=<br />
==Compilation and installation==<br />
<br />
Download and untar package [http://www.courier-mta.org/download.php#imap courier-imap] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-imap-4.4.1.tar.bz2 4.4.1.20080920]<br />
<br />
Apply the [{{#file:courrier-imap-4.4.1-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# incorrect usage of EXTEXT in main ''Makefile''<br />
# remove usage of /usr/lib/env in start/stop script (/usr/lib/env does not seem to work under Cygwin)<br />
<br />
<source lang=diff><br />
--- courier-imap-4.4.1.20080920/makedat/Makefile.in 2008-08-24 19:52:51.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/makedat/Makefile.in 2008-10-21 20:43:27.500000000 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-imap-4.4.1.20080920/Makefile.in 2008-09-20 14:48:46.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/Makefile.in 2008-10-21 20:59:45.156250000 +0200<br />
@@ -247,9 +247,9 @@<br />
CLEANFILES = $(databin_SCRIPTS) $(man_MANS) $(sysconf_DATA) $(sbin_SCRIPTS)<br />
databindir = $(datadir)<br />
databin_SCRIPTS = mkimapdcert mkpop3dcert<br />
-binPROGRAMS = imapd pop3d maildirmake maildiracl deliverquota maildirkw<br />
-sbinPROGRAMS = imaplogin pop3login<br />
-libexecPROGRAMS = makedatprog couriertcpd<br />
+binPROGRAMS = imapd$(EXEEXT) pop3d$(EXEEXT) maildirmake$(EXEEXT) maildiracl$(EXEEXT) deliverquota$(EXEEXT) maildirkw$(EXEEXT)<br />
+sbinPROGRAMS = imaplogin$(EXEEXT) pop3login$(EXEEXT)<br />
+libexecPROGRAMS = makedatprog$(EXEEXT) couriertcpd$(EXEEXT)<br />
bin_PROGRAMS = @binPROGRAMS_exec@<br />
sbin_PROGRAMS = @sbinPROGRAMS_exec@<br />
libexec_PROGRAMS = @libexecPROGRAMS_exec@<br />
--- courier-imap-4.4.1.20080920/imapd.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/imapd.rc.in 2008-10-26 10:17:51.359375000 +0100<br />
@@ -22,6 +22,15 @@<br />
exit 1<br />
fi<br />
<br />
+# Location for some shared libraries (cygcourierauth*.dll) from authlib<br />
+AUTHLIBDIR=/usr/local<br />
+if test ! -f $AUTHLIBDIR/lib/bin/cygcourierauth.dll<br />
+then<br />
+ echo "$AUTHLIBDIR/lib/bin/cygcourierauth.dll not found."<br />
+ exit 1<br />
+fi<br />
+export PATH=$PATH:$AUTHLIBDIR/lib/bin<br />
+<br />
TLS_CACHEFILE=""<br />
. @sysconfdir@/imapd-ssl<br />
. @sysconfdir@/imapd<br />
@@ -35,7 +44,7 @@<br />
<br />
umask $IMAP_UMASK<br />
@ULIMIT@ $IMAP_ULIMITD<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
--- courier-imap-4.4.1.20080920/pop3d.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/pop3d.rc.in 2008-10-26 10:18:02.187500000 +0100<br />
@@ -22,12 +22,21 @@<br />
exit 1<br />
fi<br />
<br />
+# Location for some shared libraries (cygcourierauth*.dll) from authlib<br />
+AUTHLIBDIR=/usr/local<br />
+if test ! -f $AUTHLIBDIR/lib/bin/cygcourierauth.dll<br />
+then<br />
+ echo "$AUTHLIBDIR/lib/bin/cygcourierauth.dll not found."<br />
+ exit 1<br />
+fi<br />
+export PATH=$PATH:$AUTHLIBDIR/lib/bin<br />
+<br />
. @sysconfdir@/pop3d-ssl<br />
. @sysconfdir@/pop3d<br />
<br />
case $1 in<br />
start)<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-imap-4.4.1-cygwin.patch<br />
<br />
Configure the package<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait<br />
<br />
Take a walk... and when ready execute the following command to build the package.<br />
<br />
$ make<br />
<br />
Time to go for some coffee... and then install the package with the usual<br />
<br />
$ make install<br />
$ make install-configure<br />
<br />
==Configuration==<br />
<br />
Setup courier-imap: $prefix/etc/imapd (where $prefix=/usr/lib/courier-imap)<br />
<br />
Set ADDRESS to a valid value (0 or 127.0.0.1) and change IMAP_ULIMITD to a value accepted by the command ulimit. I simply used the existing value returned by<br />
<br />
$ ulimit -v<br />
<br />
==Running==<br />
<br />
Syslogd service and authdaemond should be started. See above.<br />
<br />
Start the imap daemon with the following command:<br />
<br />
$ /usr/lib/courier-imap/libexec/imapd.rc start<br />
<br />
Stop the daemon with the following command:<br />
<br />
$ /usr/lib/courier-imap/libexec/imapd.rc stop<br />
<br />
You'll find log messages in /var/log/messages (default target file as specified in /etc/syslogd.conf)<br />
<br />
==Testing==<br />
When authdaemond and imapd are running you can do a simple login test:<br />
<br />
$ telnet localhost 143<br />
<br />
and type the login command<br />
<br />
a login <username> <password><br />
<br />
the server should reply<br />
<br />
a OK LOGIN Ok.<br />
<br />
to which you can reply with a logout<br />
<br />
a logout<br />
<br />
the session is terminated by the server<br />
<br />
* BYE Courier-IMAP server shutting down<br />
a OK LOGOUT completed<br />
Connection closed by foreign host.<br />
<br />
'''Hint:''' if the connection is immediately closed by foreign host it probably means that ''imapd'' does not have access to all required DLLs. Check your PATH.<br />
<br />
==All in one==<br />
If everything works fine you can use the following [{{#file:imapd}} startup script] to launch or stop imap and authlib daemons. It can be saved in /usr/local/sbin.<br />
<br />
<source lang=bash><br />
#! /bin/sh<br />
#<br />
# Courier imap daemon startup script.<br />
<br />
authlib=/usr/local/sbin/authdaemond<br />
imapd=/usr/lib/courier-imap/libexec/imapd.rc<br />
<br />
test ! -f $authlib && echo "File not found: $authlib" && exit 1;<br />
test ! -f $imapd && echo "File not found: $imapd" && exit 1;<br />
<br />
case $1 in<br />
start)<br />
$authlib start<br />
$imapd start<br />
;;<br />
stop)<br />
$imapd stop<br />
$authlib stop<br />
;;<br />
*)<br />
echo "Usage: $0 <start|stop>"<br />
;;<br />
esac<br />
</source><br />
<br />
==Cygwin service==<br />
Create the [{{#file:imapd-srv.sh}} service script]<br />
<br />
<source lang=bash><br />
#!/bin/sh<br />
# File: imapd-service.sh<br />
# Purpose: Courier imap daemon service script.<br />
#<br />
# NOTE: This script must be excutable by SYSTEM<br />
username=username # <<<< Change me !!!<br />
pidsleep=''<br />
<br />
# Function to handle QUIT signal.<br />
# Stop imapd daemon and kill background sleep.<br />
function handleQuit<br />
{<br />
echo "STOPPING: /usr/local/sbin/imapd"<br />
su $username -c "/usr/local/sbin/imapd stop"<br />
test -n "$pidsleep" && kill -9 $pidsleep<br />
exit<br />
}<br />
<br />
# Interruptible sleep<br />
# Note: sleep is an external command (not builtin command), hence<br />
# not interruptible by the QUIT signal.<br />
function intsleep<br />
{<br />
sleep $1 &<br />
pidsleep=$!<br />
wait $pidsleep<br />
}<br />
<br />
echo "STARTING: /usr/local/sbin/imapd as $username at "`date`<br />
su $username -c "/usr/local/sbin/imapd start"<br />
<br />
trap "handleQuit" SIGQUIT<br />
<br />
echo "WAITING: "$$<br />
while true; do intsleep 1d; done<br />
</source><br />
<br />
Change username and save it to your favorite location, says /usr/local/sbin. The service script must be executable by SYSTEM, ie: the user that run the windows services.<br />
<br />
$ chmod +rx /usr/local/sbin/imapd-service.sh<br />
<br />
Install the new service with the following command.<br />
<br />
$ cygrunsrv --install imapd --desc "Courier IMAP daemon" --disp "CYGWIN imapd" \<br />
--path /usr/local/sbin/imapd-service.sh --termsig QUIT --type auto --shutdown<br />
<br />
Finally, just start the service<br />
<br />
$ cygrunsrv --start imapd<br />
or<br />
$ net start imapd<br />
<br />
You should now have couple of processes related to courier-imap<br />
<br />
$ ps -a<br />
<br />
'''NOTES''':<br />
* If the service could not be started, it's probably because the service script is not executable by SYSTEM<br />
<br />
$ net start imapd<br />
The CYGWIN imapd service is starting.<br />
The CYGWIN imapd service could not be started. <br />
<br />
The service did not report an error.<br />
<br />
More help is available by typing NET HELPMSG 3534.<br />
<br />
* The combination of background sleep and builtin wait command is used to make the waiting statment interruptible. The original script found on the net, was simply using a 'sleep 1' which turned to consume ~10% of the CPU.<br />
<br />
=Maildir=<br />
'''maildirmake''' is part of the courier-imap package<br />
<br />
$ /usr/lib/courier-imap/bin/maildirmake<br />
<br />
=Mairix - index and search mail folders=<br />
Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install the package mairix.<br />
<br />
Create the configuration file in your home directory: ~/.mairixrc<br />
<br />
base=/home/username<br />
maildir=Maildir...<br />
omit=Maildir/.Mairix**<br />
mfolder=Maildir/.Mairix<br />
database=/home/username/.mairix_database<br />
<br />
The create the mairix index<br />
<br />
$ mairix<br />
and<br />
$ mairix --fast-index # on daily base<br />
<br />
See [[Mail_Tips]] for additional details.</div>Twalranthttps://wiki.yobi.be/index.php?title=Courier-Cygwin&diff=5272Courier-Cygwin2008-11-01T16:05:30Z<p>Twalrant: /* Mairix */</p>
<hr />
<div>=Pre-requisite=<br />
<br />
Courier-IMAP requires the installation of the [http://www.courier-mta.org/authlib/ Courier Authentication Library] and the following cygwin tools and packages<br />
<br />
* patch, tar, make, gcc<br />
* crypt<br />
* libgdbm-devel<br />
* libtool<br />
* inetutils<br />
* cygrunsrv<br />
<br />
Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install the required packages.<br />
<br />
=Courier Authentication Library=<br />
<br />
Installation of Courier Authentication Library using the module userdb to manage mail accounts. All other modules are disabled.<br />
<br />
==Compilation and installation==<br />
<br />
Download and untar [http://www.courier-mta.org/download.php#authlib courier-authlib] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-authlib-0.61.0.tar.bz2 0.61.0]<br />
<br />
Apply the [{{#file:courrier-authlib-0.61.0-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# add libtool flag (-no-undefined) required for DLL creation<br />
# add missing dependencies<br />
# add PATH in start script to access new DLL (installed in a different directory)<br />
<br />
Solution source: http://lists.cairographics.org/archives/cairo/2004-April/001125.html<br />
<br />
<source lang=diff><br />
--- courier-authlib-0.61.0/makedat/Makefile.in 2008-05-24 16:21:09.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/makedat/Makefile.in 2008-10-21 16:02:38.709166700 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-authlib-0.61.0/Makefile.in 2008-07-12 21:41:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/Makefile.in 2008-10-23 22:59:03.843750000 +0200<br />
@@ -213,9 +213,10 @@<br />
LTCOMPILE = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
--mode=compile $(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) \<br />
$(AM_CPPFLAGS) $(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS)<br />
-CCLD = $(CC)<br />
+CCLD = $(CC) -no-undefined<br />
+CCLDEXE = $(CC)<br />
LINK = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
- --mode=link $(CCLD) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
+ --mode=link $(CCLDEXE) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
$(LDFLAGS) -o $@<br />
SOURCES = $(libauthcustom_la_SOURCES) $(libauthldap_la_SOURCES) \<br />
$(libauthmysql_la_SOURCES) $(libauthpam_la_SOURCES) \<br />
@@ -452,9 +453,9 @@<br />
README.authdebug.html<br />
<br />
DISTCLEANFILES = dbobj.config README_authlib.html<br />
-commonlibdep = libcourierauthcommon.la<br />
+commonlibdep = libcourierauthcommon.la libcourierauth.la<br />
commonldflags = -module -rpath $(pkglibdir) -export-symbols-regex 'courier_auth.*_init' -avoid-version<br />
-commonlibadd = libcourierauthcommon.la<br />
+commonlibadd = libcourierauthcommon.la libcourierauth.la<br />
libcourierauthcommon_t = @CRYPTLIBS@<br />
libcourierauthcommon_la_SOURCES = \<br />
auth.h courierauth.h \<br />
--- courier-authlib-0.61.0/authdaemond.in 2005-07-05 14:25:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/authdaemond.in 2008-10-25 12:03:32.140625000 +0200<br />
@@ -15,4 +15,10 @@<br />
set -a<br />
. @authdaemonrc@<br />
<br />
+# Some shared libraries (DLL) are installed in @libdir@/bin<br />
+# instead of @libdir@/@PACKAGE@<br />
+# Setting LD_LIBRARY_PATH at runtime or LR_RUN_PATH at linktime doesn't<br />
+# work in cygwin, only setting PATH works. <br />
+export PATH=$PATH:@libdir@/bin<br />
+<br />
exec ${sbindir}/courierlogger -pid=@authdaemonvar@/pid $LOGGEROPTS -$1 @libexecdir@/courier-authlib/authdaemond<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-authlib-0.61.0-cygwin.patch<br />
<br />
Configure the package without most authentication modules, keeping only ''userdb''.<br />
<br />
'''Note''': replace ''mailuser'' by an existing user name (in your /etc/passwd file). I used my own username.<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait --without-authpam --without-authldap --without-authpwd \<br />
--without-authshadow --without-authcustom --without-authpipe --without-authmysql --without-authpgsql --with-mailuser=mailuser \<br />
--with-mailgroup=mkgroup-l-d<br />
<br />
Take a long pause... and when ready execute the following command.<br />
<br />
$ make<br />
<br />
Take again a long pause... then check the result and install the libraries<br />
<br />
$ make check<br />
$ make install<br />
<br />
'''NOTES''': list of related topics found during investigation for compilation<br />
* authldap: configure: error: -lresolve is needed for res_query... http://www.cygwin.com/ml/cygwin/2005-04/msg00419.html<br />
<br />
==Configuration==<br />
<br />
Create authdaemonrc file: /usr/local/etc/authlib/authdaemonrc<br />
<br />
$ cp /usr/local/etc/authlib/authdaemonrc.dist /usr/local/etc/authlib/authdaemonrc<br />
<br />
Change number of daemons (I use three) and enable DEBUG_LOGIN<br />
<br />
<source lang=text><br />
# The number of daemon processes that are started.<br />
daemons=3<br />
<br />
# DEBUG_LOGIN=2 - turn on debugging + log passwords too<br />
DEBUG_LOGIN=2<br />
</source><br />
<br />
See http://www.courier-mta.org/authlib/README.authdebug.html for details.<br />
<br />
==IMAP accounts==<br />
<br />
User accounts and settings are managed by ''userdb''. See [http://linux.die.net/man/8/makeuserdb makeuserdb] man page for details, or used the freshly new install man page - man makeuserdb<br />
<br />
Assuming ''username'' is your username, 1001 and 10545 are respectively the UID and GID of an existing user (part of your /etc/passwd and /etc/group). I use my own UID and GID. Create the mailuser home directory, if required, and create Maildir folder.<br />
<br />
$ mkdir -p /home/username<br />
$ cd /home/username<br />
$ /usr/lib/courier-imap/bin/maildirmake Maildir<br />
<br />
Create the userdb text file /usr/local/etc/authlib/userdb<br />
<br />
$ touch /usr/local/etc/authlib/userdb<br />
$ chmod 700 /usr/local/etc/authlib/userdb<br />
<br />
Edit /usr/local/etc/authlib/userdb, one line per account<br />
<br />
<source lang=text><br />
username[TAB]uid=1001|gid=10111|home=/home/username|mail=/home/username/Maildir|systempw=XXXXXX<br />
</source><br />
<br />
where XXXXXX is the encrypted password created with<br />
<br />
$ /usr/local/sbin/userdbpw.exe<br />
<br />
Create the (binary) userdb<br />
<br />
$ /usr/local/sbin/makeuserdb<br />
<br />
You should now have the following files created:<br />
<br />
* /usr/local/etc/authlib/userdb.dat<br />
* /usr/local/etc/authlib/userdbshadow.dat<br />
<br />
==Running==<br />
<br />
Install and configure syslogd. Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install inetutils (contains syslogd). Configure syslogd with the following command. It will create the /etc/syslogd.conf file and install a windows service using cygrunsrv<br />
<br />
$ syslogd-config<br />
<br />
Start the authlib daemon with the following command:<br />
<br />
$ /usr/local/sbin/authdaemon start<br />
<br />
Stop the daemon with the following command:<br />
<br />
$ /usr/local/sbin/authdaemon stop<br />
<br />
You'll find log messages in /var/log/messages (default target file as specified in /etc/syslogd.conf)<br />
<br />
==Testing authlib==<br />
<br />
$ /usr/local/sbin/authtest username CCCCCC<br />
Authentication succeeded.<br />
<br />
Authenticated: username (uid 1001, gid 10545)<br />
Home Directory: /home/username<br />
Maildir: /home/username/Maildir<br />
Quota: (none)<br />
Encrypted Password: XXXXXX<br />
Cleartext Password: CCCCCC<br />
Options: (none)<br />
<br />
where username is your user name and XXXXXX is your encrypted password as provided in ''/usr/local/etc/authlib/userdb''. CCCCCC is your password in clear.<br />
<br />
==Troubleshooting==<br />
<br />
Should you have a doubt on the execution of a command (ie: no output) you can check if the application is able to load required DLL. This error is not reported. Using ''strace'', windows will complain about DLL not found, if any. To solve this problem you may need to add some path in your PATH. For example, in order to test authlib with authtest:<br />
<br />
$ strace /usr/local/sbin/authtest<br />
# This will open a dialog box to complain about DLL.<br />
$ export PATH=$PATH:/usr/local/lib/bin<br />
$ /usr/local/sbin/authtest ausername<br />
<br />
==Courier Authentication Config==<br />
<br />
$ /usr/local/bin/courierauthconfig.exe --version<br />
$ /usr/local/bin/courierauthconfig.exe --ldflags<br />
$ /usr/local/bin/courierauthconfig.exe --cppflags<br />
$ /usr/local/bin/courierauthconfig.exe --configfiles<br />
<br />
=Courier-IMAP=<br />
==Compilation and installation==<br />
<br />
Download and untar package [http://www.courier-mta.org/download.php#imap courier-imap] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-imap-4.4.1.tar.bz2 4.4.1.20080920]<br />
<br />
Apply the [{{#file:courrier-imap-4.4.1-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# incorrect usage of EXTEXT in main ''Makefile''<br />
# remove usage of /usr/lib/env in start/stop script (/usr/lib/env does not seem to work under Cygwin)<br />
<br />
<source lang=diff><br />
--- courier-imap-4.4.1.20080920/makedat/Makefile.in 2008-08-24 19:52:51.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/makedat/Makefile.in 2008-10-21 20:43:27.500000000 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-imap-4.4.1.20080920/Makefile.in 2008-09-20 14:48:46.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/Makefile.in 2008-10-21 20:59:45.156250000 +0200<br />
@@ -247,9 +247,9 @@<br />
CLEANFILES = $(databin_SCRIPTS) $(man_MANS) $(sysconf_DATA) $(sbin_SCRIPTS)<br />
databindir = $(datadir)<br />
databin_SCRIPTS = mkimapdcert mkpop3dcert<br />
-binPROGRAMS = imapd pop3d maildirmake maildiracl deliverquota maildirkw<br />
-sbinPROGRAMS = imaplogin pop3login<br />
-libexecPROGRAMS = makedatprog couriertcpd<br />
+binPROGRAMS = imapd$(EXEEXT) pop3d$(EXEEXT) maildirmake$(EXEEXT) maildiracl$(EXEEXT) deliverquota$(EXEEXT) maildirkw$(EXEEXT)<br />
+sbinPROGRAMS = imaplogin$(EXEEXT) pop3login$(EXEEXT)<br />
+libexecPROGRAMS = makedatprog$(EXEEXT) couriertcpd$(EXEEXT)<br />
bin_PROGRAMS = @binPROGRAMS_exec@<br />
sbin_PROGRAMS = @sbinPROGRAMS_exec@<br />
libexec_PROGRAMS = @libexecPROGRAMS_exec@<br />
--- courier-imap-4.4.1.20080920/imapd.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/imapd.rc.in 2008-10-26 10:17:51.359375000 +0100<br />
@@ -22,6 +22,15 @@<br />
exit 1<br />
fi<br />
<br />
+# Location for some shared libraries (cygcourierauth*.dll) from authlib<br />
+AUTHLIBDIR=/usr/local<br />
+if test ! -f $AUTHLIBDIR/lib/bin/cygcourierauth.dll<br />
+then<br />
+ echo "$AUTHLIBDIR/lib/bin/cygcourierauth.dll not found."<br />
+ exit 1<br />
+fi<br />
+export PATH=$PATH:$AUTHLIBDIR/lib/bin<br />
+<br />
TLS_CACHEFILE=""<br />
. @sysconfdir@/imapd-ssl<br />
. @sysconfdir@/imapd<br />
@@ -35,7 +44,7 @@<br />
<br />
umask $IMAP_UMASK<br />
@ULIMIT@ $IMAP_ULIMITD<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
--- courier-imap-4.4.1.20080920/pop3d.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/pop3d.rc.in 2008-10-26 10:18:02.187500000 +0100<br />
@@ -22,12 +22,21 @@<br />
exit 1<br />
fi<br />
<br />
+# Location for some shared libraries (cygcourierauth*.dll) from authlib<br />
+AUTHLIBDIR=/usr/local<br />
+if test ! -f $AUTHLIBDIR/lib/bin/cygcourierauth.dll<br />
+then<br />
+ echo "$AUTHLIBDIR/lib/bin/cygcourierauth.dll not found."<br />
+ exit 1<br />
+fi<br />
+export PATH=$PATH:$AUTHLIBDIR/lib/bin<br />
+<br />
. @sysconfdir@/pop3d-ssl<br />
. @sysconfdir@/pop3d<br />
<br />
case $1 in<br />
start)<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-imap-4.4.1-cygwin.patch<br />
<br />
Configure the package<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait<br />
<br />
Take a walk... and when ready execute the following command to build the package.<br />
<br />
$ make<br />
<br />
Time to go for some coffee... and then install the package with the usual<br />
<br />
$ make install<br />
$ make install-configure<br />
<br />
==Configuration==<br />
<br />
Setup courier-imap: $prefix/etc/imapd (where $prefix=/usr/lib/courier-imap)<br />
<br />
Set ADDRESS to a valid value (0 or 127.0.0.1) and change IMAP_ULIMITD to a value accepted by the command ulimit. I simply used the existing value returned by<br />
<br />
$ ulimit -v<br />
<br />
==Running==<br />
<br />
Syslogd service and authdaemond should be started. See above.<br />
<br />
Start the imap daemon with the following command:<br />
<br />
$ /usr/lib/courier-imap/libexec/imapd.rc start<br />
<br />
Stop the daemon with the following command:<br />
<br />
$ /usr/lib/courier-imap/libexec/imapd.rc stop<br />
<br />
You'll find log messages in /var/log/messages (default target file as specified in /etc/syslogd.conf)<br />
<br />
==Testing==<br />
When authdaemond and imapd are running you can do a simple login test:<br />
<br />
$ telnet localhost 143<br />
<br />
and type the login command<br />
<br />
a login <username> <password><br />
<br />
the server should reply<br />
<br />
a OK LOGIN Ok.<br />
<br />
to which you can reply with a logout<br />
<br />
a logout<br />
<br />
the session is terminated by the server<br />
<br />
* BYE Courier-IMAP server shutting down<br />
a OK LOGOUT completed<br />
Connection closed by foreign host.<br />
<br />
'''Hint:''' if the connection is immediately closed by foreign host it probably means that ''imapd'' does not have access to all required DLLs. Check your PATH.<br />
<br />
==All in one==<br />
If everything works fine you can use the following [{{#file:imapd}} startup script] to launch or stop imap and authlib daemons. It can be saved in /usr/local/sbin.<br />
<br />
<source lang=bash><br />
#! /bin/sh<br />
#<br />
# Courier imap daemon startup script.<br />
<br />
authlib=/usr/local/sbin/authdaemond<br />
imapd=/usr/lib/courier-imap/libexec/imapd.rc<br />
<br />
test ! -f $authlib && echo "File not found: $authlib" && exit 1;<br />
test ! -f $imapd && echo "File not found: $imapd" && exit 1;<br />
<br />
case $1 in<br />
start)<br />
$authlib start<br />
$imapd start<br />
;;<br />
stop)<br />
$imapd stop<br />
$authlib stop<br />
;;<br />
*)<br />
echo "Usage: $0 <start|stop>"<br />
;;<br />
esac<br />
</source><br />
<br />
==Cygwin service==<br />
Create the [{{#file:imapd-srv.sh}} service script]<br />
<br />
<source lang=bash><br />
#!/bin/sh<br />
# File: imapd-service.sh<br />
# Purpose: Courier imap daemon service script.<br />
#<br />
# NOTE: This script must be excutable by SYSTEM<br />
username=username # <<<< Change me !!!<br />
pidsleep=''<br />
<br />
# Function to handle QUIT signal.<br />
# Stop imapd daemon and kill background sleep.<br />
function handleQuit<br />
{<br />
echo "STOPPING: /usr/local/sbin/imapd"<br />
su $username -c "/usr/local/sbin/imapd stop"<br />
test -n "$pidsleep" && kill -9 $pidsleep<br />
exit<br />
}<br />
<br />
# Interruptible sleep<br />
# Note: sleep is an external command (not builtin command), hence<br />
# not interruptible by the QUIT signal.<br />
function intsleep<br />
{<br />
sleep $1 &<br />
pidsleep=$!<br />
wait $pidsleep<br />
}<br />
<br />
echo "STARTING: /usr/local/sbin/imapd as $username at "`date`<br />
su $username -c "/usr/local/sbin/imapd start"<br />
<br />
trap "handleQuit" SIGQUIT<br />
<br />
echo "WAITING: "$$<br />
while true; do intsleep 1d; done<br />
</source><br />
<br />
Change username and save it to your favorite location, says /usr/local/sbin. The service script must be executable by SYSTEM, ie: the user that run the windows services.<br />
<br />
$ chmod +rx /usr/local/sbin/imapd-service.sh<br />
<br />
Install the new service with the following command.<br />
<br />
$ cygrunsrv --install imapd --desc "Courier IMAP daemon" --disp "CYGWIN imapd" \<br />
--path /usr/local/sbin/imapd-service.sh --termsig QUIT --type auto --shutdown<br />
<br />
Finally, just start the service<br />
<br />
$ cygrunsrv --start imapd<br />
or<br />
$ net start imapd<br />
<br />
You should now have couple of processes related to courier-imap<br />
<br />
$ ps -a<br />
<br />
'''NOTES''':<br />
* If the service could not be started, it's probably because the service script is not executable by SYSTEM<br />
<br />
$ net start imapd<br />
The CYGWIN imapd service is starting.<br />
The CYGWIN imapd service could not be started. <br />
<br />
The service did not report an error.<br />
<br />
More help is available by typing NET HELPMSG 3534.<br />
<br />
* The combination of background sleep and builtin wait command is used to make the waiting statment interruptible. The original script found on the net, was simply using a 'sleep 1' which turned to consume ~10% of the CPU.<br />
<br />
=Maildir=<br />
'''maildirmake''' is part of the courier-imap package<br />
<br />
$ /usr/lib/courier-imap/bin/maildirmake<br />
<br />
=Mairix - index and search mail folders=<br />
Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install the package mairix.<br />
<br />
Create the configuration file in your home directory: ~/.mairixrc<br />
<br />
base=/home/username<br />
maildir=Maildir...<br />
omit=Maildir/.Mairix**<br />
mfolder=Maildir/.Mairix<br />
database=/home/username/.mairix_database<br />
<br />
The create the mairix index<br />
<br />
$> mairix<br />
<br />
See [[Mail_Tips]] for additional details.</div>Twalranthttps://wiki.yobi.be/index.php?title=Courier-Cygwin&diff=5271Courier-Cygwin2008-11-01T16:04:41Z<p>Twalrant: </p>
<hr />
<div>=Pre-requisite=<br />
<br />
Courier-IMAP requires the installation of the [http://www.courier-mta.org/authlib/ Courier Authentication Library] and the following cygwin tools and packages<br />
<br />
* patch, tar, make, gcc<br />
* crypt<br />
* libgdbm-devel<br />
* libtool<br />
* inetutils<br />
* cygrunsrv<br />
<br />
Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install the required packages.<br />
<br />
=Courier Authentication Library=<br />
<br />
Installation of Courier Authentication Library using the module userdb to manage mail accounts. All other modules are disabled.<br />
<br />
==Compilation and installation==<br />
<br />
Download and untar [http://www.courier-mta.org/download.php#authlib courier-authlib] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-authlib-0.61.0.tar.bz2 0.61.0]<br />
<br />
Apply the [{{#file:courrier-authlib-0.61.0-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# add libtool flag (-no-undefined) required for DLL creation<br />
# add missing dependencies<br />
# add PATH in start script to access new DLL (installed in a different directory)<br />
<br />
Solution source: http://lists.cairographics.org/archives/cairo/2004-April/001125.html<br />
<br />
<source lang=diff><br />
--- courier-authlib-0.61.0/makedat/Makefile.in 2008-05-24 16:21:09.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/makedat/Makefile.in 2008-10-21 16:02:38.709166700 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-authlib-0.61.0/Makefile.in 2008-07-12 21:41:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/Makefile.in 2008-10-23 22:59:03.843750000 +0200<br />
@@ -213,9 +213,10 @@<br />
LTCOMPILE = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
--mode=compile $(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) \<br />
$(AM_CPPFLAGS) $(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS)<br />
-CCLD = $(CC)<br />
+CCLD = $(CC) -no-undefined<br />
+CCLDEXE = $(CC)<br />
LINK = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
- --mode=link $(CCLD) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
+ --mode=link $(CCLDEXE) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
$(LDFLAGS) -o $@<br />
SOURCES = $(libauthcustom_la_SOURCES) $(libauthldap_la_SOURCES) \<br />
$(libauthmysql_la_SOURCES) $(libauthpam_la_SOURCES) \<br />
@@ -452,9 +453,9 @@<br />
README.authdebug.html<br />
<br />
DISTCLEANFILES = dbobj.config README_authlib.html<br />
-commonlibdep = libcourierauthcommon.la<br />
+commonlibdep = libcourierauthcommon.la libcourierauth.la<br />
commonldflags = -module -rpath $(pkglibdir) -export-symbols-regex 'courier_auth.*_init' -avoid-version<br />
-commonlibadd = libcourierauthcommon.la<br />
+commonlibadd = libcourierauthcommon.la libcourierauth.la<br />
libcourierauthcommon_t = @CRYPTLIBS@<br />
libcourierauthcommon_la_SOURCES = \<br />
auth.h courierauth.h \<br />
--- courier-authlib-0.61.0/authdaemond.in 2005-07-05 14:25:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/authdaemond.in 2008-10-25 12:03:32.140625000 +0200<br />
@@ -15,4 +15,10 @@<br />
set -a<br />
. @authdaemonrc@<br />
<br />
+# Some shared libraries (DLL) are installed in @libdir@/bin<br />
+# instead of @libdir@/@PACKAGE@<br />
+# Setting LD_LIBRARY_PATH at runtime or LR_RUN_PATH at linktime doesn't<br />
+# work in cygwin, only setting PATH works. <br />
+export PATH=$PATH:@libdir@/bin<br />
+<br />
exec ${sbindir}/courierlogger -pid=@authdaemonvar@/pid $LOGGEROPTS -$1 @libexecdir@/courier-authlib/authdaemond<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-authlib-0.61.0-cygwin.patch<br />
<br />
Configure the package without most authentication modules, keeping only ''userdb''.<br />
<br />
'''Note''': replace ''mailuser'' by an existing user name (in your /etc/passwd file). I used my own username.<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait --without-authpam --without-authldap --without-authpwd \<br />
--without-authshadow --without-authcustom --without-authpipe --without-authmysql --without-authpgsql --with-mailuser=mailuser \<br />
--with-mailgroup=mkgroup-l-d<br />
<br />
Take a long pause... and when ready execute the following command.<br />
<br />
$ make<br />
<br />
Take again a long pause... then check the result and install the libraries<br />
<br />
$ make check<br />
$ make install<br />
<br />
'''NOTES''': list of related topics found during investigation for compilation<br />
* authldap: configure: error: -lresolve is needed for res_query... http://www.cygwin.com/ml/cygwin/2005-04/msg00419.html<br />
<br />
==Configuration==<br />
<br />
Create authdaemonrc file: /usr/local/etc/authlib/authdaemonrc<br />
<br />
$ cp /usr/local/etc/authlib/authdaemonrc.dist /usr/local/etc/authlib/authdaemonrc<br />
<br />
Change number of daemons (I use three) and enable DEBUG_LOGIN<br />
<br />
<source lang=text><br />
# The number of daemon processes that are started.<br />
daemons=3<br />
<br />
# DEBUG_LOGIN=2 - turn on debugging + log passwords too<br />
DEBUG_LOGIN=2<br />
</source><br />
<br />
See http://www.courier-mta.org/authlib/README.authdebug.html for details.<br />
<br />
==IMAP accounts==<br />
<br />
User accounts and settings are managed by ''userdb''. See [http://linux.die.net/man/8/makeuserdb makeuserdb] man page for details, or used the freshly new install man page - man makeuserdb<br />
<br />
Assuming ''username'' is your username, 1001 and 10545 are respectively the UID and GID of an existing user (part of your /etc/passwd and /etc/group). I use my own UID and GID. Create the mailuser home directory, if required, and create Maildir folder.<br />
<br />
$ mkdir -p /home/username<br />
$ cd /home/username<br />
$ /usr/lib/courier-imap/bin/maildirmake Maildir<br />
<br />
Create the userdb text file /usr/local/etc/authlib/userdb<br />
<br />
$ touch /usr/local/etc/authlib/userdb<br />
$ chmod 700 /usr/local/etc/authlib/userdb<br />
<br />
Edit /usr/local/etc/authlib/userdb, one line per account<br />
<br />
<source lang=text><br />
username[TAB]uid=1001|gid=10111|home=/home/username|mail=/home/username/Maildir|systempw=XXXXXX<br />
</source><br />
<br />
where XXXXXX is the encrypted password created with<br />
<br />
$ /usr/local/sbin/userdbpw.exe<br />
<br />
Create the (binary) userdb<br />
<br />
$ /usr/local/sbin/makeuserdb<br />
<br />
You should now have the following files created:<br />
<br />
* /usr/local/etc/authlib/userdb.dat<br />
* /usr/local/etc/authlib/userdbshadow.dat<br />
<br />
==Running==<br />
<br />
Install and configure syslogd. Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install inetutils (contains syslogd). Configure syslogd with the following command. It will create the /etc/syslogd.conf file and install a windows service using cygrunsrv<br />
<br />
$ syslogd-config<br />
<br />
Start the authlib daemon with the following command:<br />
<br />
$ /usr/local/sbin/authdaemon start<br />
<br />
Stop the daemon with the following command:<br />
<br />
$ /usr/local/sbin/authdaemon stop<br />
<br />
You'll find log messages in /var/log/messages (default target file as specified in /etc/syslogd.conf)<br />
<br />
==Testing authlib==<br />
<br />
$ /usr/local/sbin/authtest username CCCCCC<br />
Authentication succeeded.<br />
<br />
Authenticated: username (uid 1001, gid 10545)<br />
Home Directory: /home/username<br />
Maildir: /home/username/Maildir<br />
Quota: (none)<br />
Encrypted Password: XXXXXX<br />
Cleartext Password: CCCCCC<br />
Options: (none)<br />
<br />
where username is your user name and XXXXXX is your encrypted password as provided in ''/usr/local/etc/authlib/userdb''. CCCCCC is your password in clear.<br />
<br />
==Troubleshooting==<br />
<br />
Should you have a doubt on the execution of a command (ie: no output) you can check if the application is able to load required DLL. This error is not reported. Using ''strace'', windows will complain about DLL not found, if any. To solve this problem you may need to add some path in your PATH. For example, in order to test authlib with authtest:<br />
<br />
$ strace /usr/local/sbin/authtest<br />
# This will open a dialog box to complain about DLL.<br />
$ export PATH=$PATH:/usr/local/lib/bin<br />
$ /usr/local/sbin/authtest ausername<br />
<br />
==Courier Authentication Config==<br />
<br />
$ /usr/local/bin/courierauthconfig.exe --version<br />
$ /usr/local/bin/courierauthconfig.exe --ldflags<br />
$ /usr/local/bin/courierauthconfig.exe --cppflags<br />
$ /usr/local/bin/courierauthconfig.exe --configfiles<br />
<br />
=Courier-IMAP=<br />
==Compilation and installation==<br />
<br />
Download and untar package [http://www.courier-mta.org/download.php#imap courier-imap] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-imap-4.4.1.tar.bz2 4.4.1.20080920]<br />
<br />
Apply the [{{#file:courrier-imap-4.4.1-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# incorrect usage of EXTEXT in main ''Makefile''<br />
# remove usage of /usr/lib/env in start/stop script (/usr/lib/env does not seem to work under Cygwin)<br />
<br />
<source lang=diff><br />
--- courier-imap-4.4.1.20080920/makedat/Makefile.in 2008-08-24 19:52:51.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/makedat/Makefile.in 2008-10-21 20:43:27.500000000 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-imap-4.4.1.20080920/Makefile.in 2008-09-20 14:48:46.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/Makefile.in 2008-10-21 20:59:45.156250000 +0200<br />
@@ -247,9 +247,9 @@<br />
CLEANFILES = $(databin_SCRIPTS) $(man_MANS) $(sysconf_DATA) $(sbin_SCRIPTS)<br />
databindir = $(datadir)<br />
databin_SCRIPTS = mkimapdcert mkpop3dcert<br />
-binPROGRAMS = imapd pop3d maildirmake maildiracl deliverquota maildirkw<br />
-sbinPROGRAMS = imaplogin pop3login<br />
-libexecPROGRAMS = makedatprog couriertcpd<br />
+binPROGRAMS = imapd$(EXEEXT) pop3d$(EXEEXT) maildirmake$(EXEEXT) maildiracl$(EXEEXT) deliverquota$(EXEEXT) maildirkw$(EXEEXT)<br />
+sbinPROGRAMS = imaplogin$(EXEEXT) pop3login$(EXEEXT)<br />
+libexecPROGRAMS = makedatprog$(EXEEXT) couriertcpd$(EXEEXT)<br />
bin_PROGRAMS = @binPROGRAMS_exec@<br />
sbin_PROGRAMS = @sbinPROGRAMS_exec@<br />
libexec_PROGRAMS = @libexecPROGRAMS_exec@<br />
--- courier-imap-4.4.1.20080920/imapd.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/imapd.rc.in 2008-10-26 10:17:51.359375000 +0100<br />
@@ -22,6 +22,15 @@<br />
exit 1<br />
fi<br />
<br />
+# Location for some shared libraries (cygcourierauth*.dll) from authlib<br />
+AUTHLIBDIR=/usr/local<br />
+if test ! -f $AUTHLIBDIR/lib/bin/cygcourierauth.dll<br />
+then<br />
+ echo "$AUTHLIBDIR/lib/bin/cygcourierauth.dll not found."<br />
+ exit 1<br />
+fi<br />
+export PATH=$PATH:$AUTHLIBDIR/lib/bin<br />
+<br />
TLS_CACHEFILE=""<br />
. @sysconfdir@/imapd-ssl<br />
. @sysconfdir@/imapd<br />
@@ -35,7 +44,7 @@<br />
<br />
umask $IMAP_UMASK<br />
@ULIMIT@ $IMAP_ULIMITD<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
--- courier-imap-4.4.1.20080920/pop3d.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/pop3d.rc.in 2008-10-26 10:18:02.187500000 +0100<br />
@@ -22,12 +22,21 @@<br />
exit 1<br />
fi<br />
<br />
+# Location for some shared libraries (cygcourierauth*.dll) from authlib<br />
+AUTHLIBDIR=/usr/local<br />
+if test ! -f $AUTHLIBDIR/lib/bin/cygcourierauth.dll<br />
+then<br />
+ echo "$AUTHLIBDIR/lib/bin/cygcourierauth.dll not found."<br />
+ exit 1<br />
+fi<br />
+export PATH=$PATH:$AUTHLIBDIR/lib/bin<br />
+<br />
. @sysconfdir@/pop3d-ssl<br />
. @sysconfdir@/pop3d<br />
<br />
case $1 in<br />
start)<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-imap-4.4.1-cygwin.patch<br />
<br />
Configure the package<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait<br />
<br />
Take a walk... and when ready execute the following command to build the package.<br />
<br />
$ make<br />
<br />
Time to go for some coffee... and then install the package with the usual<br />
<br />
$ make install<br />
$ make install-configure<br />
<br />
==Configuration==<br />
<br />
Setup courier-imap: $prefix/etc/imapd (where $prefix=/usr/lib/courier-imap)<br />
<br />
Set ADDRESS to a valid value (0 or 127.0.0.1) and change IMAP_ULIMITD to a value accepted by the command ulimit. I simply used the existing value returned by<br />
<br />
$ ulimit -v<br />
<br />
==Running==<br />
<br />
Syslogd service and authdaemond should be started. See above.<br />
<br />
Start the imap daemon with the following command:<br />
<br />
$ /usr/lib/courier-imap/libexec/imapd.rc start<br />
<br />
Stop the daemon with the following command:<br />
<br />
$ /usr/lib/courier-imap/libexec/imapd.rc stop<br />
<br />
You'll find log messages in /var/log/messages (default target file as specified in /etc/syslogd.conf)<br />
<br />
==Testing==<br />
When authdaemond and imapd are running you can do a simple login test:<br />
<br />
$ telnet localhost 143<br />
<br />
and type the login command<br />
<br />
a login <username> <password><br />
<br />
the server should reply<br />
<br />
a OK LOGIN Ok.<br />
<br />
to which you can reply with a logout<br />
<br />
a logout<br />
<br />
the session is terminated by the server<br />
<br />
* BYE Courier-IMAP server shutting down<br />
a OK LOGOUT completed<br />
Connection closed by foreign host.<br />
<br />
'''Hint:''' if the connection is immediately closed by foreign host it probably means that ''imapd'' does not have access to all required DLLs. Check your PATH.<br />
<br />
==All in one==<br />
If everything works fine you can use the following [{{#file:imapd}} startup script] to launch or stop imap and authlib daemons. It can be saved in /usr/local/sbin.<br />
<br />
<source lang=bash><br />
#! /bin/sh<br />
#<br />
# Courier imap daemon startup script.<br />
<br />
authlib=/usr/local/sbin/authdaemond<br />
imapd=/usr/lib/courier-imap/libexec/imapd.rc<br />
<br />
test ! -f $authlib && echo "File not found: $authlib" && exit 1;<br />
test ! -f $imapd && echo "File not found: $imapd" && exit 1;<br />
<br />
case $1 in<br />
start)<br />
$authlib start<br />
$imapd start<br />
;;<br />
stop)<br />
$imapd stop<br />
$authlib stop<br />
;;<br />
*)<br />
echo "Usage: $0 <start|stop>"<br />
;;<br />
esac<br />
</source><br />
<br />
==Cygwin service==<br />
Create the [{{#file:imapd-srv.sh}} service script]<br />
<br />
<source lang=bash><br />
#!/bin/sh<br />
# File: imapd-service.sh<br />
# Purpose: Courier imap daemon service script.<br />
#<br />
# NOTE: This script must be excutable by SYSTEM<br />
username=username # <<<< Change me !!!<br />
pidsleep=''<br />
<br />
# Function to handle QUIT signal.<br />
# Stop imapd daemon and kill background sleep.<br />
function handleQuit<br />
{<br />
echo "STOPPING: /usr/local/sbin/imapd"<br />
su $username -c "/usr/local/sbin/imapd stop"<br />
test -n "$pidsleep" && kill -9 $pidsleep<br />
exit<br />
}<br />
<br />
# Interruptible sleep<br />
# Note: sleep is an external command (not builtin command), hence<br />
# not interruptible by the QUIT signal.<br />
function intsleep<br />
{<br />
sleep $1 &<br />
pidsleep=$!<br />
wait $pidsleep<br />
}<br />
<br />
echo "STARTING: /usr/local/sbin/imapd as $username at "`date`<br />
su $username -c "/usr/local/sbin/imapd start"<br />
<br />
trap "handleQuit" SIGQUIT<br />
<br />
echo "WAITING: "$$<br />
while true; do intsleep 1d; done<br />
</source><br />
<br />
Change username and save it to your favorite location, says /usr/local/sbin. The service script must be executable by SYSTEM, ie: the user that run the windows services.<br />
<br />
$ chmod +rx /usr/local/sbin/imapd-service.sh<br />
<br />
Install the new service with the following command.<br />
<br />
$ cygrunsrv --install imapd --desc "Courier IMAP daemon" --disp "CYGWIN imapd" \<br />
--path /usr/local/sbin/imapd-service.sh --termsig QUIT --type auto --shutdown<br />
<br />
Finally, just start the service<br />
<br />
$ cygrunsrv --start imapd<br />
or<br />
$ net start imapd<br />
<br />
You should now have couple of processes related to courier-imap<br />
<br />
$ ps -a<br />
<br />
'''NOTES''':<br />
* If the service could not be started, it's probably because the service script is not executable by SYSTEM<br />
<br />
$ net start imapd<br />
The CYGWIN imapd service is starting.<br />
The CYGWIN imapd service could not be started. <br />
<br />
The service did not report an error.<br />
<br />
More help is available by typing NET HELPMSG 3534.<br />
<br />
* The combination of background sleep and builtin wait command is used to make the waiting statment interruptible. The original script found on the net, was simply using a 'sleep 1' which turned to consume ~10% of the CPU.<br />
<br />
=Maildir=<br />
'''maildirmake''' is part of the courier-imap package<br />
<br />
$ /usr/lib/courier-imap/bin/maildirmake<br />
<br />
=Mairix=<br />
Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install the package mairix.<br />
<br />
Create the configuration file in your home directory: ~/.mairixrc<br />
<br />
base=/home/username<br />
maildir=Maildir...<br />
omit=Maildir/.Mairix**<br />
mfolder=Maildir/.Mairix<br />
database=/home/username/.mairix_database<br />
<br />
The create the mairix index<br />
<br />
$> mairix<br />
<br />
See [[Mail_Tips]] for additional details.</div>Twalranthttps://wiki.yobi.be/index.php?title=Courier-Cygwin&diff=5270Courier-Cygwin2008-11-01T15:56:16Z<p>Twalrant: /* Maildir */</p>
<hr />
<div>=Pre-requisite=<br />
<br />
Courier-IMAP requires the installation of the [http://www.courier-mta.org/authlib/ Courier Authentication Library] and the following cygwin tools and packages<br />
<br />
* patch, tar, make, gcc<br />
* crypt<br />
* libgdbm-devel<br />
* libtool<br />
* inetutils<br />
* cygrunsrv<br />
<br />
Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install the required packages.<br />
<br />
=Courier Authentication Library=<br />
<br />
Installation of Courier Authentication Library using the module userdb to manage mail accounts. All other modules are disabled.<br />
<br />
==Compilation and installation==<br />
<br />
Download and untar [http://www.courier-mta.org/download.php#authlib courier-authlib] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-authlib-0.61.0.tar.bz2 0.61.0]<br />
<br />
Apply the [{{#file:courrier-authlib-0.61.0-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# add libtool flag (-no-undefined) required for DLL creation<br />
# add missing dependencies<br />
# add PATH in start script to access new DLL (installed in a different directory)<br />
<br />
Solution source: http://lists.cairographics.org/archives/cairo/2004-April/001125.html<br />
<br />
<source lang=diff><br />
--- courier-authlib-0.61.0/makedat/Makefile.in 2008-05-24 16:21:09.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/makedat/Makefile.in 2008-10-21 16:02:38.709166700 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-authlib-0.61.0/Makefile.in 2008-07-12 21:41:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/Makefile.in 2008-10-23 22:59:03.843750000 +0200<br />
@@ -213,9 +213,10 @@<br />
LTCOMPILE = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
--mode=compile $(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) \<br />
$(AM_CPPFLAGS) $(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS)<br />
-CCLD = $(CC)<br />
+CCLD = $(CC) -no-undefined<br />
+CCLDEXE = $(CC)<br />
LINK = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
- --mode=link $(CCLD) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
+ --mode=link $(CCLDEXE) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
$(LDFLAGS) -o $@<br />
SOURCES = $(libauthcustom_la_SOURCES) $(libauthldap_la_SOURCES) \<br />
$(libauthmysql_la_SOURCES) $(libauthpam_la_SOURCES) \<br />
@@ -452,9 +453,9 @@<br />
README.authdebug.html<br />
<br />
DISTCLEANFILES = dbobj.config README_authlib.html<br />
-commonlibdep = libcourierauthcommon.la<br />
+commonlibdep = libcourierauthcommon.la libcourierauth.la<br />
commonldflags = -module -rpath $(pkglibdir) -export-symbols-regex 'courier_auth.*_init' -avoid-version<br />
-commonlibadd = libcourierauthcommon.la<br />
+commonlibadd = libcourierauthcommon.la libcourierauth.la<br />
libcourierauthcommon_t = @CRYPTLIBS@<br />
libcourierauthcommon_la_SOURCES = \<br />
auth.h courierauth.h \<br />
--- courier-authlib-0.61.0/authdaemond.in 2005-07-05 14:25:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/authdaemond.in 2008-10-25 12:03:32.140625000 +0200<br />
@@ -15,4 +15,10 @@<br />
set -a<br />
. @authdaemonrc@<br />
<br />
+# Some shared libraries (DLL) are installed in @libdir@/bin<br />
+# instead of @libdir@/@PACKAGE@<br />
+# Setting LD_LIBRARY_PATH at runtime or LR_RUN_PATH at linktime doesn't<br />
+# work in cygwin, only setting PATH works. <br />
+export PATH=$PATH:@libdir@/bin<br />
+<br />
exec ${sbindir}/courierlogger -pid=@authdaemonvar@/pid $LOGGEROPTS -$1 @libexecdir@/courier-authlib/authdaemond<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-authlib-0.61.0-cygwin.patch<br />
<br />
Configure the package without most authentication modules, keeping only ''userdb''.<br />
<br />
'''Note''': replace ''mailuser'' by an existing user name (in your /etc/passwd file). I used my own username.<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait --without-authpam --without-authldap --without-authpwd \<br />
--without-authshadow --without-authcustom --without-authpipe --without-authmysql --without-authpgsql --with-mailuser=mailuser \<br />
--with-mailgroup=mkgroup-l-d<br />
<br />
Take a long pause... and when ready execute the following command.<br />
<br />
$ make<br />
<br />
Take again a long pause... then check the result and install the libraries<br />
<br />
$ make check<br />
$ make install<br />
<br />
'''NOTES''': list of related topics found during investigation for compilation<br />
* authldap: configure: error: -lresolve is needed for res_query... http://www.cygwin.com/ml/cygwin/2005-04/msg00419.html<br />
<br />
==Configuration==<br />
<br />
Create authdaemonrc file: /usr/local/etc/authlib/authdaemonrc<br />
<br />
$ cp /usr/local/etc/authlib/authdaemonrc.dist /usr/local/etc/authlib/authdaemonrc<br />
<br />
Change number of daemons (I use three) and enable DEBUG_LOGIN<br />
<br />
<source lang=text><br />
# The number of daemon processes that are started.<br />
daemons=3<br />
<br />
# DEBUG_LOGIN=2 - turn on debugging + log passwords too<br />
DEBUG_LOGIN=2<br />
</source><br />
<br />
See http://www.courier-mta.org/authlib/README.authdebug.html for details.<br />
<br />
==IMAP accounts==<br />
<br />
User accounts and settings are managed by ''userdb''. See [http://linux.die.net/man/8/makeuserdb makeuserdb] man page for details, or used the freshly new install man page - man makeuserdb<br />
<br />
Assuming ''username'' is your username, 1001 and 10545 are respectively the UID and GID of an existing user (part of your /etc/passwd and /etc/group). I use my own UID and GID. Create the mailuser home directory, if required, and create Maildir folder.<br />
<br />
$ mkdir -p /home/username<br />
$ cd /home/username<br />
$ /usr/lib/courier-imap/bin/maildirmake Maildir<br />
<br />
Create the userdb text file /usr/local/etc/authlib/userdb<br />
<br />
$ touch /usr/local/etc/authlib/userdb<br />
$ chmod 700 /usr/local/etc/authlib/userdb<br />
<br />
Edit /usr/local/etc/authlib/userdb, one line per account<br />
<br />
<source lang=text><br />
username[TAB]uid=1001|gid=10111|home=/home/username|mail=/home/username/Maildir|systempw=XXXXXX<br />
</source><br />
<br />
where XXXXXX is the encrypted password created with<br />
<br />
$ /usr/local/sbin/userdbpw.exe<br />
<br />
Create the (binary) userdb<br />
<br />
$ /usr/local/sbin/makeuserdb<br />
<br />
You should now have the following files created:<br />
<br />
* /usr/local/etc/authlib/userdb.dat<br />
* /usr/local/etc/authlib/userdbshadow.dat<br />
<br />
==Running==<br />
<br />
Install and configure syslogd. Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install inetutils (contains syslogd). Configure syslogd with the following command. It will create the /etc/syslogd.conf file and install a windows service using cygrunsrv<br />
<br />
$ syslogd-config<br />
<br />
Start the authlib daemon with the following command:<br />
<br />
$ /usr/local/sbin/authdaemon start<br />
<br />
Stop the daemon with the following command:<br />
<br />
$ /usr/local/sbin/authdaemon stop<br />
<br />
You'll find log messages in /var/log/messages (default target file as specified in /etc/syslogd.conf)<br />
<br />
==Testing authlib==<br />
<br />
$ /usr/local/sbin/authtest username CCCCCC<br />
Authentication succeeded.<br />
<br />
Authenticated: username (uid 1001, gid 10545)<br />
Home Directory: /home/username<br />
Maildir: /home/username/Maildir<br />
Quota: (none)<br />
Encrypted Password: XXXXXX<br />
Cleartext Password: CCCCCC<br />
Options: (none)<br />
<br />
where username is your user name and XXXXXX is your encrypted password as provided in ''/usr/local/etc/authlib/userdb''. CCCCCC is your password in clear.<br />
<br />
==Troubleshooting==<br />
<br />
Should you have a doubt on the execution of a command (ie: no output) you can check if the application is able to load required DLL. This error is not reported. Using ''strace'', windows will complain about DLL not found, if any. To solve this problem you may need to add some path in your PATH. For example, in order to test authlib with authtest:<br />
<br />
$ strace /usr/local/sbin/authtest<br />
# This will open a dialog box to complain about DLL.<br />
$ export PATH=$PATH:/usr/local/lib/bin<br />
$ /usr/local/sbin/authtest ausername<br />
<br />
==Courier Authentication Config==<br />
<br />
$ /usr/local/bin/courierauthconfig.exe --version<br />
$ /usr/local/bin/courierauthconfig.exe --ldflags<br />
$ /usr/local/bin/courierauthconfig.exe --cppflags<br />
$ /usr/local/bin/courierauthconfig.exe --configfiles<br />
<br />
=Courier-IMAP=<br />
==Compilation and installation==<br />
<br />
Download and untar package [http://www.courier-mta.org/download.php#imap courier-imap] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-imap-4.4.1.tar.bz2 4.4.1.20080920]<br />
<br />
Apply the [{{#file:courrier-imap-4.4.1-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# incorrect usage of EXTEXT in main ''Makefile''<br />
# remove usage of /usr/lib/env in start/stop script (/usr/lib/env does not seem to work under Cygwin)<br />
<br />
<source lang=diff><br />
--- courier-imap-4.4.1.20080920/makedat/Makefile.in 2008-08-24 19:52:51.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/makedat/Makefile.in 2008-10-21 20:43:27.500000000 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-imap-4.4.1.20080920/Makefile.in 2008-09-20 14:48:46.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/Makefile.in 2008-10-21 20:59:45.156250000 +0200<br />
@@ -247,9 +247,9 @@<br />
CLEANFILES = $(databin_SCRIPTS) $(man_MANS) $(sysconf_DATA) $(sbin_SCRIPTS)<br />
databindir = $(datadir)<br />
databin_SCRIPTS = mkimapdcert mkpop3dcert<br />
-binPROGRAMS = imapd pop3d maildirmake maildiracl deliverquota maildirkw<br />
-sbinPROGRAMS = imaplogin pop3login<br />
-libexecPROGRAMS = makedatprog couriertcpd<br />
+binPROGRAMS = imapd$(EXEEXT) pop3d$(EXEEXT) maildirmake$(EXEEXT) maildiracl$(EXEEXT) deliverquota$(EXEEXT) maildirkw$(EXEEXT)<br />
+sbinPROGRAMS = imaplogin$(EXEEXT) pop3login$(EXEEXT)<br />
+libexecPROGRAMS = makedatprog$(EXEEXT) couriertcpd$(EXEEXT)<br />
bin_PROGRAMS = @binPROGRAMS_exec@<br />
sbin_PROGRAMS = @sbinPROGRAMS_exec@<br />
libexec_PROGRAMS = @libexecPROGRAMS_exec@<br />
--- courier-imap-4.4.1.20080920/imapd.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/imapd.rc.in 2008-10-26 10:17:51.359375000 +0100<br />
@@ -22,6 +22,15 @@<br />
exit 1<br />
fi<br />
<br />
+# Location for some shared libraries (cygcourierauth*.dll) from authlib<br />
+AUTHLIBDIR=/usr/local<br />
+if test ! -f $AUTHLIBDIR/lib/bin/cygcourierauth.dll<br />
+then<br />
+ echo "$AUTHLIBDIR/lib/bin/cygcourierauth.dll not found."<br />
+ exit 1<br />
+fi<br />
+export PATH=$PATH:$AUTHLIBDIR/lib/bin<br />
+<br />
TLS_CACHEFILE=""<br />
. @sysconfdir@/imapd-ssl<br />
. @sysconfdir@/imapd<br />
@@ -35,7 +44,7 @@<br />
<br />
umask $IMAP_UMASK<br />
@ULIMIT@ $IMAP_ULIMITD<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
--- courier-imap-4.4.1.20080920/pop3d.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/pop3d.rc.in 2008-10-26 10:18:02.187500000 +0100<br />
@@ -22,12 +22,21 @@<br />
exit 1<br />
fi<br />
<br />
+# Location for some shared libraries (cygcourierauth*.dll) from authlib<br />
+AUTHLIBDIR=/usr/local<br />
+if test ! -f $AUTHLIBDIR/lib/bin/cygcourierauth.dll<br />
+then<br />
+ echo "$AUTHLIBDIR/lib/bin/cygcourierauth.dll not found."<br />
+ exit 1<br />
+fi<br />
+export PATH=$PATH:$AUTHLIBDIR/lib/bin<br />
+<br />
. @sysconfdir@/pop3d-ssl<br />
. @sysconfdir@/pop3d<br />
<br />
case $1 in<br />
start)<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-imap-4.4.1-cygwin.patch<br />
<br />
Configure the package<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait<br />
<br />
Take a walk... and when ready execute the following command to build the package.<br />
<br />
$ make<br />
<br />
Time to go for some coffee... and then install the package with the usual<br />
<br />
$ make install<br />
$ make install-configure<br />
<br />
==Configuration==<br />
<br />
Setup courier-imap: $prefix/etc/imapd (where $prefix=/usr/lib/courier-imap)<br />
<br />
Set ADDRESS to a valid value (0 or 127.0.0.1) and change IMAP_ULIMITD to a value accepted by the command ulimit. I simply used the existing value returned by<br />
<br />
$ ulimit -v<br />
<br />
==Running==<br />
<br />
Syslogd service and authdaemond should be started. See above.<br />
<br />
Start the imap daemon with the following command:<br />
<br />
$ /usr/lib/courier-imap/libexec/imapd.rc start<br />
<br />
Stop the daemon with the following command:<br />
<br />
$ /usr/lib/courier-imap/libexec/imapd.rc stop<br />
<br />
You'll find log messages in /var/log/messages (default target file as specified in /etc/syslogd.conf)<br />
<br />
==Testing==<br />
When authdaemond and imapd are running you can do a simple login test:<br />
<br />
$ telnet localhost 143<br />
<br />
and type the login command<br />
<br />
a login <username> <password><br />
<br />
the server should reply<br />
<br />
a OK LOGIN Ok.<br />
<br />
to which you can reply with a logout<br />
<br />
a logout<br />
<br />
the session is terminated by the server<br />
<br />
* BYE Courier-IMAP server shutting down<br />
a OK LOGOUT completed<br />
Connection closed by foreign host.<br />
<br />
'''Hint:''' if the connection is immediately closed by foreign host it probably means that ''imapd'' does not have access to all required DLLs. Check your PATH.<br />
<br />
==All in one==<br />
If everything works fine you can use the following [{{#file:imapd}} startup script] to launch or stop imap and authlib daemons. It can be saved in /usr/local/sbin.<br />
<br />
<source lang=bash><br />
#! /bin/sh<br />
#<br />
# Courier imap daemon startup script.<br />
<br />
authlib=/usr/local/sbin/authdaemond<br />
imapd=/usr/lib/courier-imap/libexec/imapd.rc<br />
<br />
test ! -f $authlib && echo "File not found: $authlib" && exit 1;<br />
test ! -f $imapd && echo "File not found: $imapd" && exit 1;<br />
<br />
case $1 in<br />
start)<br />
$authlib start<br />
$imapd start<br />
;;<br />
stop)<br />
$imapd stop<br />
$authlib stop<br />
;;<br />
*)<br />
echo "Usage: $0 <start|stop>"<br />
;;<br />
esac<br />
</source><br />
<br />
==Cygwin service==<br />
Create the [{{#file:imapd-srv.sh}} service script]<br />
<br />
<source lang=bash><br />
#!/bin/sh<br />
# File: imapd-service.sh<br />
# Purpose: Courier imap daemon service script.<br />
#<br />
# NOTE: This script must be excutable by SYSTEM<br />
username=username # <<<< Change me !!!<br />
pidsleep=''<br />
<br />
# Function to handle QUIT signal.<br />
# Stop imapd daemon and kill background sleep.<br />
function handleQuit<br />
{<br />
echo "STOPPING: /usr/local/sbin/imapd"<br />
su $username -c "/usr/local/sbin/imapd stop"<br />
test -n "$pidsleep" && kill -9 $pidsleep<br />
exit<br />
}<br />
<br />
# Interruptible sleep<br />
# Note: sleep is an external command (not builtin command), hence<br />
# not interruptible by the QUIT signal.<br />
function intsleep<br />
{<br />
sleep $1 &<br />
pidsleep=$!<br />
wait $pidsleep<br />
}<br />
<br />
echo "STARTING: /usr/local/sbin/imapd as $username at "`date`<br />
su $username -c "/usr/local/sbin/imapd start"<br />
<br />
trap "handleQuit" SIGQUIT<br />
<br />
echo "WAITING: "$$<br />
while true; do intsleep 1d; done<br />
</source><br />
<br />
Change username and save it to your favorite location, says /usr/local/sbin. The service script must be executable by SYSTEM, ie: the user that run the windows services.<br />
<br />
$ chmod +rx /usr/local/sbin/imapd-service.sh<br />
<br />
Install the new service with the following command.<br />
<br />
$ cygrunsrv --install imapd --desc "Courier IMAP daemon" --disp "CYGWIN imapd" \<br />
--path /usr/local/sbin/imapd-service.sh --termsig QUIT --type auto --shutdown<br />
<br />
Finally, just start the service<br />
<br />
$ cygrunsrv --start imapd<br />
or<br />
$ net start imapd<br />
<br />
You should now have couple of processes related to courier-imap<br />
<br />
$ ps -a<br />
<br />
'''NOTES''':<br />
* If the service could not be started, it's probably because the service script is not executable by SYSTEM<br />
<br />
$ net start imapd<br />
The CYGWIN imapd service is starting.<br />
The CYGWIN imapd service could not be started. <br />
<br />
The service did not report an error.<br />
<br />
More help is available by typing NET HELPMSG 3534.<br />
<br />
* The combination of background sleep and builtin wait command is used to make the waiting statment interruptible. The original script found on the net, was simply using a 'sleep 1' which turned to consume ~10% of the CPU.<br />
<br />
=Maildir=<br />
'''maildirmake''' is part of the courier-imap package<br />
<br />
$ /usr/lib/courier-imap/bin/maildirmake<br />
<br />
=Mairix=</div>Twalranthttps://wiki.yobi.be/index.php?title=Courier-Cygwin&diff=5269Courier-Cygwin2008-11-01T09:44:53Z<p>Twalrant: </p>
<hr />
<div>=Pre-requisite=<br />
<br />
Courier-IMAP requires the installation of the [http://www.courier-mta.org/authlib/ Courier Authentication Library] and the following cygwin tools and packages<br />
<br />
* patch, tar, make, gcc<br />
* crypt<br />
* libgdbm-devel<br />
* libtool<br />
* inetutils<br />
* cygrunsrv<br />
<br />
Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install the required packages.<br />
<br />
=Courier Authentication Library=<br />
<br />
Installation of Courier Authentication Library using the module userdb to manage mail accounts. All other modules are disabled.<br />
<br />
==Compilation and installation==<br />
<br />
Download and untar [http://www.courier-mta.org/download.php#authlib courier-authlib] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-authlib-0.61.0.tar.bz2 0.61.0]<br />
<br />
Apply the [{{#file:courrier-authlib-0.61.0-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# add libtool flag (-no-undefined) required for DLL creation<br />
# add missing dependencies<br />
# add PATH in start script to access new DLL (installed in a different directory)<br />
<br />
Solution source: http://lists.cairographics.org/archives/cairo/2004-April/001125.html<br />
<br />
<source lang=diff><br />
--- courier-authlib-0.61.0/makedat/Makefile.in 2008-05-24 16:21:09.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/makedat/Makefile.in 2008-10-21 16:02:38.709166700 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-authlib-0.61.0/Makefile.in 2008-07-12 21:41:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/Makefile.in 2008-10-23 22:59:03.843750000 +0200<br />
@@ -213,9 +213,10 @@<br />
LTCOMPILE = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
--mode=compile $(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) \<br />
$(AM_CPPFLAGS) $(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS)<br />
-CCLD = $(CC)<br />
+CCLD = $(CC) -no-undefined<br />
+CCLDEXE = $(CC)<br />
LINK = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
- --mode=link $(CCLD) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
+ --mode=link $(CCLDEXE) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
$(LDFLAGS) -o $@<br />
SOURCES = $(libauthcustom_la_SOURCES) $(libauthldap_la_SOURCES) \<br />
$(libauthmysql_la_SOURCES) $(libauthpam_la_SOURCES) \<br />
@@ -452,9 +453,9 @@<br />
README.authdebug.html<br />
<br />
DISTCLEANFILES = dbobj.config README_authlib.html<br />
-commonlibdep = libcourierauthcommon.la<br />
+commonlibdep = libcourierauthcommon.la libcourierauth.la<br />
commonldflags = -module -rpath $(pkglibdir) -export-symbols-regex 'courier_auth.*_init' -avoid-version<br />
-commonlibadd = libcourierauthcommon.la<br />
+commonlibadd = libcourierauthcommon.la libcourierauth.la<br />
libcourierauthcommon_t = @CRYPTLIBS@<br />
libcourierauthcommon_la_SOURCES = \<br />
auth.h courierauth.h \<br />
--- courier-authlib-0.61.0/authdaemond.in 2005-07-05 14:25:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/authdaemond.in 2008-10-25 12:03:32.140625000 +0200<br />
@@ -15,4 +15,10 @@<br />
set -a<br />
. @authdaemonrc@<br />
<br />
+# Some shared libraries (DLL) are installed in @libdir@/bin<br />
+# instead of @libdir@/@PACKAGE@<br />
+# Setting LD_LIBRARY_PATH at runtime or LR_RUN_PATH at linktime doesn't<br />
+# work in cygwin, only setting PATH works. <br />
+export PATH=$PATH:@libdir@/bin<br />
+<br />
exec ${sbindir}/courierlogger -pid=@authdaemonvar@/pid $LOGGEROPTS -$1 @libexecdir@/courier-authlib/authdaemond<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-authlib-0.61.0-cygwin.patch<br />
<br />
Configure the package without most authentication modules, keeping only ''userdb''.<br />
<br />
'''Note''': replace ''mailuser'' by an existing user name (in your /etc/passwd file). I used my own username.<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait --without-authpam --without-authldap --without-authpwd \<br />
--without-authshadow --without-authcustom --without-authpipe --without-authmysql --without-authpgsql --with-mailuser=mailuser \<br />
--with-mailgroup=mkgroup-l-d<br />
<br />
Take a long pause... and when ready execute the following command.<br />
<br />
$ make<br />
<br />
Take again a long pause... then check the result and install the libraries<br />
<br />
$ make check<br />
$ make install<br />
<br />
'''NOTES''': list of related topics found during investigation for compilation<br />
* authldap: configure: error: -lresolve is needed for res_query... http://www.cygwin.com/ml/cygwin/2005-04/msg00419.html<br />
<br />
==Configuration==<br />
<br />
Create authdaemonrc file: /usr/local/etc/authlib/authdaemonrc<br />
<br />
$ cp /usr/local/etc/authlib/authdaemonrc.dist /usr/local/etc/authlib/authdaemonrc<br />
<br />
Change number of daemons (I use three) and enable DEBUG_LOGIN<br />
<br />
<source lang=text><br />
# The number of daemon processes that are started.<br />
daemons=3<br />
<br />
# DEBUG_LOGIN=2 - turn on debugging + log passwords too<br />
DEBUG_LOGIN=2<br />
</source><br />
<br />
See http://www.courier-mta.org/authlib/README.authdebug.html for details.<br />
<br />
==IMAP accounts==<br />
<br />
User accounts and settings are managed by ''userdb''. See [http://linux.die.net/man/8/makeuserdb makeuserdb] man page for details, or used the freshly new install man page - man makeuserdb<br />
<br />
Assuming ''username'' is your username, 1001 and 10545 are respectively the UID and GID of an existing user (part of your /etc/passwd and /etc/group). I use my own UID and GID. Create the mailuser home directory, if required, and create Maildir folder.<br />
<br />
$ mkdir -p /home/username<br />
$ cd /home/username<br />
$ /usr/lib/courier-imap/bin/maildirmake Maildir<br />
<br />
Create the userdb text file /usr/local/etc/authlib/userdb<br />
<br />
$ touch /usr/local/etc/authlib/userdb<br />
$ chmod 700 /usr/local/etc/authlib/userdb<br />
<br />
Edit /usr/local/etc/authlib/userdb, one line per account<br />
<br />
<source lang=text><br />
username[TAB]uid=1001|gid=10111|home=/home/username|mail=/home/username/Maildir|systempw=XXXXXX<br />
</source><br />
<br />
where XXXXXX is the encrypted password created with<br />
<br />
$ /usr/local/sbin/userdbpw.exe<br />
<br />
Create the (binary) userdb<br />
<br />
$ /usr/local/sbin/makeuserdb<br />
<br />
You should now have the following files created:<br />
<br />
* /usr/local/etc/authlib/userdb.dat<br />
* /usr/local/etc/authlib/userdbshadow.dat<br />
<br />
==Running==<br />
<br />
Install and configure syslogd. Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install inetutils (contains syslogd). Configure syslogd with the following command. It will create the /etc/syslogd.conf file and install a windows service using cygrunsrv<br />
<br />
$ syslogd-config<br />
<br />
Start the authlib daemon with the following command:<br />
<br />
$ /usr/local/sbin/authdaemon start<br />
<br />
Stop the daemon with the following command:<br />
<br />
$ /usr/local/sbin/authdaemon stop<br />
<br />
You'll find log messages in /var/log/messages (default target file as specified in /etc/syslogd.conf)<br />
<br />
==Testing authlib==<br />
<br />
$ /usr/local/sbin/authtest username CCCCCC<br />
Authentication succeeded.<br />
<br />
Authenticated: username (uid 1001, gid 10545)<br />
Home Directory: /home/username<br />
Maildir: /home/username/Maildir<br />
Quota: (none)<br />
Encrypted Password: XXXXXX<br />
Cleartext Password: CCCCCC<br />
Options: (none)<br />
<br />
where username is your user name and XXXXXX is your encrypted password as provided in ''/usr/local/etc/authlib/userdb''. CCCCCC is your password in clear.<br />
<br />
==Troubleshooting==<br />
<br />
Should you have a doubt on the execution of a command (ie: no output) you can check if the application is able to load required DLL. This error is not reported. Using ''strace'', windows will complain about DLL not found, if any. To solve this problem you may need to add some path in your PATH. For example, in order to test authlib with authtest:<br />
<br />
$ strace /usr/local/sbin/authtest<br />
# This will open a dialog box to complain about DLL.<br />
$ export PATH=$PATH:/usr/local/lib/bin<br />
$ /usr/local/sbin/authtest ausername<br />
<br />
==Courier Authentication Config==<br />
<br />
$ /usr/local/bin/courierauthconfig.exe --version<br />
$ /usr/local/bin/courierauthconfig.exe --ldflags<br />
$ /usr/local/bin/courierauthconfig.exe --cppflags<br />
$ /usr/local/bin/courierauthconfig.exe --configfiles<br />
<br />
=Courier-IMAP=<br />
==Compilation and installation==<br />
<br />
Download and untar package [http://www.courier-mta.org/download.php#imap courier-imap] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-imap-4.4.1.tar.bz2 4.4.1.20080920]<br />
<br />
Apply the [{{#file:courrier-imap-4.4.1-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# incorrect usage of EXTEXT in main ''Makefile''<br />
# remove usage of /usr/lib/env in start/stop script (/usr/lib/env does not seem to work under Cygwin)<br />
<br />
<source lang=diff><br />
--- courier-imap-4.4.1.20080920/makedat/Makefile.in 2008-08-24 19:52:51.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/makedat/Makefile.in 2008-10-21 20:43:27.500000000 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-imap-4.4.1.20080920/Makefile.in 2008-09-20 14:48:46.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/Makefile.in 2008-10-21 20:59:45.156250000 +0200<br />
@@ -247,9 +247,9 @@<br />
CLEANFILES = $(databin_SCRIPTS) $(man_MANS) $(sysconf_DATA) $(sbin_SCRIPTS)<br />
databindir = $(datadir)<br />
databin_SCRIPTS = mkimapdcert mkpop3dcert<br />
-binPROGRAMS = imapd pop3d maildirmake maildiracl deliverquota maildirkw<br />
-sbinPROGRAMS = imaplogin pop3login<br />
-libexecPROGRAMS = makedatprog couriertcpd<br />
+binPROGRAMS = imapd$(EXEEXT) pop3d$(EXEEXT) maildirmake$(EXEEXT) maildiracl$(EXEEXT) deliverquota$(EXEEXT) maildirkw$(EXEEXT)<br />
+sbinPROGRAMS = imaplogin$(EXEEXT) pop3login$(EXEEXT)<br />
+libexecPROGRAMS = makedatprog$(EXEEXT) couriertcpd$(EXEEXT)<br />
bin_PROGRAMS = @binPROGRAMS_exec@<br />
sbin_PROGRAMS = @sbinPROGRAMS_exec@<br />
libexec_PROGRAMS = @libexecPROGRAMS_exec@<br />
--- courier-imap-4.4.1.20080920/imapd.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/imapd.rc.in 2008-10-26 10:17:51.359375000 +0100<br />
@@ -22,6 +22,15 @@<br />
exit 1<br />
fi<br />
<br />
+# Location for some shared libraries (cygcourierauth*.dll) from authlib<br />
+AUTHLIBDIR=/usr/local<br />
+if test ! -f $AUTHLIBDIR/lib/bin/cygcourierauth.dll<br />
+then<br />
+ echo "$AUTHLIBDIR/lib/bin/cygcourierauth.dll not found."<br />
+ exit 1<br />
+fi<br />
+export PATH=$PATH:$AUTHLIBDIR/lib/bin<br />
+<br />
TLS_CACHEFILE=""<br />
. @sysconfdir@/imapd-ssl<br />
. @sysconfdir@/imapd<br />
@@ -35,7 +44,7 @@<br />
<br />
umask $IMAP_UMASK<br />
@ULIMIT@ $IMAP_ULIMITD<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
--- courier-imap-4.4.1.20080920/pop3d.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/pop3d.rc.in 2008-10-26 10:18:02.187500000 +0100<br />
@@ -22,12 +22,21 @@<br />
exit 1<br />
fi<br />
<br />
+# Location for some shared libraries (cygcourierauth*.dll) from authlib<br />
+AUTHLIBDIR=/usr/local<br />
+if test ! -f $AUTHLIBDIR/lib/bin/cygcourierauth.dll<br />
+then<br />
+ echo "$AUTHLIBDIR/lib/bin/cygcourierauth.dll not found."<br />
+ exit 1<br />
+fi<br />
+export PATH=$PATH:$AUTHLIBDIR/lib/bin<br />
+<br />
. @sysconfdir@/pop3d-ssl<br />
. @sysconfdir@/pop3d<br />
<br />
case $1 in<br />
start)<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-imap-4.4.1-cygwin.patch<br />
<br />
Configure the package<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait<br />
<br />
Take a walk... and when ready execute the following command to build the package.<br />
<br />
$ make<br />
<br />
Time to go for some coffee... and then install the package with the usual<br />
<br />
$ make install<br />
$ make install-configure<br />
<br />
==Configuration==<br />
<br />
Setup courier-imap: $prefix/etc/imapd (where $prefix=/usr/lib/courier-imap)<br />
<br />
Set ADDRESS to a valid value (0 or 127.0.0.1) and change IMAP_ULIMITD to a value accepted by the command ulimit. I simply used the existing value returned by<br />
<br />
$ ulimit -v<br />
<br />
==Running==<br />
<br />
Syslogd service and authdaemond should be started. See above.<br />
<br />
Start the imap daemon with the following command:<br />
<br />
$ /usr/lib/courier-imap/libexec/imapd.rc start<br />
<br />
Stop the daemon with the following command:<br />
<br />
$ /usr/lib/courier-imap/libexec/imapd.rc stop<br />
<br />
You'll find log messages in /var/log/messages (default target file as specified in /etc/syslogd.conf)<br />
<br />
==Testing==<br />
When authdaemond and imapd are running you can do a simple login test:<br />
<br />
$ telnet localhost 143<br />
<br />
and type the login command<br />
<br />
a login <username> <password><br />
<br />
the server should reply<br />
<br />
a OK LOGIN Ok.<br />
<br />
to which you can reply with a logout<br />
<br />
a logout<br />
<br />
the session is terminated by the server<br />
<br />
* BYE Courier-IMAP server shutting down<br />
a OK LOGOUT completed<br />
Connection closed by foreign host.<br />
<br />
'''Hint:''' if the connection is immediately closed by foreign host it probably means that ''imapd'' does not have access to all required DLLs. Check your PATH.<br />
<br />
==All in one==<br />
If everything works fine you can use the following [{{#file:imapd}} startup script] to launch or stop imap and authlib daemons. It can be saved in /usr/local/sbin.<br />
<br />
<source lang=bash><br />
#! /bin/sh<br />
#<br />
# Courier imap daemon startup script.<br />
<br />
authlib=/usr/local/sbin/authdaemond<br />
imapd=/usr/lib/courier-imap/libexec/imapd.rc<br />
<br />
test ! -f $authlib && echo "File not found: $authlib" && exit 1;<br />
test ! -f $imapd && echo "File not found: $imapd" && exit 1;<br />
<br />
case $1 in<br />
start)<br />
$authlib start<br />
$imapd start<br />
;;<br />
stop)<br />
$imapd stop<br />
$authlib stop<br />
;;<br />
*)<br />
echo "Usage: $0 <start|stop>"<br />
;;<br />
esac<br />
</source><br />
<br />
==Cygwin service==<br />
Create the [{{#file:imapd-srv.sh}} service script]<br />
<br />
<source lang=bash><br />
#!/bin/sh<br />
# File: imapd-service.sh<br />
# Purpose: Courier imap daemon service script.<br />
#<br />
# NOTE: This script must be excutable by SYSTEM<br />
username=username # <<<< Change me !!!<br />
pidsleep=''<br />
<br />
# Function to handle QUIT signal.<br />
# Stop imapd daemon and kill background sleep.<br />
function handleQuit<br />
{<br />
echo "STOPPING: /usr/local/sbin/imapd"<br />
su $username -c "/usr/local/sbin/imapd stop"<br />
test -n "$pidsleep" && kill -9 $pidsleep<br />
exit<br />
}<br />
<br />
# Interruptible sleep<br />
# Note: sleep is an external command (not builtin command), hence<br />
# not interruptible by the QUIT signal.<br />
function intsleep<br />
{<br />
sleep $1 &<br />
pidsleep=$!<br />
wait $pidsleep<br />
}<br />
<br />
echo "STARTING: /usr/local/sbin/imapd as $username at "`date`<br />
su $username -c "/usr/local/sbin/imapd start"<br />
<br />
trap "handleQuit" SIGQUIT<br />
<br />
echo "WAITING: "$$<br />
while true; do intsleep 1d; done<br />
</source><br />
<br />
Change username and save it to your favorite location, says /usr/local/sbin. The service script must be executable by SYSTEM, ie: the user that run the windows services.<br />
<br />
$ chmod +rx /usr/local/sbin/imapd-service.sh<br />
<br />
Install the new service with the following command.<br />
<br />
$ cygrunsrv --install imapd --desc "Courier IMAP daemon" --disp "CYGWIN imapd" \<br />
--path /usr/local/sbin/imapd-service.sh --termsig QUIT --type auto --shutdown<br />
<br />
Finally, just start the service<br />
<br />
$ cygrunsrv --start imapd<br />
or<br />
$ net start imapd<br />
<br />
You should now have couple of processes related to courier-imap<br />
<br />
$ ps -a<br />
<br />
'''NOTES''':<br />
* If the service could not be started, it's probably because the service script is not executable by SYSTEM<br />
<br />
$ net start imapd<br />
The CYGWIN imapd service is starting.<br />
The CYGWIN imapd service could not be started. <br />
<br />
The service did not report an error.<br />
<br />
More help is available by typing NET HELPMSG 3534.<br />
<br />
* The combination of background sleep and builtin wait command is used to make the waiting statment interruptible. The original script found on the net, was simply using a 'sleep 1' which turned to consume ~10% of the CPU.<br />
<br />
=Maildir=<br />
'''maildirmake''' is part of the courier-imap package<br />
<br />
$ /usr/lib/courier-imap/bin/maildirmake</div>Twalranthttps://wiki.yobi.be/index.php?title=Outlook&diff=5268Outlook2008-11-01T09:41:42Z<p>Twalrant: /* Installing a local IMAP server on Windows */</p>
<hr />
<div>A page about Outlook on this wiki? Sounds weird isn't it?<br />
<br>Well, blame my employer.<br />
<br />
We migrated from Lotus Notes, with crappy hacked outdated client so Outlook is still better but...<br />
<br>At least under Lotus Notes it was possible to add an IMAP account (BTW Lotus Notes crashed quite often when talking IMAP...)<br />
<br>Here: Tools->Account Settings->''This feature has been disabled by your system administrator''<br />
<br />
== References ==<br />
* Microsoft Office 2007 Resource Kit (official documentation from Microsoft)<br />
** [http://technet.microsoft.com/en-gb/library/cc178979.aspx Documentation page]<br />
*** [http://go.microsoft.com/fwlink/?LinkId=85671 Security for the 2007 Office release]<br />
*** [http://go.microsoft.com/fwlink/?LinkID=94264 Group Policy overview for the 2007 Office release]<br />
** [http://go.microsoft.com/fwlink/?LinkId=78161 Administrative template (ADM,ADMX,...) files]<br />
*** Use [http://www.7-zip.org/ 7-zip] to decompress this file without installing it. Don't miss the summary excel sheet inside.<br />
* ''Configuring Microsoft Outlook 2003'', By Sue Mosher, Robert Sparnaaij, Charlie Pulfer, David Hooker.<br />
** Excellent book for administering Outlook 2003. Content can be browsed/searched on [http://books.google.com/books?id=v8oZNEByTR0C Google Books].<br />
* Excellent 3rd party page on Outlook policy: http://www.howto-outlook.com/howto/policies.htm<br />
* Folder with interesting policy settings on Outlook [http://theether.net/download/Microsoft/Office/2007/].<br />
<br />
== Unlocking ==<br />
<br />
===Main registry keys===<br />
Apparently important registry keys are under:<br />
HKEY_CURRENT_USER\Software\Microsoft\Office\12.0\Outlook<br />
HKEY_CURRENT_USER\Software\Microsoft\Windows NT\CurrentVersion\Windows Messaging Subsystem\Profiles\Outlook<br />
HKEY_CURRENT_USER\Software\Policies\Microsoft\Office\12.0\Outlook<br />
Some tips [http://www.hotline-pc.org/outlook.htm here] (french)<br />
<br />
===IMAP settings===<br />
<br />
We can remove the admin barrier on account management:<br />
HKEY_CURRENT_USER\Software\Policies\Microsoft\Office\12.0\Outlook\Setup\ModifyAccounts<br />
=0<br />
<br />
Another way without modifying the Registry is to use the import feature:<br />
<br>If e.g. Outlook Express client is also present on the Windows machine<br />
* In Outlook Express:<br />
** Wizard -> typed my IMAP&SMTP settings<br />
* In Outlook:<br />
** File -> Import and Export... -> Import Internet Mail Account Settings -> Microsoft Outlook Express or Microsoft Windows Mail -> Wizard allowing to edit the imported settings :-)<br />
** Then write a new mail -> Account (below Send button) -> select your new account -> Send test mail -> Prompted to choose the sent folder, ok -> you've a multiple tabs config view of your new account, possibility to switch servers to TLS, changing name of the account, saying you need auth to talk to your SMTP etc etc<br />
** If you need to tune IMAP settings later, go to registry and reset key (000000NN must be replaced with the number of your IMAP profile)<br />
HKEY_CURRENT_USER\Software\Microsoft\Windows NT\CurrentVersion\Windows Messaging Subsystem\Profiles\Outlook\9375CFF0413111d3B88A00104B2A6676\000000NN\IMAP Sentitems<br />
= 0<br />
<br />
Note that I also tried importing from Eudora Light & Eudora but Outlook didn't see anything<br />
<br />
=== Cached Exchange Mode ===<br />
The following keys were set in my configuration, preventing to change the settings related to ''Cached Exchange Mode''. In particular the mode selection was disabled, ie. the options ''Download full items'', ''Download headers and then full items'', ''Download headers'' were all grayed out.<br />
<source lang="reg"><br />
[HKEY_CURRENT_USER\Software\Policies\Microsoft\Office\12.0\Outlook\Cached Mode]<br />
"CachedExchangeMode"=dword:00000001<br />
"Enable"=dword:00000001<br />
"NoDrizzle"=dword:00000001<br />
"NoFullItems"=dword:00000001<br />
"NoHeaders"=dword:00000000<br />
"NoManualOnlineSync"=dword:00000001<br />
"SyncPFFav"=dword:00000001<br />
</source><br />
To unlock all settings, and eg. allow download full headers, simply delete values ''CachedExchangeMode'', ''NoDrizzle'', ''NoFullItems'', ''NoHeaders'', and ''NoManualOnlineSync'' (ie. all but ''Enable'' and ''SyncPFFav'').<br />
<br />
===Changing JunkMail levels===<br />
HKEY_CURRENT_USER\Software\Policies\Microsoft\Office\12.0\Outlook\Options\Mail\JunkMailProtection<br />
No Protection = 0xffffffff = 4294967295<br />
Low = 6<br />
High = 3<br />
Trusted Lists Only = 0x80000000 = 2147483648<br />
To enable the JunkMail otions in the Options->Preferences->E-Mail->Junk E-mail menu<br />
HKEY_CURRENT_USER\Software\Policies\Microsoft\Office\12.0\Outlook\DisableAntiSpam<br />
=0<br />
<br />
===AutoArchive===<br />
Recently the function ''AutoArchive'' vanished from Outlook, don't panic! To enable AutoArchive in the Menu->File again just change the following registry value:<br />
<br />
HKEY_CURRENT_USER\Software\Policies\Microsoft\Office\12.0\Outlook\Preferences\DisableManualArchive = 0<br />
<br />
Changing this value is not sufficient to get access back the AutoArchive options. You need to delete the entire registry key ''Preferences''. Not sure everything needs to go, but it does the work.<br />
<br />
[HKEY_CURRENT_USER\Software\Policies\Microsoft\Office\12.0\Outlook\Preferences]<br />
<br />
===All in one registry file===<br />
You can also put all the above registry modifications in one single file [{{#file:Outlook.reg}} Outlook.reg]<br />
<source lang=reg><br />
Windows Registry Editor Version 5.00<br />
<br />
[HKEY_CURRENT_USER\Software\Policies\Microsoft\Office\12.0\Outlook]<br />
"DisableAntiSpam"=dword:00000000<br />
<br />
[HKEY_CURRENT_USER\Software\Policies\Microsoft\Office\12.0\Outlook\Cached Mode]<br />
"NoFullItems"=-<br />
"NoDrizzle"=-<br />
"NoHeaders"=-<br />
"CachedExchangeMode"=-<br />
"NoManualOnlineSync"=-<br />
<br />
[HKEY_CURRENT_USER\Software\Policies\Microsoft\Office\12.0\Outlook\Options\Mail]<br />
"JunkMailProtection"=-<br />
<br />
[HKEY_CURRENT_USER\Software\Policies\Microsoft\Office\12.0\Outlook\Setup]<br />
"ModifyAccounts"=dword:00000000<br />
<br />
;Take care of that one, it could delete more than intended...<br />
[-HKEY_CURRENT_USER\Software\Policies\Microsoft\Office\12.0\Outlook\Preferences]<br />
</source><br />
<br />
...and modify the registry at each startup with the following command:<br />
regedit /s Outlook.reg<br />
<br />
'''Note''': the hyphens after the registry value and in front of the registry key indicates respectively a request to delete the value and the entire key. See http://support.microsoft.com/kb/310516 for details.<br />
<br />
==Group Policy and other configuration hints==<br />
<br />
* [http://technet.microsoft.com/en-us/library/cc303396.aspx Configure Outlook security and protection features]<br />
* [http://books.google.com/books?id=v8oZNEByTR0C&pg=PA232&lpg=PA232&dq=Outlook+policy+JunkMailProtection+registry&source=web&ots=NgPRrRu7ms&sig=0Fz7fiRm-hpc8GQTp9od3GtLLrM&hl=en&sa=X&oi=book_result&resnum=9&ct=result#PPA221,M1 Configuring Microsoft Outlook 2003]<br />
<br />
To use the Group Policy for Microsoft Outlook 2007 you may need to install the Outlook Group Policy template [http://www.yobi.be/files/outlk12.adm Outlk12.adm]<br />
<br />
# Copy the policy template Outlk12.adm into %WINDIR%\inf<br />
# Open Group Policy Editor: Start-> Run-> gpedit.msc<br />
# Add template:<br />
## Select User Configuration<br />
## Right-click on Administrative Templates<br />
## Select Add/Remove properties-> Click Add button<br />
## Browse to %WINDIR%\inf and select Outlk12.adm<br />
<br />
==iCalendar==<br />
Outlook does not handle correctly the iCal file (*.ics) with recurrent event.<br />
<br />
Problem: when opening (eg.: double-click on the attachment) an iCal file with multiple events, ie. multiple VEVENT sections, Outlook tries to add a complete calendar. Your are prompted with a dialog box with the following question: '''Add this Internet Calendar to Outlook'''. It is probably not what you want. Most probably you just need to add the multiple events in your existing calendar.<br />
<br />
The solution requires to save the iCal file on your hard drive and import it back using the import function.<br />
<br />
# Save file as...<br />
# File -> Import and Export...<br />
# Select ''Import and iCalendar (*.ics) or vCalendar (.vcs)''<br />
# Browse and select your saved iCal file, done.<br />
<br />
Solution source: https://events.sfu.ca/manual/en/iCalExporter.htm.<br />
<br />
==Moving PST location==<br />
cf [http://azcarya.blogspot.com/2008/02/gmail-outlook-2007-and-imap.html this post]<br />
<br />
# Close Outlook.<br />
# Open Control Panel -> Choose Mails -> Click on Data files.<br />
# Select the Account name and check for the location of the PST file. Leave the window open.<br />
# Open the folder containing the PST. Move the PST to the desired location.<br />
# Do NOT rename the file - if you do Outlook creates a new file in the default location again.<br />
# Switch to the Data Files window (as opened in Step 2) and double click on the PST file location.<br />
# This displays an error window, Ignore the error, and point to the new location. Close the windows.<br />
# Restart Outlook.<br />
# Outlook may create a new PST in the default location again, delete it, in such a case.<br />
<br />
==Recovering PST password==<br />
Password protection of PST is terribly wrong.<br />
<br />
Get [http://www.nirsoft.net/utils/pst_password.html PstPassword, a free Outlook PST Password Recovery], launch it and launch your PST, you'll get instantly a password, actuallt many passwords, and they will all work! How is it possible? Read [http://www.nirsoft.net/articles/pst_password_bug.html this].<br />
<br />
Note that McAfee detects the program as "Potentially Unwanted Program", a "[http://vil.nai.com/vil/content/v_150020.htm Generic PUP.z]":<br />
<br>''McAfee(R) Avert™ recognizes that this program may have legitimate uses in contexts where an authorized administrator has knowingly installed this application''<br />
<br>But still no question, the program is simply erased by McAfee.<br />
<br>One easy solution: open it under andLinux and run it with WINE :-)<br />
<br />
Apparently this can work both on "compressible encryption" and "high encryption" types of PST.<br />
==Coping with enterprise backup policy==<br />
The policy states:<br />
* Original e-mail and 'unique copies' must be stored in the mailbox or in the Central Vault (a Symantec stuff for central storage). <br />
* Copies of original e-mail can be stored locally to support working offline for which the original is available in the mailbox or Central Vault. <br />
* Original e-mail is e-mail as it enters MS Outlook or Central Vault. <br />
* A 'unique copy' is an original e-mail that has been modified. <br />
* This policy applies to all mailboxes in MS Outlook and Central Vault. <br />
So what we can do is:<br />
* Create a local .PST (or local IMAP) where you'll really archive your mails.<br />
* Don't create folders in the exchange mailbox but instead in your local .PST<br />
* In Exchange mailbox, only create a single folder called 'EV crap' or 'EV overload', or simply 'EV'<br />
* To archive a mail, you copy it from Exchange Inbox to your local .PST, then you move it to your 'EV' folder.<br />
* Every once in a while you go to your 'EV' folder, and you mass-send them to Enterprise Vault. Time to take a coffee break! (or two) (well, take a day off).<br />
<br />
You can setup a rule to do this automatically<br />
<br />
* Go to Tools --> Rules and Alerts --> New Rules <br />
* Select Start from a blank rule / Check messages after sending, then click Next<br />
* Click Next again and confirm rules applies to all sent mails<br />
* Select "Move a copy to the specified folder"<br />
* Click on "specified", and create a new EV folder in your inbox for instance, select 'EV' folder. Click Next.<br />
* Click Next again (no exception) <br />
** or optionally you can add exception for private mails by e.g. selecting "except if the subject contains specific words"<br />
** Click on "specific words" and add your keywords, such as "private", "Private", "PRIVATE", etc<br />
* Give rule a name (eg. Auto EV sent message), click Finish.<br />
<br />
You can do the same so that any incoming mail is automatically copied to given folder:<br />
* Go to Tools --> Rules and Alerts --> New Rules <br />
* Select Start from a blank rule / Check messages when they arrive, then click Next<br />
* Click Next again.<br />
* Select "Move a copy to the specified folder"<br />
* Click on "specified", and create a new EV folder in your inbox for instance, select 'EV' folder. Click Next.<br />
* Click Next again (no exception).<br />
** or optionally you can add exception for private mails by e.g. selecting "except if the subject contains specific words"<br />
** Click on "specific words" and add your keywords, such as "private", "Private", "PRIVATE", etc<br />
* Give rule a name (eg. Auto EV incoming message), click Finish.<br />
<br />
With these 2 rules, you can continue archive your mails normally in the local PST (remember don't make folders in exchange account, it's useless). For compliance with EV policy, you only need to go once in a while to the EV folder, and mass send all mails there in EV.<br />
<br />
Good luck!<br />
<br />
==Installing a local IMAP server on Windows==<br />
One possibility is uw-imap in Cygwin but if you want to use courier-imap, compilation under Cygwin is a nightmare... not anymore, see [[Courier-Cygwin]]<br />
<br>One easy way is to install courier-imap within AndLinux, e.g. following instructions at https://help.ubuntu.com/community/Courier<br />
<br />
==Macros==<br />
===Installation===<br />
To install a macro:<br />
* Alt-F11 in Outlook<br />
* Open Project1 -> Microsoft Office Outlook Objects -> ThisOutlookSession (double-click)<br />
* copy/paste code<br />
* close & save<br />
If required, allow unsigned macros:<br />
* Tools -> Macro -> Security -> Macro Security -> Warning for all macros<br />
You'll have annoying popup at startup but there is no way around<br />
<br />
====Adding toolbar button to execute a Macro====<br />
# Create a new toolbar. Right-click on any Outlook toolbar and choose "Customize." From the Toolbars tab, hit the "New" button, and name your toolbar anything you want (like "my shortcuts"). Drag and drop your new toolbar to the top of Outlook to dock it next to your other toolbars.<br />
# Add a Macro to your new toolbar. With the Customize dialog still open, go to its Commands tab. From the Commands tab, scroll down the Categories list, select Macros. In the Commands list select, drag and drop your Macro to your new toolbar.<br />
# Customize your new shortcut/button. With the Customize dialog still open, go to its Commands tab. Click on the new button in the toolbar (not in the Customize dialog). The button ''Modify Selection'' in the Customize dialog is now enabled. Click on it to change multiple properties of your new toolbar button.<br />
<br />
Solution source: http://lifehacker.com/381966/tweak-microsoft-outlook-to-empty-your-inbox-faster<br />
<br />
<br>Todo: add the macro in the right-click menu.<br />
<br />
===Send & Save===<br />
Lotus Notes can prompt the sender to specify what folder a message should be saved in. In Outlook, you can set the storage folder on the Options dialog. This VBA code reproduces something closer to the Notes behavior by popping up the Select Folder dialog when the user sends the message. (see [http://www.outlookcode.com/d/code/setsavefolder.htm here] and [http://www.outlookcode.com/codedetail.aspx?id=456 there])<br />
<br>''UPDATE:'' Avoid treating appointments as it fails.<br />
<source lang=vb><br />
Private Sub Application_ItemSend(ByVal Item As Object, _<br />
Cancel As Boolean)<br />
Dim objNS As NameSpace<br />
Dim objFolder As MAPIFolder<br />
Set objNS = Application.GetNamespace("MAPI")<br />
If TypeOf Item Is MailItem Then<br />
Set objFolder = objNS.PickFolder<br />
If TypeName(objFolder) <> "Nothing" Then<br />
Set Item.SaveSentMessageFolder = objFolder<br />
End If<br />
End If<br />
Set objFolder = Nothing<br />
Set objNS = Nothing<br />
End Sub<br />
</source><br />
If you don't want this pop-up all the time but to sort on casual base, you can use the built-in option:<br />
* While writing a new mail, select "Options" tab (not the "Options" toolbar) -> "Save Sent Item" button -> Other Folder -> Select<br />
<br />
===Move To Archive===<br />
Lotus Notes provided a way to archive mails manually. This feature is not supported by Outlook. To point is to select one or multiple mails in the inbox and move then with one single action to an archive folder. The following macro helps you to move mail into a dedicated archive folder (selected PST file + selected folder):<br />
<br>'''Note''':You may need to change the name of the PST file (''"Personal Folders"'') and the target folder (''"Ancient Archive"'') according to your setup.<br />
<br />
'''OBSOLETE''': take a look at the macro ''Archive Now''<br />
<br />
<source lang=vb><br />
Sub MoveToArchive()<br />
On Error Resume Next<br />
Dim objFolder As Outlook.MAPIFolder<br />
Dim objNS As Outlook.NameSpace, objItem As Outlook.MailItem<br />
<br />
Set objNS = Application.GetNamespace("MAPI")<br />
Set objFolder = objNS.Folders("Personal Folders").Folders("Ancient Archive")<br />
'Assume this is a mail folder<br />
<br />
<br />
If objFolder Is Nothing Then<br />
MsgBox "This folder doesn't exist!", vbOKOnly + vbExclamation, "INVALID FOLDER"<br />
End If<br />
<br />
<br />
If Application.ActiveExplorer.Selection.Count = 0 Then<br />
'Require that this procedure be called only when a message is selected<br />
Exit Sub<br />
End If<br />
<br />
For Each objItem In Application.ActiveExplorer.Selection<br />
If objFolder.DefaultItemType = olMailItem Then<br />
If objItem.Class = olMail Then<br />
objItem.UnRead = False<br />
objItem.Move objFolder<br />
End If<br />
End If<br />
Next<br />
<br />
Set objItem = Nothing<br />
Set objFolder = Nothing<br />
Set objNS = Nothing<br />
End Sub<br />
</source><br />
<br>Solution source: http://www.yeraze.com/article.php/outlook_macro_move_to_folder_mark_Read<br />
<br />
===Archive Now===<br />
The ''Archive Now'' macro better mimic the expected behavior of the ''Archive Selected Items'' of Lotus Notes (I never thought I would like to mimic anything from Lotus Notes,...) This ''Archive Now'' macro moves the selected mails, meetings and appointments ('''NEW''') in the same sub-folder as its original location. Note that the archive operation does not depend on any time and date information. All selected mails, meetings and appointments will be archived/moved.<br />
<br>'''Note''': you may need or want to change the destination name (ie: ''"Archive Folders"'')<br />
<br />
<source lang=vb><br />
' Routine/Macro to archive selected mails into given data file<br />
Sub ArchiveNow()<br />
On Error Resume Next<br />
MoveToFolder ("Archive Folders")<br />
End Sub<br />
'<br />
' Function to move selected mails into given data file<br />
Public Function MoveToFolder(destName As String)<br />
Dim objNS As Outlook.NameSpace<br />
Dim objApp As Application<br />
Dim objFolder As Outlook.MAPIFolder<br />
Dim strCurrentFolderRootName As String<br />
Dim strDestinationFolderPath As String<br />
Dim objItem As Object<br />
<br />
On Error Resume Next<br />
<br />
' Some basic initialization, get app & namespace objects<br />
Set objApp = CreateObject("Outlook.Application")<br />
Set objNS = objApp.GetNamespace("MAPI")<br />
<br />
' Abort if nothing selected<br />
If objApp.ActiveExplorer.Selection.Count = 0 Then<br />
'Require that this procedure be called only when a message is selected<br />
Exit Function<br />
End If<br />
<br />
' Abort if destination == source<br />
strCurrentFolderRootName = GetFolderRootName(objApp.ActiveExplorer.CurrentFolder)<br />
If strCurrentFolderRootName = destName Then<br />
' Require that this procedure be called outside destination folder<br />
Exit Function<br />
End If<br />
<br />
' Get destination folder path<br />
strDestinationFolderPath = Replace(objApp.ActiveExplorer.CurrentFolder.FolderPath, _<br />
"\\" + strCurrentFolderRootName, destName)<br />
<br />
' Get destination folder object<br />
Set objFolder = GetFolder(strDestinationFolderPath)<br />
<br />
' Check if destination folder exist, if not create it!<br />
If objFolder Is Nothing Then<br />
Dim Response<br />
Response = MsgBox("Folder '" + strDestinationFolderPath + "' does not exist. " + _<br />
"Do you want to create it?", vbYesNo + vbExclamation, "Folder not found")<br />
If Response = vbYes Then<br />
CreateFolder (strDestinationFolderPath)<br />
Set objFolder = GetFolder(strDestinationFolderPath)<br />
If objFolder Is Nothing Then<br />
MsgBox "The destination folder creation failed!", vbOKOnly + vbExclamation, "INVALID FOLDER"<br />
Exit Function<br />
End If<br />
Else<br />
Exit Function<br />
End If<br />
End If<br />
<br />
' Move mails, meetings and appointments to destination folder<br />
For Each objItem In objApp.ActiveExplorer.Selection<br />
If objFolder.DefaultItemType = olMailItem Then<br />
' Process Mail item<br />
If TypeOf objItem Is MailItem Then<br />
Dim objMailItem As Outlook.MailItem<br />
Set objMailItem = objItem<br />
objMailItem.UnRead = False<br />
objMailItem.Move objFolder<br />
Set objMailItem = Nothing<br />
End If<br />
' Process Meeting item<br />
If TypeOf objItem Is MeetingItem Then<br />
Dim objMeetingItem As Outlook.MeetingItem<br />
Set objMeetingItem = objItem<br />
objMeetingItem.UnRead = False<br />
objMeetingItem.Move objFolder<br />
Set objMeetingItem = Nothing<br />
End If<br />
' Process Appointment item - NOTE: not sure it will ever be necessary<br />
If TypeOf objItem Is AppointmentItem Then<br />
Dim objAppointItem As Outlook.AppointmentItem<br />
Set objAppointItem = objItem<br />
objAppointItem.UnRead = False<br />
objAppointItem.Move objFolder<br />
Set objAppointItem = Nothing<br />
End If<br />
End If<br />
Next<br />
<br />
Set objNS = Nothing<br />
Set objApp = Nothing<br />
Set objItem = Nothing<br />
Set objFolder = Nothing<br />
End Function<br />
'<br />
' Function to returns the folder name of the top/root folder, just below the namespace<br />
Public Function GetFolderRootName(objFolder As MAPIFolder) As String<br />
If Not objFolder.Parent.Class = olFolder Then<br />
GetFolderRootName = objFolder.Name<br />
Exit Function<br />
End If<br />
GetFolderRootName = GetFolderRootName(objFolder.Parent)<br />
End Function<br />
'<br />
' Function to return a folder (object) specified by a full folder path<br />
Public Function GetFolder(strFolderPath As String) As MAPIFolder<br />
<br />
' folder path needs to be something like<br />
' "Public Folders\All Public Folders\Company\Sales"<br />
<br />
Dim objApp As Outlook.Application<br />
Dim objNS As Outlook.NameSpace<br />
Dim colFolders As Outlook.Folders<br />
Dim objFolder As Outlook.MAPIFolder<br />
Dim arrFolders() As String<br />
Dim I As Long<br />
<br />
On Error Resume Next<br />
<br />
strFolderPath = Replace(strFolderPath, "/", "\")<br />
arrFolders() = Split(strFolderPath, "\")<br />
Set objApp = CreateObject("Outlook.Application")<br />
Set objNS = objApp.GetNamespace("MAPI")<br />
Set objFolder = objNS.Folders.Item(arrFolders(0))<br />
<br />
If Not objFolder Is Nothing Then<br />
For I = 1 To UBound(arrFolders)<br />
Set colFolders = objFolder.Folders<br />
Set objFolder = Nothing<br />
Set objFolder = colFolders.Item(arrFolders(I))<br />
If objFolder Is Nothing Then<br />
Exit For<br />
End If<br />
Next<br />
End If<br />
<br />
Set GetFolder = objFolder<br />
Set colFolders = Nothing<br />
Set objNS = Nothing<br />
Set objApp = Nothing<br />
End Function<br />
'<br />
' Function to create a folder specified by a full folder path<br />
Public Function CreateFolder(strFolderPath As String)<br />
<br />
' folder path needs to be something like<br />
' "Public Folders\All Public Folders\Company\Sales"<br />
Dim objNS As Outlook.NameSpace<br />
Dim objApp As Application<br />
Dim objFolder As Outlook.MAPIFolder<br />
Dim colFolders As Outlook.Folders<br />
Dim arrFolders() As String<br />
<br />
On Error Resume Next<br />
<br />
' Some basic initialization, get app & namespace objects<br />
Set objApp = CreateObject("Outlook.Application")<br />
Set objNS = objApp.GetNamespace("MAPI")<br />
<br />
' Build an array of folder names...<br />
strFolderPath = Replace(strFolderPath, "/", "\")<br />
strFolderPath = Replace(strFolderPath, "\\", "", 1, 1)<br />
arrFolders() = Split(strFolderPath, "\")<br />
Set objFolder = objNS.Folders.Item(arrFolders(0))<br />
<br />
' Process folders<br />
If Not objFolder Is Nothing Then<br />
For I = 1 To UBound(arrFolders)<br />
Set colFolders = objFolder.Folders<br />
Set objFolder = Nothing<br />
Set objFolder = colFolders.Item(arrFolders(I))<br />
If objFolder Is Nothing Then<br />
colFolders.Add (arrFolders(I))<br />
Set objFolder = colFolders.Item(arrFolders(I))<br />
End If<br />
Next<br />
End If<br />
<br />
Set colFolders = Nothing<br />
Set objNS = Nothing<br />
Set objApp = Nothing<br />
End Function<br />
</source><br />
<br />
<br>Inspiration sources: <br />
*http://www.outlookcode.com/codedetail.aspx?id=321<br />
*http://www.outlookcode.com/codedetail.aspx?id=714<br />
<br />
==Interoperability between Exchange/Outlook & Linux==<br />
<br />
===PST to Maildir===<br />
<br />
* In Outlook:<br />
** New -> Outlook Data File... -> Outlook 97-2002 Personal Folders file<br />
** Copy/Move mails to it<br />
** Right-Click on it -> Close it (probably safer)<br />
* In Linux:<br />
** Convert to mbox using readpst, then to Maildir using mb2md<br />
<source lang=bash><br />
mkdir pst<br />
readpst -r -o pst backup.pst<br />
find pst -name mbox -size 0 -exec rm {} \;<br />
find pst -mindepth 2 -type d -print0|xargs --null -I XXX mb2md -s "$(pwd)/XXX/mbox" -<br />
find pst -mindepth 2 -name mbox -print0|xargs --null rm<br />
</source><br />
<br />
I tried the PST Import plugin v1.2 for Thunderbird but it failed finding any mail in the PST<br />
===Openchange===<br />
I tried the one from Debian Experimental (version 1.0~svn679-1)<br />
mapiprofile --address=A.B.C.D --username=name --password=passwd --domain=DOM --workstation=BLABLA --profile=test --create<br />
-> segfault from libmapi0<br />
<br />
I tried to compile the libmapi0 from the SVN, no segfault anymore but still failed<br />
===Evolution===<br />
Apparently ther is an attempt to support MAPI in a development branch but it has too much recent dependencies for me to compile it...<br />
svn checkout http://svn.gnome.org/svn/evolution/branches/EXCHANGE_MAPI_BRANCH<br />
<br />
svn diff http://svn.gnome.org/svn/evolution/trunk http://svn.gnome.org/svn/evolution/branches/EXCHANGE_MAPI_BRANCH</div>Twalranthttps://wiki.yobi.be/index.php?title=Outlook&diff=5267Outlook2008-11-01T09:41:21Z<p>Twalrant: /* Installing a local IMAP server on Windows */</p>
<hr />
<div>A page about Outlook on this wiki? Sounds weird isn't it?<br />
<br>Well, blame my employer.<br />
<br />
We migrated from Lotus Notes, with crappy hacked outdated client so Outlook is still better but...<br />
<br>At least under Lotus Notes it was possible to add an IMAP account (BTW Lotus Notes crashed quite often when talking IMAP...)<br />
<br>Here: Tools->Account Settings->''This feature has been disabled by your system administrator''<br />
<br />
== References ==<br />
* Microsoft Office 2007 Resource Kit (official documentation from Microsoft)<br />
** [http://technet.microsoft.com/en-gb/library/cc178979.aspx Documentation page]<br />
*** [http://go.microsoft.com/fwlink/?LinkId=85671 Security for the 2007 Office release]<br />
*** [http://go.microsoft.com/fwlink/?LinkID=94264 Group Policy overview for the 2007 Office release]<br />
** [http://go.microsoft.com/fwlink/?LinkId=78161 Administrative template (ADM,ADMX,...) files]<br />
*** Use [http://www.7-zip.org/ 7-zip] to decompress this file without installing it. Don't miss the summary excel sheet inside.<br />
* ''Configuring Microsoft Outlook 2003'', By Sue Mosher, Robert Sparnaaij, Charlie Pulfer, David Hooker.<br />
** Excellent book for administering Outlook 2003. Content can be browsed/searched on [http://books.google.com/books?id=v8oZNEByTR0C Google Books].<br />
* Excellent 3rd party page on Outlook policy: http://www.howto-outlook.com/howto/policies.htm<br />
* Folder with interesting policy settings on Outlook [http://theether.net/download/Microsoft/Office/2007/].<br />
<br />
== Unlocking ==<br />
<br />
===Main registry keys===<br />
Apparently important registry keys are under:<br />
HKEY_CURRENT_USER\Software\Microsoft\Office\12.0\Outlook<br />
HKEY_CURRENT_USER\Software\Microsoft\Windows NT\CurrentVersion\Windows Messaging Subsystem\Profiles\Outlook<br />
HKEY_CURRENT_USER\Software\Policies\Microsoft\Office\12.0\Outlook<br />
Some tips [http://www.hotline-pc.org/outlook.htm here] (french)<br />
<br />
===IMAP settings===<br />
<br />
We can remove the admin barrier on account management:<br />
HKEY_CURRENT_USER\Software\Policies\Microsoft\Office\12.0\Outlook\Setup\ModifyAccounts<br />
=0<br />
<br />
Another way without modifying the Registry is to use the import feature:<br />
<br>If e.g. Outlook Express client is also present on the Windows machine<br />
* In Outlook Express:<br />
** Wizard -> typed my IMAP&SMTP settings<br />
* In Outlook:<br />
** File -> Import and Export... -> Import Internet Mail Account Settings -> Microsoft Outlook Express or Microsoft Windows Mail -> Wizard allowing to edit the imported settings :-)<br />
** Then write a new mail -> Account (below Send button) -> select your new account -> Send test mail -> Prompted to choose the sent folder, ok -> you've a multiple tabs config view of your new account, possibility to switch servers to TLS, changing name of the account, saying you need auth to talk to your SMTP etc etc<br />
** If you need to tune IMAP settings later, go to registry and reset key (000000NN must be replaced with the number of your IMAP profile)<br />
HKEY_CURRENT_USER\Software\Microsoft\Windows NT\CurrentVersion\Windows Messaging Subsystem\Profiles\Outlook\9375CFF0413111d3B88A00104B2A6676\000000NN\IMAP Sentitems<br />
= 0<br />
<br />
Note that I also tried importing from Eudora Light & Eudora but Outlook didn't see anything<br />
<br />
=== Cached Exchange Mode ===<br />
The following keys were set in my configuration, preventing to change the settings related to ''Cached Exchange Mode''. In particular the mode selection was disabled, ie. the options ''Download full items'', ''Download headers and then full items'', ''Download headers'' were all grayed out.<br />
<source lang="reg"><br />
[HKEY_CURRENT_USER\Software\Policies\Microsoft\Office\12.0\Outlook\Cached Mode]<br />
"CachedExchangeMode"=dword:00000001<br />
"Enable"=dword:00000001<br />
"NoDrizzle"=dword:00000001<br />
"NoFullItems"=dword:00000001<br />
"NoHeaders"=dword:00000000<br />
"NoManualOnlineSync"=dword:00000001<br />
"SyncPFFav"=dword:00000001<br />
</source><br />
To unlock all settings, and eg. allow download full headers, simply delete values ''CachedExchangeMode'', ''NoDrizzle'', ''NoFullItems'', ''NoHeaders'', and ''NoManualOnlineSync'' (ie. all but ''Enable'' and ''SyncPFFav'').<br />
<br />
===Changing JunkMail levels===<br />
HKEY_CURRENT_USER\Software\Policies\Microsoft\Office\12.0\Outlook\Options\Mail\JunkMailProtection<br />
No Protection = 0xffffffff = 4294967295<br />
Low = 6<br />
High = 3<br />
Trusted Lists Only = 0x80000000 = 2147483648<br />
To enable the JunkMail otions in the Options->Preferences->E-Mail->Junk E-mail menu<br />
HKEY_CURRENT_USER\Software\Policies\Microsoft\Office\12.0\Outlook\DisableAntiSpam<br />
=0<br />
<br />
===AutoArchive===<br />
Recently the function ''AutoArchive'' vanished from Outlook, don't panic! To enable AutoArchive in the Menu->File again just change the following registry value:<br />
<br />
HKEY_CURRENT_USER\Software\Policies\Microsoft\Office\12.0\Outlook\Preferences\DisableManualArchive = 0<br />
<br />
Changing this value is not sufficient to get access back the AutoArchive options. You need to delete the entire registry key ''Preferences''. Not sure everything needs to go, but it does the work.<br />
<br />
[HKEY_CURRENT_USER\Software\Policies\Microsoft\Office\12.0\Outlook\Preferences]<br />
<br />
===All in one registry file===<br />
You can also put all the above registry modifications in one single file [{{#file:Outlook.reg}} Outlook.reg]<br />
<source lang=reg><br />
Windows Registry Editor Version 5.00<br />
<br />
[HKEY_CURRENT_USER\Software\Policies\Microsoft\Office\12.0\Outlook]<br />
"DisableAntiSpam"=dword:00000000<br />
<br />
[HKEY_CURRENT_USER\Software\Policies\Microsoft\Office\12.0\Outlook\Cached Mode]<br />
"NoFullItems"=-<br />
"NoDrizzle"=-<br />
"NoHeaders"=-<br />
"CachedExchangeMode"=-<br />
"NoManualOnlineSync"=-<br />
<br />
[HKEY_CURRENT_USER\Software\Policies\Microsoft\Office\12.0\Outlook\Options\Mail]<br />
"JunkMailProtection"=-<br />
<br />
[HKEY_CURRENT_USER\Software\Policies\Microsoft\Office\12.0\Outlook\Setup]<br />
"ModifyAccounts"=dword:00000000<br />
<br />
;Take care of that one, it could delete more than intended...<br />
[-HKEY_CURRENT_USER\Software\Policies\Microsoft\Office\12.0\Outlook\Preferences]<br />
</source><br />
<br />
...and modify the registry at each startup with the following command:<br />
regedit /s Outlook.reg<br />
<br />
'''Note''': the hyphens after the registry value and in front of the registry key indicates respectively a request to delete the value and the entire key. See http://support.microsoft.com/kb/310516 for details.<br />
<br />
==Group Policy and other configuration hints==<br />
<br />
* [http://technet.microsoft.com/en-us/library/cc303396.aspx Configure Outlook security and protection features]<br />
* [http://books.google.com/books?id=v8oZNEByTR0C&pg=PA232&lpg=PA232&dq=Outlook+policy+JunkMailProtection+registry&source=web&ots=NgPRrRu7ms&sig=0Fz7fiRm-hpc8GQTp9od3GtLLrM&hl=en&sa=X&oi=book_result&resnum=9&ct=result#PPA221,M1 Configuring Microsoft Outlook 2003]<br />
<br />
To use the Group Policy for Microsoft Outlook 2007 you may need to install the Outlook Group Policy template [http://www.yobi.be/files/outlk12.adm Outlk12.adm]<br />
<br />
# Copy the policy template Outlk12.adm into %WINDIR%\inf<br />
# Open Group Policy Editor: Start-> Run-> gpedit.msc<br />
# Add template:<br />
## Select User Configuration<br />
## Right-click on Administrative Templates<br />
## Select Add/Remove properties-> Click Add button<br />
## Browse to %WINDIR%\inf and select Outlk12.adm<br />
<br />
==iCalendar==<br />
Outlook does not handle correctly the iCal file (*.ics) with recurrent event.<br />
<br />
Problem: when opening (eg.: double-click on the attachment) an iCal file with multiple events, ie. multiple VEVENT sections, Outlook tries to add a complete calendar. Your are prompted with a dialog box with the following question: '''Add this Internet Calendar to Outlook'''. It is probably not what you want. Most probably you just need to add the multiple events in your existing calendar.<br />
<br />
The solution requires to save the iCal file on your hard drive and import it back using the import function.<br />
<br />
# Save file as...<br />
# File -> Import and Export...<br />
# Select ''Import and iCalendar (*.ics) or vCalendar (.vcs)''<br />
# Browse and select your saved iCal file, done.<br />
<br />
Solution source: https://events.sfu.ca/manual/en/iCalExporter.htm.<br />
<br />
==Moving PST location==<br />
cf [http://azcarya.blogspot.com/2008/02/gmail-outlook-2007-and-imap.html this post]<br />
<br />
# Close Outlook.<br />
# Open Control Panel -> Choose Mails -> Click on Data files.<br />
# Select the Account name and check for the location of the PST file. Leave the window open.<br />
# Open the folder containing the PST. Move the PST to the desired location.<br />
# Do NOT rename the file - if you do Outlook creates a new file in the default location again.<br />
# Switch to the Data Files window (as opened in Step 2) and double click on the PST file location.<br />
# This displays an error window, Ignore the error, and point to the new location. Close the windows.<br />
# Restart Outlook.<br />
# Outlook may create a new PST in the default location again, delete it, in such a case.<br />
<br />
==Recovering PST password==<br />
Password protection of PST is terribly wrong.<br />
<br />
Get [http://www.nirsoft.net/utils/pst_password.html PstPassword, a free Outlook PST Password Recovery], launch it and launch your PST, you'll get instantly a password, actuallt many passwords, and they will all work! How is it possible? Read [http://www.nirsoft.net/articles/pst_password_bug.html this].<br />
<br />
Note that McAfee detects the program as "Potentially Unwanted Program", a "[http://vil.nai.com/vil/content/v_150020.htm Generic PUP.z]":<br />
<br>''McAfee(R) Avert™ recognizes that this program may have legitimate uses in contexts where an authorized administrator has knowingly installed this application''<br />
<br>But still no question, the program is simply erased by McAfee.<br />
<br>One easy solution: open it under andLinux and run it with WINE :-)<br />
<br />
Apparently this can work both on "compressible encryption" and "high encryption" types of PST.<br />
==Coping with enterprise backup policy==<br />
The policy states:<br />
* Original e-mail and 'unique copies' must be stored in the mailbox or in the Central Vault (a Symantec stuff for central storage). <br />
* Copies of original e-mail can be stored locally to support working offline for which the original is available in the mailbox or Central Vault. <br />
* Original e-mail is e-mail as it enters MS Outlook or Central Vault. <br />
* A 'unique copy' is an original e-mail that has been modified. <br />
* This policy applies to all mailboxes in MS Outlook and Central Vault. <br />
So what we can do is:<br />
* Create a local .PST (or local IMAP) where you'll really archive your mails.<br />
* Don't create folders in the exchange mailbox but instead in your local .PST<br />
* In Exchange mailbox, only create a single folder called 'EV crap' or 'EV overload', or simply 'EV'<br />
* To archive a mail, you copy it from Exchange Inbox to your local .PST, then you move it to your 'EV' folder.<br />
* Every once in a while you go to your 'EV' folder, and you mass-send them to Enterprise Vault. Time to take a coffee break! (or two) (well, take a day off).<br />
<br />
You can setup a rule to do this automatically<br />
<br />
* Go to Tools --> Rules and Alerts --> New Rules <br />
* Select Start from a blank rule / Check messages after sending, then click Next<br />
* Click Next again and confirm rules applies to all sent mails<br />
* Select "Move a copy to the specified folder"<br />
* Click on "specified", and create a new EV folder in your inbox for instance, select 'EV' folder. Click Next.<br />
* Click Next again (no exception) <br />
** or optionally you can add exception for private mails by e.g. selecting "except if the subject contains specific words"<br />
** Click on "specific words" and add your keywords, such as "private", "Private", "PRIVATE", etc<br />
* Give rule a name (eg. Auto EV sent message), click Finish.<br />
<br />
You can do the same so that any incoming mail is automatically copied to given folder:<br />
* Go to Tools --> Rules and Alerts --> New Rules <br />
* Select Start from a blank rule / Check messages when they arrive, then click Next<br />
* Click Next again.<br />
* Select "Move a copy to the specified folder"<br />
* Click on "specified", and create a new EV folder in your inbox for instance, select 'EV' folder. Click Next.<br />
* Click Next again (no exception).<br />
** or optionally you can add exception for private mails by e.g. selecting "except if the subject contains specific words"<br />
** Click on "specific words" and add your keywords, such as "private", "Private", "PRIVATE", etc<br />
* Give rule a name (eg. Auto EV incoming message), click Finish.<br />
<br />
With these 2 rules, you can continue archive your mails normally in the local PST (remember don't make folders in exchange account, it's useless). For compliance with EV policy, you only need to go once in a while to the EV folder, and mass send all mails there in EV.<br />
<br />
Good luck!<br />
<br />
==Installing a local IMAP server on Windows==<br />
One possibility is uw-imap in Cygwin but if you want to use courier-imap, compilation under Cygwin is a nightmare... not anymore see [[Courier-Cygwin]]<br />
<br>One easy way is to install courier-imap within AndLinux, e.g. following instructions at https://help.ubuntu.com/community/Courier<br />
<br />
==Macros==<br />
===Installation===<br />
To install a macro:<br />
* Alt-F11 in Outlook<br />
* Open Project1 -> Microsoft Office Outlook Objects -> ThisOutlookSession (double-click)<br />
* copy/paste code<br />
* close & save<br />
If required, allow unsigned macros:<br />
* Tools -> Macro -> Security -> Macro Security -> Warning for all macros<br />
You'll have annoying popup at startup but there is no way around<br />
<br />
====Adding toolbar button to execute a Macro====<br />
# Create a new toolbar. Right-click on any Outlook toolbar and choose "Customize." From the Toolbars tab, hit the "New" button, and name your toolbar anything you want (like "my shortcuts"). Drag and drop your new toolbar to the top of Outlook to dock it next to your other toolbars.<br />
# Add a Macro to your new toolbar. With the Customize dialog still open, go to its Commands tab. From the Commands tab, scroll down the Categories list, select Macros. In the Commands list select, drag and drop your Macro to your new toolbar.<br />
# Customize your new shortcut/button. With the Customize dialog still open, go to its Commands tab. Click on the new button in the toolbar (not in the Customize dialog). The button ''Modify Selection'' in the Customize dialog is now enabled. Click on it to change multiple properties of your new toolbar button.<br />
<br />
Solution source: http://lifehacker.com/381966/tweak-microsoft-outlook-to-empty-your-inbox-faster<br />
<br />
<br>Todo: add the macro in the right-click menu.<br />
<br />
===Send & Save===<br />
Lotus Notes can prompt the sender to specify what folder a message should be saved in. In Outlook, you can set the storage folder on the Options dialog. This VBA code reproduces something closer to the Notes behavior by popping up the Select Folder dialog when the user sends the message. (see [http://www.outlookcode.com/d/code/setsavefolder.htm here] and [http://www.outlookcode.com/codedetail.aspx?id=456 there])<br />
<br>''UPDATE:'' Avoid treating appointments as it fails.<br />
<source lang=vb><br />
Private Sub Application_ItemSend(ByVal Item As Object, _<br />
Cancel As Boolean)<br />
Dim objNS As NameSpace<br />
Dim objFolder As MAPIFolder<br />
Set objNS = Application.GetNamespace("MAPI")<br />
If TypeOf Item Is MailItem Then<br />
Set objFolder = objNS.PickFolder<br />
If TypeName(objFolder) <> "Nothing" Then<br />
Set Item.SaveSentMessageFolder = objFolder<br />
End If<br />
End If<br />
Set objFolder = Nothing<br />
Set objNS = Nothing<br />
End Sub<br />
</source><br />
If you don't want this pop-up all the time but to sort on casual base, you can use the built-in option:<br />
* While writing a new mail, select "Options" tab (not the "Options" toolbar) -> "Save Sent Item" button -> Other Folder -> Select<br />
<br />
===Move To Archive===<br />
Lotus Notes provided a way to archive mails manually. This feature is not supported by Outlook. To point is to select one or multiple mails in the inbox and move then with one single action to an archive folder. The following macro helps you to move mail into a dedicated archive folder (selected PST file + selected folder):<br />
<br>'''Note''':You may need to change the name of the PST file (''"Personal Folders"'') and the target folder (''"Ancient Archive"'') according to your setup.<br />
<br />
'''OBSOLETE''': take a look at the macro ''Archive Now''<br />
<br />
<source lang=vb><br />
Sub MoveToArchive()<br />
On Error Resume Next<br />
Dim objFolder As Outlook.MAPIFolder<br />
Dim objNS As Outlook.NameSpace, objItem As Outlook.MailItem<br />
<br />
Set objNS = Application.GetNamespace("MAPI")<br />
Set objFolder = objNS.Folders("Personal Folders").Folders("Ancient Archive")<br />
'Assume this is a mail folder<br />
<br />
<br />
If objFolder Is Nothing Then<br />
MsgBox "This folder doesn't exist!", vbOKOnly + vbExclamation, "INVALID FOLDER"<br />
End If<br />
<br />
<br />
If Application.ActiveExplorer.Selection.Count = 0 Then<br />
'Require that this procedure be called only when a message is selected<br />
Exit Sub<br />
End If<br />
<br />
For Each objItem In Application.ActiveExplorer.Selection<br />
If objFolder.DefaultItemType = olMailItem Then<br />
If objItem.Class = olMail Then<br />
objItem.UnRead = False<br />
objItem.Move objFolder<br />
End If<br />
End If<br />
Next<br />
<br />
Set objItem = Nothing<br />
Set objFolder = Nothing<br />
Set objNS = Nothing<br />
End Sub<br />
</source><br />
<br>Solution source: http://www.yeraze.com/article.php/outlook_macro_move_to_folder_mark_Read<br />
<br />
===Archive Now===<br />
The ''Archive Now'' macro better mimic the expected behavior of the ''Archive Selected Items'' of Lotus Notes (I never thought I would like to mimic anything from Lotus Notes,...) This ''Archive Now'' macro moves the selected mails, meetings and appointments ('''NEW''') in the same sub-folder as its original location. Note that the archive operation does not depend on any time and date information. All selected mails, meetings and appointments will be archived/moved.<br />
<br>'''Note''': you may need or want to change the destination name (ie: ''"Archive Folders"'')<br />
<br />
<source lang=vb><br />
' Routine/Macro to archive selected mails into given data file<br />
Sub ArchiveNow()<br />
On Error Resume Next<br />
MoveToFolder ("Archive Folders")<br />
End Sub<br />
'<br />
' Function to move selected mails into given data file<br />
Public Function MoveToFolder(destName As String)<br />
Dim objNS As Outlook.NameSpace<br />
Dim objApp As Application<br />
Dim objFolder As Outlook.MAPIFolder<br />
Dim strCurrentFolderRootName As String<br />
Dim strDestinationFolderPath As String<br />
Dim objItem As Object<br />
<br />
On Error Resume Next<br />
<br />
' Some basic initialization, get app & namespace objects<br />
Set objApp = CreateObject("Outlook.Application")<br />
Set objNS = objApp.GetNamespace("MAPI")<br />
<br />
' Abort if nothing selected<br />
If objApp.ActiveExplorer.Selection.Count = 0 Then<br />
'Require that this procedure be called only when a message is selected<br />
Exit Function<br />
End If<br />
<br />
' Abort if destination == source<br />
strCurrentFolderRootName = GetFolderRootName(objApp.ActiveExplorer.CurrentFolder)<br />
If strCurrentFolderRootName = destName Then<br />
' Require that this procedure be called outside destination folder<br />
Exit Function<br />
End If<br />
<br />
' Get destination folder path<br />
strDestinationFolderPath = Replace(objApp.ActiveExplorer.CurrentFolder.FolderPath, _<br />
"\\" + strCurrentFolderRootName, destName)<br />
<br />
' Get destination folder object<br />
Set objFolder = GetFolder(strDestinationFolderPath)<br />
<br />
' Check if destination folder exist, if not create it!<br />
If objFolder Is Nothing Then<br />
Dim Response<br />
Response = MsgBox("Folder '" + strDestinationFolderPath + "' does not exist. " + _<br />
"Do you want to create it?", vbYesNo + vbExclamation, "Folder not found")<br />
If Response = vbYes Then<br />
CreateFolder (strDestinationFolderPath)<br />
Set objFolder = GetFolder(strDestinationFolderPath)<br />
If objFolder Is Nothing Then<br />
MsgBox "The destination folder creation failed!", vbOKOnly + vbExclamation, "INVALID FOLDER"<br />
Exit Function<br />
End If<br />
Else<br />
Exit Function<br />
End If<br />
End If<br />
<br />
' Move mails, meetings and appointments to destination folder<br />
For Each objItem In objApp.ActiveExplorer.Selection<br />
If objFolder.DefaultItemType = olMailItem Then<br />
' Process Mail item<br />
If TypeOf objItem Is MailItem Then<br />
Dim objMailItem As Outlook.MailItem<br />
Set objMailItem = objItem<br />
objMailItem.UnRead = False<br />
objMailItem.Move objFolder<br />
Set objMailItem = Nothing<br />
End If<br />
' Process Meeting item<br />
If TypeOf objItem Is MeetingItem Then<br />
Dim objMeetingItem As Outlook.MeetingItem<br />
Set objMeetingItem = objItem<br />
objMeetingItem.UnRead = False<br />
objMeetingItem.Move objFolder<br />
Set objMeetingItem = Nothing<br />
End If<br />
' Process Appointment item - NOTE: not sure it will ever be necessary<br />
If TypeOf objItem Is AppointmentItem Then<br />
Dim objAppointItem As Outlook.AppointmentItem<br />
Set objAppointItem = objItem<br />
objAppointItem.UnRead = False<br />
objAppointItem.Move objFolder<br />
Set objAppointItem = Nothing<br />
End If<br />
End If<br />
Next<br />
<br />
Set objNS = Nothing<br />
Set objApp = Nothing<br />
Set objItem = Nothing<br />
Set objFolder = Nothing<br />
End Function<br />
'<br />
' Function to returns the folder name of the top/root folder, just below the namespace<br />
Public Function GetFolderRootName(objFolder As MAPIFolder) As String<br />
If Not objFolder.Parent.Class = olFolder Then<br />
GetFolderRootName = objFolder.Name<br />
Exit Function<br />
End If<br />
GetFolderRootName = GetFolderRootName(objFolder.Parent)<br />
End Function<br />
'<br />
' Function to return a folder (object) specified by a full folder path<br />
Public Function GetFolder(strFolderPath As String) As MAPIFolder<br />
<br />
' folder path needs to be something like<br />
' "Public Folders\All Public Folders\Company\Sales"<br />
<br />
Dim objApp As Outlook.Application<br />
Dim objNS As Outlook.NameSpace<br />
Dim colFolders As Outlook.Folders<br />
Dim objFolder As Outlook.MAPIFolder<br />
Dim arrFolders() As String<br />
Dim I As Long<br />
<br />
On Error Resume Next<br />
<br />
strFolderPath = Replace(strFolderPath, "/", "\")<br />
arrFolders() = Split(strFolderPath, "\")<br />
Set objApp = CreateObject("Outlook.Application")<br />
Set objNS = objApp.GetNamespace("MAPI")<br />
Set objFolder = objNS.Folders.Item(arrFolders(0))<br />
<br />
If Not objFolder Is Nothing Then<br />
For I = 1 To UBound(arrFolders)<br />
Set colFolders = objFolder.Folders<br />
Set objFolder = Nothing<br />
Set objFolder = colFolders.Item(arrFolders(I))<br />
If objFolder Is Nothing Then<br />
Exit For<br />
End If<br />
Next<br />
End If<br />
<br />
Set GetFolder = objFolder<br />
Set colFolders = Nothing<br />
Set objNS = Nothing<br />
Set objApp = Nothing<br />
End Function<br />
'<br />
' Function to create a folder specified by a full folder path<br />
Public Function CreateFolder(strFolderPath As String)<br />
<br />
' folder path needs to be something like<br />
' "Public Folders\All Public Folders\Company\Sales"<br />
Dim objNS As Outlook.NameSpace<br />
Dim objApp As Application<br />
Dim objFolder As Outlook.MAPIFolder<br />
Dim colFolders As Outlook.Folders<br />
Dim arrFolders() As String<br />
<br />
On Error Resume Next<br />
<br />
' Some basic initialization, get app & namespace objects<br />
Set objApp = CreateObject("Outlook.Application")<br />
Set objNS = objApp.GetNamespace("MAPI")<br />
<br />
' Build an array of folder names...<br />
strFolderPath = Replace(strFolderPath, "/", "\")<br />
strFolderPath = Replace(strFolderPath, "\\", "", 1, 1)<br />
arrFolders() = Split(strFolderPath, "\")<br />
Set objFolder = objNS.Folders.Item(arrFolders(0))<br />
<br />
' Process folders<br />
If Not objFolder Is Nothing Then<br />
For I = 1 To UBound(arrFolders)<br />
Set colFolders = objFolder.Folders<br />
Set objFolder = Nothing<br />
Set objFolder = colFolders.Item(arrFolders(I))<br />
If objFolder Is Nothing Then<br />
colFolders.Add (arrFolders(I))<br />
Set objFolder = colFolders.Item(arrFolders(I))<br />
End If<br />
Next<br />
End If<br />
<br />
Set colFolders = Nothing<br />
Set objNS = Nothing<br />
Set objApp = Nothing<br />
End Function<br />
</source><br />
<br />
<br>Inspiration sources: <br />
*http://www.outlookcode.com/codedetail.aspx?id=321<br />
*http://www.outlookcode.com/codedetail.aspx?id=714<br />
<br />
==Interoperability between Exchange/Outlook & Linux==<br />
<br />
===PST to Maildir===<br />
<br />
* In Outlook:<br />
** New -> Outlook Data File... -> Outlook 97-2002 Personal Folders file<br />
** Copy/Move mails to it<br />
** Right-Click on it -> Close it (probably safer)<br />
* In Linux:<br />
** Convert to mbox using readpst, then to Maildir using mb2md<br />
<source lang=bash><br />
mkdir pst<br />
readpst -r -o pst backup.pst<br />
find pst -name mbox -size 0 -exec rm {} \;<br />
find pst -mindepth 2 -type d -print0|xargs --null -I XXX mb2md -s "$(pwd)/XXX/mbox" -<br />
find pst -mindepth 2 -name mbox -print0|xargs --null rm<br />
</source><br />
<br />
I tried the PST Import plugin v1.2 for Thunderbird but it failed finding any mail in the PST<br />
===Openchange===<br />
I tried the one from Debian Experimental (version 1.0~svn679-1)<br />
mapiprofile --address=A.B.C.D --username=name --password=passwd --domain=DOM --workstation=BLABLA --profile=test --create<br />
-> segfault from libmapi0<br />
<br />
I tried to compile the libmapi0 from the SVN, no segfault anymore but still failed<br />
===Evolution===<br />
Apparently ther is an attempt to support MAPI in a development branch but it has too much recent dependencies for me to compile it...<br />
svn checkout http://svn.gnome.org/svn/evolution/branches/EXCHANGE_MAPI_BRANCH<br />
<br />
svn diff http://svn.gnome.org/svn/evolution/trunk http://svn.gnome.org/svn/evolution/branches/EXCHANGE_MAPI_BRANCH</div>Twalranthttps://wiki.yobi.be/index.php?title=Courier-Cygwin&diff=5266Courier-Cygwin2008-11-01T09:37:03Z<p>Twalrant: /* Compilation and installation */</p>
<hr />
<div>=Pre-requisite=<br />
<br />
Courier-IMAP requires the installation of the [http://www.courier-mta.org/authlib/ Courier Authentication Library] and the following cygwin tools and packages<br />
<br />
* patch, tar, make, gcc<br />
* crypt<br />
* libgdbm-devel<br />
* libtool<br />
* inetutils<br />
* cygrunsrv<br />
<br />
Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install the required packages.<br />
<br />
=Courier Authentication Library=<br />
<br />
Installation of Courier Authentication Library using the module userdb to manage mail accounts. All other modules are disabled.<br />
<br />
==Compilation and installation==<br />
<br />
Download and untar [http://www.courier-mta.org/download.php#authlib courier-authlib] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-authlib-0.61.0.tar.bz2 0.61.0]<br />
<br />
Apply the [{{#file:courrier-authlib-0.61.0-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# add libtool flag (-no-undefined) required for DLL creation<br />
# add missing dependencies<br />
# add PATH in start script to access new DLL (installed in a different directory)<br />
<br />
Solution source: http://lists.cairographics.org/archives/cairo/2004-April/001125.html<br />
<br />
<source lang=diff><br />
--- courier-authlib-0.61.0/makedat/Makefile.in 2008-05-24 16:21:09.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/makedat/Makefile.in 2008-10-21 16:02:38.709166700 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-authlib-0.61.0/Makefile.in 2008-07-12 21:41:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/Makefile.in 2008-10-23 22:59:03.843750000 +0200<br />
@@ -213,9 +213,10 @@<br />
LTCOMPILE = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
--mode=compile $(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) \<br />
$(AM_CPPFLAGS) $(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS)<br />
-CCLD = $(CC)<br />
+CCLD = $(CC) -no-undefined<br />
+CCLDEXE = $(CC)<br />
LINK = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
- --mode=link $(CCLD) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
+ --mode=link $(CCLDEXE) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
$(LDFLAGS) -o $@<br />
SOURCES = $(libauthcustom_la_SOURCES) $(libauthldap_la_SOURCES) \<br />
$(libauthmysql_la_SOURCES) $(libauthpam_la_SOURCES) \<br />
@@ -452,9 +453,9 @@<br />
README.authdebug.html<br />
<br />
DISTCLEANFILES = dbobj.config README_authlib.html<br />
-commonlibdep = libcourierauthcommon.la<br />
+commonlibdep = libcourierauthcommon.la libcourierauth.la<br />
commonldflags = -module -rpath $(pkglibdir) -export-symbols-regex 'courier_auth.*_init' -avoid-version<br />
-commonlibadd = libcourierauthcommon.la<br />
+commonlibadd = libcourierauthcommon.la libcourierauth.la<br />
libcourierauthcommon_t = @CRYPTLIBS@<br />
libcourierauthcommon_la_SOURCES = \<br />
auth.h courierauth.h \<br />
--- courier-authlib-0.61.0/authdaemond.in 2005-07-05 14:25:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/authdaemond.in 2008-10-25 12:03:32.140625000 +0200<br />
@@ -15,4 +15,10 @@<br />
set -a<br />
. @authdaemonrc@<br />
<br />
+# Some shared libraries (DLL) are installed in @libdir@/bin<br />
+# instead of @libdir@/@PACKAGE@<br />
+# Setting LD_LIBRARY_PATH at runtime or LR_RUN_PATH at linktime doesn't<br />
+# work in cygwin, only setting PATH works. <br />
+export PATH=$PATH:@libdir@/bin<br />
+<br />
exec ${sbindir}/courierlogger -pid=@authdaemonvar@/pid $LOGGEROPTS -$1 @libexecdir@/courier-authlib/authdaemond<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-authlib-0.61.0-cygwin.patch<br />
<br />
Configure the package without most authentication modules, keeping only ''userdb''.<br />
<br />
'''Note''': replace ''mailuser'' by an existing user name (in your /etc/passwd file). I used my own username.<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait --without-authpam --without-authldap --without-authpwd \<br />
--without-authshadow --without-authcustom --without-authpipe --without-authmysql --without-authpgsql --with-mailuser=mailuser \<br />
--with-mailgroup=mkgroup-l-d<br />
<br />
Take a long pause... and when ready execute the following command.<br />
<br />
$ make<br />
<br />
Take again a long pause... then check the result and install the libraries<br />
<br />
$ make check<br />
$ make install<br />
<br />
==Configuration==<br />
<br />
Create authdaemonrc file: /usr/local/etc/authlib/authdaemonrc<br />
<br />
$ cp /usr/local/etc/authlib/authdaemonrc.dist /usr/local/etc/authlib/authdaemonrc<br />
<br />
Change number of daemons (I use three) and enable DEBUG_LOGIN<br />
<br />
<source lang=text><br />
# The number of daemon processes that are started.<br />
daemons=3<br />
<br />
# DEBUG_LOGIN=2 - turn on debugging + log passwords too<br />
DEBUG_LOGIN=2<br />
</source><br />
<br />
See http://www.courier-mta.org/authlib/README.authdebug.html for details.<br />
<br />
==IMAP accounts==<br />
<br />
User accounts and settings are managed by ''userdb''. See [http://linux.die.net/man/8/makeuserdb makeuserdb] man page for details, or used the freshly new install man page - man makeuserdb<br />
<br />
Assuming ''username'' is your username, 1001 and 10545 are respectively the UID and GID of an existing user (part of your /etc/passwd and /etc/group). I use my own UID and GID. Create the mailuser home directory, if required, and create Maildir folder.<br />
<br />
$ mkdir -p /home/username<br />
$ cd /home/username<br />
$ /usr/lib/courier-imap/bin/maildirmake Maildir<br />
<br />
Create the userdb text file /usr/local/etc/authlib/userdb<br />
<br />
$ touch /usr/local/etc/authlib/userdb<br />
$ chmod 700 /usr/local/etc/authlib/userdb<br />
<br />
Edit /usr/local/etc/authlib/userdb, one line per account<br />
<br />
<source lang=text><br />
username[TAB]uid=1001|gid=10111|home=/home/username|mail=/home/username/Maildir|systempw=XXXXXX<br />
</source><br />
<br />
where XXXXXX is the encrypted password created with<br />
<br />
$ /usr/local/sbin/userdbpw.exe<br />
<br />
Create the (binary) userdb<br />
<br />
$ /usr/local/sbin/makeuserdb<br />
<br />
You should now have the following files created:<br />
<br />
* /usr/local/etc/authlib/userdb.dat<br />
* /usr/local/etc/authlib/userdbshadow.dat<br />
<br />
==Running==<br />
<br />
Install and configure syslogd. Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install inetutils (contains syslogd). Configure syslogd with the following command. It will create the /etc/syslogd.conf file and install a windows service using cygrunsrv<br />
<br />
$ syslogd-config<br />
<br />
Start the authlib daemon with the following command:<br />
<br />
$ /usr/local/sbin/authdaemon start<br />
<br />
Stop the daemon with the following command:<br />
<br />
$ /usr/local/sbin/authdaemon stop<br />
<br />
You'll find log messages in /var/log/messages (default target file as specified in /etc/syslogd.conf)<br />
<br />
==Testing authlib==<br />
<br />
$ /usr/local/sbin/authtest username CCCCCC<br />
Authentication succeeded.<br />
<br />
Authenticated: username (uid 1001, gid 10545)<br />
Home Directory: /home/username<br />
Maildir: /home/username/Maildir<br />
Quota: (none)<br />
Encrypted Password: XXXXXX<br />
Cleartext Password: CCCCCC<br />
Options: (none)<br />
<br />
where username is your user name and XXXXXX is your encrypted password as provided in ''/usr/local/etc/authlib/userdb''. CCCCCC is your password in clear.<br />
<br />
==Troubleshooting==<br />
<br />
Should you have a doubt on the execution of a command (ie: no output) you can check if the application is able to load required DLL. This error is not reported. Using ''strace'', windows will complain about DLL not found, if any. To solve this problem you may need to add some path in your PATH. For example, in order to test authlib with authtest:<br />
<br />
$ strace /usr/local/sbin/authtest<br />
# This will open a dialog box to complain about DLL.<br />
$ export PATH=$PATH:/usr/local/lib/bin<br />
$ /usr/local/sbin/authtest ausername<br />
<br />
==Courier Authentication Config==<br />
<br />
$ /usr/local/bin/courierauthconfig.exe --version<br />
$ /usr/local/bin/courierauthconfig.exe --ldflags<br />
$ /usr/local/bin/courierauthconfig.exe --cppflags<br />
$ /usr/local/bin/courierauthconfig.exe --configfiles<br />
<br />
=Courier-IMAP=<br />
==Compilation and installation==<br />
<br />
Download and untar package [http://www.courier-mta.org/download.php#imap courier-imap] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-imap-4.4.1.tar.bz2 4.4.1.20080920]<br />
<br />
Apply the [{{#file:courrier-imap-4.4.1-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# incorrect usage of EXTEXT in main ''Makefile''<br />
# remove usage of /usr/lib/env in start/stop script (/usr/lib/env does not seem to work under Cygwin)<br />
<br />
<source lang=diff><br />
--- courier-imap-4.4.1.20080920/makedat/Makefile.in 2008-08-24 19:52:51.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/makedat/Makefile.in 2008-10-21 20:43:27.500000000 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-imap-4.4.1.20080920/Makefile.in 2008-09-20 14:48:46.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/Makefile.in 2008-10-21 20:59:45.156250000 +0200<br />
@@ -247,9 +247,9 @@<br />
CLEANFILES = $(databin_SCRIPTS) $(man_MANS) $(sysconf_DATA) $(sbin_SCRIPTS)<br />
databindir = $(datadir)<br />
databin_SCRIPTS = mkimapdcert mkpop3dcert<br />
-binPROGRAMS = imapd pop3d maildirmake maildiracl deliverquota maildirkw<br />
-sbinPROGRAMS = imaplogin pop3login<br />
-libexecPROGRAMS = makedatprog couriertcpd<br />
+binPROGRAMS = imapd$(EXEEXT) pop3d$(EXEEXT) maildirmake$(EXEEXT) maildiracl$(EXEEXT) deliverquota$(EXEEXT) maildirkw$(EXEEXT)<br />
+sbinPROGRAMS = imaplogin$(EXEEXT) pop3login$(EXEEXT)<br />
+libexecPROGRAMS = makedatprog$(EXEEXT) couriertcpd$(EXEEXT)<br />
bin_PROGRAMS = @binPROGRAMS_exec@<br />
sbin_PROGRAMS = @sbinPROGRAMS_exec@<br />
libexec_PROGRAMS = @libexecPROGRAMS_exec@<br />
--- courier-imap-4.4.1.20080920/imapd.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/imapd.rc.in 2008-10-26 10:17:51.359375000 +0100<br />
@@ -22,6 +22,15 @@<br />
exit 1<br />
fi<br />
<br />
+# Location for some shared libraries (cygcourierauth*.dll) from authlib<br />
+AUTHLIBDIR=/usr/local<br />
+if test ! -f $AUTHLIBDIR/lib/bin/cygcourierauth.dll<br />
+then<br />
+ echo "$AUTHLIBDIR/lib/bin/cygcourierauth.dll not found."<br />
+ exit 1<br />
+fi<br />
+export PATH=$PATH:$AUTHLIBDIR/lib/bin<br />
+<br />
TLS_CACHEFILE=""<br />
. @sysconfdir@/imapd-ssl<br />
. @sysconfdir@/imapd<br />
@@ -35,7 +44,7 @@<br />
<br />
umask $IMAP_UMASK<br />
@ULIMIT@ $IMAP_ULIMITD<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
--- courier-imap-4.4.1.20080920/pop3d.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/pop3d.rc.in 2008-10-26 10:18:02.187500000 +0100<br />
@@ -22,12 +22,21 @@<br />
exit 1<br />
fi<br />
<br />
+# Location for some shared libraries (cygcourierauth*.dll) from authlib<br />
+AUTHLIBDIR=/usr/local<br />
+if test ! -f $AUTHLIBDIR/lib/bin/cygcourierauth.dll<br />
+then<br />
+ echo "$AUTHLIBDIR/lib/bin/cygcourierauth.dll not found."<br />
+ exit 1<br />
+fi<br />
+export PATH=$PATH:$AUTHLIBDIR/lib/bin<br />
+<br />
. @sysconfdir@/pop3d-ssl<br />
. @sysconfdir@/pop3d<br />
<br />
case $1 in<br />
start)<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-imap-4.4.1-cygwin.patch<br />
<br />
Configure the package<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait<br />
<br />
Take a walk... and when ready execute the following command to build the package.<br />
<br />
$ make<br />
<br />
Time to go for some coffee... and then install the package with the usual<br />
<br />
$ make install<br />
$ make install-configure<br />
<br />
'''NOTES''': list of related topics found during investigation for compilation<br />
* authldap: configure: error: -lresolve is needed for res_query... http://www.cygwin.com/ml/cygwin/2005-04/msg00419.html<br />
<br />
==Configuration==<br />
<br />
Setup courier-imap: $prefix/etc/imapd (where $prefix=/usr/lib/courier-imap)<br />
<br />
Set ADDRESS to a valid value (0 or 127.0.0.1) and change IMAP_ULIMITD to a value accepted by the command ulimit. I simply used the existing value returned by<br />
<br />
$ ulimit -v<br />
<br />
==Running==<br />
<br />
Syslogd service and authdaemond should be started. See above.<br />
<br />
Start the imap daemon with the following command:<br />
<br />
$ /usr/lib/courier-imap/libexec/imapd.rc start<br />
<br />
Stop the daemon with the following command:<br />
<br />
$ /usr/lib/courier-imap/libexec/imapd.rc stop<br />
<br />
You'll find log messages in /var/log/messages (default target file as specified in /etc/syslogd.conf)<br />
<br />
==Testing==<br />
When authdaemond and imapd are running you can do a simple login test:<br />
<br />
$ telnet localhost 143<br />
<br />
and type the login command<br />
<br />
a login <username> <password><br />
<br />
the server should reply<br />
<br />
a OK LOGIN Ok.<br />
<br />
to which you can reply with a logout<br />
<br />
a logout<br />
<br />
the session is terminated by the server<br />
<br />
* BYE Courier-IMAP server shutting down<br />
a OK LOGOUT completed<br />
Connection closed by foreign host.<br />
<br />
'''Hint:''' if the connection is immediately closed by foreign host it probably means that ''imapd'' does not have access to all required DLLs. Check your PATH.<br />
<br />
==All in one==<br />
If everything works fine you can use the following [{{#file:imapd}} startup script] to launch or stop imap and authlib daemons. It can be saved in /usr/local/sbin.<br />
<br />
<source lang=bash><br />
#! /bin/sh<br />
#<br />
# Courier imap daemon startup script.<br />
<br />
authlib=/usr/local/sbin/authdaemond<br />
imapd=/usr/lib/courier-imap/libexec/imapd.rc<br />
<br />
test ! -f $authlib && echo "File not found: $authlib" && exit 1;<br />
test ! -f $imapd && echo "File not found: $imapd" && exit 1;<br />
<br />
case $1 in<br />
start)<br />
$authlib start<br />
$imapd start<br />
;;<br />
stop)<br />
$imapd stop<br />
$authlib stop<br />
;;<br />
*)<br />
echo "Usage: $0 <start|stop>"<br />
;;<br />
esac<br />
</source><br />
<br />
==Cygwin service==<br />
Create the [{{#file:imapd-srv.sh}} service script]<br />
<br />
<source lang=bash><br />
#!/bin/sh<br />
# File: imapd-service.sh<br />
# Purpose: Courier imap daemon service script.<br />
#<br />
# NOTE: This script must be excutable by SYSTEM<br />
username=username # <<<< Change me !!!<br />
pidsleep=''<br />
<br />
# Function to handle QUIT signal.<br />
# Stop imapd daemon and kill background sleep.<br />
function handleQuit<br />
{<br />
echo "STOPPING: /usr/local/sbin/imapd"<br />
su $username -c "/usr/local/sbin/imapd stop"<br />
test -n "$pidsleep" && kill -9 $pidsleep<br />
exit<br />
}<br />
<br />
# Interruptible sleep<br />
# Note: sleep is an external command (not builtin command), hence<br />
# not interruptible by the QUIT signal.<br />
function intsleep<br />
{<br />
sleep $1 &<br />
pidsleep=$!<br />
wait $pidsleep<br />
}<br />
<br />
echo "STARTING: /usr/local/sbin/imapd as $username at "`date`<br />
su $username -c "/usr/local/sbin/imapd start"<br />
<br />
trap "handleQuit" SIGQUIT<br />
<br />
echo "WAITING: "$$<br />
while true; do intsleep 1d; done<br />
</source><br />
<br />
Change username and save it to your favorite location, says /usr/local/sbin. The service script must be executable by SYSTEM, ie: the user that run the windows services.<br />
<br />
$ chmod +rx /usr/local/sbin/imapd-service.sh<br />
<br />
Install the new service with the following command.<br />
<br />
$ cygrunsrv --install imapd --desc "Courier IMAP daemon" --disp "CYGWIN imapd" \<br />
--path /usr/local/sbin/imapd-service.sh --termsig QUIT --type auto --shutdown<br />
<br />
Finally, just start the service<br />
<br />
$ cygrunsrv --start imapd<br />
or<br />
$ net start imapd<br />
<br />
You should now have couple of processes related to courier-imap<br />
<br />
$ ps -a<br />
<br />
'''NOTES''':<br />
* If the service could not be started, it's probably because the service script is not executable by SYSTEM<br />
<br />
$ net start imapd<br />
The CYGWIN imapd service is starting.<br />
The CYGWIN imapd service could not be started. <br />
<br />
The service did not report an error.<br />
<br />
More help is available by typing NET HELPMSG 3534.<br />
<br />
* The combination of background sleep and builtin wait command is used to make the waiting statment interruptible. The original script found on the net, was simply using a 'sleep 1' which turned to consume ~10% of the CPU.<br />
<br />
=Maildir=<br />
'''maildirmake''' is part of the courier-imap package<br />
<br />
$ /usr/lib/courier-imap/bin/maildirmake</div>Twalranthttps://wiki.yobi.be/index.php?title=Courier-Cygwin&diff=5265Courier-Cygwin2008-11-01T09:24:51Z<p>Twalrant: /* Configuration */</p>
<hr />
<div>=Pre-requisite=<br />
<br />
Courier-IMAP requires the installation of the [http://www.courier-mta.org/authlib/ Courier Authentication Library] and the following cygwin tools and packages<br />
<br />
* patch, tar, make, gcc<br />
* crypt<br />
* libgdbm-devel<br />
* libtool<br />
* inetutils<br />
* cygrunsrv<br />
<br />
Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install the required packages.<br />
<br />
=Courier Authentication Library=<br />
<br />
Installation of Courier Authentication Library using the module userdb to manage mail accounts. All other modules are disabled.<br />
<br />
==Compilation and installation==<br />
<br />
Download and untar [http://www.courier-mta.org/download.php#authlib courier-authlib] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-authlib-0.61.0.tar.bz2 0.61.0]<br />
<br />
Apply the [{{#file:courrier-authlib-0.61.0-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# add libtool flag (-no-undefined) required for DLL creation<br />
# add missing dependencies<br />
# add PATH in start script to access new DLL (installed in a different directory)<br />
<br />
Solution source: http://lists.cairographics.org/archives/cairo/2004-April/001125.html<br />
<br />
<source lang=diff><br />
--- courier-authlib-0.61.0/makedat/Makefile.in 2008-05-24 16:21:09.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/makedat/Makefile.in 2008-10-21 16:02:38.709166700 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-authlib-0.61.0/Makefile.in 2008-07-12 21:41:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/Makefile.in 2008-10-23 22:59:03.843750000 +0200<br />
@@ -213,9 +213,10 @@<br />
LTCOMPILE = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
--mode=compile $(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) \<br />
$(AM_CPPFLAGS) $(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS)<br />
-CCLD = $(CC)<br />
+CCLD = $(CC) -no-undefined<br />
+CCLDEXE = $(CC)<br />
LINK = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
- --mode=link $(CCLD) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
+ --mode=link $(CCLDEXE) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
$(LDFLAGS) -o $@<br />
SOURCES = $(libauthcustom_la_SOURCES) $(libauthldap_la_SOURCES) \<br />
$(libauthmysql_la_SOURCES) $(libauthpam_la_SOURCES) \<br />
@@ -452,9 +453,9 @@<br />
README.authdebug.html<br />
<br />
DISTCLEANFILES = dbobj.config README_authlib.html<br />
-commonlibdep = libcourierauthcommon.la<br />
+commonlibdep = libcourierauthcommon.la libcourierauth.la<br />
commonldflags = -module -rpath $(pkglibdir) -export-symbols-regex 'courier_auth.*_init' -avoid-version<br />
-commonlibadd = libcourierauthcommon.la<br />
+commonlibadd = libcourierauthcommon.la libcourierauth.la<br />
libcourierauthcommon_t = @CRYPTLIBS@<br />
libcourierauthcommon_la_SOURCES = \<br />
auth.h courierauth.h \<br />
--- courier-authlib-0.61.0/authdaemond.in 2005-07-05 14:25:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/authdaemond.in 2008-10-25 12:03:32.140625000 +0200<br />
@@ -15,4 +15,10 @@<br />
set -a<br />
. @authdaemonrc@<br />
<br />
+# Some shared libraries (DLL) are installed in @libdir@/bin<br />
+# instead of @libdir@/@PACKAGE@<br />
+# Setting LD_LIBRARY_PATH at runtime or LR_RUN_PATH at linktime doesn't<br />
+# work in cygwin, only setting PATH works. <br />
+export PATH=$PATH:@libdir@/bin<br />
+<br />
exec ${sbindir}/courierlogger -pid=@authdaemonvar@/pid $LOGGEROPTS -$1 @libexecdir@/courier-authlib/authdaemond<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-authlib-0.61.0-cygwin.patch<br />
<br />
Configure the package without most authentication modules, keeping only ''userdb''.<br />
<br />
'''Note''': replace ''mailuser'' by an existing user name (in your /etc/passwd file). I used my own username.<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait --without-authpam --without-authldap --without-authpwd \<br />
--without-authshadow --without-authcustom --without-authpipe --without-authmysql --without-authpgsql --with-mailuser=mailuser \<br />
--with-mailgroup=mkgroup-l-d<br />
<br />
Take a long pause... and when ready execute the following command.<br />
<br />
$ make<br />
<br />
Take again a long pause... then check the result and install the libraries<br />
<br />
$ make check<br />
$ make install<br />
<br />
==Configuration==<br />
<br />
Create authdaemonrc file: /usr/local/etc/authlib/authdaemonrc<br />
<br />
$ cp /usr/local/etc/authlib/authdaemonrc.dist /usr/local/etc/authlib/authdaemonrc<br />
<br />
Change number of daemons (I use three) and enable DEBUG_LOGIN<br />
<br />
<source lang=text><br />
# The number of daemon processes that are started.<br />
daemons=3<br />
<br />
# DEBUG_LOGIN=2 - turn on debugging + log passwords too<br />
DEBUG_LOGIN=2<br />
</source><br />
<br />
See http://www.courier-mta.org/authlib/README.authdebug.html for details.<br />
<br />
==IMAP accounts==<br />
<br />
User accounts and settings are managed by ''userdb''. See [http://linux.die.net/man/8/makeuserdb makeuserdb] man page for details, or used the freshly new install man page - man makeuserdb<br />
<br />
Assuming ''username'' is your username, 1001 and 10545 are respectively the UID and GID of an existing user (part of your /etc/passwd and /etc/group). I use my own UID and GID. Create the mailuser home directory, if required, and create Maildir folder.<br />
<br />
$ mkdir -p /home/username<br />
$ cd /home/username<br />
$ /usr/lib/courier-imap/bin/maildirmake Maildir<br />
<br />
Create the userdb text file /usr/local/etc/authlib/userdb<br />
<br />
$ touch /usr/local/etc/authlib/userdb<br />
$ chmod 700 /usr/local/etc/authlib/userdb<br />
<br />
Edit /usr/local/etc/authlib/userdb, one line per account<br />
<br />
<source lang=text><br />
username[TAB]uid=1001|gid=10111|home=/home/username|mail=/home/username/Maildir|systempw=XXXXXX<br />
</source><br />
<br />
where XXXXXX is the encrypted password created with<br />
<br />
$ /usr/local/sbin/userdbpw.exe<br />
<br />
Create the (binary) userdb<br />
<br />
$ /usr/local/sbin/makeuserdb<br />
<br />
You should now have the following files created:<br />
<br />
* /usr/local/etc/authlib/userdb.dat<br />
* /usr/local/etc/authlib/userdbshadow.dat<br />
<br />
==Running==<br />
<br />
Install and configure syslogd. Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install inetutils (contains syslogd). Configure syslogd with the following command. It will create the /etc/syslogd.conf file and install a windows service using cygrunsrv<br />
<br />
$ syslogd-config<br />
<br />
Start the authlib daemon with the following command:<br />
<br />
$ /usr/local/sbin/authdaemon start<br />
<br />
Stop the daemon with the following command:<br />
<br />
$ /usr/local/sbin/authdaemon stop<br />
<br />
You'll find log messages in /var/log/messages (default target file as specified in /etc/syslogd.conf)<br />
<br />
==Testing authlib==<br />
<br />
$ /usr/local/sbin/authtest username CCCCCC<br />
Authentication succeeded.<br />
<br />
Authenticated: username (uid 1001, gid 10545)<br />
Home Directory: /home/username<br />
Maildir: /home/username/Maildir<br />
Quota: (none)<br />
Encrypted Password: XXXXXX<br />
Cleartext Password: CCCCCC<br />
Options: (none)<br />
<br />
where username is your user name and XXXXXX is your encrypted password as provided in ''/usr/local/etc/authlib/userdb''. CCCCCC is your password in clear.<br />
<br />
==Troubleshooting==<br />
<br />
Should you have a doubt on the execution of a command (ie: no output) you can check if the application is able to load required DLL. This error is not reported. Using ''strace'', windows will complain about DLL not found, if any. To solve this problem you may need to add some path in your PATH. For example, in order to test authlib with authtest:<br />
<br />
$ strace /usr/local/sbin/authtest<br />
# This will open a dialog box to complain about DLL.<br />
$ export PATH=$PATH:/usr/local/lib/bin<br />
$ /usr/local/sbin/authtest ausername<br />
<br />
==Courier Authentication Config==<br />
<br />
$ /usr/local/bin/courierauthconfig.exe --version<br />
$ /usr/local/bin/courierauthconfig.exe --ldflags<br />
$ /usr/local/bin/courierauthconfig.exe --cppflags<br />
$ /usr/local/bin/courierauthconfig.exe --configfiles<br />
<br />
=Courier-IMAP=<br />
==Compilation and installation==<br />
<br />
Download and untar package [http://www.courier-mta.org/download.php#imap courier-imap] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-imap-4.4.1.tar.bz2 4.4.1.20080920]<br />
<br />
Apply the [{{#file:courrier-imap-4.4.1-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# incorrect usage of EXTEXT in main ''Makefile''<br />
# remove usage of /usr/lib/env in start/stop script (/usr/lib/env does not seem to work under Cygwin)<br />
<br />
<source lang=diff><br />
--- courier-imap-4.4.1.20080920/makedat/Makefile.in 2008-08-24 19:52:51.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/makedat/Makefile.in 2008-10-21 20:43:27.500000000 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-imap-4.4.1.20080920/Makefile.in 2008-09-20 14:48:46.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/Makefile.in 2008-10-21 20:59:45.156250000 +0200<br />
@@ -247,9 +247,9 @@<br />
CLEANFILES = $(databin_SCRIPTS) $(man_MANS) $(sysconf_DATA) $(sbin_SCRIPTS)<br />
databindir = $(datadir)<br />
databin_SCRIPTS = mkimapdcert mkpop3dcert<br />
-binPROGRAMS = imapd pop3d maildirmake maildiracl deliverquota maildirkw<br />
-sbinPROGRAMS = imaplogin pop3login<br />
-libexecPROGRAMS = makedatprog couriertcpd<br />
+binPROGRAMS = imapd$(EXEEXT) pop3d$(EXEEXT) maildirmake$(EXEEXT) maildiracl$(EXEEXT) deliverquota$(EXEEXT) maildirkw$(EXEEXT)<br />
+sbinPROGRAMS = imaplogin$(EXEEXT) pop3login$(EXEEXT)<br />
+libexecPROGRAMS = makedatprog$(EXEEXT) couriertcpd$(EXEEXT)<br />
bin_PROGRAMS = @binPROGRAMS_exec@<br />
sbin_PROGRAMS = @sbinPROGRAMS_exec@<br />
libexec_PROGRAMS = @libexecPROGRAMS_exec@<br />
--- courier-imap-4.4.1.20080920/imapd.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/imapd.rc.in 2008-10-26 10:17:51.359375000 +0100<br />
@@ -22,6 +22,15 @@<br />
exit 1<br />
fi<br />
<br />
+# Location for some shared libraries (cygcourierauth*.dll) from authlib<br />
+AUTHLIBDIR=/usr/local<br />
+if test ! -f $AUTHLIBDIR/lib/bin/cygcourierauth.dll<br />
+then<br />
+ echo "$AUTHLIBDIR/lib/bin/cygcourierauth.dll not found."<br />
+ exit 1<br />
+fi<br />
+export PATH=$PATH:$AUTHLIBDIR/lib/bin<br />
+<br />
TLS_CACHEFILE=""<br />
. @sysconfdir@/imapd-ssl<br />
. @sysconfdir@/imapd<br />
@@ -35,7 +44,7 @@<br />
<br />
umask $IMAP_UMASK<br />
@ULIMIT@ $IMAP_ULIMITD<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
--- courier-imap-4.4.1.20080920/pop3d.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/pop3d.rc.in 2008-10-26 10:18:02.187500000 +0100<br />
@@ -22,12 +22,21 @@<br />
exit 1<br />
fi<br />
<br />
+# Location for some shared libraries (cygcourierauth*.dll) from authlib<br />
+AUTHLIBDIR=/usr/local<br />
+if test ! -f $AUTHLIBDIR/lib/bin/cygcourierauth.dll<br />
+then<br />
+ echo "$AUTHLIBDIR/lib/bin/cygcourierauth.dll not found."<br />
+ exit 1<br />
+fi<br />
+export PATH=$PATH:$AUTHLIBDIR/lib/bin<br />
+<br />
. @sysconfdir@/pop3d-ssl<br />
. @sysconfdir@/pop3d<br />
<br />
case $1 in<br />
start)<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-imap-4.4.1-cygwin.patch<br />
<br />
Configure the package<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait<br />
<br />
Take a walk... and when ready execute the following command to build the package.<br />
<br />
$ make<br />
<br />
Time to go for some coffee... and then install the package with the usual<br />
<br />
$ make install<br />
$ make install-configure<br />
<br />
==Configuration==<br />
<br />
Setup courier-imap: $prefix/etc/imapd (where $prefix=/usr/lib/courier-imap)<br />
<br />
Set ADDRESS to a valid value (0 or 127.0.0.1) and change IMAP_ULIMITD to a value accepted by the command ulimit. I simply used the existing value returned by<br />
<br />
$ ulimit -v<br />
<br />
==Running==<br />
<br />
Syslogd service and authdaemond should be started. See above.<br />
<br />
Start the imap daemon with the following command:<br />
<br />
$ /usr/lib/courier-imap/libexec/imapd.rc start<br />
<br />
Stop the daemon with the following command:<br />
<br />
$ /usr/lib/courier-imap/libexec/imapd.rc stop<br />
<br />
You'll find log messages in /var/log/messages (default target file as specified in /etc/syslogd.conf)<br />
<br />
==Testing==<br />
When authdaemond and imapd are running you can do a simple login test:<br />
<br />
$ telnet localhost 143<br />
<br />
and type the login command<br />
<br />
a login <username> <password><br />
<br />
the server should reply<br />
<br />
a OK LOGIN Ok.<br />
<br />
to which you can reply with a logout<br />
<br />
a logout<br />
<br />
the session is terminated by the server<br />
<br />
* BYE Courier-IMAP server shutting down<br />
a OK LOGOUT completed<br />
Connection closed by foreign host.<br />
<br />
'''Hint:''' if the connection is immediately closed by foreign host it probably means that ''imapd'' does not have access to all required DLLs. Check your PATH.<br />
<br />
==All in one==<br />
If everything works fine you can use the following [{{#file:imapd}} startup script] to launch or stop imap and authlib daemons. It can be saved in /usr/local/sbin.<br />
<br />
<source lang=bash><br />
#! /bin/sh<br />
#<br />
# Courier imap daemon startup script.<br />
<br />
authlib=/usr/local/sbin/authdaemond<br />
imapd=/usr/lib/courier-imap/libexec/imapd.rc<br />
<br />
test ! -f $authlib && echo "File not found: $authlib" && exit 1;<br />
test ! -f $imapd && echo "File not found: $imapd" && exit 1;<br />
<br />
case $1 in<br />
start)<br />
$authlib start<br />
$imapd start<br />
;;<br />
stop)<br />
$imapd stop<br />
$authlib stop<br />
;;<br />
*)<br />
echo "Usage: $0 <start|stop>"<br />
;;<br />
esac<br />
</source><br />
<br />
==Cygwin service==<br />
Create the [{{#file:imapd-srv.sh}} service script]<br />
<br />
<source lang=bash><br />
#!/bin/sh<br />
# File: imapd-service.sh<br />
# Purpose: Courier imap daemon service script.<br />
#<br />
# NOTE: This script must be excutable by SYSTEM<br />
username=username # <<<< Change me !!!<br />
pidsleep=''<br />
<br />
# Function to handle QUIT signal.<br />
# Stop imapd daemon and kill background sleep.<br />
function handleQuit<br />
{<br />
echo "STOPPING: /usr/local/sbin/imapd"<br />
su $username -c "/usr/local/sbin/imapd stop"<br />
test -n "$pidsleep" && kill -9 $pidsleep<br />
exit<br />
}<br />
<br />
# Interruptible sleep<br />
# Note: sleep is an external command (not builtin command), hence<br />
# not interruptible by the QUIT signal.<br />
function intsleep<br />
{<br />
sleep $1 &<br />
pidsleep=$!<br />
wait $pidsleep<br />
}<br />
<br />
echo "STARTING: /usr/local/sbin/imapd as $username at "`date`<br />
su $username -c "/usr/local/sbin/imapd start"<br />
<br />
trap "handleQuit" SIGQUIT<br />
<br />
echo "WAITING: "$$<br />
while true; do intsleep 1d; done<br />
</source><br />
<br />
Change username and save it to your favorite location, says /usr/local/sbin. The service script must be executable by SYSTEM, ie: the user that run the windows services.<br />
<br />
$ chmod +rx /usr/local/sbin/imapd-service.sh<br />
<br />
Install the new service with the following command.<br />
<br />
$ cygrunsrv --install imapd --desc "Courier IMAP daemon" --disp "CYGWIN imapd" \<br />
--path /usr/local/sbin/imapd-service.sh --termsig QUIT --type auto --shutdown<br />
<br />
Finally, just start the service<br />
<br />
$ cygrunsrv --start imapd<br />
or<br />
$ net start imapd<br />
<br />
You should now have couple of processes related to courier-imap<br />
<br />
$ ps -a<br />
<br />
'''NOTES''':<br />
* If the service could not be started, it's probably because the service script is not executable by SYSTEM<br />
<br />
$ net start imapd<br />
The CYGWIN imapd service is starting.<br />
The CYGWIN imapd service could not be started. <br />
<br />
The service did not report an error.<br />
<br />
More help is available by typing NET HELPMSG 3534.<br />
<br />
* The combination of background sleep and builtin wait command is used to make the waiting statment interruptible. The original script found on the net, was simply using a 'sleep 1' which turned to consume ~10% of the CPU.<br />
<br />
=Maildir=<br />
'''maildirmake''' is part of the courier-imap package<br />
<br />
$ /usr/lib/courier-imap/bin/maildirmake</div>Twalranthttps://wiki.yobi.be/index.php?title=Courier-Cygwin&diff=5263Courier-Cygwin2008-10-31T13:45:30Z<p>Twalrant: /* Cygwin service */</p>
<hr />
<div>=Pre-requisite=<br />
<br />
Courier-IMAP requires the installation of the [http://www.courier-mta.org/authlib/ Courier Authentication Library] and the following cygwin tools and packages<br />
<br />
* patch, tar, make, gcc<br />
* crypt<br />
* libgdbm-devel<br />
* libtool<br />
* inetutils<br />
* cygrunsrv<br />
<br />
Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install the required packages.<br />
<br />
=Courier Authentication Library=<br />
<br />
Installation of Courier Authentication Library using the module userdb to manage mail accounts. All other modules are disabled.<br />
<br />
==Compilation and installation==<br />
<br />
Download and untar [http://www.courier-mta.org/download.php#authlib courier-authlib] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-authlib-0.61.0.tar.bz2 0.61.0]<br />
<br />
Apply the [{{#file:courrier-authlib-0.61.0-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# add libtool flag (-no-undefined) required for DLL creation<br />
# add missing dependencies<br />
# add PATH in start script to access new DLL (installed in a different directory)<br />
<br />
Solution source: http://lists.cairographics.org/archives/cairo/2004-April/001125.html<br />
<br />
<source lang=diff><br />
--- courier-authlib-0.61.0/makedat/Makefile.in 2008-05-24 16:21:09.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/makedat/Makefile.in 2008-10-21 16:02:38.709166700 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-authlib-0.61.0/Makefile.in 2008-07-12 21:41:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/Makefile.in 2008-10-23 22:59:03.843750000 +0200<br />
@@ -213,9 +213,10 @@<br />
LTCOMPILE = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
--mode=compile $(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) \<br />
$(AM_CPPFLAGS) $(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS)<br />
-CCLD = $(CC)<br />
+CCLD = $(CC) -no-undefined<br />
+CCLDEXE = $(CC)<br />
LINK = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
- --mode=link $(CCLD) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
+ --mode=link $(CCLDEXE) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
$(LDFLAGS) -o $@<br />
SOURCES = $(libauthcustom_la_SOURCES) $(libauthldap_la_SOURCES) \<br />
$(libauthmysql_la_SOURCES) $(libauthpam_la_SOURCES) \<br />
@@ -452,9 +453,9 @@<br />
README.authdebug.html<br />
<br />
DISTCLEANFILES = dbobj.config README_authlib.html<br />
-commonlibdep = libcourierauthcommon.la<br />
+commonlibdep = libcourierauthcommon.la libcourierauth.la<br />
commonldflags = -module -rpath $(pkglibdir) -export-symbols-regex 'courier_auth.*_init' -avoid-version<br />
-commonlibadd = libcourierauthcommon.la<br />
+commonlibadd = libcourierauthcommon.la libcourierauth.la<br />
libcourierauthcommon_t = @CRYPTLIBS@<br />
libcourierauthcommon_la_SOURCES = \<br />
auth.h courierauth.h \<br />
--- courier-authlib-0.61.0/authdaemond.in 2005-07-05 14:25:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/authdaemond.in 2008-10-25 12:03:32.140625000 +0200<br />
@@ -15,4 +15,10 @@<br />
set -a<br />
. @authdaemonrc@<br />
<br />
+# Some shared libraries (DLL) are installed in @libdir@/bin<br />
+# instead of @libdir@/@PACKAGE@<br />
+# Setting LD_LIBRARY_PATH at runtime or LR_RUN_PATH at linktime doesn't<br />
+# work in cygwin, only setting PATH works. <br />
+export PATH=$PATH:@libdir@/bin<br />
+<br />
exec ${sbindir}/courierlogger -pid=@authdaemonvar@/pid $LOGGEROPTS -$1 @libexecdir@/courier-authlib/authdaemond<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-authlib-0.61.0-cygwin.patch<br />
<br />
Configure the package without most authentication modules, keeping only ''userdb''.<br />
<br />
'''Note''': replace ''mailuser'' by an existing user name (in your /etc/passwd file). I used my own username.<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait --without-authpam --without-authldap --without-authpwd \<br />
--without-authshadow --without-authcustom --without-authpipe --without-authmysql --without-authpgsql --with-mailuser=mailuser \<br />
--with-mailgroup=mkgroup-l-d<br />
<br />
Take a long pause... and when ready execute the following command.<br />
<br />
$ make<br />
<br />
Take again a long pause... then check the result and install the libraries<br />
<br />
$ make check<br />
$ make install<br />
<br />
==Configuration==<br />
<br />
Create authdaemonrc file: /usr/local/etc/authlib/authdaemonrc<br />
<br />
$ cp /usr/local/etc/authlib/authdaemonrc.dist /usr/local/etc/authlib/authdaemonrc<br />
<br />
Change number of daemons (I use only one) and enable DEBUG_LOGIN<br />
<br />
<source lang=text><br />
# The number of daemon processes that are started.<br />
daemons=1<br />
<br />
# DEBUG_LOGIN=2 - turn on debugging + log passwords too<br />
DEBUG_LOGIN=2<br />
</source><br />
<br />
See http://www.courier-mta.org/authlib/README.authdebug.html for details.<br />
<br />
==IMAP accounts==<br />
<br />
User accounts and settings are managed by ''userdb''. See [http://linux.die.net/man/8/makeuserdb makeuserdb] man page for details, or used the freshly new install man page - man makeuserdb<br />
<br />
Assuming ''username'' is your username, 1001 and 10545 are respectively the UID and GID of an existing user (part of your /etc/passwd and /etc/group). I use my own UID and GID. Create the mailuser home directory, if required, and create Maildir folder.<br />
<br />
$ mkdir -p /home/username<br />
$ cd /home/username<br />
$ /usr/lib/courier-imap/bin/maildirmake Maildir<br />
<br />
Create the userdb text file /usr/local/etc/authlib/userdb<br />
<br />
$ touch /usr/local/etc/authlib/userdb<br />
$ chmod 700 /usr/local/etc/authlib/userdb<br />
<br />
Edit /usr/local/etc/authlib/userdb, one line per account<br />
<br />
<source lang=text><br />
username[TAB]uid=1001|gid=10111|home=/home/username|mail=/home/username/Maildir|systempw=XXXXXX<br />
</source><br />
<br />
where XXXXXX is the encrypted password created with<br />
<br />
$ /usr/local/sbin/userdbpw.exe<br />
<br />
Create the (binary) userdb<br />
<br />
$ /usr/local/sbin/makeuserdb<br />
<br />
You should now have the following files created:<br />
<br />
* /usr/local/etc/authlib/userdb.dat<br />
* /usr/local/etc/authlib/userdbshadow.dat<br />
<br />
==Running==<br />
<br />
Install and configure syslogd. Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install inetutils (contains syslogd). Configure syslogd with the following command. It will create the /etc/syslogd.conf file and install a windows service using cygrunsrv<br />
<br />
$ syslogd-config<br />
<br />
Start the authlib daemon with the following command:<br />
<br />
$ /usr/local/sbin/authdaemon start<br />
<br />
Stop the daemon with the following command:<br />
<br />
$ /usr/local/sbin/authdaemon stop<br />
<br />
You'll find log messages in /var/log/messages (default target file as specified in /etc/syslogd.conf)<br />
<br />
==Testing authlib==<br />
<br />
$ /usr/local/sbin/authtest username CCCCCC<br />
Authentication succeeded.<br />
<br />
Authenticated: username (uid 1001, gid 10545)<br />
Home Directory: /home/username<br />
Maildir: /home/username/Maildir<br />
Quota: (none)<br />
Encrypted Password: XXXXXX<br />
Cleartext Password: CCCCCC<br />
Options: (none)<br />
<br />
where username is your user name and XXXXXX is your encrypted password as provided in ''/usr/local/etc/authlib/userdb''. CCCCCC is your password in clear.<br />
<br />
==Troubleshooting==<br />
<br />
Should you have a doubt on the execution of a command (ie: no output) you can check if the application is able to load required DLL. This error is not reported. Using ''strace'', windows will complain about DLL not found, if any. To solve this problem you may need to add some path in your PATH. For example, in order to test authlib with authtest:<br />
<br />
$ strace /usr/local/sbin/authtest<br />
# This will open a dialog box to complain about DLL.<br />
$ export PATH=$PATH:/usr/local/lib/bin<br />
$ /usr/local/sbin/authtest ausername<br />
<br />
==Courier Authentication Config==<br />
<br />
$ /usr/local/bin/courierauthconfig.exe --version<br />
$ /usr/local/bin/courierauthconfig.exe --ldflags<br />
$ /usr/local/bin/courierauthconfig.exe --cppflags<br />
$ /usr/local/bin/courierauthconfig.exe --configfiles<br />
<br />
=Courier-IMAP=<br />
==Compilation and installation==<br />
<br />
Download and untar package [http://www.courier-mta.org/download.php#imap courier-imap] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-imap-4.4.1.tar.bz2 4.4.1.20080920]<br />
<br />
Apply the [{{#file:courrier-imap-4.4.1-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# incorrect usage of EXTEXT in main ''Makefile''<br />
# remove usage of /usr/lib/env in start/stop script (/usr/lib/env does not seem to work under Cygwin)<br />
<br />
<source lang=diff><br />
--- courier-imap-4.4.1.20080920/makedat/Makefile.in 2008-08-24 19:52:51.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/makedat/Makefile.in 2008-10-21 20:43:27.500000000 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-imap-4.4.1.20080920/Makefile.in 2008-09-20 14:48:46.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/Makefile.in 2008-10-21 20:59:45.156250000 +0200<br />
@@ -247,9 +247,9 @@<br />
CLEANFILES = $(databin_SCRIPTS) $(man_MANS) $(sysconf_DATA) $(sbin_SCRIPTS)<br />
databindir = $(datadir)<br />
databin_SCRIPTS = mkimapdcert mkpop3dcert<br />
-binPROGRAMS = imapd pop3d maildirmake maildiracl deliverquota maildirkw<br />
-sbinPROGRAMS = imaplogin pop3login<br />
-libexecPROGRAMS = makedatprog couriertcpd<br />
+binPROGRAMS = imapd$(EXEEXT) pop3d$(EXEEXT) maildirmake$(EXEEXT) maildiracl$(EXEEXT) deliverquota$(EXEEXT) maildirkw$(EXEEXT)<br />
+sbinPROGRAMS = imaplogin$(EXEEXT) pop3login$(EXEEXT)<br />
+libexecPROGRAMS = makedatprog$(EXEEXT) couriertcpd$(EXEEXT)<br />
bin_PROGRAMS = @binPROGRAMS_exec@<br />
sbin_PROGRAMS = @sbinPROGRAMS_exec@<br />
libexec_PROGRAMS = @libexecPROGRAMS_exec@<br />
--- courier-imap-4.4.1.20080920/imapd.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/imapd.rc.in 2008-10-26 10:17:51.359375000 +0100<br />
@@ -22,6 +22,15 @@<br />
exit 1<br />
fi<br />
<br />
+# Location for some shared libraries (cygcourierauth*.dll) from authlib<br />
+AUTHLIBDIR=/usr/local<br />
+if test ! -f $AUTHLIBDIR/lib/bin/cygcourierauth.dll<br />
+then<br />
+ echo "$AUTHLIBDIR/lib/bin/cygcourierauth.dll not found."<br />
+ exit 1<br />
+fi<br />
+export PATH=$PATH:$AUTHLIBDIR/lib/bin<br />
+<br />
TLS_CACHEFILE=""<br />
. @sysconfdir@/imapd-ssl<br />
. @sysconfdir@/imapd<br />
@@ -35,7 +44,7 @@<br />
<br />
umask $IMAP_UMASK<br />
@ULIMIT@ $IMAP_ULIMITD<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
--- courier-imap-4.4.1.20080920/pop3d.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/pop3d.rc.in 2008-10-26 10:18:02.187500000 +0100<br />
@@ -22,12 +22,21 @@<br />
exit 1<br />
fi<br />
<br />
+# Location for some shared libraries (cygcourierauth*.dll) from authlib<br />
+AUTHLIBDIR=/usr/local<br />
+if test ! -f $AUTHLIBDIR/lib/bin/cygcourierauth.dll<br />
+then<br />
+ echo "$AUTHLIBDIR/lib/bin/cygcourierauth.dll not found."<br />
+ exit 1<br />
+fi<br />
+export PATH=$PATH:$AUTHLIBDIR/lib/bin<br />
+<br />
. @sysconfdir@/pop3d-ssl<br />
. @sysconfdir@/pop3d<br />
<br />
case $1 in<br />
start)<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-imap-4.4.1-cygwin.patch<br />
<br />
Configure the package<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait<br />
<br />
Take a walk... and when ready execute the following command to build the package.<br />
<br />
$ make<br />
<br />
Time to go for some coffee... and then install the package with the usual<br />
<br />
$ make install<br />
$ make install-configure<br />
<br />
==Configuration==<br />
<br />
Setup courier-imap: $prefix/etc/imapd (where $prefix=/usr/lib/courier-imap)<br />
<br />
Set ADDRESS to a valid value (0 or 127.0.0.1) and change IMAP_ULIMITD to a value accepted by the command ulimit. I simply used the existing value returned by<br />
<br />
$ ulimit -v<br />
<br />
==Running==<br />
<br />
Syslogd service and authdaemond should be started. See above.<br />
<br />
Start the imap daemon with the following command:<br />
<br />
$ /usr/lib/courier-imap/libexec/imapd.rc start<br />
<br />
Stop the daemon with the following command:<br />
<br />
$ /usr/lib/courier-imap/libexec/imapd.rc stop<br />
<br />
You'll find log messages in /var/log/messages (default target file as specified in /etc/syslogd.conf)<br />
<br />
==Testing==<br />
When authdaemond and imapd are running you can do a simple login test:<br />
<br />
$ telnet localhost 143<br />
<br />
and type the login command<br />
<br />
a login <username> <password><br />
<br />
the server should reply<br />
<br />
a OK LOGIN Ok.<br />
<br />
to which you can reply with a logout<br />
<br />
a logout<br />
<br />
the session is terminated by the server<br />
<br />
* BYE Courier-IMAP server shutting down<br />
a OK LOGOUT completed<br />
Connection closed by foreign host.<br />
<br />
'''Hint:''' if the connection is immediately closed by foreign host it probably means that ''imapd'' does not have access to all required DLLs. Check your PATH.<br />
<br />
==All in one==<br />
If everything works fine you can use the following [{{#file:imapd}} startup script] to launch or stop imap and authlib daemons. It can be saved in /usr/local/sbin.<br />
<br />
<source lang=bash><br />
#! /bin/sh<br />
#<br />
# Courier imap daemon startup script.<br />
<br />
authlib=/usr/local/sbin/authdaemond<br />
imapd=/usr/lib/courier-imap/libexec/imapd.rc<br />
<br />
test ! -f $authlib && echo "File not found: $authlib" && exit 1;<br />
test ! -f $imapd && echo "File not found: $imapd" && exit 1;<br />
<br />
case $1 in<br />
start)<br />
$authlib start<br />
$imapd start<br />
;;<br />
stop)<br />
$imapd stop<br />
$authlib stop<br />
;;<br />
*)<br />
echo "Usage: $0 <start|stop>"<br />
;;<br />
esac<br />
</source><br />
<br />
==Cygwin service==<br />
Create the [{{#file:imapd-srv.sh}} service script]<br />
<br />
<source lang=bash><br />
#!/bin/sh<br />
# File: imapd-service.sh<br />
# Purpose: Courier imap daemon service script.<br />
#<br />
# NOTE: This script must be excutable by SYSTEM<br />
username=beq03798<br />
pidsleep=''<br />
<br />
# Function to handle QUIT signal.<br />
# Stop imapd daemon and kill background sleep.<br />
function handleQuit<br />
{<br />
echo "STOPPING: /usr/local/sbin/imapd"<br />
su $username -c "/usr/local/sbin/imapd stop"<br />
test -n "$pidsleep" && kill -9 $pidsleep<br />
exit<br />
}<br />
<br />
# Interruptible sleep<br />
# Note: sleep is an external command (not builtin command), hence<br />
# not interruptible by the QUIT signal.<br />
function intsleep<br />
{<br />
sleep $1 &<br />
pidsleep=$!<br />
wait $pidsleep<br />
}<br />
<br />
echo "STARTING: /usr/local/sbin/imapd as $username at "`date`<br />
su $username -c "/usr/local/sbin/imapd start"<br />
<br />
trap "handleQuit" SIGQUIT<br />
<br />
echo "WAITING: "$$<br />
while true; do intsleep 1d; done<br />
</source><br />
<br />
Change username and save it to your favorite location, says /usr/local/sbin. The service script must be executable by SYSTEM, ie: the user that run the windows services.<br />
<br />
$ chmod +rx /usr/local/sbin/imapd-service.sh<br />
<br />
Install the new service with the following command.<br />
<br />
$ cygrunsrv --install imapd --desc "Courier IMAP daemon" --disp "CYGWIN imapd" \<br />
--path /usr/local/sbin/imapd-service.sh --termsig QUIT --type auto --shutdown<br />
<br />
Finally, just start the service<br />
<br />
$ cygrunsrv --start imapd<br />
or<br />
$ net start imapd<br />
<br />
You should now have couple of processes related to courier-imap<br />
<br />
$ ps -a<br />
<br />
'''NOTES''':<br />
* If the service could not be started, it's probably because the service script is not executable by SYSTEM<br />
<br />
$ net start imapd<br />
The CYGWIN imapd service is starting.<br />
The CYGWIN imapd service could not be started. <br />
<br />
The service did not report an error.<br />
<br />
More help is available by typing NET HELPMSG 3534.<br />
<br />
* The combination of background sleep and builtin wait command is used to make the waiting statment interruptible. The original script found on the net, was simply using a 'sleep 1' which turned to consume ~10% of the CPU.<br />
<br />
=Maildir=<br />
'''maildirmake''' is part of the courier-imap package<br />
<br />
$ /usr/lib/courier-imap/bin/maildirmake</div>Twalranthttps://wiki.yobi.be/index.php?title=Courier-Cygwin&diff=5262Courier-Cygwin2008-10-31T13:44:49Z<p>Twalrant: /* Cygwin service */</p>
<hr />
<div>=Pre-requisite=<br />
<br />
Courier-IMAP requires the installation of the [http://www.courier-mta.org/authlib/ Courier Authentication Library] and the following cygwin tools and packages<br />
<br />
* patch, tar, make, gcc<br />
* crypt<br />
* libgdbm-devel<br />
* libtool<br />
* inetutils<br />
* cygrunsrv<br />
<br />
Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install the required packages.<br />
<br />
=Courier Authentication Library=<br />
<br />
Installation of Courier Authentication Library using the module userdb to manage mail accounts. All other modules are disabled.<br />
<br />
==Compilation and installation==<br />
<br />
Download and untar [http://www.courier-mta.org/download.php#authlib courier-authlib] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-authlib-0.61.0.tar.bz2 0.61.0]<br />
<br />
Apply the [{{#file:courrier-authlib-0.61.0-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# add libtool flag (-no-undefined) required for DLL creation<br />
# add missing dependencies<br />
# add PATH in start script to access new DLL (installed in a different directory)<br />
<br />
Solution source: http://lists.cairographics.org/archives/cairo/2004-April/001125.html<br />
<br />
<source lang=diff><br />
--- courier-authlib-0.61.0/makedat/Makefile.in 2008-05-24 16:21:09.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/makedat/Makefile.in 2008-10-21 16:02:38.709166700 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-authlib-0.61.0/Makefile.in 2008-07-12 21:41:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/Makefile.in 2008-10-23 22:59:03.843750000 +0200<br />
@@ -213,9 +213,10 @@<br />
LTCOMPILE = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
--mode=compile $(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) \<br />
$(AM_CPPFLAGS) $(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS)<br />
-CCLD = $(CC)<br />
+CCLD = $(CC) -no-undefined<br />
+CCLDEXE = $(CC)<br />
LINK = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
- --mode=link $(CCLD) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
+ --mode=link $(CCLDEXE) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
$(LDFLAGS) -o $@<br />
SOURCES = $(libauthcustom_la_SOURCES) $(libauthldap_la_SOURCES) \<br />
$(libauthmysql_la_SOURCES) $(libauthpam_la_SOURCES) \<br />
@@ -452,9 +453,9 @@<br />
README.authdebug.html<br />
<br />
DISTCLEANFILES = dbobj.config README_authlib.html<br />
-commonlibdep = libcourierauthcommon.la<br />
+commonlibdep = libcourierauthcommon.la libcourierauth.la<br />
commonldflags = -module -rpath $(pkglibdir) -export-symbols-regex 'courier_auth.*_init' -avoid-version<br />
-commonlibadd = libcourierauthcommon.la<br />
+commonlibadd = libcourierauthcommon.la libcourierauth.la<br />
libcourierauthcommon_t = @CRYPTLIBS@<br />
libcourierauthcommon_la_SOURCES = \<br />
auth.h courierauth.h \<br />
--- courier-authlib-0.61.0/authdaemond.in 2005-07-05 14:25:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/authdaemond.in 2008-10-25 12:03:32.140625000 +0200<br />
@@ -15,4 +15,10 @@<br />
set -a<br />
. @authdaemonrc@<br />
<br />
+# Some shared libraries (DLL) are installed in @libdir@/bin<br />
+# instead of @libdir@/@PACKAGE@<br />
+# Setting LD_LIBRARY_PATH at runtime or LR_RUN_PATH at linktime doesn't<br />
+# work in cygwin, only setting PATH works. <br />
+export PATH=$PATH:@libdir@/bin<br />
+<br />
exec ${sbindir}/courierlogger -pid=@authdaemonvar@/pid $LOGGEROPTS -$1 @libexecdir@/courier-authlib/authdaemond<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-authlib-0.61.0-cygwin.patch<br />
<br />
Configure the package without most authentication modules, keeping only ''userdb''.<br />
<br />
'''Note''': replace ''mailuser'' by an existing user name (in your /etc/passwd file). I used my own username.<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait --without-authpam --without-authldap --without-authpwd \<br />
--without-authshadow --without-authcustom --without-authpipe --without-authmysql --without-authpgsql --with-mailuser=mailuser \<br />
--with-mailgroup=mkgroup-l-d<br />
<br />
Take a long pause... and when ready execute the following command.<br />
<br />
$ make<br />
<br />
Take again a long pause... then check the result and install the libraries<br />
<br />
$ make check<br />
$ make install<br />
<br />
==Configuration==<br />
<br />
Create authdaemonrc file: /usr/local/etc/authlib/authdaemonrc<br />
<br />
$ cp /usr/local/etc/authlib/authdaemonrc.dist /usr/local/etc/authlib/authdaemonrc<br />
<br />
Change number of daemons (I use only one) and enable DEBUG_LOGIN<br />
<br />
<source lang=text><br />
# The number of daemon processes that are started.<br />
daemons=1<br />
<br />
# DEBUG_LOGIN=2 - turn on debugging + log passwords too<br />
DEBUG_LOGIN=2<br />
</source><br />
<br />
See http://www.courier-mta.org/authlib/README.authdebug.html for details.<br />
<br />
==IMAP accounts==<br />
<br />
User accounts and settings are managed by ''userdb''. See [http://linux.die.net/man/8/makeuserdb makeuserdb] man page for details, or used the freshly new install man page - man makeuserdb<br />
<br />
Assuming ''username'' is your username, 1001 and 10545 are respectively the UID and GID of an existing user (part of your /etc/passwd and /etc/group). I use my own UID and GID. Create the mailuser home directory, if required, and create Maildir folder.<br />
<br />
$ mkdir -p /home/username<br />
$ cd /home/username<br />
$ /usr/lib/courier-imap/bin/maildirmake Maildir<br />
<br />
Create the userdb text file /usr/local/etc/authlib/userdb<br />
<br />
$ touch /usr/local/etc/authlib/userdb<br />
$ chmod 700 /usr/local/etc/authlib/userdb<br />
<br />
Edit /usr/local/etc/authlib/userdb, one line per account<br />
<br />
<source lang=text><br />
username[TAB]uid=1001|gid=10111|home=/home/username|mail=/home/username/Maildir|systempw=XXXXXX<br />
</source><br />
<br />
where XXXXXX is the encrypted password created with<br />
<br />
$ /usr/local/sbin/userdbpw.exe<br />
<br />
Create the (binary) userdb<br />
<br />
$ /usr/local/sbin/makeuserdb<br />
<br />
You should now have the following files created:<br />
<br />
* /usr/local/etc/authlib/userdb.dat<br />
* /usr/local/etc/authlib/userdbshadow.dat<br />
<br />
==Running==<br />
<br />
Install and configure syslogd. Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install inetutils (contains syslogd). Configure syslogd with the following command. It will create the /etc/syslogd.conf file and install a windows service using cygrunsrv<br />
<br />
$ syslogd-config<br />
<br />
Start the authlib daemon with the following command:<br />
<br />
$ /usr/local/sbin/authdaemon start<br />
<br />
Stop the daemon with the following command:<br />
<br />
$ /usr/local/sbin/authdaemon stop<br />
<br />
You'll find log messages in /var/log/messages (default target file as specified in /etc/syslogd.conf)<br />
<br />
==Testing authlib==<br />
<br />
$ /usr/local/sbin/authtest username CCCCCC<br />
Authentication succeeded.<br />
<br />
Authenticated: username (uid 1001, gid 10545)<br />
Home Directory: /home/username<br />
Maildir: /home/username/Maildir<br />
Quota: (none)<br />
Encrypted Password: XXXXXX<br />
Cleartext Password: CCCCCC<br />
Options: (none)<br />
<br />
where username is your user name and XXXXXX is your encrypted password as provided in ''/usr/local/etc/authlib/userdb''. CCCCCC is your password in clear.<br />
<br />
==Troubleshooting==<br />
<br />
Should you have a doubt on the execution of a command (ie: no output) you can check if the application is able to load required DLL. This error is not reported. Using ''strace'', windows will complain about DLL not found, if any. To solve this problem you may need to add some path in your PATH. For example, in order to test authlib with authtest:<br />
<br />
$ strace /usr/local/sbin/authtest<br />
# This will open a dialog box to complain about DLL.<br />
$ export PATH=$PATH:/usr/local/lib/bin<br />
$ /usr/local/sbin/authtest ausername<br />
<br />
==Courier Authentication Config==<br />
<br />
$ /usr/local/bin/courierauthconfig.exe --version<br />
$ /usr/local/bin/courierauthconfig.exe --ldflags<br />
$ /usr/local/bin/courierauthconfig.exe --cppflags<br />
$ /usr/local/bin/courierauthconfig.exe --configfiles<br />
<br />
=Courier-IMAP=<br />
==Compilation and installation==<br />
<br />
Download and untar package [http://www.courier-mta.org/download.php#imap courier-imap] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-imap-4.4.1.tar.bz2 4.4.1.20080920]<br />
<br />
Apply the [{{#file:courrier-imap-4.4.1-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# incorrect usage of EXTEXT in main ''Makefile''<br />
# remove usage of /usr/lib/env in start/stop script (/usr/lib/env does not seem to work under Cygwin)<br />
<br />
<source lang=diff><br />
--- courier-imap-4.4.1.20080920/makedat/Makefile.in 2008-08-24 19:52:51.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/makedat/Makefile.in 2008-10-21 20:43:27.500000000 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-imap-4.4.1.20080920/Makefile.in 2008-09-20 14:48:46.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/Makefile.in 2008-10-21 20:59:45.156250000 +0200<br />
@@ -247,9 +247,9 @@<br />
CLEANFILES = $(databin_SCRIPTS) $(man_MANS) $(sysconf_DATA) $(sbin_SCRIPTS)<br />
databindir = $(datadir)<br />
databin_SCRIPTS = mkimapdcert mkpop3dcert<br />
-binPROGRAMS = imapd pop3d maildirmake maildiracl deliverquota maildirkw<br />
-sbinPROGRAMS = imaplogin pop3login<br />
-libexecPROGRAMS = makedatprog couriertcpd<br />
+binPROGRAMS = imapd$(EXEEXT) pop3d$(EXEEXT) maildirmake$(EXEEXT) maildiracl$(EXEEXT) deliverquota$(EXEEXT) maildirkw$(EXEEXT)<br />
+sbinPROGRAMS = imaplogin$(EXEEXT) pop3login$(EXEEXT)<br />
+libexecPROGRAMS = makedatprog$(EXEEXT) couriertcpd$(EXEEXT)<br />
bin_PROGRAMS = @binPROGRAMS_exec@<br />
sbin_PROGRAMS = @sbinPROGRAMS_exec@<br />
libexec_PROGRAMS = @libexecPROGRAMS_exec@<br />
--- courier-imap-4.4.1.20080920/imapd.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/imapd.rc.in 2008-10-26 10:17:51.359375000 +0100<br />
@@ -22,6 +22,15 @@<br />
exit 1<br />
fi<br />
<br />
+# Location for some shared libraries (cygcourierauth*.dll) from authlib<br />
+AUTHLIBDIR=/usr/local<br />
+if test ! -f $AUTHLIBDIR/lib/bin/cygcourierauth.dll<br />
+then<br />
+ echo "$AUTHLIBDIR/lib/bin/cygcourierauth.dll not found."<br />
+ exit 1<br />
+fi<br />
+export PATH=$PATH:$AUTHLIBDIR/lib/bin<br />
+<br />
TLS_CACHEFILE=""<br />
. @sysconfdir@/imapd-ssl<br />
. @sysconfdir@/imapd<br />
@@ -35,7 +44,7 @@<br />
<br />
umask $IMAP_UMASK<br />
@ULIMIT@ $IMAP_ULIMITD<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
--- courier-imap-4.4.1.20080920/pop3d.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/pop3d.rc.in 2008-10-26 10:18:02.187500000 +0100<br />
@@ -22,12 +22,21 @@<br />
exit 1<br />
fi<br />
<br />
+# Location for some shared libraries (cygcourierauth*.dll) from authlib<br />
+AUTHLIBDIR=/usr/local<br />
+if test ! -f $AUTHLIBDIR/lib/bin/cygcourierauth.dll<br />
+then<br />
+ echo "$AUTHLIBDIR/lib/bin/cygcourierauth.dll not found."<br />
+ exit 1<br />
+fi<br />
+export PATH=$PATH:$AUTHLIBDIR/lib/bin<br />
+<br />
. @sysconfdir@/pop3d-ssl<br />
. @sysconfdir@/pop3d<br />
<br />
case $1 in<br />
start)<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-imap-4.4.1-cygwin.patch<br />
<br />
Configure the package<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait<br />
<br />
Take a walk... and when ready execute the following command to build the package.<br />
<br />
$ make<br />
<br />
Time to go for some coffee... and then install the package with the usual<br />
<br />
$ make install<br />
$ make install-configure<br />
<br />
==Configuration==<br />
<br />
Setup courier-imap: $prefix/etc/imapd (where $prefix=/usr/lib/courier-imap)<br />
<br />
Set ADDRESS to a valid value (0 or 127.0.0.1) and change IMAP_ULIMITD to a value accepted by the command ulimit. I simply used the existing value returned by<br />
<br />
$ ulimit -v<br />
<br />
==Running==<br />
<br />
Syslogd service and authdaemond should be started. See above.<br />
<br />
Start the imap daemon with the following command:<br />
<br />
$ /usr/lib/courier-imap/libexec/imapd.rc start<br />
<br />
Stop the daemon with the following command:<br />
<br />
$ /usr/lib/courier-imap/libexec/imapd.rc stop<br />
<br />
You'll find log messages in /var/log/messages (default target file as specified in /etc/syslogd.conf)<br />
<br />
==Testing==<br />
When authdaemond and imapd are running you can do a simple login test:<br />
<br />
$ telnet localhost 143<br />
<br />
and type the login command<br />
<br />
a login <username> <password><br />
<br />
the server should reply<br />
<br />
a OK LOGIN Ok.<br />
<br />
to which you can reply with a logout<br />
<br />
a logout<br />
<br />
the session is terminated by the server<br />
<br />
* BYE Courier-IMAP server shutting down<br />
a OK LOGOUT completed<br />
Connection closed by foreign host.<br />
<br />
'''Hint:''' if the connection is immediately closed by foreign host it probably means that ''imapd'' does not have access to all required DLLs. Check your PATH.<br />
<br />
==All in one==<br />
If everything works fine you can use the following [{{#file:imapd}} startup script] to launch or stop imap and authlib daemons. It can be saved in /usr/local/sbin.<br />
<br />
<source lang=bash><br />
#! /bin/sh<br />
#<br />
# Courier imap daemon startup script.<br />
<br />
authlib=/usr/local/sbin/authdaemond<br />
imapd=/usr/lib/courier-imap/libexec/imapd.rc<br />
<br />
test ! -f $authlib && echo "File not found: $authlib" && exit 1;<br />
test ! -f $imapd && echo "File not found: $imapd" && exit 1;<br />
<br />
case $1 in<br />
start)<br />
$authlib start<br />
$imapd start<br />
;;<br />
stop)<br />
$imapd stop<br />
$authlib stop<br />
;;<br />
*)<br />
echo "Usage: $0 <start|stop>"<br />
;;<br />
esac<br />
</source><br />
<br />
==Cygwin service==<br />
Create the [{{#file:imapd-srv.sh}} service script]<br />
<br />
<source lang=bash><br />
#!/bin/sh<br />
# File: imapd-service.sh<br />
# Purpose: Courier imap daemon service script.<br />
#<br />
# NOTE: This script must be excutable by SYSTEM<br />
username=beq03798<br />
pidsleep=''<br />
<br />
# Function to handle QUIT signal.<br />
# Stop imapd daemon and kill background sleep.<br />
function handleQuit<br />
{<br />
echo "STOPPING: /usr/local/sbin/imapd"<br />
su $username -c "/usr/local/sbin/imapd stop"<br />
test -n "$pidsleep" && kill -9 $pidsleep<br />
exit<br />
}<br />
<br />
# Interruptible sleep<br />
# Note: sleep is an external command (not builtin command), hence<br />
# not interruptible by the QUIT signal.<br />
function intsleep<br />
{<br />
sleep $1 &<br />
pidsleep=$!<br />
wait $pidsleep<br />
}<br />
<br />
echo "STARTING: /usr/local/sbin/imapd as $username at "`date`<br />
su $username -c "/usr/local/sbin/imapd start"<br />
<br />
trap "handleQuit" SIGQUIT<br />
<br />
echo "WAITING: "$$<br />
while true; do intsleep 1d; done<br />
</source><br />
<br />
Change username and save it to your favorite location, says /usr/local/sbin. The service script must be executable by SYSTEM, ie: the user that run the windows services.<br />
<br />
$ chmod +x /usr/local/sbin/imapd-service.sh<br />
<br />
Install the new service with the following command.<br />
<br />
$ cygrunsrv --install imapd --desc "Courier IMAP daemon" --disp "CYGWIN imapd" \<br />
--path /usr/local/sbin/imapd-service.sh --termsig QUIT --type auto --shutdown<br />
<br />
Finally, just start the service<br />
<br />
$ cygrunsrv --start imapd<br />
or<br />
$ net start imapd<br />
<br />
You should now have couple of processes related to courier-imap<br />
<br />
$ ps -a<br />
<br />
'''NOTES''':<br />
* If the service could not be started, it's probably because the service script is not executable by SYSTEM<br />
<br />
$ net start imapd<br />
The CYGWIN imapd service is starting.<br />
The CYGWIN imapd service could not be started. <br />
<br />
The service did not report an error.<br />
<br />
More help is available by typing NET HELPMSG 3534.<br />
<br />
* The combination of background sleep and builtin wait command is used to make the waiting statment interruptible. The original script found on the net, was simply using a 'sleep 1' which turned to consume ~10% of the CPU.<br />
<br />
=Maildir=<br />
'''maildirmake''' is part of the courier-imap package<br />
<br />
$ /usr/lib/courier-imap/bin/maildirmake</div>Twalranthttps://wiki.yobi.be/index.php?title=Courier-Cygwin&diff=5261Courier-Cygwin2008-10-31T13:44:13Z<p>Twalrant: /* Cygwin service */</p>
<hr />
<div>=Pre-requisite=<br />
<br />
Courier-IMAP requires the installation of the [http://www.courier-mta.org/authlib/ Courier Authentication Library] and the following cygwin tools and packages<br />
<br />
* patch, tar, make, gcc<br />
* crypt<br />
* libgdbm-devel<br />
* libtool<br />
* inetutils<br />
* cygrunsrv<br />
<br />
Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install the required packages.<br />
<br />
=Courier Authentication Library=<br />
<br />
Installation of Courier Authentication Library using the module userdb to manage mail accounts. All other modules are disabled.<br />
<br />
==Compilation and installation==<br />
<br />
Download and untar [http://www.courier-mta.org/download.php#authlib courier-authlib] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-authlib-0.61.0.tar.bz2 0.61.0]<br />
<br />
Apply the [{{#file:courrier-authlib-0.61.0-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# add libtool flag (-no-undefined) required for DLL creation<br />
# add missing dependencies<br />
# add PATH in start script to access new DLL (installed in a different directory)<br />
<br />
Solution source: http://lists.cairographics.org/archives/cairo/2004-April/001125.html<br />
<br />
<source lang=diff><br />
--- courier-authlib-0.61.0/makedat/Makefile.in 2008-05-24 16:21:09.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/makedat/Makefile.in 2008-10-21 16:02:38.709166700 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-authlib-0.61.0/Makefile.in 2008-07-12 21:41:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/Makefile.in 2008-10-23 22:59:03.843750000 +0200<br />
@@ -213,9 +213,10 @@<br />
LTCOMPILE = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
--mode=compile $(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) \<br />
$(AM_CPPFLAGS) $(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS)<br />
-CCLD = $(CC)<br />
+CCLD = $(CC) -no-undefined<br />
+CCLDEXE = $(CC)<br />
LINK = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
- --mode=link $(CCLD) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
+ --mode=link $(CCLDEXE) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
$(LDFLAGS) -o $@<br />
SOURCES = $(libauthcustom_la_SOURCES) $(libauthldap_la_SOURCES) \<br />
$(libauthmysql_la_SOURCES) $(libauthpam_la_SOURCES) \<br />
@@ -452,9 +453,9 @@<br />
README.authdebug.html<br />
<br />
DISTCLEANFILES = dbobj.config README_authlib.html<br />
-commonlibdep = libcourierauthcommon.la<br />
+commonlibdep = libcourierauthcommon.la libcourierauth.la<br />
commonldflags = -module -rpath $(pkglibdir) -export-symbols-regex 'courier_auth.*_init' -avoid-version<br />
-commonlibadd = libcourierauthcommon.la<br />
+commonlibadd = libcourierauthcommon.la libcourierauth.la<br />
libcourierauthcommon_t = @CRYPTLIBS@<br />
libcourierauthcommon_la_SOURCES = \<br />
auth.h courierauth.h \<br />
--- courier-authlib-0.61.0/authdaemond.in 2005-07-05 14:25:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/authdaemond.in 2008-10-25 12:03:32.140625000 +0200<br />
@@ -15,4 +15,10 @@<br />
set -a<br />
. @authdaemonrc@<br />
<br />
+# Some shared libraries (DLL) are installed in @libdir@/bin<br />
+# instead of @libdir@/@PACKAGE@<br />
+# Setting LD_LIBRARY_PATH at runtime or LR_RUN_PATH at linktime doesn't<br />
+# work in cygwin, only setting PATH works. <br />
+export PATH=$PATH:@libdir@/bin<br />
+<br />
exec ${sbindir}/courierlogger -pid=@authdaemonvar@/pid $LOGGEROPTS -$1 @libexecdir@/courier-authlib/authdaemond<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-authlib-0.61.0-cygwin.patch<br />
<br />
Configure the package without most authentication modules, keeping only ''userdb''.<br />
<br />
'''Note''': replace ''mailuser'' by an existing user name (in your /etc/passwd file). I used my own username.<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait --without-authpam --without-authldap --without-authpwd \<br />
--without-authshadow --without-authcustom --without-authpipe --without-authmysql --without-authpgsql --with-mailuser=mailuser \<br />
--with-mailgroup=mkgroup-l-d<br />
<br />
Take a long pause... and when ready execute the following command.<br />
<br />
$ make<br />
<br />
Take again a long pause... then check the result and install the libraries<br />
<br />
$ make check<br />
$ make install<br />
<br />
==Configuration==<br />
<br />
Create authdaemonrc file: /usr/local/etc/authlib/authdaemonrc<br />
<br />
$ cp /usr/local/etc/authlib/authdaemonrc.dist /usr/local/etc/authlib/authdaemonrc<br />
<br />
Change number of daemons (I use only one) and enable DEBUG_LOGIN<br />
<br />
<source lang=text><br />
# The number of daemon processes that are started.<br />
daemons=1<br />
<br />
# DEBUG_LOGIN=2 - turn on debugging + log passwords too<br />
DEBUG_LOGIN=2<br />
</source><br />
<br />
See http://www.courier-mta.org/authlib/README.authdebug.html for details.<br />
<br />
==IMAP accounts==<br />
<br />
User accounts and settings are managed by ''userdb''. See [http://linux.die.net/man/8/makeuserdb makeuserdb] man page for details, or used the freshly new install man page - man makeuserdb<br />
<br />
Assuming ''username'' is your username, 1001 and 10545 are respectively the UID and GID of an existing user (part of your /etc/passwd and /etc/group). I use my own UID and GID. Create the mailuser home directory, if required, and create Maildir folder.<br />
<br />
$ mkdir -p /home/username<br />
$ cd /home/username<br />
$ /usr/lib/courier-imap/bin/maildirmake Maildir<br />
<br />
Create the userdb text file /usr/local/etc/authlib/userdb<br />
<br />
$ touch /usr/local/etc/authlib/userdb<br />
$ chmod 700 /usr/local/etc/authlib/userdb<br />
<br />
Edit /usr/local/etc/authlib/userdb, one line per account<br />
<br />
<source lang=text><br />
username[TAB]uid=1001|gid=10111|home=/home/username|mail=/home/username/Maildir|systempw=XXXXXX<br />
</source><br />
<br />
where XXXXXX is the encrypted password created with<br />
<br />
$ /usr/local/sbin/userdbpw.exe<br />
<br />
Create the (binary) userdb<br />
<br />
$ /usr/local/sbin/makeuserdb<br />
<br />
You should now have the following files created:<br />
<br />
* /usr/local/etc/authlib/userdb.dat<br />
* /usr/local/etc/authlib/userdbshadow.dat<br />
<br />
==Running==<br />
<br />
Install and configure syslogd. Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install inetutils (contains syslogd). Configure syslogd with the following command. It will create the /etc/syslogd.conf file and install a windows service using cygrunsrv<br />
<br />
$ syslogd-config<br />
<br />
Start the authlib daemon with the following command:<br />
<br />
$ /usr/local/sbin/authdaemon start<br />
<br />
Stop the daemon with the following command:<br />
<br />
$ /usr/local/sbin/authdaemon stop<br />
<br />
You'll find log messages in /var/log/messages (default target file as specified in /etc/syslogd.conf)<br />
<br />
==Testing authlib==<br />
<br />
$ /usr/local/sbin/authtest username CCCCCC<br />
Authentication succeeded.<br />
<br />
Authenticated: username (uid 1001, gid 10545)<br />
Home Directory: /home/username<br />
Maildir: /home/username/Maildir<br />
Quota: (none)<br />
Encrypted Password: XXXXXX<br />
Cleartext Password: CCCCCC<br />
Options: (none)<br />
<br />
where username is your user name and XXXXXX is your encrypted password as provided in ''/usr/local/etc/authlib/userdb''. CCCCCC is your password in clear.<br />
<br />
==Troubleshooting==<br />
<br />
Should you have a doubt on the execution of a command (ie: no output) you can check if the application is able to load required DLL. This error is not reported. Using ''strace'', windows will complain about DLL not found, if any. To solve this problem you may need to add some path in your PATH. For example, in order to test authlib with authtest:<br />
<br />
$ strace /usr/local/sbin/authtest<br />
# This will open a dialog box to complain about DLL.<br />
$ export PATH=$PATH:/usr/local/lib/bin<br />
$ /usr/local/sbin/authtest ausername<br />
<br />
==Courier Authentication Config==<br />
<br />
$ /usr/local/bin/courierauthconfig.exe --version<br />
$ /usr/local/bin/courierauthconfig.exe --ldflags<br />
$ /usr/local/bin/courierauthconfig.exe --cppflags<br />
$ /usr/local/bin/courierauthconfig.exe --configfiles<br />
<br />
=Courier-IMAP=<br />
==Compilation and installation==<br />
<br />
Download and untar package [http://www.courier-mta.org/download.php#imap courier-imap] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-imap-4.4.1.tar.bz2 4.4.1.20080920]<br />
<br />
Apply the [{{#file:courrier-imap-4.4.1-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# incorrect usage of EXTEXT in main ''Makefile''<br />
# remove usage of /usr/lib/env in start/stop script (/usr/lib/env does not seem to work under Cygwin)<br />
<br />
<source lang=diff><br />
--- courier-imap-4.4.1.20080920/makedat/Makefile.in 2008-08-24 19:52:51.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/makedat/Makefile.in 2008-10-21 20:43:27.500000000 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-imap-4.4.1.20080920/Makefile.in 2008-09-20 14:48:46.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/Makefile.in 2008-10-21 20:59:45.156250000 +0200<br />
@@ -247,9 +247,9 @@<br />
CLEANFILES = $(databin_SCRIPTS) $(man_MANS) $(sysconf_DATA) $(sbin_SCRIPTS)<br />
databindir = $(datadir)<br />
databin_SCRIPTS = mkimapdcert mkpop3dcert<br />
-binPROGRAMS = imapd pop3d maildirmake maildiracl deliverquota maildirkw<br />
-sbinPROGRAMS = imaplogin pop3login<br />
-libexecPROGRAMS = makedatprog couriertcpd<br />
+binPROGRAMS = imapd$(EXEEXT) pop3d$(EXEEXT) maildirmake$(EXEEXT) maildiracl$(EXEEXT) deliverquota$(EXEEXT) maildirkw$(EXEEXT)<br />
+sbinPROGRAMS = imaplogin$(EXEEXT) pop3login$(EXEEXT)<br />
+libexecPROGRAMS = makedatprog$(EXEEXT) couriertcpd$(EXEEXT)<br />
bin_PROGRAMS = @binPROGRAMS_exec@<br />
sbin_PROGRAMS = @sbinPROGRAMS_exec@<br />
libexec_PROGRAMS = @libexecPROGRAMS_exec@<br />
--- courier-imap-4.4.1.20080920/imapd.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/imapd.rc.in 2008-10-26 10:17:51.359375000 +0100<br />
@@ -22,6 +22,15 @@<br />
exit 1<br />
fi<br />
<br />
+# Location for some shared libraries (cygcourierauth*.dll) from authlib<br />
+AUTHLIBDIR=/usr/local<br />
+if test ! -f $AUTHLIBDIR/lib/bin/cygcourierauth.dll<br />
+then<br />
+ echo "$AUTHLIBDIR/lib/bin/cygcourierauth.dll not found."<br />
+ exit 1<br />
+fi<br />
+export PATH=$PATH:$AUTHLIBDIR/lib/bin<br />
+<br />
TLS_CACHEFILE=""<br />
. @sysconfdir@/imapd-ssl<br />
. @sysconfdir@/imapd<br />
@@ -35,7 +44,7 @@<br />
<br />
umask $IMAP_UMASK<br />
@ULIMIT@ $IMAP_ULIMITD<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
--- courier-imap-4.4.1.20080920/pop3d.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/pop3d.rc.in 2008-10-26 10:18:02.187500000 +0100<br />
@@ -22,12 +22,21 @@<br />
exit 1<br />
fi<br />
<br />
+# Location for some shared libraries (cygcourierauth*.dll) from authlib<br />
+AUTHLIBDIR=/usr/local<br />
+if test ! -f $AUTHLIBDIR/lib/bin/cygcourierauth.dll<br />
+then<br />
+ echo "$AUTHLIBDIR/lib/bin/cygcourierauth.dll not found."<br />
+ exit 1<br />
+fi<br />
+export PATH=$PATH:$AUTHLIBDIR/lib/bin<br />
+<br />
. @sysconfdir@/pop3d-ssl<br />
. @sysconfdir@/pop3d<br />
<br />
case $1 in<br />
start)<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-imap-4.4.1-cygwin.patch<br />
<br />
Configure the package<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait<br />
<br />
Take a walk... and when ready execute the following command to build the package.<br />
<br />
$ make<br />
<br />
Time to go for some coffee... and then install the package with the usual<br />
<br />
$ make install<br />
$ make install-configure<br />
<br />
==Configuration==<br />
<br />
Setup courier-imap: $prefix/etc/imapd (where $prefix=/usr/lib/courier-imap)<br />
<br />
Set ADDRESS to a valid value (0 or 127.0.0.1) and change IMAP_ULIMITD to a value accepted by the command ulimit. I simply used the existing value returned by<br />
<br />
$ ulimit -v<br />
<br />
==Running==<br />
<br />
Syslogd service and authdaemond should be started. See above.<br />
<br />
Start the imap daemon with the following command:<br />
<br />
$ /usr/lib/courier-imap/libexec/imapd.rc start<br />
<br />
Stop the daemon with the following command:<br />
<br />
$ /usr/lib/courier-imap/libexec/imapd.rc stop<br />
<br />
You'll find log messages in /var/log/messages (default target file as specified in /etc/syslogd.conf)<br />
<br />
==Testing==<br />
When authdaemond and imapd are running you can do a simple login test:<br />
<br />
$ telnet localhost 143<br />
<br />
and type the login command<br />
<br />
a login <username> <password><br />
<br />
the server should reply<br />
<br />
a OK LOGIN Ok.<br />
<br />
to which you can reply with a logout<br />
<br />
a logout<br />
<br />
the session is terminated by the server<br />
<br />
* BYE Courier-IMAP server shutting down<br />
a OK LOGOUT completed<br />
Connection closed by foreign host.<br />
<br />
'''Hint:''' if the connection is immediately closed by foreign host it probably means that ''imapd'' does not have access to all required DLLs. Check your PATH.<br />
<br />
==All in one==<br />
If everything works fine you can use the following [{{#file:imapd}} startup script] to launch or stop imap and authlib daemons. It can be saved in /usr/local/sbin.<br />
<br />
<source lang=bash><br />
#! /bin/sh<br />
#<br />
# Courier imap daemon startup script.<br />
<br />
authlib=/usr/local/sbin/authdaemond<br />
imapd=/usr/lib/courier-imap/libexec/imapd.rc<br />
<br />
test ! -f $authlib && echo "File not found: $authlib" && exit 1;<br />
test ! -f $imapd && echo "File not found: $imapd" && exit 1;<br />
<br />
case $1 in<br />
start)<br />
$authlib start<br />
$imapd start<br />
;;<br />
stop)<br />
$imapd stop<br />
$authlib stop<br />
;;<br />
*)<br />
echo "Usage: $0 <start|stop>"<br />
;;<br />
esac<br />
</source><br />
<br />
==Cygwin service==<br />
Create the [{{#file:imapd-srv.sh}} service script]<br />
<br />
<source lang=bash><br />
#!/bin/sh<br />
# File: imapd-service.sh<br />
# Purpose: Courier imap daemon service script.<br />
#<br />
# NOTE: This script must be excutable by SYSTEM<br />
username=beq03798<br />
pidsleep=''<br />
<br />
# Function to handle QUIT signal.<br />
# Stop imapd daemon and kill background sleep.<br />
function handleQuit<br />
{<br />
echo "STOPPING: /usr/local/sbin/imapd"<br />
su $username -c "/usr/local/sbin/imapd stop"<br />
test -n "$pidsleep" && kill -9 $pidsleep<br />
exit<br />
}<br />
<br />
# Interruptible sleep<br />
# Note: sleep is an external command (not builtin command), hence<br />
# not interruptible by the QUIT signal.<br />
function intsleep<br />
{<br />
sleep $1 &<br />
pidsleep=$!<br />
wait $pidsleep<br />
}<br />
<br />
echo "STARTING: /usr/local/sbin/imapd as $username at "`date`<br />
su $username -c "/usr/local/sbin/imapd start"<br />
<br />
trap "handleQuit" SIGQUIT<br />
<br />
echo "WAITING: "$$<br />
while true; do intsleep 1d; done<br />
</source><br />
<br />
Change username and save it to your favorite location, says /usr/local/sbin. The service script must be executable by SYSTEM, ie: the user that run the windows services.<br />
<br />
$ chmod +x /usr/local/sbin/imapd-service.sh<br />
<br />
Install the new service with the following command.<br />
<br />
$ cygrunsrv --install imapd --desc "Courier IMAP daemon" --disp "CYGWIN imapd" \<br />
--path /usr/local/sbin/imapd-service.sh --termsig QUIT --type auto --shutdown<br />
<br />
Finally, just start the service<br />
<br />
$ cygrunsrv --start imapd<br />
or<br />
$ net start imapd<br />
<br />
You should now have couple of processes related to courier-imap<br />
<br />
$ ps<br />
<br />
'''NOTES''':<br />
* If the service could not be started, it's probably because the service script is not executable by SYSTEM<br />
<br />
$ net start imapd<br />
The CYGWIN imapd service is starting.<br />
The CYGWIN imapd service could not be started. <br />
<br />
The service did not report an error.<br />
<br />
More help is available by typing NET HELPMSG 3534.<br />
<br />
* The combination of background sleep and builtin wait command is used to make the waiting statment interruptible. The original script found on the net, was simply using a 'sleep 1' which turned to consume ~10% of the CPU.<br />
<br />
=Maildir=<br />
'''maildirmake''' is part of the courier-imap package<br />
<br />
$ /usr/lib/courier-imap/bin/maildirmake</div>Twalranthttps://wiki.yobi.be/index.php?title=Courier-Cygwin&diff=5260Courier-Cygwin2008-10-30T21:29:28Z<p>Twalrant: /* Cygwin service */</p>
<hr />
<div>=Pre-requisite=<br />
<br />
Courier-IMAP requires the installation of the [http://www.courier-mta.org/authlib/ Courier Authentication Library] and the following cygwin tools and packages<br />
<br />
* patch, tar, make, gcc<br />
* crypt<br />
* libgdbm-devel<br />
* libtool<br />
* inetutils<br />
* cygrunsrv<br />
<br />
Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install the required packages.<br />
<br />
=Courier Authentication Library=<br />
<br />
Installation of Courier Authentication Library using the module userdb to manage mail accounts. All other modules are disabled.<br />
<br />
==Compilation and installation==<br />
<br />
Download and untar [http://www.courier-mta.org/download.php#authlib courier-authlib] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-authlib-0.61.0.tar.bz2 0.61.0]<br />
<br />
Apply the [{{#file:courrier-authlib-0.61.0-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# add libtool flag (-no-undefined) required for DLL creation<br />
# add missing dependencies<br />
# add PATH in start script to access new DLL (installed in a different directory)<br />
<br />
Solution source: http://lists.cairographics.org/archives/cairo/2004-April/001125.html<br />
<br />
<source lang=diff><br />
--- courier-authlib-0.61.0/makedat/Makefile.in 2008-05-24 16:21:09.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/makedat/Makefile.in 2008-10-21 16:02:38.709166700 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-authlib-0.61.0/Makefile.in 2008-07-12 21:41:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/Makefile.in 2008-10-23 22:59:03.843750000 +0200<br />
@@ -213,9 +213,10 @@<br />
LTCOMPILE = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
--mode=compile $(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) \<br />
$(AM_CPPFLAGS) $(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS)<br />
-CCLD = $(CC)<br />
+CCLD = $(CC) -no-undefined<br />
+CCLDEXE = $(CC)<br />
LINK = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
- --mode=link $(CCLD) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
+ --mode=link $(CCLDEXE) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
$(LDFLAGS) -o $@<br />
SOURCES = $(libauthcustom_la_SOURCES) $(libauthldap_la_SOURCES) \<br />
$(libauthmysql_la_SOURCES) $(libauthpam_la_SOURCES) \<br />
@@ -452,9 +453,9 @@<br />
README.authdebug.html<br />
<br />
DISTCLEANFILES = dbobj.config README_authlib.html<br />
-commonlibdep = libcourierauthcommon.la<br />
+commonlibdep = libcourierauthcommon.la libcourierauth.la<br />
commonldflags = -module -rpath $(pkglibdir) -export-symbols-regex 'courier_auth.*_init' -avoid-version<br />
-commonlibadd = libcourierauthcommon.la<br />
+commonlibadd = libcourierauthcommon.la libcourierauth.la<br />
libcourierauthcommon_t = @CRYPTLIBS@<br />
libcourierauthcommon_la_SOURCES = \<br />
auth.h courierauth.h \<br />
--- courier-authlib-0.61.0/authdaemond.in 2005-07-05 14:25:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/authdaemond.in 2008-10-25 12:03:32.140625000 +0200<br />
@@ -15,4 +15,10 @@<br />
set -a<br />
. @authdaemonrc@<br />
<br />
+# Some shared libraries (DLL) are installed in @libdir@/bin<br />
+# instead of @libdir@/@PACKAGE@<br />
+# Setting LD_LIBRARY_PATH at runtime or LR_RUN_PATH at linktime doesn't<br />
+# work in cygwin, only setting PATH works. <br />
+export PATH=$PATH:@libdir@/bin<br />
+<br />
exec ${sbindir}/courierlogger -pid=@authdaemonvar@/pid $LOGGEROPTS -$1 @libexecdir@/courier-authlib/authdaemond<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-authlib-0.61.0-cygwin.patch<br />
<br />
Configure the package without most authentication modules, keeping only ''userdb''.<br />
<br />
'''Note''': replace ''mailuser'' by an existing user name (in your /etc/passwd file). I used my own username.<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait --without-authpam --without-authldap --without-authpwd \<br />
--without-authshadow --without-authcustom --without-authpipe --without-authmysql --without-authpgsql --with-mailuser=mailuser \<br />
--with-mailgroup=mkgroup-l-d<br />
<br />
Take a long pause... and when ready execute the following command.<br />
<br />
$ make<br />
<br />
Take again a long pause... then check the result and install the libraries<br />
<br />
$ make check<br />
$ make install<br />
<br />
==Configuration==<br />
<br />
Create authdaemonrc file: /usr/local/etc/authlib/authdaemonrc<br />
<br />
$ cp /usr/local/etc/authlib/authdaemonrc.dist /usr/local/etc/authlib/authdaemonrc<br />
<br />
Change number of daemons (I use only one) and enable DEBUG_LOGIN<br />
<br />
<source lang=text><br />
# The number of daemon processes that are started.<br />
daemons=1<br />
<br />
# DEBUG_LOGIN=2 - turn on debugging + log passwords too<br />
DEBUG_LOGIN=2<br />
</source><br />
<br />
See http://www.courier-mta.org/authlib/README.authdebug.html for details.<br />
<br />
==IMAP accounts==<br />
<br />
User accounts and settings are managed by ''userdb''. See [http://linux.die.net/man/8/makeuserdb makeuserdb] man page for details, or used the freshly new install man page - man makeuserdb<br />
<br />
Assuming ''username'' is your username, 1001 and 10545 are respectively the UID and GID of an existing user (part of your /etc/passwd and /etc/group). I use my own UID and GID. Create the mailuser home directory, if required, and create Maildir folder.<br />
<br />
$ mkdir -p /home/username<br />
$ cd /home/username<br />
$ /usr/lib/courier-imap/bin/maildirmake Maildir<br />
<br />
Create the userdb text file /usr/local/etc/authlib/userdb<br />
<br />
$ touch /usr/local/etc/authlib/userdb<br />
$ chmod 700 /usr/local/etc/authlib/userdb<br />
<br />
Edit /usr/local/etc/authlib/userdb, one line per account<br />
<br />
<source lang=text><br />
username[TAB]uid=1001|gid=10111|home=/home/username|mail=/home/username/Maildir|systempw=XXXXXX<br />
</source><br />
<br />
where XXXXXX is the encrypted password created with<br />
<br />
$ /usr/local/sbin/userdbpw.exe<br />
<br />
Create the (binary) userdb<br />
<br />
$ /usr/local/sbin/makeuserdb<br />
<br />
You should now have the following files created:<br />
<br />
* /usr/local/etc/authlib/userdb.dat<br />
* /usr/local/etc/authlib/userdbshadow.dat<br />
<br />
==Running==<br />
<br />
Install and configure syslogd. Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install inetutils (contains syslogd). Configure syslogd with the following command. It will create the /etc/syslogd.conf file and install a windows service using cygrunsrv<br />
<br />
$ syslogd-config<br />
<br />
Start the authlib daemon with the following command:<br />
<br />
$ /usr/local/sbin/authdaemon start<br />
<br />
Stop the daemon with the following command:<br />
<br />
$ /usr/local/sbin/authdaemon stop<br />
<br />
You'll find log messages in /var/log/messages (default target file as specified in /etc/syslogd.conf)<br />
<br />
==Testing authlib==<br />
<br />
$ /usr/local/sbin/authtest username CCCCCC<br />
Authentication succeeded.<br />
<br />
Authenticated: username (uid 1001, gid 10545)<br />
Home Directory: /home/username<br />
Maildir: /home/username/Maildir<br />
Quota: (none)<br />
Encrypted Password: XXXXXX<br />
Cleartext Password: CCCCCC<br />
Options: (none)<br />
<br />
where username is your user name and XXXXXX is your encrypted password as provided in ''/usr/local/etc/authlib/userdb''. CCCCCC is your password in clear.<br />
<br />
==Troubleshooting==<br />
<br />
Should you have a doubt on the execution of a command (ie: no output) you can check if the application is able to load required DLL. This error is not reported. Using ''strace'', windows will complain about DLL not found, if any. To solve this problem you may need to add some path in your PATH. For example, in order to test authlib with authtest:<br />
<br />
$ strace /usr/local/sbin/authtest<br />
# This will open a dialog box to complain about DLL.<br />
$ export PATH=$PATH:/usr/local/lib/bin<br />
$ /usr/local/sbin/authtest ausername<br />
<br />
==Courier Authentication Config==<br />
<br />
$ /usr/local/bin/courierauthconfig.exe --version<br />
$ /usr/local/bin/courierauthconfig.exe --ldflags<br />
$ /usr/local/bin/courierauthconfig.exe --cppflags<br />
$ /usr/local/bin/courierauthconfig.exe --configfiles<br />
<br />
=Courier-IMAP=<br />
==Compilation and installation==<br />
<br />
Download and untar package [http://www.courier-mta.org/download.php#imap courier-imap] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-imap-4.4.1.tar.bz2 4.4.1.20080920]<br />
<br />
Apply the [{{#file:courrier-imap-4.4.1-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# incorrect usage of EXTEXT in main ''Makefile''<br />
# remove usage of /usr/lib/env in start/stop script (/usr/lib/env does not seem to work under Cygwin)<br />
<br />
<source lang=diff><br />
--- courier-imap-4.4.1.20080920/makedat/Makefile.in 2008-08-24 19:52:51.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/makedat/Makefile.in 2008-10-21 20:43:27.500000000 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-imap-4.4.1.20080920/Makefile.in 2008-09-20 14:48:46.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/Makefile.in 2008-10-21 20:59:45.156250000 +0200<br />
@@ -247,9 +247,9 @@<br />
CLEANFILES = $(databin_SCRIPTS) $(man_MANS) $(sysconf_DATA) $(sbin_SCRIPTS)<br />
databindir = $(datadir)<br />
databin_SCRIPTS = mkimapdcert mkpop3dcert<br />
-binPROGRAMS = imapd pop3d maildirmake maildiracl deliverquota maildirkw<br />
-sbinPROGRAMS = imaplogin pop3login<br />
-libexecPROGRAMS = makedatprog couriertcpd<br />
+binPROGRAMS = imapd$(EXEEXT) pop3d$(EXEEXT) maildirmake$(EXEEXT) maildiracl$(EXEEXT) deliverquota$(EXEEXT) maildirkw$(EXEEXT)<br />
+sbinPROGRAMS = imaplogin$(EXEEXT) pop3login$(EXEEXT)<br />
+libexecPROGRAMS = makedatprog$(EXEEXT) couriertcpd$(EXEEXT)<br />
bin_PROGRAMS = @binPROGRAMS_exec@<br />
sbin_PROGRAMS = @sbinPROGRAMS_exec@<br />
libexec_PROGRAMS = @libexecPROGRAMS_exec@<br />
--- courier-imap-4.4.1.20080920/imapd.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/imapd.rc.in 2008-10-26 10:17:51.359375000 +0100<br />
@@ -22,6 +22,15 @@<br />
exit 1<br />
fi<br />
<br />
+# Location for some shared libraries (cygcourierauth*.dll) from authlib<br />
+AUTHLIBDIR=/usr/local<br />
+if test ! -f $AUTHLIBDIR/lib/bin/cygcourierauth.dll<br />
+then<br />
+ echo "$AUTHLIBDIR/lib/bin/cygcourierauth.dll not found."<br />
+ exit 1<br />
+fi<br />
+export PATH=$PATH:$AUTHLIBDIR/lib/bin<br />
+<br />
TLS_CACHEFILE=""<br />
. @sysconfdir@/imapd-ssl<br />
. @sysconfdir@/imapd<br />
@@ -35,7 +44,7 @@<br />
<br />
umask $IMAP_UMASK<br />
@ULIMIT@ $IMAP_ULIMITD<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
--- courier-imap-4.4.1.20080920/pop3d.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/pop3d.rc.in 2008-10-26 10:18:02.187500000 +0100<br />
@@ -22,12 +22,21 @@<br />
exit 1<br />
fi<br />
<br />
+# Location for some shared libraries (cygcourierauth*.dll) from authlib<br />
+AUTHLIBDIR=/usr/local<br />
+if test ! -f $AUTHLIBDIR/lib/bin/cygcourierauth.dll<br />
+then<br />
+ echo "$AUTHLIBDIR/lib/bin/cygcourierauth.dll not found."<br />
+ exit 1<br />
+fi<br />
+export PATH=$PATH:$AUTHLIBDIR/lib/bin<br />
+<br />
. @sysconfdir@/pop3d-ssl<br />
. @sysconfdir@/pop3d<br />
<br />
case $1 in<br />
start)<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-imap-4.4.1-cygwin.patch<br />
<br />
Configure the package<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait<br />
<br />
Take a walk... and when ready execute the following command to build the package.<br />
<br />
$ make<br />
<br />
Time to go for some coffee... and then install the package with the usual<br />
<br />
$ make install<br />
$ make install-configure<br />
<br />
==Configuration==<br />
<br />
Setup courier-imap: $prefix/etc/imapd (where $prefix=/usr/lib/courier-imap)<br />
<br />
Set ADDRESS to a valid value (0 or 127.0.0.1) and change IMAP_ULIMITD to a value accepted by the command ulimit. I simply used the existing value returned by<br />
<br />
$ ulimit -v<br />
<br />
==Running==<br />
<br />
Syslogd service and authdaemond should be started. See above.<br />
<br />
Start the imap daemon with the following command:<br />
<br />
$ /usr/lib/courier-imap/libexec/imapd.rc start<br />
<br />
Stop the daemon with the following command:<br />
<br />
$ /usr/lib/courier-imap/libexec/imapd.rc stop<br />
<br />
You'll find log messages in /var/log/messages (default target file as specified in /etc/syslogd.conf)<br />
<br />
==Testing==<br />
When authdaemond and imapd are running you can do a simple login test:<br />
<br />
$ telnet localhost 143<br />
<br />
and type the login command<br />
<br />
a login <username> <password><br />
<br />
the server should reply<br />
<br />
a OK LOGIN Ok.<br />
<br />
to which you can reply with a logout<br />
<br />
a logout<br />
<br />
the session is terminated by the server<br />
<br />
* BYE Courier-IMAP server shutting down<br />
a OK LOGOUT completed<br />
Connection closed by foreign host.<br />
<br />
'''Hint:''' if the connection is immediately closed by foreign host it probably means that ''imapd'' does not have access to all required DLLs. Check your PATH.<br />
<br />
==All in one==<br />
If everything works fine you can use the following [{{#file:imapd}} startup script] to launch or stop imap and authlib daemons. It can be saved in /usr/local/sbin.<br />
<br />
<source lang=bash><br />
#! /bin/sh<br />
#<br />
# Courier imap daemon startup script.<br />
<br />
authlib=/usr/local/sbin/authdaemond<br />
imapd=/usr/lib/courier-imap/libexec/imapd.rc<br />
<br />
test ! -f $authlib && echo "File not found: $authlib" && exit 1;<br />
test ! -f $imapd && echo "File not found: $imapd" && exit 1;<br />
<br />
case $1 in<br />
start)<br />
$authlib start<br />
$imapd start<br />
;;<br />
stop)<br />
$imapd stop<br />
$authlib stop<br />
;;<br />
*)<br />
echo "Usage: $0 <start|stop>"<br />
;;<br />
esac<br />
</source><br />
<br />
==Cygwin service==<br />
Create the [{{#file:imapd-srv.sh}} service script]<br />
<br />
<source lang=bash><br />
#!/bin/sh<br />
# File: imapd-srv.sh<br />
# Purpose: Courier imap daemon service script.<br />
#<br />
# This script must be excutable by SYSTEM<br />
username=username # <<<< Change me !!!<br />
<br />
function handleQuit<br />
{<br />
echo "STOPPING: /usr/local/sbin/imapd"<br />
su $username -c "/usr/local/sbin/imapd stop"<br />
exit<br />
}<br />
<br />
echo "STARTING: /usr/local/sbin/imapd as $username"<br />
su $username -c "/usr/local/sbin/imapd start"<br />
<br />
trap "handleQuit" SIGQUIT<br />
<br />
echo "WAITING"<br />
while true<br />
do<br />
sleep 1<br />
done<br />
</source><br />
<br />
Change username and save it to your favorite location, says /usr/local/sbin. The service script must be executable by SYSTEM, ie: the user that run the windows services.<br />
<br />
$ chmod +x /usr/local/sbin/imapd-srv.sh<br />
<br />
Install the new service with the following command.<br />
<br />
$ cygrunsrv --install imapd --desc "Courier IMAP daemon" --disp "CYGWIN imapd" \<br />
--path /usr/local/sbin/imapd-srv.sh --termsig QUIT --type auto --shutdown<br />
<br />
Finally, just start the service<br />
<br />
$ cygrunsrv --start imapd<br />
or<br />
$ net start imapd<br />
<br />
You should now have couple of processes related to courier-imap<br />
<br />
$ ps<br />
<br />
===Troubleshooting===<br />
If the service is could not be started, it's probably because the service script is not executable by SYSTEM<br />
<br />
$ net start imapd<br />
The CYGWIN imapd service is starting.<br />
The CYGWIN imapd service could not be started. <br />
<br />
The service did not report an error.<br />
<br />
More help is available by typing NET HELPMSG 3534.<br />
<br />
=Maildir=<br />
'''maildirmake''' is part of the courier-imap package<br />
<br />
$ /usr/lib/courier-imap/bin/maildirmake</div>Twalranthttps://wiki.yobi.be/index.php?title=Courier-Cygwin&diff=5250Courier-Cygwin2008-10-26T15:37:15Z<p>Twalrant: /* Compilation and installation */</p>
<hr />
<div>=Pre-requisite=<br />
<br />
Courier-IMAP requires the installation of the [http://www.courier-mta.org/authlib/ Courier Authentication Library] and the following cygwin tools and packages<br />
<br />
* patch, tar, make, gcc<br />
* crypt<br />
* libgdbm-devel<br />
* libtool<br />
* inetutils<br />
* cygrunsrv<br />
<br />
Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install the required packages.<br />
<br />
=Courier Authentication Library=<br />
<br />
Installation of Courier Authentication Library using the module userdb to manage mail accounts. All other modules are disabled.<br />
<br />
==Compilation and installation==<br />
<br />
Download and untar [http://www.courier-mta.org/download.php#authlib courier-authlib] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-authlib-0.61.0.tar.bz2 0.61.0]<br />
<br />
Apply the [{{#file:courrier-authlib-0.61.0-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# add libtool flag (-no-undefined) required for DLL creation<br />
# add missing dependencies<br />
# add PATH in start script to access new DLL (installed in a different directory)<br />
<br />
Solution source: http://lists.cairographics.org/archives/cairo/2004-April/001125.html<br />
<br />
<source lang=diff><br />
--- courier-authlib-0.61.0/makedat/Makefile.in 2008-05-24 16:21:09.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/makedat/Makefile.in 2008-10-21 16:02:38.709166700 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-authlib-0.61.0/Makefile.in 2008-07-12 21:41:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/Makefile.in 2008-10-23 22:59:03.843750000 +0200<br />
@@ -213,9 +213,10 @@<br />
LTCOMPILE = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
--mode=compile $(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) \<br />
$(AM_CPPFLAGS) $(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS)<br />
-CCLD = $(CC)<br />
+CCLD = $(CC) -no-undefined<br />
+CCLDEXE = $(CC)<br />
LINK = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
- --mode=link $(CCLD) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
+ --mode=link $(CCLDEXE) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
$(LDFLAGS) -o $@<br />
SOURCES = $(libauthcustom_la_SOURCES) $(libauthldap_la_SOURCES) \<br />
$(libauthmysql_la_SOURCES) $(libauthpam_la_SOURCES) \<br />
@@ -452,9 +453,9 @@<br />
README.authdebug.html<br />
<br />
DISTCLEANFILES = dbobj.config README_authlib.html<br />
-commonlibdep = libcourierauthcommon.la<br />
+commonlibdep = libcourierauthcommon.la libcourierauth.la<br />
commonldflags = -module -rpath $(pkglibdir) -export-symbols-regex 'courier_auth.*_init' -avoid-version<br />
-commonlibadd = libcourierauthcommon.la<br />
+commonlibadd = libcourierauthcommon.la libcourierauth.la<br />
libcourierauthcommon_t = @CRYPTLIBS@<br />
libcourierauthcommon_la_SOURCES = \<br />
auth.h courierauth.h \<br />
--- courier-authlib-0.61.0/authdaemond.in 2005-07-05 14:25:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/authdaemond.in 2008-10-25 12:03:32.140625000 +0200<br />
@@ -15,4 +15,10 @@<br />
set -a<br />
. @authdaemonrc@<br />
<br />
+# Some shared libraries (DLL) are installed in @libdir@/bin<br />
+# instead of @libdir@/@PACKAGE@<br />
+# Setting LD_LIBRARY_PATH at runtime or LR_RUN_PATH at linktime doesn't<br />
+# work in cygwin, only setting PATH works. <br />
+export PATH=$PATH:@libdir@/bin<br />
+<br />
exec ${sbindir}/courierlogger -pid=@authdaemonvar@/pid $LOGGEROPTS -$1 @libexecdir@/courier-authlib/authdaemond<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-authlib-0.61.0-cygwin.patch<br />
<br />
Configure the package without most authentication modules, keeping only ''userdb''.<br />
<br />
'''Note''': replace ''mailuser'' by an existing user name (in your /etc/passwd file). I used my own username.<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait --without-authpam --without-authldap --without-authpwd \<br />
--without-authshadow --without-authcustom --without-authpipe --without-authmysql --without-authpgsql --with-mailuser=mailuser \<br />
--with-mailgroup=mkgroup-l-d<br />
<br />
Take a long pause... and when ready execute the following command.<br />
<br />
$ make<br />
<br />
Take again a long pause... then check the result and install the libraries<br />
<br />
$ make check<br />
$ make install<br />
<br />
==Configuration==<br />
<br />
Create authdaemonrc file: /usr/local/etc/authlib/authdaemonrc<br />
<br />
$ cp /usr/local/etc/authlib/authdaemonrc.dist /usr/local/etc/authlib/authdaemonrc<br />
<br />
Change number of daemons (I use only one) and enable DEBUG_LOGIN<br />
<br />
<source lang=text><br />
# The number of daemon processes that are started.<br />
daemons=1<br />
<br />
# DEBUG_LOGIN=2 - turn on debugging + log passwords too<br />
DEBUG_LOGIN=2<br />
</source><br />
<br />
See http://www.courier-mta.org/authlib/README.authdebug.html for details.<br />
<br />
==IMAP accounts==<br />
<br />
User accounts and settings are managed by ''userdb''. See [http://linux.die.net/man/8/makeuserdb makeuserdb] man page for details, or used the freshly new install man page - man makeuserdb<br />
<br />
Assuming ''username'' is your username, 1001 and 10545 are respectively the UID and GID of an existing user (part of your /etc/passwd and /etc/group). I use my own UID and GID. Create the mailuser home directory, if required, and create Maildir folder.<br />
<br />
$ mkdir -p /home/username<br />
$ cd /home/username<br />
$ /usr/lib/courier-imap/bin/maildirmake Maildir<br />
<br />
Create the userdb text file /usr/local/etc/authlib/userdb<br />
<br />
$ touch /usr/local/etc/authlib/userdb<br />
$ chmod 700 /usr/local/etc/authlib/userdb<br />
<br />
Edit /usr/local/etc/authlib/userdb, one line per account<br />
<br />
<source lang=text><br />
username[TAB]uid=1001|gid=10111|home=/home/username|mail=/home/username/Maildir|systempw=XXXXXX<br />
</source><br />
<br />
where XXXXXX is the encrypted password created with<br />
<br />
$ /usr/local/sbin/userdbpw.exe<br />
<br />
Create the (binary) userdb<br />
<br />
$ /usr/local/sbin/makeuserdb<br />
<br />
You should now have the following files created:<br />
<br />
* /usr/local/etc/authlib/userdb.dat<br />
* /usr/local/etc/authlib/userdbshadow.dat<br />
<br />
==Running==<br />
<br />
Install and configure syslogd. Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install inetutils (contains syslogd). Configure syslogd with the following command. It will create the /etc/syslogd.conf file and install a windows service using cygrunsrv<br />
<br />
$ syslogd-config<br />
<br />
Start the authlib daemon with the following command:<br />
<br />
$ /usr/local/sbin/authdaemon start<br />
<br />
Stop the daemon with the following command:<br />
<br />
$ /usr/local/sbin/authdaemon stop<br />
<br />
You'll find log messages in /var/log/messages (default target file as specified in /etc/syslogd.conf)<br />
<br />
==Testing authlib==<br />
<br />
$ /usr/local/sbin/authtest username CCCCCC<br />
Authentication succeeded.<br />
<br />
Authenticated: username (uid 1001, gid 10545)<br />
Home Directory: /home/username<br />
Maildir: /home/username/Maildir<br />
Quota: (none)<br />
Encrypted Password: XXXXXX<br />
Cleartext Password: CCCCCC<br />
Options: (none)<br />
<br />
where username is your user name and XXXXXX is your encrypted password as provided in ''/usr/local/etc/authlib/userdb''. CCCCCC is your password in clear.<br />
<br />
==Troubleshooting==<br />
<br />
Should you have a doubt on the execution of a command (ie: no output) you can check if the application is able to load required DLL. This error is not reported. Using ''strace'', windows will complain about DLL not found, if any. To solve this problem you may need to add some path in your PATH. For example, in order to test authlib with authtest:<br />
<br />
$ strace /usr/local/sbin/authtest<br />
# This will open a dialog box to complain about DLL.<br />
$ export PATH=$PATH:/usr/local/lib/bin<br />
$ /usr/local/sbin/authtest ausername<br />
<br />
==Courier Authentication Config==<br />
<br />
$ /usr/local/bin/courierauthconfig.exe --version<br />
$ /usr/local/bin/courierauthconfig.exe --ldflags<br />
$ /usr/local/bin/courierauthconfig.exe --cppflags<br />
$ /usr/local/bin/courierauthconfig.exe --configfiles<br />
<br />
=Courier-IMAP=<br />
==Compilation and installation==<br />
<br />
Download and untar package [http://www.courier-mta.org/download.php#imap courier-imap] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-imap-4.4.1.tar.bz2 4.4.1.20080920]<br />
<br />
Apply the [{{#file:courrier-imap-4.4.1-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# incorrect usage of EXTEXT in main ''Makefile''<br />
# remove usage of /usr/lib/env in start/stop script (/usr/lib/env does not seem to work under Cygwin)<br />
<br />
<source lang=diff><br />
--- courier-imap-4.4.1.20080920/makedat/Makefile.in 2008-08-24 19:52:51.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/makedat/Makefile.in 2008-10-21 20:43:27.500000000 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-imap-4.4.1.20080920/Makefile.in 2008-09-20 14:48:46.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/Makefile.in 2008-10-21 20:59:45.156250000 +0200<br />
@@ -247,9 +247,9 @@<br />
CLEANFILES = $(databin_SCRIPTS) $(man_MANS) $(sysconf_DATA) $(sbin_SCRIPTS)<br />
databindir = $(datadir)<br />
databin_SCRIPTS = mkimapdcert mkpop3dcert<br />
-binPROGRAMS = imapd pop3d maildirmake maildiracl deliverquota maildirkw<br />
-sbinPROGRAMS = imaplogin pop3login<br />
-libexecPROGRAMS = makedatprog couriertcpd<br />
+binPROGRAMS = imapd$(EXEEXT) pop3d$(EXEEXT) maildirmake$(EXEEXT) maildiracl$(EXEEXT) deliverquota$(EXEEXT) maildirkw$(EXEEXT)<br />
+sbinPROGRAMS = imaplogin$(EXEEXT) pop3login$(EXEEXT)<br />
+libexecPROGRAMS = makedatprog$(EXEEXT) couriertcpd$(EXEEXT)<br />
bin_PROGRAMS = @binPROGRAMS_exec@<br />
sbin_PROGRAMS = @sbinPROGRAMS_exec@<br />
libexec_PROGRAMS = @libexecPROGRAMS_exec@<br />
--- courier-imap-4.4.1.20080920/imapd.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/imapd.rc.in 2008-10-26 10:17:51.359375000 +0100<br />
@@ -22,6 +22,15 @@<br />
exit 1<br />
fi<br />
<br />
+# Location for some shared libraries (cygcourierauth*.dll) from authlib<br />
+AUTHLIBDIR=/usr/local<br />
+if test ! -f $AUTHLIBDIR/lib/bin/cygcourierauth.dll<br />
+then<br />
+ echo "$AUTHLIBDIR/lib/bin/cygcourierauth.dll not found."<br />
+ exit 1<br />
+fi<br />
+export PATH=$PATH:$AUTHLIBDIR/lib/bin<br />
+<br />
TLS_CACHEFILE=""<br />
. @sysconfdir@/imapd-ssl<br />
. @sysconfdir@/imapd<br />
@@ -35,7 +44,7 @@<br />
<br />
umask $IMAP_UMASK<br />
@ULIMIT@ $IMAP_ULIMITD<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
--- courier-imap-4.4.1.20080920/pop3d.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/pop3d.rc.in 2008-10-26 10:18:02.187500000 +0100<br />
@@ -22,12 +22,21 @@<br />
exit 1<br />
fi<br />
<br />
+# Location for some shared libraries (cygcourierauth*.dll) from authlib<br />
+AUTHLIBDIR=/usr/local<br />
+if test ! -f $AUTHLIBDIR/lib/bin/cygcourierauth.dll<br />
+then<br />
+ echo "$AUTHLIBDIR/lib/bin/cygcourierauth.dll not found."<br />
+ exit 1<br />
+fi<br />
+export PATH=$PATH:$AUTHLIBDIR/lib/bin<br />
+<br />
. @sysconfdir@/pop3d-ssl<br />
. @sysconfdir@/pop3d<br />
<br />
case $1 in<br />
start)<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-imap-4.4.1-cygwin.patch<br />
<br />
Configure the package<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait<br />
<br />
Take a walk... and when ready execute the following command to build the package.<br />
<br />
$ make<br />
<br />
Time to go for some coffee... and then install the package with the usual<br />
<br />
$ make install<br />
$ make install-configure<br />
<br />
==Configuration==<br />
<br />
Setup courier-imap: $prefix/etc/imapd (where $prefix=/usr/lib/courier-imap)<br />
<br />
Set ADDRESS to a valid value (0 or 127.0.0.1) and change IMAP_ULIMITD to a value accepted by the command ulimit. I simply used the existing value returned by<br />
<br />
$ ulimit -v<br />
<br />
==Running==<br />
<br />
Syslogd service and authdaemond should be started. See above.<br />
<br />
Start the imap daemon with the following command:<br />
<br />
$ /usr/lib/courier-imap/libexec/imapd.rc start<br />
<br />
Stop the daemon with the following command:<br />
<br />
$ /usr/lib/courier-imap/libexec/imapd.rc stop<br />
<br />
You'll find log messages in /var/log/messages (default target file as specified in /etc/syslogd.conf)<br />
<br />
==Testing==<br />
When authdaemond and imapd are running you can do a simple login test:<br />
<br />
$ telnet localhost 143<br />
<br />
and type the login command<br />
<br />
a login <username> <password><br />
<br />
the server should reply<br />
<br />
a OK LOGIN Ok.<br />
<br />
to which you can reply with a logout<br />
<br />
a logout<br />
<br />
the session is terminated by the server<br />
<br />
* BYE Courier-IMAP server shutting down<br />
a OK LOGOUT completed<br />
Connection closed by foreign host.<br />
<br />
'''Hint:''' if the connection is immediately closed by foreign host it probably means that ''imapd'' does not have access to all required DLLs. Check your PATH.<br />
<br />
==All in one==<br />
If everything works fine you can use the following [{{#file:imapd}} startup script] to launch or stop imap and authlib daemons. It can be saved in /usr/local/sbin.<br />
<br />
<source lang=bash><br />
#! /bin/sh<br />
#<br />
# Courier imap daemon startup script.<br />
<br />
authlib=/usr/local/sbin/authdaemond<br />
imapd=/usr/lib/courier-imap/libexec/imapd.rc<br />
<br />
test ! -f $authlib && echo "File not found: $authlib" && exit 1;<br />
test ! -f $imapd && echo "File not found: $imapd" && exit 1;<br />
<br />
case $1 in<br />
start)<br />
$authlib start<br />
$imapd start<br />
;;<br />
stop)<br />
$imapd stop<br />
$authlib stop<br />
;;<br />
*)<br />
echo "Usage: $0 <start|stop>"<br />
;;<br />
esac<br />
</source><br />
<br />
==Cygwin service==<br />
Create the [{{#file:imapd-srv.sh}} service script]<br />
<br />
<source lang=bash><br />
#!/bin/sh<br />
# File: imapd-service.sh<br />
# Purpose: Courier imap daemon service script.<br />
#<br />
# This script must be excutable by SYSTEM<br />
username=username # <<<< Change me !!!<br />
<br />
function handleQuit<br />
{<br />
echo "STOPPING: /usr/local/sbin/imapd"<br />
su $username -c "/usr/local/sbin/imapd stop"<br />
exit<br />
}<br />
<br />
echo "STARTING: /usr/local/sbin/imapd as $username"<br />
su $username -c "/usr/local/sbin/imapd start"<br />
<br />
trap "handleQuit" SIGQUIT<br />
<br />
echo "WAITING"<br />
while true<br />
do<br />
sleep 1<br />
done<br />
</source><br />
<br />
Change username and save it to your favorite location, says /usr/local/sbin. The service script must be executable by SYSTEM, ie: the user that run the windows services.<br />
<br />
$ chmod +x /usr/local/sbin/imapd-srv.sh<br />
<br />
Install the new service with the following command.<br />
<br />
$ cygrunsrv --install imapd --desc "Courier IMAP daemon" --disp "CYGWIN imapd" \<br />
--path /usr/local/sbin/imapd-srv.sh --termsig QUIT --type auto --shutdown<br />
<br />
Finally, just start the service<br />
<br />
$ cygrunsrv --start imapd<br />
or<br />
$ net start imapd<br />
<br />
You should now have couple of processes related to courier-imap<br />
<br />
$ ps<br />
<br />
=Maildir=<br />
'''maildirmake''' is part of the courier-imap package<br />
<br />
$ /usr/lib/courier-imap/bin/maildirmake</div>Twalranthttps://wiki.yobi.be/index.php?title=Courier-Cygwin&diff=5249Courier-Cygwin2008-10-26T15:36:00Z<p>Twalrant: /* Compilation and installation */</p>
<hr />
<div>=Pre-requisite=<br />
<br />
Courier-IMAP requires the installation of the [http://www.courier-mta.org/authlib/ Courier Authentication Library] and the following cygwin tools and packages<br />
<br />
* patch, tar, make, gcc<br />
* crypt<br />
* libgdbm-devel<br />
* libtool<br />
* inetutils<br />
* cygrunsrv<br />
<br />
Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install the required packages.<br />
<br />
=Courier Authentication Library=<br />
<br />
Installation of Courier Authentication Library using the module userdb to manage mail accounts. All other modules are disabled.<br />
<br />
==Compilation and installation==<br />
<br />
Download and untar [http://www.courier-mta.org/download.php#authlib courier-authlib] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-authlib-0.61.0.tar.bz2 0.61.0]<br />
<br />
Apply the [{{#file:courrier-authlib-0.61.0-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# add libtool flag (-no-undefined) required for DLL creation<br />
# add missing dependencies<br />
# add PATH in start script to access new DLL (installed in a different directory)<br />
<br />
Solution source: http://lists.cairographics.org/archives/cairo/2004-April/001125.html<br />
<br />
<source lang=diff><br />
--- courier-authlib-0.61.0/makedat/Makefile.in 2008-05-24 16:21:09.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/makedat/Makefile.in 2008-10-21 16:02:38.709166700 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-authlib-0.61.0/Makefile.in 2008-07-12 21:41:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/Makefile.in 2008-10-23 22:59:03.843750000 +0200<br />
@@ -213,9 +213,10 @@<br />
LTCOMPILE = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
--mode=compile $(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) \<br />
$(AM_CPPFLAGS) $(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS)<br />
-CCLD = $(CC)<br />
+CCLD = $(CC) -no-undefined<br />
+CCLDEXE = $(CC)<br />
LINK = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
- --mode=link $(CCLD) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
+ --mode=link $(CCLDEXE) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
$(LDFLAGS) -o $@<br />
SOURCES = $(libauthcustom_la_SOURCES) $(libauthldap_la_SOURCES) \<br />
$(libauthmysql_la_SOURCES) $(libauthpam_la_SOURCES) \<br />
@@ -452,9 +453,9 @@<br />
README.authdebug.html<br />
<br />
DISTCLEANFILES = dbobj.config README_authlib.html<br />
-commonlibdep = libcourierauthcommon.la<br />
+commonlibdep = libcourierauthcommon.la libcourierauth.la<br />
commonldflags = -module -rpath $(pkglibdir) -export-symbols-regex 'courier_auth.*_init' -avoid-version<br />
-commonlibadd = libcourierauthcommon.la<br />
+commonlibadd = libcourierauthcommon.la libcourierauth.la<br />
libcourierauthcommon_t = @CRYPTLIBS@<br />
libcourierauthcommon_la_SOURCES = \<br />
auth.h courierauth.h \<br />
--- courier-authlib-0.61.0/authdaemond.in 2005-07-05 14:25:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/authdaemond.in 2008-10-25 12:03:32.140625000 +0200<br />
@@ -15,4 +15,10 @@<br />
set -a<br />
. @authdaemonrc@<br />
<br />
+# Some shared libraries (DLL) are installed in @libdir@/bin<br />
+# instead of @libdir@/@PACKAGE@<br />
+# Setting LD_LIBRARY_PATH at runtime or LR_RUN_PATH at linktime doesn't<br />
+# work in cygwin, only setting PATH works. <br />
+export PATH=$PATH:@libdir@/bin<br />
+<br />
exec ${sbindir}/courierlogger -pid=@authdaemonvar@/pid $LOGGEROPTS -$1 @libexecdir@/courier-authlib/authdaemond<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-authlib-0.61.0-cygwin.patch<br />
<br />
Configure the package without most authentication modules, keeping only ''userdb''.<br />
<br />
'''Note''': replace ''mailuser'' by an existing user name (in your /etc/passwd file). I used my own username.<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait --without-authpam --without-authldap --without-authpwd \<br />
--without-authshadow --without-authcustom --without-authpipe --without-authmysql --without-authpgsql --with-mailuser=mailuser \<br />
--with-mailgroup=mkgroup-l-d<br />
<br />
Take a long pause... and when ready execute the following command.<br />
<br />
$ make<br />
<br />
Take again a long pause... then check the result and install the libraries<br />
<br />
$ make check<br />
$ make install<br />
<br />
==Configuration==<br />
<br />
Create authdaemonrc file: /usr/local/etc/authlib/authdaemonrc<br />
<br />
$ cp /usr/local/etc/authlib/authdaemonrc.dist /usr/local/etc/authlib/authdaemonrc<br />
<br />
Change number of daemons (I use only one) and enable DEBUG_LOGIN<br />
<br />
<source lang=text><br />
# The number of daemon processes that are started.<br />
daemons=1<br />
<br />
# DEBUG_LOGIN=2 - turn on debugging + log passwords too<br />
DEBUG_LOGIN=2<br />
</source><br />
<br />
See http://www.courier-mta.org/authlib/README.authdebug.html for details.<br />
<br />
==IMAP accounts==<br />
<br />
User accounts and settings are managed by ''userdb''. See [http://linux.die.net/man/8/makeuserdb makeuserdb] man page for details, or used the freshly new install man page - man makeuserdb<br />
<br />
Assuming ''username'' is your username, 1001 and 10545 are respectively the UID and GID of an existing user (part of your /etc/passwd and /etc/group). I use my own UID and GID. Create the mailuser home directory, if required, and create Maildir folder.<br />
<br />
$ mkdir -p /home/username<br />
$ cd /home/username<br />
$ /usr/lib/courier-imap/bin/maildirmake Maildir<br />
<br />
Create the userdb text file /usr/local/etc/authlib/userdb<br />
<br />
$ touch /usr/local/etc/authlib/userdb<br />
$ chmod 700 /usr/local/etc/authlib/userdb<br />
<br />
Edit /usr/local/etc/authlib/userdb, one line per account<br />
<br />
<source lang=text><br />
username[TAB]uid=1001|gid=10111|home=/home/username|mail=/home/username/Maildir|systempw=XXXXXX<br />
</source><br />
<br />
where XXXXXX is the encrypted password created with<br />
<br />
$ /usr/local/sbin/userdbpw.exe<br />
<br />
Create the (binary) userdb<br />
<br />
$ /usr/local/sbin/makeuserdb<br />
<br />
You should now have the following files created:<br />
<br />
* /usr/local/etc/authlib/userdb.dat<br />
* /usr/local/etc/authlib/userdbshadow.dat<br />
<br />
==Running==<br />
<br />
Install and configure syslogd. Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install inetutils (contains syslogd). Configure syslogd with the following command. It will create the /etc/syslogd.conf file and install a windows service using cygrunsrv<br />
<br />
$ syslogd-config<br />
<br />
Start the authlib daemon with the following command:<br />
<br />
$ /usr/local/sbin/authdaemon start<br />
<br />
Stop the daemon with the following command:<br />
<br />
$ /usr/local/sbin/authdaemon stop<br />
<br />
You'll find log messages in /var/log/messages (default target file as specified in /etc/syslogd.conf)<br />
<br />
==Testing authlib==<br />
<br />
$ /usr/local/sbin/authtest username CCCCCC<br />
Authentication succeeded.<br />
<br />
Authenticated: username (uid 1001, gid 10545)<br />
Home Directory: /home/username<br />
Maildir: /home/username/Maildir<br />
Quota: (none)<br />
Encrypted Password: XXXXXX<br />
Cleartext Password: CCCCCC<br />
Options: (none)<br />
<br />
where username is your user name and XXXXXX is your encrypted password as provided in ''/usr/local/etc/authlib/userdb''. CCCCCC is your password in clear.<br />
<br />
==Troubleshooting==<br />
<br />
Should you have a doubt on the execution of a command (ie: no output) you can check if the application is able to load required DLL. This error is not reported. Using ''strace'', windows will complain about DLL not found, if any. To solve this problem you may need to add some path in your PATH. For example, in order to test authlib with authtest:<br />
<br />
$ strace /usr/local/sbin/authtest<br />
# This will open a dialog box to complain about DLL.<br />
$ export PATH=$PATH:/usr/local/lib/bin<br />
$ /usr/local/sbin/authtest ausername<br />
<br />
==Courier Authentication Config==<br />
<br />
$ /usr/local/bin/courierauthconfig.exe --version<br />
$ /usr/local/bin/courierauthconfig.exe --ldflags<br />
$ /usr/local/bin/courierauthconfig.exe --cppflags<br />
$ /usr/local/bin/courierauthconfig.exe --configfiles<br />
<br />
=Courier-IMAP=<br />
==Compilation and installation==<br />
<br />
Download and untar package [http://www.courier-mta.org/download.php#imap courier-imap] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-imap-4.4.1.tar.bz2 4.4.1.20080920]<br />
<br />
Apply the [{{#file:courrier-imap-4.4.1-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# incorrect usage of EXTEXT in main ''Makefile''<br />
# remove usage of /usr/lib/env in start/stop script (/usr/lib/env does not seem to work under Cygwin)<br />
<br />
<source lang=diff><br />
--- courier-imap-4.4.1.20080920/makedat/Makefile.in 2008-08-24 19:52:51.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/makedat/Makefile.in 2008-10-21 20:43:27.500000000 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-imap-4.4.1.20080920/Makefile.in 2008-09-20 14:48:46.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/Makefile.in 2008-10-21 20:59:45.156250000 +0200<br />
@@ -247,9 +247,9 @@<br />
CLEANFILES = $(databin_SCRIPTS) $(man_MANS) $(sysconf_DATA) $(sbin_SCRIPTS)<br />
databindir = $(datadir)<br />
databin_SCRIPTS = mkimapdcert mkpop3dcert<br />
-binPROGRAMS = imapd pop3d maildirmake maildiracl deliverquota maildirkw<br />
-sbinPROGRAMS = imaplogin pop3login<br />
-libexecPROGRAMS = makedatprog couriertcpd<br />
+binPROGRAMS = imapd$(EXEEXT) pop3d$(EXEEXT) maildirmake$(EXEEXT) maildiracl$(EXEEXT) deliverquota$(EXEEXT) maildirkw$(EXEEXT)<br />
+sbinPROGRAMS = imaplogin$(EXEEXT) pop3login$(EXEEXT)<br />
+libexecPROGRAMS = makedatprog$(EXEEXT) couriertcpd$(EXEEXT)<br />
bin_PROGRAMS = @binPROGRAMS_exec@<br />
sbin_PROGRAMS = @sbinPROGRAMS_exec@<br />
libexec_PROGRAMS = @libexecPROGRAMS_exec@<br />
--- courier-imap-4.4.1.20080920/imapd.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/imapd.rc.in 2008-10-26 10:17:51.359375000 +0100<br />
@@ -22,6 +22,15 @@<br />
exit 1<br />
fi<br />
<br />
+# Location for some shared libraries (cygcourierauth*.dll) from authlib<br />
+AUTHLIBDIR=/usr/local<br />
+if test ! -f $AUTHLIBDIR/lib/bin/cygcourierauth.dll<br />
+then<br />
+ echo "$AUTHLIBDIR/lib/bin/cygcourierauth.dll not found."<br />
+ exit 1<br />
+fi<br />
+export PATH=$PATH:$AUTHLIBDIR/lib/bin<br />
+<br />
TLS_CACHEFILE=""<br />
. @sysconfdir@/imapd-ssl<br />
. @sysconfdir@/imapd<br />
@@ -35,7 +44,7 @@<br />
<br />
umask $IMAP_UMASK<br />
@ULIMIT@ $IMAP_ULIMITD<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
--- courier-imap-4.4.1.20080920/pop3d.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/pop3d.rc.in 2008-10-26 10:18:02.187500000 +0100<br />
@@ -22,12 +22,21 @@<br />
exit 1<br />
fi<br />
<br />
+# Location for some shared libraries (cygcourierauth*.dll) from authlib<br />
+AUTHLIBDIR=/usr/local<br />
+if test ! -f $AUTHLIBDIR/lib/bin/cygcourierauth.dll<br />
+then<br />
+ echo "$AUTHLIBDIR/lib/bin/cygcourierauth.dll not found."<br />
+ exit 1<br />
+fi<br />
+export PATH=$PATH:/usr/local/lib/bin<br />
+<br />
. @sysconfdir@/pop3d-ssl<br />
. @sysconfdir@/pop3d<br />
<br />
case $1 in<br />
start)<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-imap-4.4.1-cygwin.patch<br />
<br />
Configure the package<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait<br />
<br />
Take a walk... and when ready execute the following command to build the package.<br />
<br />
$ make<br />
<br />
Time to go for some coffee... and then install the package with the usual<br />
<br />
$ make install<br />
$ make install-configure<br />
<br />
==Configuration==<br />
<br />
Setup courier-imap: $prefix/etc/imapd (where $prefix=/usr/lib/courier-imap)<br />
<br />
Set ADDRESS to a valid value (0 or 127.0.0.1) and change IMAP_ULIMITD to a value accepted by the command ulimit. I simply used the existing value returned by<br />
<br />
$ ulimit -v<br />
<br />
==Running==<br />
<br />
Syslogd service and authdaemond should be started. See above.<br />
<br />
Start the imap daemon with the following command:<br />
<br />
$ /usr/lib/courier-imap/libexec/imapd.rc start<br />
<br />
Stop the daemon with the following command:<br />
<br />
$ /usr/lib/courier-imap/libexec/imapd.rc stop<br />
<br />
You'll find log messages in /var/log/messages (default target file as specified in /etc/syslogd.conf)<br />
<br />
==Testing==<br />
When authdaemond and imapd are running you can do a simple login test:<br />
<br />
$ telnet localhost 143<br />
<br />
and type the login command<br />
<br />
a login <username> <password><br />
<br />
the server should reply<br />
<br />
a OK LOGIN Ok.<br />
<br />
to which you can reply with a logout<br />
<br />
a logout<br />
<br />
the session is terminated by the server<br />
<br />
* BYE Courier-IMAP server shutting down<br />
a OK LOGOUT completed<br />
Connection closed by foreign host.<br />
<br />
'''Hint:''' if the connection is immediately closed by foreign host it probably means that ''imapd'' does not have access to all required DLLs. Check your PATH.<br />
<br />
==All in one==<br />
If everything works fine you can use the following [{{#file:imapd}} startup script] to launch or stop imap and authlib daemons. It can be saved in /usr/local/sbin.<br />
<br />
<source lang=bash><br />
#! /bin/sh<br />
#<br />
# Courier imap daemon startup script.<br />
<br />
authlib=/usr/local/sbin/authdaemond<br />
imapd=/usr/lib/courier-imap/libexec/imapd.rc<br />
<br />
test ! -f $authlib && echo "File not found: $authlib" && exit 1;<br />
test ! -f $imapd && echo "File not found: $imapd" && exit 1;<br />
<br />
case $1 in<br />
start)<br />
$authlib start<br />
$imapd start<br />
;;<br />
stop)<br />
$imapd stop<br />
$authlib stop<br />
;;<br />
*)<br />
echo "Usage: $0 <start|stop>"<br />
;;<br />
esac<br />
</source><br />
<br />
==Cygwin service==<br />
Create the [{{#file:imapd-srv.sh}} service script]<br />
<br />
<source lang=bash><br />
#!/bin/sh<br />
# File: imapd-service.sh<br />
# Purpose: Courier imap daemon service script.<br />
#<br />
# This script must be excutable by SYSTEM<br />
username=username # <<<< Change me !!!<br />
<br />
function handleQuit<br />
{<br />
echo "STOPPING: /usr/local/sbin/imapd"<br />
su $username -c "/usr/local/sbin/imapd stop"<br />
exit<br />
}<br />
<br />
echo "STARTING: /usr/local/sbin/imapd as $username"<br />
su $username -c "/usr/local/sbin/imapd start"<br />
<br />
trap "handleQuit" SIGQUIT<br />
<br />
echo "WAITING"<br />
while true<br />
do<br />
sleep 1<br />
done<br />
</source><br />
<br />
Change username and save it to your favorite location, says /usr/local/sbin. The service script must be executable by SYSTEM, ie: the user that run the windows services.<br />
<br />
$ chmod +x /usr/local/sbin/imapd-srv.sh<br />
<br />
Install the new service with the following command.<br />
<br />
$ cygrunsrv --install imapd --desc "Courier IMAP daemon" --disp "CYGWIN imapd" \<br />
--path /usr/local/sbin/imapd-srv.sh --termsig QUIT --type auto --shutdown<br />
<br />
Finally, just start the service<br />
<br />
$ cygrunsrv --start imapd<br />
or<br />
$ net start imapd<br />
<br />
You should now have couple of processes related to courier-imap<br />
<br />
$ ps<br />
<br />
=Maildir=<br />
'''maildirmake''' is part of the courier-imap package<br />
<br />
$ /usr/lib/courier-imap/bin/maildirmake</div>Twalranthttps://wiki.yobi.be/index.php?title=Courier-Cygwin&diff=5248Courier-Cygwin2008-10-26T14:31:31Z<p>Twalrant: /* Testing */</p>
<hr />
<div>=Pre-requisite=<br />
<br />
Courier-IMAP requires the installation of the [http://www.courier-mta.org/authlib/ Courier Authentication Library] and the following cygwin tools and packages<br />
<br />
* patch, tar, make, gcc<br />
* crypt<br />
* libgdbm-devel<br />
* libtool<br />
* inetutils<br />
* cygrunsrv<br />
<br />
Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install the required packages.<br />
<br />
=Courier Authentication Library=<br />
<br />
Installation of Courier Authentication Library using the module userdb to manage mail accounts. All other modules are disabled.<br />
<br />
==Compilation and installation==<br />
<br />
Download and untar [http://www.courier-mta.org/download.php#authlib courier-authlib] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-authlib-0.61.0.tar.bz2 0.61.0]<br />
<br />
Apply the [{{#file:courrier-authlib-0.61.0-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# add libtool flag (-no-undefined) required for DLL creation<br />
# add missing dependencies<br />
# add PATH in start script to access new DLL (installed in a different directory)<br />
<br />
Solution source: http://lists.cairographics.org/archives/cairo/2004-April/001125.html<br />
<br />
<source lang=diff><br />
--- courier-authlib-0.61.0/makedat/Makefile.in 2008-05-24 16:21:09.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/makedat/Makefile.in 2008-10-21 16:02:38.709166700 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-authlib-0.61.0/Makefile.in 2008-07-12 21:41:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/Makefile.in 2008-10-23 22:59:03.843750000 +0200<br />
@@ -213,9 +213,10 @@<br />
LTCOMPILE = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
--mode=compile $(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) \<br />
$(AM_CPPFLAGS) $(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS)<br />
-CCLD = $(CC)<br />
+CCLD = $(CC) -no-undefined<br />
+CCLDEXE = $(CC)<br />
LINK = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
- --mode=link $(CCLD) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
+ --mode=link $(CCLDEXE) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
$(LDFLAGS) -o $@<br />
SOURCES = $(libauthcustom_la_SOURCES) $(libauthldap_la_SOURCES) \<br />
$(libauthmysql_la_SOURCES) $(libauthpam_la_SOURCES) \<br />
@@ -452,9 +453,9 @@<br />
README.authdebug.html<br />
<br />
DISTCLEANFILES = dbobj.config README_authlib.html<br />
-commonlibdep = libcourierauthcommon.la<br />
+commonlibdep = libcourierauthcommon.la libcourierauth.la<br />
commonldflags = -module -rpath $(pkglibdir) -export-symbols-regex 'courier_auth.*_init' -avoid-version<br />
-commonlibadd = libcourierauthcommon.la<br />
+commonlibadd = libcourierauthcommon.la libcourierauth.la<br />
libcourierauthcommon_t = @CRYPTLIBS@<br />
libcourierauthcommon_la_SOURCES = \<br />
auth.h courierauth.h \<br />
--- courier-authlib-0.61.0/authdaemond.in 2005-07-05 14:25:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/authdaemond.in 2008-10-25 12:03:32.140625000 +0200<br />
@@ -15,4 +15,10 @@<br />
set -a<br />
. @authdaemonrc@<br />
<br />
+# Some shared libraries (DLL) are installed in @libdir@/bin<br />
+# instead of @libdir@/@PACKAGE@<br />
+# Setting LD_LIBRARY_PATH at runtime or LR_RUN_PATH at linktime doesn't<br />
+# work in cygwin, only setting PATH works. <br />
+export PATH=$PATH:@libdir@/bin<br />
+<br />
exec ${sbindir}/courierlogger -pid=@authdaemonvar@/pid $LOGGEROPTS -$1 @libexecdir@/courier-authlib/authdaemond<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-authlib-0.61.0-cygwin.patch<br />
<br />
Configure the package without most authentication modules, keeping only ''userdb''.<br />
<br />
'''Note''': replace ''mailuser'' by an existing user name (in your /etc/passwd file). I used my own username.<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait --without-authpam --without-authldap --without-authpwd \<br />
--without-authshadow --without-authcustom --without-authpipe --without-authmysql --without-authpgsql --with-mailuser=mailuser \<br />
--with-mailgroup=mkgroup-l-d<br />
<br />
Take a long pause... and when ready execute the following command.<br />
<br />
$ make<br />
<br />
Take again a long pause... then check the result and install the libraries<br />
<br />
$ make check<br />
$ make install<br />
<br />
==Configuration==<br />
<br />
Create authdaemonrc file: /usr/local/etc/authlib/authdaemonrc<br />
<br />
$ cp /usr/local/etc/authlib/authdaemonrc.dist /usr/local/etc/authlib/authdaemonrc<br />
<br />
Change number of daemons (I use only one) and enable DEBUG_LOGIN<br />
<br />
<source lang=text><br />
# The number of daemon processes that are started.<br />
daemons=1<br />
<br />
# DEBUG_LOGIN=2 - turn on debugging + log passwords too<br />
DEBUG_LOGIN=2<br />
</source><br />
<br />
See http://www.courier-mta.org/authlib/README.authdebug.html for details.<br />
<br />
==IMAP accounts==<br />
<br />
User accounts and settings are managed by ''userdb''. See [http://linux.die.net/man/8/makeuserdb makeuserdb] man page for details, or used the freshly new install man page - man makeuserdb<br />
<br />
Assuming ''username'' is your username, 1001 and 10545 are respectively the UID and GID of an existing user (part of your /etc/passwd and /etc/group). I use my own UID and GID. Create the mailuser home directory, if required, and create Maildir folder.<br />
<br />
$ mkdir -p /home/username<br />
$ cd /home/username<br />
$ /usr/lib/courier-imap/bin/maildirmake Maildir<br />
<br />
Create the userdb text file /usr/local/etc/authlib/userdb<br />
<br />
$ touch /usr/local/etc/authlib/userdb<br />
$ chmod 700 /usr/local/etc/authlib/userdb<br />
<br />
Edit /usr/local/etc/authlib/userdb, one line per account<br />
<br />
<source lang=text><br />
username[TAB]uid=1001|gid=10111|home=/home/username|mail=/home/username/Maildir|systempw=XXXXXX<br />
</source><br />
<br />
where XXXXXX is the encrypted password created with<br />
<br />
$ /usr/local/sbin/userdbpw.exe<br />
<br />
Create the (binary) userdb<br />
<br />
$ /usr/local/sbin/makeuserdb<br />
<br />
You should now have the following files created:<br />
<br />
* /usr/local/etc/authlib/userdb.dat<br />
* /usr/local/etc/authlib/userdbshadow.dat<br />
<br />
==Running==<br />
<br />
Install and configure syslogd. Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install inetutils (contains syslogd). Configure syslogd with the following command. It will create the /etc/syslogd.conf file and install a windows service using cygrunsrv<br />
<br />
$ syslogd-config<br />
<br />
Start the authlib daemon with the following command:<br />
<br />
$ /usr/local/sbin/authdaemon start<br />
<br />
Stop the daemon with the following command:<br />
<br />
$ /usr/local/sbin/authdaemon stop<br />
<br />
You'll find log messages in /var/log/messages (default target file as specified in /etc/syslogd.conf)<br />
<br />
==Testing authlib==<br />
<br />
$ /usr/local/sbin/authtest username CCCCCC<br />
Authentication succeeded.<br />
<br />
Authenticated: username (uid 1001, gid 10545)<br />
Home Directory: /home/username<br />
Maildir: /home/username/Maildir<br />
Quota: (none)<br />
Encrypted Password: XXXXXX<br />
Cleartext Password: CCCCCC<br />
Options: (none)<br />
<br />
where username is your user name and XXXXXX is your encrypted password as provided in ''/usr/local/etc/authlib/userdb''. CCCCCC is your password in clear.<br />
<br />
==Troubleshooting==<br />
<br />
Should you have a doubt on the execution of a command (ie: no output) you can check if the application is able to load required DLL. This error is not reported. Using ''strace'', windows will complain about DLL not found, if any. To solve this problem you may need to add some path in your PATH. For example, in order to test authlib with authtest:<br />
<br />
$ strace /usr/local/sbin/authtest<br />
# This will open a dialog box to complain about DLL.<br />
$ export PATH=$PATH:/usr/local/lib/bin<br />
$ /usr/local/sbin/authtest ausername<br />
<br />
==Courier Authentication Config==<br />
<br />
$ /usr/local/bin/courierauthconfig.exe --version<br />
$ /usr/local/bin/courierauthconfig.exe --ldflags<br />
$ /usr/local/bin/courierauthconfig.exe --cppflags<br />
$ /usr/local/bin/courierauthconfig.exe --configfiles<br />
<br />
=Courier-IMAP=<br />
==Compilation and installation==<br />
<br />
Download and untar package [http://www.courier-mta.org/download.php#imap courier-imap] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-imap-4.4.1.tar.bz2 4.4.1.20080920]<br />
<br />
Apply the [{{#file:courrier-imap-4.4.1-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# incorrect usage of EXTEXT in main ''Makefile''<br />
# remove usage of /usr/lib/env in start/stop script (/usr/lib/env does not seem to work under Cygwin)<br />
<br />
<source lang=diff><br />
--- courier-imap-4.4.1.20080920/makedat/Makefile.in 2008-08-24 19:52:51.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/makedat/Makefile.in 2008-10-21 20:43:27.500000000 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-imap-4.4.1.20080920/Makefile.in 2008-09-20 14:48:46.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/Makefile.in 2008-10-21 20:59:45.156250000 +0200<br />
@@ -247,9 +247,9 @@<br />
CLEANFILES = $(databin_SCRIPTS) $(man_MANS) $(sysconf_DATA) $(sbin_SCRIPTS)<br />
databindir = $(datadir)<br />
databin_SCRIPTS = mkimapdcert mkpop3dcert<br />
-binPROGRAMS = imapd pop3d maildirmake maildiracl deliverquota maildirkw<br />
-sbinPROGRAMS = imaplogin pop3login<br />
-libexecPROGRAMS = makedatprog couriertcpd<br />
+binPROGRAMS = imapd$(EXEEXT) pop3d$(EXEEXT) maildirmake$(EXEEXT) maildiracl$(EXEEXT) deliverquota$(EXEEXT) maildirkw$(EXEEXT)<br />
+sbinPROGRAMS = imaplogin$(EXEEXT) pop3login$(EXEEXT)<br />
+libexecPROGRAMS = makedatprog$(EXEEXT) couriertcpd$(EXEEXT)<br />
bin_PROGRAMS = @binPROGRAMS_exec@<br />
sbin_PROGRAMS = @sbinPROGRAMS_exec@<br />
libexec_PROGRAMS = @libexecPROGRAMS_exec@<br />
--- courier-imap-4.4.1.20080920/imapd.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/imapd.rc.in 2008-10-26 10:17:51.359375000 +0100<br />
@@ -22,6 +22,15 @@<br />
exit 1<br />
fi<br />
<br />
+# Location for some shared libraries (cygcourierauth*.dll) from authlib<br />
+AUTHLIBDIR=/usr/local<br />
+if test ! -f $AUTHLIBDIR/lib/bin/cygcourierauth.dll<br />
+then<br />
+ echo "$AUTHLIBDIR/lib/bin/cygcourierauth.dll not found."<br />
+ exit 1<br />
+fi<br />
+export PATH=$PATH:/usr/local/lib/bin<br />
+<br />
TLS_CACHEFILE=""<br />
. @sysconfdir@/imapd-ssl<br />
. @sysconfdir@/imapd<br />
@@ -35,7 +44,7 @@<br />
<br />
umask $IMAP_UMASK<br />
@ULIMIT@ $IMAP_ULIMITD<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
--- courier-imap-4.4.1.20080920/pop3d.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/pop3d.rc.in 2008-10-26 10:18:02.187500000 +0100<br />
@@ -22,12 +22,21 @@<br />
exit 1<br />
fi<br />
<br />
+# Location for some shared libraries (cygcourierauth*.dll) from authlib<br />
+AUTHLIBDIR=/usr/local<br />
+if test ! -f $AUTHLIBDIR/lib/bin/cygcourierauth.dll<br />
+then<br />
+ echo "$AUTHLIBDIR/lib/bin/cygcourierauth.dll not found."<br />
+ exit 1<br />
+fi<br />
+export PATH=$PATH:/usr/local/lib/bin<br />
+<br />
. @sysconfdir@/pop3d-ssl<br />
. @sysconfdir@/pop3d<br />
<br />
case $1 in<br />
start)<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-imap-4.4.1-cygwin.patch<br />
<br />
Configure the package<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait<br />
<br />
Take a walk... and when ready execute the following command to build the package.<br />
<br />
$ make<br />
<br />
Time to go for some coffee... and then install the package with the usual<br />
<br />
$ make install<br />
$ make install-configure<br />
<br />
==Configuration==<br />
<br />
Setup courier-imap: $prefix/etc/imapd (where $prefix=/usr/lib/courier-imap)<br />
<br />
Set ADDRESS to a valid value (0 or 127.0.0.1) and change IMAP_ULIMITD to a value accepted by the command ulimit. I simply used the existing value returned by<br />
<br />
$ ulimit -v<br />
<br />
==Running==<br />
<br />
Syslogd service and authdaemond should be started. See above.<br />
<br />
Start the imap daemon with the following command:<br />
<br />
$ /usr/lib/courier-imap/libexec/imapd.rc start<br />
<br />
Stop the daemon with the following command:<br />
<br />
$ /usr/lib/courier-imap/libexec/imapd.rc stop<br />
<br />
You'll find log messages in /var/log/messages (default target file as specified in /etc/syslogd.conf)<br />
<br />
==Testing==<br />
When authdaemond and imapd are running you can do a simple login test:<br />
<br />
$ telnet localhost 143<br />
<br />
and type the login command<br />
<br />
a login <username> <password><br />
<br />
the server should reply<br />
<br />
a OK LOGIN Ok.<br />
<br />
to which you can reply with a logout<br />
<br />
a logout<br />
<br />
the session is terminated by the server<br />
<br />
* BYE Courier-IMAP server shutting down<br />
a OK LOGOUT completed<br />
Connection closed by foreign host.<br />
<br />
'''Hint:''' if the connection is immediately closed by foreign host it probably means that ''imapd'' does not have access to all required DLLs. Check your PATH.<br />
<br />
==All in one==<br />
If everything works fine you can use the following [{{#file:imapd}} startup script] to launch or stop imap and authlib daemons. It can be saved in /usr/local/sbin.<br />
<br />
<source lang=bash><br />
#! /bin/sh<br />
#<br />
# Courier imap daemon startup script.<br />
<br />
authlib=/usr/local/sbin/authdaemond<br />
imapd=/usr/lib/courier-imap/libexec/imapd.rc<br />
<br />
test ! -f $authlib && echo "File not found: $authlib" && exit 1;<br />
test ! -f $imapd && echo "File not found: $imapd" && exit 1;<br />
<br />
case $1 in<br />
start)<br />
$authlib start<br />
$imapd start<br />
;;<br />
stop)<br />
$imapd stop<br />
$authlib stop<br />
;;<br />
*)<br />
echo "Usage: $0 <start|stop>"<br />
;;<br />
esac<br />
</source><br />
<br />
==Cygwin service==<br />
Create the [{{#file:imapd-srv.sh}} service script]<br />
<br />
<source lang=bash><br />
#!/bin/sh<br />
# File: imapd-service.sh<br />
# Purpose: Courier imap daemon service script.<br />
#<br />
# This script must be excutable by SYSTEM<br />
username=username # <<<< Change me !!!<br />
<br />
function handleQuit<br />
{<br />
echo "STOPPING: /usr/local/sbin/imapd"<br />
su $username -c "/usr/local/sbin/imapd stop"<br />
exit<br />
}<br />
<br />
echo "STARTING: /usr/local/sbin/imapd as $username"<br />
su $username -c "/usr/local/sbin/imapd start"<br />
<br />
trap "handleQuit" SIGQUIT<br />
<br />
echo "WAITING"<br />
while true<br />
do<br />
sleep 1<br />
done<br />
</source><br />
<br />
Change username and save it to your favorite location, says /usr/local/sbin. The service script must be executable by SYSTEM, ie: the user that run the windows services.<br />
<br />
$ chmod +x /usr/local/sbin/imapd-srv.sh<br />
<br />
Install the new service with the following command.<br />
<br />
$ cygrunsrv --install imapd --desc "Courier IMAP daemon" --disp "CYGWIN imapd" \<br />
--path /usr/local/sbin/imapd-srv.sh --termsig QUIT --type auto --shutdown<br />
<br />
Finally, just start the service<br />
<br />
$ cygrunsrv --start imapd<br />
or<br />
$ net start imapd<br />
<br />
You should now have couple of processes related to courier-imap<br />
<br />
$ ps<br />
<br />
=Maildir=<br />
'''maildirmake''' is part of the courier-imap package<br />
<br />
$ /usr/lib/courier-imap/bin/maildirmake</div>Twalranthttps://wiki.yobi.be/index.php?title=Courier-Cygwin&diff=5247Courier-Cygwin2008-10-26T14:29:48Z<p>Twalrant: /* Testing */</p>
<hr />
<div>=Pre-requisite=<br />
<br />
Courier-IMAP requires the installation of the [http://www.courier-mta.org/authlib/ Courier Authentication Library] and the following cygwin tools and packages<br />
<br />
* patch, tar, make, gcc<br />
* crypt<br />
* libgdbm-devel<br />
* libtool<br />
* inetutils<br />
* cygrunsrv<br />
<br />
Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install the required packages.<br />
<br />
=Courier Authentication Library=<br />
<br />
Installation of Courier Authentication Library using the module userdb to manage mail accounts. All other modules are disabled.<br />
<br />
==Compilation and installation==<br />
<br />
Download and untar [http://www.courier-mta.org/download.php#authlib courier-authlib] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-authlib-0.61.0.tar.bz2 0.61.0]<br />
<br />
Apply the [{{#file:courrier-authlib-0.61.0-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# add libtool flag (-no-undefined) required for DLL creation<br />
# add missing dependencies<br />
# add PATH in start script to access new DLL (installed in a different directory)<br />
<br />
Solution source: http://lists.cairographics.org/archives/cairo/2004-April/001125.html<br />
<br />
<source lang=diff><br />
--- courier-authlib-0.61.0/makedat/Makefile.in 2008-05-24 16:21:09.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/makedat/Makefile.in 2008-10-21 16:02:38.709166700 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-authlib-0.61.0/Makefile.in 2008-07-12 21:41:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/Makefile.in 2008-10-23 22:59:03.843750000 +0200<br />
@@ -213,9 +213,10 @@<br />
LTCOMPILE = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
--mode=compile $(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) \<br />
$(AM_CPPFLAGS) $(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS)<br />
-CCLD = $(CC)<br />
+CCLD = $(CC) -no-undefined<br />
+CCLDEXE = $(CC)<br />
LINK = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
- --mode=link $(CCLD) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
+ --mode=link $(CCLDEXE) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
$(LDFLAGS) -o $@<br />
SOURCES = $(libauthcustom_la_SOURCES) $(libauthldap_la_SOURCES) \<br />
$(libauthmysql_la_SOURCES) $(libauthpam_la_SOURCES) \<br />
@@ -452,9 +453,9 @@<br />
README.authdebug.html<br />
<br />
DISTCLEANFILES = dbobj.config README_authlib.html<br />
-commonlibdep = libcourierauthcommon.la<br />
+commonlibdep = libcourierauthcommon.la libcourierauth.la<br />
commonldflags = -module -rpath $(pkglibdir) -export-symbols-regex 'courier_auth.*_init' -avoid-version<br />
-commonlibadd = libcourierauthcommon.la<br />
+commonlibadd = libcourierauthcommon.la libcourierauth.la<br />
libcourierauthcommon_t = @CRYPTLIBS@<br />
libcourierauthcommon_la_SOURCES = \<br />
auth.h courierauth.h \<br />
--- courier-authlib-0.61.0/authdaemond.in 2005-07-05 14:25:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/authdaemond.in 2008-10-25 12:03:32.140625000 +0200<br />
@@ -15,4 +15,10 @@<br />
set -a<br />
. @authdaemonrc@<br />
<br />
+# Some shared libraries (DLL) are installed in @libdir@/bin<br />
+# instead of @libdir@/@PACKAGE@<br />
+# Setting LD_LIBRARY_PATH at runtime or LR_RUN_PATH at linktime doesn't<br />
+# work in cygwin, only setting PATH works. <br />
+export PATH=$PATH:@libdir@/bin<br />
+<br />
exec ${sbindir}/courierlogger -pid=@authdaemonvar@/pid $LOGGEROPTS -$1 @libexecdir@/courier-authlib/authdaemond<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-authlib-0.61.0-cygwin.patch<br />
<br />
Configure the package without most authentication modules, keeping only ''userdb''.<br />
<br />
'''Note''': replace ''mailuser'' by an existing user name (in your /etc/passwd file). I used my own username.<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait --without-authpam --without-authldap --without-authpwd \<br />
--without-authshadow --without-authcustom --without-authpipe --without-authmysql --without-authpgsql --with-mailuser=mailuser \<br />
--with-mailgroup=mkgroup-l-d<br />
<br />
Take a long pause... and when ready execute the following command.<br />
<br />
$ make<br />
<br />
Take again a long pause... then check the result and install the libraries<br />
<br />
$ make check<br />
$ make install<br />
<br />
==Configuration==<br />
<br />
Create authdaemonrc file: /usr/local/etc/authlib/authdaemonrc<br />
<br />
$ cp /usr/local/etc/authlib/authdaemonrc.dist /usr/local/etc/authlib/authdaemonrc<br />
<br />
Change number of daemons (I use only one) and enable DEBUG_LOGIN<br />
<br />
<source lang=text><br />
# The number of daemon processes that are started.<br />
daemons=1<br />
<br />
# DEBUG_LOGIN=2 - turn on debugging + log passwords too<br />
DEBUG_LOGIN=2<br />
</source><br />
<br />
See http://www.courier-mta.org/authlib/README.authdebug.html for details.<br />
<br />
==IMAP accounts==<br />
<br />
User accounts and settings are managed by ''userdb''. See [http://linux.die.net/man/8/makeuserdb makeuserdb] man page for details, or used the freshly new install man page - man makeuserdb<br />
<br />
Assuming ''username'' is your username, 1001 and 10545 are respectively the UID and GID of an existing user (part of your /etc/passwd and /etc/group). I use my own UID and GID. Create the mailuser home directory, if required, and create Maildir folder.<br />
<br />
$ mkdir -p /home/username<br />
$ cd /home/username<br />
$ /usr/lib/courier-imap/bin/maildirmake Maildir<br />
<br />
Create the userdb text file /usr/local/etc/authlib/userdb<br />
<br />
$ touch /usr/local/etc/authlib/userdb<br />
$ chmod 700 /usr/local/etc/authlib/userdb<br />
<br />
Edit /usr/local/etc/authlib/userdb, one line per account<br />
<br />
<source lang=text><br />
username[TAB]uid=1001|gid=10111|home=/home/username|mail=/home/username/Maildir|systempw=XXXXXX<br />
</source><br />
<br />
where XXXXXX is the encrypted password created with<br />
<br />
$ /usr/local/sbin/userdbpw.exe<br />
<br />
Create the (binary) userdb<br />
<br />
$ /usr/local/sbin/makeuserdb<br />
<br />
You should now have the following files created:<br />
<br />
* /usr/local/etc/authlib/userdb.dat<br />
* /usr/local/etc/authlib/userdbshadow.dat<br />
<br />
==Running==<br />
<br />
Install and configure syslogd. Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install inetutils (contains syslogd). Configure syslogd with the following command. It will create the /etc/syslogd.conf file and install a windows service using cygrunsrv<br />
<br />
$ syslogd-config<br />
<br />
Start the authlib daemon with the following command:<br />
<br />
$ /usr/local/sbin/authdaemon start<br />
<br />
Stop the daemon with the following command:<br />
<br />
$ /usr/local/sbin/authdaemon stop<br />
<br />
You'll find log messages in /var/log/messages (default target file as specified in /etc/syslogd.conf)<br />
<br />
==Testing authlib==<br />
<br />
$ /usr/local/sbin/authtest username CCCCCC<br />
Authentication succeeded.<br />
<br />
Authenticated: username (uid 1001, gid 10545)<br />
Home Directory: /home/username<br />
Maildir: /home/username/Maildir<br />
Quota: (none)<br />
Encrypted Password: XXXXXX<br />
Cleartext Password: CCCCCC<br />
Options: (none)<br />
<br />
where username is your user name and XXXXXX is your encrypted password as provided in ''/usr/local/etc/authlib/userdb''. CCCCCC is your password in clear.<br />
<br />
==Troubleshooting==<br />
<br />
Should you have a doubt on the execution of a command (ie: no output) you can check if the application is able to load required DLL. This error is not reported. Using ''strace'', windows will complain about DLL not found, if any. To solve this problem you may need to add some path in your PATH. For example, in order to test authlib with authtest:<br />
<br />
$ strace /usr/local/sbin/authtest<br />
# This will open a dialog box to complain about DLL.<br />
$ export PATH=$PATH:/usr/local/lib/bin<br />
$ /usr/local/sbin/authtest ausername<br />
<br />
==Courier Authentication Config==<br />
<br />
$ /usr/local/bin/courierauthconfig.exe --version<br />
$ /usr/local/bin/courierauthconfig.exe --ldflags<br />
$ /usr/local/bin/courierauthconfig.exe --cppflags<br />
$ /usr/local/bin/courierauthconfig.exe --configfiles<br />
<br />
=Courier-IMAP=<br />
==Compilation and installation==<br />
<br />
Download and untar package [http://www.courier-mta.org/download.php#imap courier-imap] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-imap-4.4.1.tar.bz2 4.4.1.20080920]<br />
<br />
Apply the [{{#file:courrier-imap-4.4.1-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# incorrect usage of EXTEXT in main ''Makefile''<br />
# remove usage of /usr/lib/env in start/stop script (/usr/lib/env does not seem to work under Cygwin)<br />
<br />
<source lang=diff><br />
--- courier-imap-4.4.1.20080920/makedat/Makefile.in 2008-08-24 19:52:51.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/makedat/Makefile.in 2008-10-21 20:43:27.500000000 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-imap-4.4.1.20080920/Makefile.in 2008-09-20 14:48:46.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/Makefile.in 2008-10-21 20:59:45.156250000 +0200<br />
@@ -247,9 +247,9 @@<br />
CLEANFILES = $(databin_SCRIPTS) $(man_MANS) $(sysconf_DATA) $(sbin_SCRIPTS)<br />
databindir = $(datadir)<br />
databin_SCRIPTS = mkimapdcert mkpop3dcert<br />
-binPROGRAMS = imapd pop3d maildirmake maildiracl deliverquota maildirkw<br />
-sbinPROGRAMS = imaplogin pop3login<br />
-libexecPROGRAMS = makedatprog couriertcpd<br />
+binPROGRAMS = imapd$(EXEEXT) pop3d$(EXEEXT) maildirmake$(EXEEXT) maildiracl$(EXEEXT) deliverquota$(EXEEXT) maildirkw$(EXEEXT)<br />
+sbinPROGRAMS = imaplogin$(EXEEXT) pop3login$(EXEEXT)<br />
+libexecPROGRAMS = makedatprog$(EXEEXT) couriertcpd$(EXEEXT)<br />
bin_PROGRAMS = @binPROGRAMS_exec@<br />
sbin_PROGRAMS = @sbinPROGRAMS_exec@<br />
libexec_PROGRAMS = @libexecPROGRAMS_exec@<br />
--- courier-imap-4.4.1.20080920/imapd.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/imapd.rc.in 2008-10-26 10:17:51.359375000 +0100<br />
@@ -22,6 +22,15 @@<br />
exit 1<br />
fi<br />
<br />
+# Location for some shared libraries (cygcourierauth*.dll) from authlib<br />
+AUTHLIBDIR=/usr/local<br />
+if test ! -f $AUTHLIBDIR/lib/bin/cygcourierauth.dll<br />
+then<br />
+ echo "$AUTHLIBDIR/lib/bin/cygcourierauth.dll not found."<br />
+ exit 1<br />
+fi<br />
+export PATH=$PATH:/usr/local/lib/bin<br />
+<br />
TLS_CACHEFILE=""<br />
. @sysconfdir@/imapd-ssl<br />
. @sysconfdir@/imapd<br />
@@ -35,7 +44,7 @@<br />
<br />
umask $IMAP_UMASK<br />
@ULIMIT@ $IMAP_ULIMITD<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
--- courier-imap-4.4.1.20080920/pop3d.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/pop3d.rc.in 2008-10-26 10:18:02.187500000 +0100<br />
@@ -22,12 +22,21 @@<br />
exit 1<br />
fi<br />
<br />
+# Location for some shared libraries (cygcourierauth*.dll) from authlib<br />
+AUTHLIBDIR=/usr/local<br />
+if test ! -f $AUTHLIBDIR/lib/bin/cygcourierauth.dll<br />
+then<br />
+ echo "$AUTHLIBDIR/lib/bin/cygcourierauth.dll not found."<br />
+ exit 1<br />
+fi<br />
+export PATH=$PATH:/usr/local/lib/bin<br />
+<br />
. @sysconfdir@/pop3d-ssl<br />
. @sysconfdir@/pop3d<br />
<br />
case $1 in<br />
start)<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-imap-4.4.1-cygwin.patch<br />
<br />
Configure the package<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait<br />
<br />
Take a walk... and when ready execute the following command to build the package.<br />
<br />
$ make<br />
<br />
Time to go for some coffee... and then install the package with the usual<br />
<br />
$ make install<br />
$ make install-configure<br />
<br />
==Configuration==<br />
<br />
Setup courier-imap: $prefix/etc/imapd (where $prefix=/usr/lib/courier-imap)<br />
<br />
Set ADDRESS to a valid value (0 or 127.0.0.1) and change IMAP_ULIMITD to a value accepted by the command ulimit. I simply used the existing value returned by<br />
<br />
$ ulimit -v<br />
<br />
==Running==<br />
<br />
Syslogd service and authdaemond should be started. See above.<br />
<br />
Start the imap daemon with the following command:<br />
<br />
$ /usr/lib/courier-imap/libexec/imapd.rc start<br />
<br />
Stop the daemon with the following command:<br />
<br />
$ /usr/lib/courier-imap/libexec/imapd.rc stop<br />
<br />
You'll find log messages in /var/log/messages (default target file as specified in /etc/syslogd.conf)<br />
<br />
==Testing==<br />
When authdaemond and imapd are running you can do a simple login test:<br />
<br />
$ telnet localhost 143<br />
<br />
and type the login command<br />
<br />
a login <username> <password><br />
<br />
the server should reply<br />
<br />
a OK LOGIN Ok.<br />
<br />
to which you can reply with a logout<br />
<br />
a logout<br />
<br />
the session is terminated by the server<br />
<br />
* BYE Courier-IMAP server shutting down<br />
a OK LOGOUT completed<br />
Connection closed by foreign host.<br />
<br />
==All in one==<br />
If everything works fine you can use the following [{{#file:imapd}} startup script] to launch or stop imap and authlib daemons. It can be saved in /usr/local/sbin.<br />
<br />
<source lang=bash><br />
#! /bin/sh<br />
#<br />
# Courier imap daemon startup script.<br />
<br />
authlib=/usr/local/sbin/authdaemond<br />
imapd=/usr/lib/courier-imap/libexec/imapd.rc<br />
<br />
test ! -f $authlib && echo "File not found: $authlib" && exit 1;<br />
test ! -f $imapd && echo "File not found: $imapd" && exit 1;<br />
<br />
case $1 in<br />
start)<br />
$authlib start<br />
$imapd start<br />
;;<br />
stop)<br />
$imapd stop<br />
$authlib stop<br />
;;<br />
*)<br />
echo "Usage: $0 <start|stop>"<br />
;;<br />
esac<br />
</source><br />
<br />
==Cygwin service==<br />
Create the [{{#file:imapd-srv.sh}} service script]<br />
<br />
<source lang=bash><br />
#!/bin/sh<br />
# File: imapd-service.sh<br />
# Purpose: Courier imap daemon service script.<br />
#<br />
# This script must be excutable by SYSTEM<br />
username=username # <<<< Change me !!!<br />
<br />
function handleQuit<br />
{<br />
echo "STOPPING: /usr/local/sbin/imapd"<br />
su $username -c "/usr/local/sbin/imapd stop"<br />
exit<br />
}<br />
<br />
echo "STARTING: /usr/local/sbin/imapd as $username"<br />
su $username -c "/usr/local/sbin/imapd start"<br />
<br />
trap "handleQuit" SIGQUIT<br />
<br />
echo "WAITING"<br />
while true<br />
do<br />
sleep 1<br />
done<br />
</source><br />
<br />
Change username and save it to your favorite location, says /usr/local/sbin. The service script must be executable by SYSTEM, ie: the user that run the windows services.<br />
<br />
$ chmod +x /usr/local/sbin/imapd-srv.sh<br />
<br />
Install the new service with the following command.<br />
<br />
$ cygrunsrv --install imapd --desc "Courier IMAP daemon" --disp "CYGWIN imapd" \<br />
--path /usr/local/sbin/imapd-srv.sh --termsig QUIT --type auto --shutdown<br />
<br />
Finally, just start the service<br />
<br />
$ cygrunsrv --start imapd<br />
or<br />
$ net start imapd<br />
<br />
You should now have couple of processes related to courier-imap<br />
<br />
$ ps<br />
<br />
=Maildir=<br />
'''maildirmake''' is part of the courier-imap package<br />
<br />
$ /usr/lib/courier-imap/bin/maildirmake</div>Twalranthttps://wiki.yobi.be/index.php?title=Courier-Cygwin&diff=5246Courier-Cygwin2008-10-26T14:29:07Z<p>Twalrant: /* Running */</p>
<hr />
<div>=Pre-requisite=<br />
<br />
Courier-IMAP requires the installation of the [http://www.courier-mta.org/authlib/ Courier Authentication Library] and the following cygwin tools and packages<br />
<br />
* patch, tar, make, gcc<br />
* crypt<br />
* libgdbm-devel<br />
* libtool<br />
* inetutils<br />
* cygrunsrv<br />
<br />
Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install the required packages.<br />
<br />
=Courier Authentication Library=<br />
<br />
Installation of Courier Authentication Library using the module userdb to manage mail accounts. All other modules are disabled.<br />
<br />
==Compilation and installation==<br />
<br />
Download and untar [http://www.courier-mta.org/download.php#authlib courier-authlib] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-authlib-0.61.0.tar.bz2 0.61.0]<br />
<br />
Apply the [{{#file:courrier-authlib-0.61.0-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# add libtool flag (-no-undefined) required for DLL creation<br />
# add missing dependencies<br />
# add PATH in start script to access new DLL (installed in a different directory)<br />
<br />
Solution source: http://lists.cairographics.org/archives/cairo/2004-April/001125.html<br />
<br />
<source lang=diff><br />
--- courier-authlib-0.61.0/makedat/Makefile.in 2008-05-24 16:21:09.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/makedat/Makefile.in 2008-10-21 16:02:38.709166700 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-authlib-0.61.0/Makefile.in 2008-07-12 21:41:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/Makefile.in 2008-10-23 22:59:03.843750000 +0200<br />
@@ -213,9 +213,10 @@<br />
LTCOMPILE = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
--mode=compile $(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) \<br />
$(AM_CPPFLAGS) $(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS)<br />
-CCLD = $(CC)<br />
+CCLD = $(CC) -no-undefined<br />
+CCLDEXE = $(CC)<br />
LINK = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
- --mode=link $(CCLD) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
+ --mode=link $(CCLDEXE) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
$(LDFLAGS) -o $@<br />
SOURCES = $(libauthcustom_la_SOURCES) $(libauthldap_la_SOURCES) \<br />
$(libauthmysql_la_SOURCES) $(libauthpam_la_SOURCES) \<br />
@@ -452,9 +453,9 @@<br />
README.authdebug.html<br />
<br />
DISTCLEANFILES = dbobj.config README_authlib.html<br />
-commonlibdep = libcourierauthcommon.la<br />
+commonlibdep = libcourierauthcommon.la libcourierauth.la<br />
commonldflags = -module -rpath $(pkglibdir) -export-symbols-regex 'courier_auth.*_init' -avoid-version<br />
-commonlibadd = libcourierauthcommon.la<br />
+commonlibadd = libcourierauthcommon.la libcourierauth.la<br />
libcourierauthcommon_t = @CRYPTLIBS@<br />
libcourierauthcommon_la_SOURCES = \<br />
auth.h courierauth.h \<br />
--- courier-authlib-0.61.0/authdaemond.in 2005-07-05 14:25:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/authdaemond.in 2008-10-25 12:03:32.140625000 +0200<br />
@@ -15,4 +15,10 @@<br />
set -a<br />
. @authdaemonrc@<br />
<br />
+# Some shared libraries (DLL) are installed in @libdir@/bin<br />
+# instead of @libdir@/@PACKAGE@<br />
+# Setting LD_LIBRARY_PATH at runtime or LR_RUN_PATH at linktime doesn't<br />
+# work in cygwin, only setting PATH works. <br />
+export PATH=$PATH:@libdir@/bin<br />
+<br />
exec ${sbindir}/courierlogger -pid=@authdaemonvar@/pid $LOGGEROPTS -$1 @libexecdir@/courier-authlib/authdaemond<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-authlib-0.61.0-cygwin.patch<br />
<br />
Configure the package without most authentication modules, keeping only ''userdb''.<br />
<br />
'''Note''': replace ''mailuser'' by an existing user name (in your /etc/passwd file). I used my own username.<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait --without-authpam --without-authldap --without-authpwd \<br />
--without-authshadow --without-authcustom --without-authpipe --without-authmysql --without-authpgsql --with-mailuser=mailuser \<br />
--with-mailgroup=mkgroup-l-d<br />
<br />
Take a long pause... and when ready execute the following command.<br />
<br />
$ make<br />
<br />
Take again a long pause... then check the result and install the libraries<br />
<br />
$ make check<br />
$ make install<br />
<br />
==Configuration==<br />
<br />
Create authdaemonrc file: /usr/local/etc/authlib/authdaemonrc<br />
<br />
$ cp /usr/local/etc/authlib/authdaemonrc.dist /usr/local/etc/authlib/authdaemonrc<br />
<br />
Change number of daemons (I use only one) and enable DEBUG_LOGIN<br />
<br />
<source lang=text><br />
# The number of daemon processes that are started.<br />
daemons=1<br />
<br />
# DEBUG_LOGIN=2 - turn on debugging + log passwords too<br />
DEBUG_LOGIN=2<br />
</source><br />
<br />
See http://www.courier-mta.org/authlib/README.authdebug.html for details.<br />
<br />
==IMAP accounts==<br />
<br />
User accounts and settings are managed by ''userdb''. See [http://linux.die.net/man/8/makeuserdb makeuserdb] man page for details, or used the freshly new install man page - man makeuserdb<br />
<br />
Assuming ''username'' is your username, 1001 and 10545 are respectively the UID and GID of an existing user (part of your /etc/passwd and /etc/group). I use my own UID and GID. Create the mailuser home directory, if required, and create Maildir folder.<br />
<br />
$ mkdir -p /home/username<br />
$ cd /home/username<br />
$ /usr/lib/courier-imap/bin/maildirmake Maildir<br />
<br />
Create the userdb text file /usr/local/etc/authlib/userdb<br />
<br />
$ touch /usr/local/etc/authlib/userdb<br />
$ chmod 700 /usr/local/etc/authlib/userdb<br />
<br />
Edit /usr/local/etc/authlib/userdb, one line per account<br />
<br />
<source lang=text><br />
username[TAB]uid=1001|gid=10111|home=/home/username|mail=/home/username/Maildir|systempw=XXXXXX<br />
</source><br />
<br />
where XXXXXX is the encrypted password created with<br />
<br />
$ /usr/local/sbin/userdbpw.exe<br />
<br />
Create the (binary) userdb<br />
<br />
$ /usr/local/sbin/makeuserdb<br />
<br />
You should now have the following files created:<br />
<br />
* /usr/local/etc/authlib/userdb.dat<br />
* /usr/local/etc/authlib/userdbshadow.dat<br />
<br />
==Running==<br />
<br />
Install and configure syslogd. Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install inetutils (contains syslogd). Configure syslogd with the following command. It will create the /etc/syslogd.conf file and install a windows service using cygrunsrv<br />
<br />
$ syslogd-config<br />
<br />
Start the authlib daemon with the following command:<br />
<br />
$ /usr/local/sbin/authdaemon start<br />
<br />
Stop the daemon with the following command:<br />
<br />
$ /usr/local/sbin/authdaemon stop<br />
<br />
You'll find log messages in /var/log/messages (default target file as specified in /etc/syslogd.conf)<br />
<br />
==Testing authlib==<br />
<br />
$ /usr/local/sbin/authtest username CCCCCC<br />
Authentication succeeded.<br />
<br />
Authenticated: username (uid 1001, gid 10545)<br />
Home Directory: /home/username<br />
Maildir: /home/username/Maildir<br />
Quota: (none)<br />
Encrypted Password: XXXXXX<br />
Cleartext Password: CCCCCC<br />
Options: (none)<br />
<br />
where username is your user name and XXXXXX is your encrypted password as provided in ''/usr/local/etc/authlib/userdb''. CCCCCC is your password in clear.<br />
<br />
==Troubleshooting==<br />
<br />
Should you have a doubt on the execution of a command (ie: no output) you can check if the application is able to load required DLL. This error is not reported. Using ''strace'', windows will complain about DLL not found, if any. To solve this problem you may need to add some path in your PATH. For example, in order to test authlib with authtest:<br />
<br />
$ strace /usr/local/sbin/authtest<br />
# This will open a dialog box to complain about DLL.<br />
$ export PATH=$PATH:/usr/local/lib/bin<br />
$ /usr/local/sbin/authtest ausername<br />
<br />
==Courier Authentication Config==<br />
<br />
$ /usr/local/bin/courierauthconfig.exe --version<br />
$ /usr/local/bin/courierauthconfig.exe --ldflags<br />
$ /usr/local/bin/courierauthconfig.exe --cppflags<br />
$ /usr/local/bin/courierauthconfig.exe --configfiles<br />
<br />
=Courier-IMAP=<br />
==Compilation and installation==<br />
<br />
Download and untar package [http://www.courier-mta.org/download.php#imap courier-imap] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-imap-4.4.1.tar.bz2 4.4.1.20080920]<br />
<br />
Apply the [{{#file:courrier-imap-4.4.1-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# incorrect usage of EXTEXT in main ''Makefile''<br />
# remove usage of /usr/lib/env in start/stop script (/usr/lib/env does not seem to work under Cygwin)<br />
<br />
<source lang=diff><br />
--- courier-imap-4.4.1.20080920/makedat/Makefile.in 2008-08-24 19:52:51.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/makedat/Makefile.in 2008-10-21 20:43:27.500000000 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-imap-4.4.1.20080920/Makefile.in 2008-09-20 14:48:46.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/Makefile.in 2008-10-21 20:59:45.156250000 +0200<br />
@@ -247,9 +247,9 @@<br />
CLEANFILES = $(databin_SCRIPTS) $(man_MANS) $(sysconf_DATA) $(sbin_SCRIPTS)<br />
databindir = $(datadir)<br />
databin_SCRIPTS = mkimapdcert mkpop3dcert<br />
-binPROGRAMS = imapd pop3d maildirmake maildiracl deliverquota maildirkw<br />
-sbinPROGRAMS = imaplogin pop3login<br />
-libexecPROGRAMS = makedatprog couriertcpd<br />
+binPROGRAMS = imapd$(EXEEXT) pop3d$(EXEEXT) maildirmake$(EXEEXT) maildiracl$(EXEEXT) deliverquota$(EXEEXT) maildirkw$(EXEEXT)<br />
+sbinPROGRAMS = imaplogin$(EXEEXT) pop3login$(EXEEXT)<br />
+libexecPROGRAMS = makedatprog$(EXEEXT) couriertcpd$(EXEEXT)<br />
bin_PROGRAMS = @binPROGRAMS_exec@<br />
sbin_PROGRAMS = @sbinPROGRAMS_exec@<br />
libexec_PROGRAMS = @libexecPROGRAMS_exec@<br />
--- courier-imap-4.4.1.20080920/imapd.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/imapd.rc.in 2008-10-26 10:17:51.359375000 +0100<br />
@@ -22,6 +22,15 @@<br />
exit 1<br />
fi<br />
<br />
+# Location for some shared libraries (cygcourierauth*.dll) from authlib<br />
+AUTHLIBDIR=/usr/local<br />
+if test ! -f $AUTHLIBDIR/lib/bin/cygcourierauth.dll<br />
+then<br />
+ echo "$AUTHLIBDIR/lib/bin/cygcourierauth.dll not found."<br />
+ exit 1<br />
+fi<br />
+export PATH=$PATH:/usr/local/lib/bin<br />
+<br />
TLS_CACHEFILE=""<br />
. @sysconfdir@/imapd-ssl<br />
. @sysconfdir@/imapd<br />
@@ -35,7 +44,7 @@<br />
<br />
umask $IMAP_UMASK<br />
@ULIMIT@ $IMAP_ULIMITD<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
--- courier-imap-4.4.1.20080920/pop3d.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/pop3d.rc.in 2008-10-26 10:18:02.187500000 +0100<br />
@@ -22,12 +22,21 @@<br />
exit 1<br />
fi<br />
<br />
+# Location for some shared libraries (cygcourierauth*.dll) from authlib<br />
+AUTHLIBDIR=/usr/local<br />
+if test ! -f $AUTHLIBDIR/lib/bin/cygcourierauth.dll<br />
+then<br />
+ echo "$AUTHLIBDIR/lib/bin/cygcourierauth.dll not found."<br />
+ exit 1<br />
+fi<br />
+export PATH=$PATH:/usr/local/lib/bin<br />
+<br />
. @sysconfdir@/pop3d-ssl<br />
. @sysconfdir@/pop3d<br />
<br />
case $1 in<br />
start)<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-imap-4.4.1-cygwin.patch<br />
<br />
Configure the package<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait<br />
<br />
Take a walk... and when ready execute the following command to build the package.<br />
<br />
$ make<br />
<br />
Time to go for some coffee... and then install the package with the usual<br />
<br />
$ make install<br />
$ make install-configure<br />
<br />
==Configuration==<br />
<br />
Setup courier-imap: $prefix/etc/imapd (where $prefix=/usr/lib/courier-imap)<br />
<br />
Set ADDRESS to a valid value (0 or 127.0.0.1) and change IMAP_ULIMITD to a value accepted by the command ulimit. I simply used the existing value returned by<br />
<br />
$ ulimit -v<br />
<br />
==Running==<br />
<br />
Syslogd service and authdaemond should be started. See above.<br />
<br />
Start the imap daemon with the following command:<br />
<br />
$ /usr/lib/courier-imap/libexec/imapd.rc start<br />
<br />
Stop the daemon with the following command:<br />
<br />
$ /usr/lib/courier-imap/libexec/imapd.rc stop<br />
<br />
You'll find log messages in /var/log/messages (default target file as specified in /etc/syslogd.conf)<br />
<br />
==Testing==<br />
When authdaemon and imapd are running you can do a simple login test:<br />
<br />
$ telnet localhost 143<br />
<br />
and type the login command<br />
<br />
a login <username> <password><br />
<br />
the server should reply<br />
<br />
a OK LOGIN Ok.<br />
<br />
to which you can reply with a logout<br />
<br />
a logout<br />
<br />
the session is terminated by the server<br />
<br />
* BYE Courier-IMAP server shutting down<br />
a OK LOGOUT completed<br />
Connection closed by foreign host.<br />
<br />
==All in one==<br />
If everything works fine you can use the following [{{#file:imapd}} startup script] to launch or stop imap and authlib daemons. It can be saved in /usr/local/sbin.<br />
<br />
<source lang=bash><br />
#! /bin/sh<br />
#<br />
# Courier imap daemon startup script.<br />
<br />
authlib=/usr/local/sbin/authdaemond<br />
imapd=/usr/lib/courier-imap/libexec/imapd.rc<br />
<br />
test ! -f $authlib && echo "File not found: $authlib" && exit 1;<br />
test ! -f $imapd && echo "File not found: $imapd" && exit 1;<br />
<br />
case $1 in<br />
start)<br />
$authlib start<br />
$imapd start<br />
;;<br />
stop)<br />
$imapd stop<br />
$authlib stop<br />
;;<br />
*)<br />
echo "Usage: $0 <start|stop>"<br />
;;<br />
esac<br />
</source><br />
<br />
==Cygwin service==<br />
Create the [{{#file:imapd-srv.sh}} service script]<br />
<br />
<source lang=bash><br />
#!/bin/sh<br />
# File: imapd-service.sh<br />
# Purpose: Courier imap daemon service script.<br />
#<br />
# This script must be excutable by SYSTEM<br />
username=username # <<<< Change me !!!<br />
<br />
function handleQuit<br />
{<br />
echo "STOPPING: /usr/local/sbin/imapd"<br />
su $username -c "/usr/local/sbin/imapd stop"<br />
exit<br />
}<br />
<br />
echo "STARTING: /usr/local/sbin/imapd as $username"<br />
su $username -c "/usr/local/sbin/imapd start"<br />
<br />
trap "handleQuit" SIGQUIT<br />
<br />
echo "WAITING"<br />
while true<br />
do<br />
sleep 1<br />
done<br />
</source><br />
<br />
Change username and save it to your favorite location, says /usr/local/sbin. The service script must be executable by SYSTEM, ie: the user that run the windows services.<br />
<br />
$ chmod +x /usr/local/sbin/imapd-srv.sh<br />
<br />
Install the new service with the following command.<br />
<br />
$ cygrunsrv --install imapd --desc "Courier IMAP daemon" --disp "CYGWIN imapd" \<br />
--path /usr/local/sbin/imapd-srv.sh --termsig QUIT --type auto --shutdown<br />
<br />
Finally, just start the service<br />
<br />
$ cygrunsrv --start imapd<br />
or<br />
$ net start imapd<br />
<br />
You should now have couple of processes related to courier-imap<br />
<br />
$ ps<br />
<br />
=Maildir=<br />
'''maildirmake''' is part of the courier-imap package<br />
<br />
$ /usr/lib/courier-imap/bin/maildirmake</div>Twalranthttps://wiki.yobi.be/index.php?title=Courier-Cygwin&diff=5245Courier-Cygwin2008-10-26T14:26:42Z<p>Twalrant: /* Testing authlib */</p>
<hr />
<div>=Pre-requisite=<br />
<br />
Courier-IMAP requires the installation of the [http://www.courier-mta.org/authlib/ Courier Authentication Library] and the following cygwin tools and packages<br />
<br />
* patch, tar, make, gcc<br />
* crypt<br />
* libgdbm-devel<br />
* libtool<br />
* inetutils<br />
* cygrunsrv<br />
<br />
Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install the required packages.<br />
<br />
=Courier Authentication Library=<br />
<br />
Installation of Courier Authentication Library using the module userdb to manage mail accounts. All other modules are disabled.<br />
<br />
==Compilation and installation==<br />
<br />
Download and untar [http://www.courier-mta.org/download.php#authlib courier-authlib] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-authlib-0.61.0.tar.bz2 0.61.0]<br />
<br />
Apply the [{{#file:courrier-authlib-0.61.0-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# add libtool flag (-no-undefined) required for DLL creation<br />
# add missing dependencies<br />
# add PATH in start script to access new DLL (installed in a different directory)<br />
<br />
Solution source: http://lists.cairographics.org/archives/cairo/2004-April/001125.html<br />
<br />
<source lang=diff><br />
--- courier-authlib-0.61.0/makedat/Makefile.in 2008-05-24 16:21:09.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/makedat/Makefile.in 2008-10-21 16:02:38.709166700 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-authlib-0.61.0/Makefile.in 2008-07-12 21:41:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/Makefile.in 2008-10-23 22:59:03.843750000 +0200<br />
@@ -213,9 +213,10 @@<br />
LTCOMPILE = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
--mode=compile $(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) \<br />
$(AM_CPPFLAGS) $(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS)<br />
-CCLD = $(CC)<br />
+CCLD = $(CC) -no-undefined<br />
+CCLDEXE = $(CC)<br />
LINK = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
- --mode=link $(CCLD) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
+ --mode=link $(CCLDEXE) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
$(LDFLAGS) -o $@<br />
SOURCES = $(libauthcustom_la_SOURCES) $(libauthldap_la_SOURCES) \<br />
$(libauthmysql_la_SOURCES) $(libauthpam_la_SOURCES) \<br />
@@ -452,9 +453,9 @@<br />
README.authdebug.html<br />
<br />
DISTCLEANFILES = dbobj.config README_authlib.html<br />
-commonlibdep = libcourierauthcommon.la<br />
+commonlibdep = libcourierauthcommon.la libcourierauth.la<br />
commonldflags = -module -rpath $(pkglibdir) -export-symbols-regex 'courier_auth.*_init' -avoid-version<br />
-commonlibadd = libcourierauthcommon.la<br />
+commonlibadd = libcourierauthcommon.la libcourierauth.la<br />
libcourierauthcommon_t = @CRYPTLIBS@<br />
libcourierauthcommon_la_SOURCES = \<br />
auth.h courierauth.h \<br />
--- courier-authlib-0.61.0/authdaemond.in 2005-07-05 14:25:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/authdaemond.in 2008-10-25 12:03:32.140625000 +0200<br />
@@ -15,4 +15,10 @@<br />
set -a<br />
. @authdaemonrc@<br />
<br />
+# Some shared libraries (DLL) are installed in @libdir@/bin<br />
+# instead of @libdir@/@PACKAGE@<br />
+# Setting LD_LIBRARY_PATH at runtime or LR_RUN_PATH at linktime doesn't<br />
+# work in cygwin, only setting PATH works. <br />
+export PATH=$PATH:@libdir@/bin<br />
+<br />
exec ${sbindir}/courierlogger -pid=@authdaemonvar@/pid $LOGGEROPTS -$1 @libexecdir@/courier-authlib/authdaemond<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-authlib-0.61.0-cygwin.patch<br />
<br />
Configure the package without most authentication modules, keeping only ''userdb''.<br />
<br />
'''Note''': replace ''mailuser'' by an existing user name (in your /etc/passwd file). I used my own username.<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait --without-authpam --without-authldap --without-authpwd \<br />
--without-authshadow --without-authcustom --without-authpipe --without-authmysql --without-authpgsql --with-mailuser=mailuser \<br />
--with-mailgroup=mkgroup-l-d<br />
<br />
Take a long pause... and when ready execute the following command.<br />
<br />
$ make<br />
<br />
Take again a long pause... then check the result and install the libraries<br />
<br />
$ make check<br />
$ make install<br />
<br />
==Configuration==<br />
<br />
Create authdaemonrc file: /usr/local/etc/authlib/authdaemonrc<br />
<br />
$ cp /usr/local/etc/authlib/authdaemonrc.dist /usr/local/etc/authlib/authdaemonrc<br />
<br />
Change number of daemons (I use only one) and enable DEBUG_LOGIN<br />
<br />
<source lang=text><br />
# The number of daemon processes that are started.<br />
daemons=1<br />
<br />
# DEBUG_LOGIN=2 - turn on debugging + log passwords too<br />
DEBUG_LOGIN=2<br />
</source><br />
<br />
See http://www.courier-mta.org/authlib/README.authdebug.html for details.<br />
<br />
==IMAP accounts==<br />
<br />
User accounts and settings are managed by ''userdb''. See [http://linux.die.net/man/8/makeuserdb makeuserdb] man page for details, or used the freshly new install man page - man makeuserdb<br />
<br />
Assuming ''username'' is your username, 1001 and 10545 are respectively the UID and GID of an existing user (part of your /etc/passwd and /etc/group). I use my own UID and GID. Create the mailuser home directory, if required, and create Maildir folder.<br />
<br />
$ mkdir -p /home/username<br />
$ cd /home/username<br />
$ /usr/lib/courier-imap/bin/maildirmake Maildir<br />
<br />
Create the userdb text file /usr/local/etc/authlib/userdb<br />
<br />
$ touch /usr/local/etc/authlib/userdb<br />
$ chmod 700 /usr/local/etc/authlib/userdb<br />
<br />
Edit /usr/local/etc/authlib/userdb, one line per account<br />
<br />
<source lang=text><br />
username[TAB]uid=1001|gid=10111|home=/home/username|mail=/home/username/Maildir|systempw=XXXXXX<br />
</source><br />
<br />
where XXXXXX is the encrypted password created with<br />
<br />
$ /usr/local/sbin/userdbpw.exe<br />
<br />
Create the (binary) userdb<br />
<br />
$ /usr/local/sbin/makeuserdb<br />
<br />
You should now have the following files created:<br />
<br />
* /usr/local/etc/authlib/userdb.dat<br />
* /usr/local/etc/authlib/userdbshadow.dat<br />
<br />
==Running==<br />
<br />
Install and configure syslogd. Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install inetutils (contains syslogd). Configure syslogd with the following command. It will create the /etc/syslogd.conf file and install a windows service using cygrunsrv<br />
<br />
$ syslogd-config<br />
<br />
Start the authlib daemon with the following command:<br />
<br />
$ /usr/local/sbin/authdaemon start<br />
<br />
Stop the daemon with the following command:<br />
<br />
$ /usr/local/sbin/authdaemon stop<br />
<br />
You'll find log messages in /var/log/messages (default target file as specified in /etc/syslogd.conf)<br />
<br />
==Testing authlib==<br />
<br />
$ /usr/local/sbin/authtest username CCCCCC<br />
Authentication succeeded.<br />
<br />
Authenticated: username (uid 1001, gid 10545)<br />
Home Directory: /home/username<br />
Maildir: /home/username/Maildir<br />
Quota: (none)<br />
Encrypted Password: XXXXXX<br />
Cleartext Password: CCCCCC<br />
Options: (none)<br />
<br />
where username is your user name and XXXXXX is your encrypted password as provided in ''/usr/local/etc/authlib/userdb''. CCCCCC is your password in clear.<br />
<br />
==Troubleshooting==<br />
<br />
Should you have a doubt on the execution of a command (ie: no output) you can check if the application is able to load required DLL. This error is not reported. Using ''strace'', windows will complain about DLL not found, if any. To solve this problem you may need to add some path in your PATH. For example, in order to test authlib with authtest:<br />
<br />
$ strace /usr/local/sbin/authtest<br />
# This will open a dialog box to complain about DLL.<br />
$ export PATH=$PATH:/usr/local/lib/bin<br />
$ /usr/local/sbin/authtest ausername<br />
<br />
==Courier Authentication Config==<br />
<br />
$ /usr/local/bin/courierauthconfig.exe --version<br />
$ /usr/local/bin/courierauthconfig.exe --ldflags<br />
$ /usr/local/bin/courierauthconfig.exe --cppflags<br />
$ /usr/local/bin/courierauthconfig.exe --configfiles<br />
<br />
=Courier-IMAP=<br />
==Compilation and installation==<br />
<br />
Download and untar package [http://www.courier-mta.org/download.php#imap courier-imap] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-imap-4.4.1.tar.bz2 4.4.1.20080920]<br />
<br />
Apply the [{{#file:courrier-imap-4.4.1-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# incorrect usage of EXTEXT in main ''Makefile''<br />
# remove usage of /usr/lib/env in start/stop script (/usr/lib/env does not seem to work under Cygwin)<br />
<br />
<source lang=diff><br />
--- courier-imap-4.4.1.20080920/makedat/Makefile.in 2008-08-24 19:52:51.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/makedat/Makefile.in 2008-10-21 20:43:27.500000000 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-imap-4.4.1.20080920/Makefile.in 2008-09-20 14:48:46.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/Makefile.in 2008-10-21 20:59:45.156250000 +0200<br />
@@ -247,9 +247,9 @@<br />
CLEANFILES = $(databin_SCRIPTS) $(man_MANS) $(sysconf_DATA) $(sbin_SCRIPTS)<br />
databindir = $(datadir)<br />
databin_SCRIPTS = mkimapdcert mkpop3dcert<br />
-binPROGRAMS = imapd pop3d maildirmake maildiracl deliverquota maildirkw<br />
-sbinPROGRAMS = imaplogin pop3login<br />
-libexecPROGRAMS = makedatprog couriertcpd<br />
+binPROGRAMS = imapd$(EXEEXT) pop3d$(EXEEXT) maildirmake$(EXEEXT) maildiracl$(EXEEXT) deliverquota$(EXEEXT) maildirkw$(EXEEXT)<br />
+sbinPROGRAMS = imaplogin$(EXEEXT) pop3login$(EXEEXT)<br />
+libexecPROGRAMS = makedatprog$(EXEEXT) couriertcpd$(EXEEXT)<br />
bin_PROGRAMS = @binPROGRAMS_exec@<br />
sbin_PROGRAMS = @sbinPROGRAMS_exec@<br />
libexec_PROGRAMS = @libexecPROGRAMS_exec@<br />
--- courier-imap-4.4.1.20080920/imapd.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/imapd.rc.in 2008-10-26 10:17:51.359375000 +0100<br />
@@ -22,6 +22,15 @@<br />
exit 1<br />
fi<br />
<br />
+# Location for some shared libraries (cygcourierauth*.dll) from authlib<br />
+AUTHLIBDIR=/usr/local<br />
+if test ! -f $AUTHLIBDIR/lib/bin/cygcourierauth.dll<br />
+then<br />
+ echo "$AUTHLIBDIR/lib/bin/cygcourierauth.dll not found."<br />
+ exit 1<br />
+fi<br />
+export PATH=$PATH:/usr/local/lib/bin<br />
+<br />
TLS_CACHEFILE=""<br />
. @sysconfdir@/imapd-ssl<br />
. @sysconfdir@/imapd<br />
@@ -35,7 +44,7 @@<br />
<br />
umask $IMAP_UMASK<br />
@ULIMIT@ $IMAP_ULIMITD<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
--- courier-imap-4.4.1.20080920/pop3d.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/pop3d.rc.in 2008-10-26 10:18:02.187500000 +0100<br />
@@ -22,12 +22,21 @@<br />
exit 1<br />
fi<br />
<br />
+# Location for some shared libraries (cygcourierauth*.dll) from authlib<br />
+AUTHLIBDIR=/usr/local<br />
+if test ! -f $AUTHLIBDIR/lib/bin/cygcourierauth.dll<br />
+then<br />
+ echo "$AUTHLIBDIR/lib/bin/cygcourierauth.dll not found."<br />
+ exit 1<br />
+fi<br />
+export PATH=$PATH:/usr/local/lib/bin<br />
+<br />
. @sysconfdir@/pop3d-ssl<br />
. @sysconfdir@/pop3d<br />
<br />
case $1 in<br />
start)<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-imap-4.4.1-cygwin.patch<br />
<br />
Configure the package<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait<br />
<br />
Take a walk... and when ready execute the following command to build the package.<br />
<br />
$ make<br />
<br />
Time to go for some coffee... and then install the package with the usual<br />
<br />
$ make install<br />
$ make install-configure<br />
<br />
==Configuration==<br />
<br />
Setup courier-imap: $prefix/etc/imapd (where $prefix=/usr/lib/courier-imap)<br />
<br />
Set ADDRESS to a valid value (0 or 127.0.0.1) and change IMAP_ULIMITD to a value accepted by the command ulimit. I simply used the existing value returned by<br />
<br />
$ ulimit -v<br />
<br />
==Running==<br />
<br />
Syslogd service and authdaemond should be started. See above.<br />
<br />
Start the authlib and imap daemons with the following command:<br />
<br />
$ /usr/lib/courier-imap/libexec/imapd.rc start<br />
<br />
Stop the daemons with the following command:<br />
<br />
$ /usr/lib/courier-imap/libexec/imapd.rc stop<br />
<br />
You'll find log messages in /var/log/messages (default target file as specified in /etc/syslogd.conf)<br />
<br />
==Testing==<br />
When authdaemon and imapd are running you can do a simple login test:<br />
<br />
$ telnet localhost 143<br />
<br />
and type the login command<br />
<br />
a login <username> <password><br />
<br />
the server should reply<br />
<br />
a OK LOGIN Ok.<br />
<br />
to which you can reply with a logout<br />
<br />
a logout<br />
<br />
the session is terminated by the server<br />
<br />
* BYE Courier-IMAP server shutting down<br />
a OK LOGOUT completed<br />
Connection closed by foreign host.<br />
<br />
==All in one==<br />
If everything works fine you can use the following [{{#file:imapd}} startup script] to launch or stop imap and authlib daemons. It can be saved in /usr/local/sbin.<br />
<br />
<source lang=bash><br />
#! /bin/sh<br />
#<br />
# Courier imap daemon startup script.<br />
<br />
authlib=/usr/local/sbin/authdaemond<br />
imapd=/usr/lib/courier-imap/libexec/imapd.rc<br />
<br />
test ! -f $authlib && echo "File not found: $authlib" && exit 1;<br />
test ! -f $imapd && echo "File not found: $imapd" && exit 1;<br />
<br />
case $1 in<br />
start)<br />
$authlib start<br />
$imapd start<br />
;;<br />
stop)<br />
$imapd stop<br />
$authlib stop<br />
;;<br />
*)<br />
echo "Usage: $0 <start|stop>"<br />
;;<br />
esac<br />
</source><br />
<br />
==Cygwin service==<br />
Create the [{{#file:imapd-srv.sh}} service script]<br />
<br />
<source lang=bash><br />
#!/bin/sh<br />
# File: imapd-service.sh<br />
# Purpose: Courier imap daemon service script.<br />
#<br />
# This script must be excutable by SYSTEM<br />
username=username # <<<< Change me !!!<br />
<br />
function handleQuit<br />
{<br />
echo "STOPPING: /usr/local/sbin/imapd"<br />
su $username -c "/usr/local/sbin/imapd stop"<br />
exit<br />
}<br />
<br />
echo "STARTING: /usr/local/sbin/imapd as $username"<br />
su $username -c "/usr/local/sbin/imapd start"<br />
<br />
trap "handleQuit" SIGQUIT<br />
<br />
echo "WAITING"<br />
while true<br />
do<br />
sleep 1<br />
done<br />
</source><br />
<br />
Change username and save it to your favorite location, says /usr/local/sbin. The service script must be executable by SYSTEM, ie: the user that run the windows services.<br />
<br />
$ chmod +x /usr/local/sbin/imapd-srv.sh<br />
<br />
Install the new service with the following command.<br />
<br />
$ cygrunsrv --install imapd --desc "Courier IMAP daemon" --disp "CYGWIN imapd" \<br />
--path /usr/local/sbin/imapd-srv.sh --termsig QUIT --type auto --shutdown<br />
<br />
Finally, just start the service<br />
<br />
$ cygrunsrv --start imapd<br />
or<br />
$ net start imapd<br />
<br />
You should now have couple of processes related to courier-imap<br />
<br />
$ ps<br />
<br />
=Maildir=<br />
'''maildirmake''' is part of the courier-imap package<br />
<br />
$ /usr/lib/courier-imap/bin/maildirmake</div>Twalranthttps://wiki.yobi.be/index.php?title=Courier-Cygwin&diff=5244Courier-Cygwin2008-10-26T14:26:08Z<p>Twalrant: /* Running */</p>
<hr />
<div>=Pre-requisite=<br />
<br />
Courier-IMAP requires the installation of the [http://www.courier-mta.org/authlib/ Courier Authentication Library] and the following cygwin tools and packages<br />
<br />
* patch, tar, make, gcc<br />
* crypt<br />
* libgdbm-devel<br />
* libtool<br />
* inetutils<br />
* cygrunsrv<br />
<br />
Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install the required packages.<br />
<br />
=Courier Authentication Library=<br />
<br />
Installation of Courier Authentication Library using the module userdb to manage mail accounts. All other modules are disabled.<br />
<br />
==Compilation and installation==<br />
<br />
Download and untar [http://www.courier-mta.org/download.php#authlib courier-authlib] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-authlib-0.61.0.tar.bz2 0.61.0]<br />
<br />
Apply the [{{#file:courrier-authlib-0.61.0-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# add libtool flag (-no-undefined) required for DLL creation<br />
# add missing dependencies<br />
# add PATH in start script to access new DLL (installed in a different directory)<br />
<br />
Solution source: http://lists.cairographics.org/archives/cairo/2004-April/001125.html<br />
<br />
<source lang=diff><br />
--- courier-authlib-0.61.0/makedat/Makefile.in 2008-05-24 16:21:09.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/makedat/Makefile.in 2008-10-21 16:02:38.709166700 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-authlib-0.61.0/Makefile.in 2008-07-12 21:41:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/Makefile.in 2008-10-23 22:59:03.843750000 +0200<br />
@@ -213,9 +213,10 @@<br />
LTCOMPILE = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
--mode=compile $(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) \<br />
$(AM_CPPFLAGS) $(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS)<br />
-CCLD = $(CC)<br />
+CCLD = $(CC) -no-undefined<br />
+CCLDEXE = $(CC)<br />
LINK = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
- --mode=link $(CCLD) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
+ --mode=link $(CCLDEXE) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
$(LDFLAGS) -o $@<br />
SOURCES = $(libauthcustom_la_SOURCES) $(libauthldap_la_SOURCES) \<br />
$(libauthmysql_la_SOURCES) $(libauthpam_la_SOURCES) \<br />
@@ -452,9 +453,9 @@<br />
README.authdebug.html<br />
<br />
DISTCLEANFILES = dbobj.config README_authlib.html<br />
-commonlibdep = libcourierauthcommon.la<br />
+commonlibdep = libcourierauthcommon.la libcourierauth.la<br />
commonldflags = -module -rpath $(pkglibdir) -export-symbols-regex 'courier_auth.*_init' -avoid-version<br />
-commonlibadd = libcourierauthcommon.la<br />
+commonlibadd = libcourierauthcommon.la libcourierauth.la<br />
libcourierauthcommon_t = @CRYPTLIBS@<br />
libcourierauthcommon_la_SOURCES = \<br />
auth.h courierauth.h \<br />
--- courier-authlib-0.61.0/authdaemond.in 2005-07-05 14:25:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/authdaemond.in 2008-10-25 12:03:32.140625000 +0200<br />
@@ -15,4 +15,10 @@<br />
set -a<br />
. @authdaemonrc@<br />
<br />
+# Some shared libraries (DLL) are installed in @libdir@/bin<br />
+# instead of @libdir@/@PACKAGE@<br />
+# Setting LD_LIBRARY_PATH at runtime or LR_RUN_PATH at linktime doesn't<br />
+# work in cygwin, only setting PATH works. <br />
+export PATH=$PATH:@libdir@/bin<br />
+<br />
exec ${sbindir}/courierlogger -pid=@authdaemonvar@/pid $LOGGEROPTS -$1 @libexecdir@/courier-authlib/authdaemond<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-authlib-0.61.0-cygwin.patch<br />
<br />
Configure the package without most authentication modules, keeping only ''userdb''.<br />
<br />
'''Note''': replace ''mailuser'' by an existing user name (in your /etc/passwd file). I used my own username.<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait --without-authpam --without-authldap --without-authpwd \<br />
--without-authshadow --without-authcustom --without-authpipe --without-authmysql --without-authpgsql --with-mailuser=mailuser \<br />
--with-mailgroup=mkgroup-l-d<br />
<br />
Take a long pause... and when ready execute the following command.<br />
<br />
$ make<br />
<br />
Take again a long pause... then check the result and install the libraries<br />
<br />
$ make check<br />
$ make install<br />
<br />
==Configuration==<br />
<br />
Create authdaemonrc file: /usr/local/etc/authlib/authdaemonrc<br />
<br />
$ cp /usr/local/etc/authlib/authdaemonrc.dist /usr/local/etc/authlib/authdaemonrc<br />
<br />
Change number of daemons (I use only one) and enable DEBUG_LOGIN<br />
<br />
<source lang=text><br />
# The number of daemon processes that are started.<br />
daemons=1<br />
<br />
# DEBUG_LOGIN=2 - turn on debugging + log passwords too<br />
DEBUG_LOGIN=2<br />
</source><br />
<br />
See http://www.courier-mta.org/authlib/README.authdebug.html for details.<br />
<br />
==IMAP accounts==<br />
<br />
User accounts and settings are managed by ''userdb''. See [http://linux.die.net/man/8/makeuserdb makeuserdb] man page for details, or used the freshly new install man page - man makeuserdb<br />
<br />
Assuming ''username'' is your username, 1001 and 10545 are respectively the UID and GID of an existing user (part of your /etc/passwd and /etc/group). I use my own UID and GID. Create the mailuser home directory, if required, and create Maildir folder.<br />
<br />
$ mkdir -p /home/username<br />
$ cd /home/username<br />
$ /usr/lib/courier-imap/bin/maildirmake Maildir<br />
<br />
Create the userdb text file /usr/local/etc/authlib/userdb<br />
<br />
$ touch /usr/local/etc/authlib/userdb<br />
$ chmod 700 /usr/local/etc/authlib/userdb<br />
<br />
Edit /usr/local/etc/authlib/userdb, one line per account<br />
<br />
<source lang=text><br />
username[TAB]uid=1001|gid=10111|home=/home/username|mail=/home/username/Maildir|systempw=XXXXXX<br />
</source><br />
<br />
where XXXXXX is the encrypted password created with<br />
<br />
$ /usr/local/sbin/userdbpw.exe<br />
<br />
Create the (binary) userdb<br />
<br />
$ /usr/local/sbin/makeuserdb<br />
<br />
You should now have the following files created:<br />
<br />
* /usr/local/etc/authlib/userdb.dat<br />
* /usr/local/etc/authlib/userdbshadow.dat<br />
<br />
==Running==<br />
<br />
Install and configure syslogd. Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install inetutils (contains syslogd). Configure syslogd with the following command. It will create the /etc/syslogd.conf file and install a windows service using cygrunsrv<br />
<br />
$ syslogd-config<br />
<br />
Start the authlib daemon with the following command:<br />
<br />
$ /usr/local/sbin/authdaemon start<br />
<br />
Stop the daemon with the following command:<br />
<br />
$ /usr/local/sbin/authdaemon stop<br />
<br />
You'll find log messages in /var/log/messages (default target file as specified in /etc/syslogd.conf)<br />
<br />
==Testing authlib==<br />
<br />
$ /usr/local/sbin/authtest username CCCCCC<br />
Authentication succeeded.<br />
<br />
Authenticated: username (uid 1001, gid 10545)<br />
Home Directory: /home/username<br />
Maildir: /home/username/Maildir<br />
Quota: (none)<br />
Encrypted Password: XXXXXX<br />
Cleartext Password: CCCCCC<br />
Options: (none)<br />
<br />
where username is you user name and XXXXXX is you encrypted password as provided in ''/usr/local/etc/authlib/userdb''. CCCCCC is your password in clear.<br />
<br />
==Troubleshooting==<br />
<br />
Should you have a doubt on the execution of a command (ie: no output) you can check if the application is able to load required DLL. This error is not reported. Using ''strace'', windows will complain about DLL not found, if any. To solve this problem you may need to add some path in your PATH. For example, in order to test authlib with authtest:<br />
<br />
$ strace /usr/local/sbin/authtest<br />
# This will open a dialog box to complain about DLL.<br />
$ export PATH=$PATH:/usr/local/lib/bin<br />
$ /usr/local/sbin/authtest ausername<br />
<br />
==Courier Authentication Config==<br />
<br />
$ /usr/local/bin/courierauthconfig.exe --version<br />
$ /usr/local/bin/courierauthconfig.exe --ldflags<br />
$ /usr/local/bin/courierauthconfig.exe --cppflags<br />
$ /usr/local/bin/courierauthconfig.exe --configfiles<br />
<br />
=Courier-IMAP=<br />
==Compilation and installation==<br />
<br />
Download and untar package [http://www.courier-mta.org/download.php#imap courier-imap] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-imap-4.4.1.tar.bz2 4.4.1.20080920]<br />
<br />
Apply the [{{#file:courrier-imap-4.4.1-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# incorrect usage of EXTEXT in main ''Makefile''<br />
# remove usage of /usr/lib/env in start/stop script (/usr/lib/env does not seem to work under Cygwin)<br />
<br />
<source lang=diff><br />
--- courier-imap-4.4.1.20080920/makedat/Makefile.in 2008-08-24 19:52:51.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/makedat/Makefile.in 2008-10-21 20:43:27.500000000 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-imap-4.4.1.20080920/Makefile.in 2008-09-20 14:48:46.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/Makefile.in 2008-10-21 20:59:45.156250000 +0200<br />
@@ -247,9 +247,9 @@<br />
CLEANFILES = $(databin_SCRIPTS) $(man_MANS) $(sysconf_DATA) $(sbin_SCRIPTS)<br />
databindir = $(datadir)<br />
databin_SCRIPTS = mkimapdcert mkpop3dcert<br />
-binPROGRAMS = imapd pop3d maildirmake maildiracl deliverquota maildirkw<br />
-sbinPROGRAMS = imaplogin pop3login<br />
-libexecPROGRAMS = makedatprog couriertcpd<br />
+binPROGRAMS = imapd$(EXEEXT) pop3d$(EXEEXT) maildirmake$(EXEEXT) maildiracl$(EXEEXT) deliverquota$(EXEEXT) maildirkw$(EXEEXT)<br />
+sbinPROGRAMS = imaplogin$(EXEEXT) pop3login$(EXEEXT)<br />
+libexecPROGRAMS = makedatprog$(EXEEXT) couriertcpd$(EXEEXT)<br />
bin_PROGRAMS = @binPROGRAMS_exec@<br />
sbin_PROGRAMS = @sbinPROGRAMS_exec@<br />
libexec_PROGRAMS = @libexecPROGRAMS_exec@<br />
--- courier-imap-4.4.1.20080920/imapd.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/imapd.rc.in 2008-10-26 10:17:51.359375000 +0100<br />
@@ -22,6 +22,15 @@<br />
exit 1<br />
fi<br />
<br />
+# Location for some shared libraries (cygcourierauth*.dll) from authlib<br />
+AUTHLIBDIR=/usr/local<br />
+if test ! -f $AUTHLIBDIR/lib/bin/cygcourierauth.dll<br />
+then<br />
+ echo "$AUTHLIBDIR/lib/bin/cygcourierauth.dll not found."<br />
+ exit 1<br />
+fi<br />
+export PATH=$PATH:/usr/local/lib/bin<br />
+<br />
TLS_CACHEFILE=""<br />
. @sysconfdir@/imapd-ssl<br />
. @sysconfdir@/imapd<br />
@@ -35,7 +44,7 @@<br />
<br />
umask $IMAP_UMASK<br />
@ULIMIT@ $IMAP_ULIMITD<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
--- courier-imap-4.4.1.20080920/pop3d.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/pop3d.rc.in 2008-10-26 10:18:02.187500000 +0100<br />
@@ -22,12 +22,21 @@<br />
exit 1<br />
fi<br />
<br />
+# Location for some shared libraries (cygcourierauth*.dll) from authlib<br />
+AUTHLIBDIR=/usr/local<br />
+if test ! -f $AUTHLIBDIR/lib/bin/cygcourierauth.dll<br />
+then<br />
+ echo "$AUTHLIBDIR/lib/bin/cygcourierauth.dll not found."<br />
+ exit 1<br />
+fi<br />
+export PATH=$PATH:/usr/local/lib/bin<br />
+<br />
. @sysconfdir@/pop3d-ssl<br />
. @sysconfdir@/pop3d<br />
<br />
case $1 in<br />
start)<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-imap-4.4.1-cygwin.patch<br />
<br />
Configure the package<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait<br />
<br />
Take a walk... and when ready execute the following command to build the package.<br />
<br />
$ make<br />
<br />
Time to go for some coffee... and then install the package with the usual<br />
<br />
$ make install<br />
$ make install-configure<br />
<br />
==Configuration==<br />
<br />
Setup courier-imap: $prefix/etc/imapd (where $prefix=/usr/lib/courier-imap)<br />
<br />
Set ADDRESS to a valid value (0 or 127.0.0.1) and change IMAP_ULIMITD to a value accepted by the command ulimit. I simply used the existing value returned by<br />
<br />
$ ulimit -v<br />
<br />
==Running==<br />
<br />
Syslogd service and authdaemond should be started. See above.<br />
<br />
Start the authlib and imap daemons with the following command:<br />
<br />
$ /usr/lib/courier-imap/libexec/imapd.rc start<br />
<br />
Stop the daemons with the following command:<br />
<br />
$ /usr/lib/courier-imap/libexec/imapd.rc stop<br />
<br />
You'll find log messages in /var/log/messages (default target file as specified in /etc/syslogd.conf)<br />
<br />
==Testing==<br />
When authdaemon and imapd are running you can do a simple login test:<br />
<br />
$ telnet localhost 143<br />
<br />
and type the login command<br />
<br />
a login <username> <password><br />
<br />
the server should reply<br />
<br />
a OK LOGIN Ok.<br />
<br />
to which you can reply with a logout<br />
<br />
a logout<br />
<br />
the session is terminated by the server<br />
<br />
* BYE Courier-IMAP server shutting down<br />
a OK LOGOUT completed<br />
Connection closed by foreign host.<br />
<br />
==All in one==<br />
If everything works fine you can use the following [{{#file:imapd}} startup script] to launch or stop imap and authlib daemons. It can be saved in /usr/local/sbin.<br />
<br />
<source lang=bash><br />
#! /bin/sh<br />
#<br />
# Courier imap daemon startup script.<br />
<br />
authlib=/usr/local/sbin/authdaemond<br />
imapd=/usr/lib/courier-imap/libexec/imapd.rc<br />
<br />
test ! -f $authlib && echo "File not found: $authlib" && exit 1;<br />
test ! -f $imapd && echo "File not found: $imapd" && exit 1;<br />
<br />
case $1 in<br />
start)<br />
$authlib start<br />
$imapd start<br />
;;<br />
stop)<br />
$imapd stop<br />
$authlib stop<br />
;;<br />
*)<br />
echo "Usage: $0 <start|stop>"<br />
;;<br />
esac<br />
</source><br />
<br />
==Cygwin service==<br />
Create the [{{#file:imapd-srv.sh}} service script]<br />
<br />
<source lang=bash><br />
#!/bin/sh<br />
# File: imapd-service.sh<br />
# Purpose: Courier imap daemon service script.<br />
#<br />
# This script must be excutable by SYSTEM<br />
username=username # <<<< Change me !!!<br />
<br />
function handleQuit<br />
{<br />
echo "STOPPING: /usr/local/sbin/imapd"<br />
su $username -c "/usr/local/sbin/imapd stop"<br />
exit<br />
}<br />
<br />
echo "STARTING: /usr/local/sbin/imapd as $username"<br />
su $username -c "/usr/local/sbin/imapd start"<br />
<br />
trap "handleQuit" SIGQUIT<br />
<br />
echo "WAITING"<br />
while true<br />
do<br />
sleep 1<br />
done<br />
</source><br />
<br />
Change username and save it to your favorite location, says /usr/local/sbin. The service script must be executable by SYSTEM, ie: the user that run the windows services.<br />
<br />
$ chmod +x /usr/local/sbin/imapd-srv.sh<br />
<br />
Install the new service with the following command.<br />
<br />
$ cygrunsrv --install imapd --desc "Courier IMAP daemon" --disp "CYGWIN imapd" \<br />
--path /usr/local/sbin/imapd-srv.sh --termsig QUIT --type auto --shutdown<br />
<br />
Finally, just start the service<br />
<br />
$ cygrunsrv --start imapd<br />
or<br />
$ net start imapd<br />
<br />
You should now have couple of processes related to courier-imap<br />
<br />
$ ps<br />
<br />
=Maildir=<br />
'''maildirmake''' is part of the courier-imap package<br />
<br />
$ /usr/lib/courier-imap/bin/maildirmake</div>Twalranthttps://wiki.yobi.be/index.php?title=Courier-Cygwin&diff=5243Courier-Cygwin2008-10-26T14:23:10Z<p>Twalrant: /* Cygwin service */</p>
<hr />
<div>=Pre-requisite=<br />
<br />
Courier-IMAP requires the installation of the [http://www.courier-mta.org/authlib/ Courier Authentication Library] and the following cygwin tools and packages<br />
<br />
* patch, tar, make, gcc<br />
* crypt<br />
* libgdbm-devel<br />
* libtool<br />
* inetutils<br />
* cygrunsrv<br />
<br />
Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install the required packages.<br />
<br />
=Courier Authentication Library=<br />
<br />
Installation of Courier Authentication Library using the module userdb to manage mail accounts. All other modules are disabled.<br />
<br />
==Compilation and installation==<br />
<br />
Download and untar [http://www.courier-mta.org/download.php#authlib courier-authlib] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-authlib-0.61.0.tar.bz2 0.61.0]<br />
<br />
Apply the [{{#file:courrier-authlib-0.61.0-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# add libtool flag (-no-undefined) required for DLL creation<br />
# add missing dependencies<br />
# add PATH in start script to access new DLL (installed in a different directory)<br />
<br />
Solution source: http://lists.cairographics.org/archives/cairo/2004-April/001125.html<br />
<br />
<source lang=diff><br />
--- courier-authlib-0.61.0/makedat/Makefile.in 2008-05-24 16:21:09.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/makedat/Makefile.in 2008-10-21 16:02:38.709166700 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-authlib-0.61.0/Makefile.in 2008-07-12 21:41:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/Makefile.in 2008-10-23 22:59:03.843750000 +0200<br />
@@ -213,9 +213,10 @@<br />
LTCOMPILE = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
--mode=compile $(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) \<br />
$(AM_CPPFLAGS) $(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS)<br />
-CCLD = $(CC)<br />
+CCLD = $(CC) -no-undefined<br />
+CCLDEXE = $(CC)<br />
LINK = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
- --mode=link $(CCLD) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
+ --mode=link $(CCLDEXE) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
$(LDFLAGS) -o $@<br />
SOURCES = $(libauthcustom_la_SOURCES) $(libauthldap_la_SOURCES) \<br />
$(libauthmysql_la_SOURCES) $(libauthpam_la_SOURCES) \<br />
@@ -452,9 +453,9 @@<br />
README.authdebug.html<br />
<br />
DISTCLEANFILES = dbobj.config README_authlib.html<br />
-commonlibdep = libcourierauthcommon.la<br />
+commonlibdep = libcourierauthcommon.la libcourierauth.la<br />
commonldflags = -module -rpath $(pkglibdir) -export-symbols-regex 'courier_auth.*_init' -avoid-version<br />
-commonlibadd = libcourierauthcommon.la<br />
+commonlibadd = libcourierauthcommon.la libcourierauth.la<br />
libcourierauthcommon_t = @CRYPTLIBS@<br />
libcourierauthcommon_la_SOURCES = \<br />
auth.h courierauth.h \<br />
--- courier-authlib-0.61.0/authdaemond.in 2005-07-05 14:25:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/authdaemond.in 2008-10-25 12:03:32.140625000 +0200<br />
@@ -15,4 +15,10 @@<br />
set -a<br />
. @authdaemonrc@<br />
<br />
+# Some shared libraries (DLL) are installed in @libdir@/bin<br />
+# instead of @libdir@/@PACKAGE@<br />
+# Setting LD_LIBRARY_PATH at runtime or LR_RUN_PATH at linktime doesn't<br />
+# work in cygwin, only setting PATH works. <br />
+export PATH=$PATH:@libdir@/bin<br />
+<br />
exec ${sbindir}/courierlogger -pid=@authdaemonvar@/pid $LOGGEROPTS -$1 @libexecdir@/courier-authlib/authdaemond<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-authlib-0.61.0-cygwin.patch<br />
<br />
Configure the package without most authentication modules, keeping only ''userdb''.<br />
<br />
'''Note''': replace ''mailuser'' by an existing user name (in your /etc/passwd file). I used my own username.<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait --without-authpam --without-authldap --without-authpwd \<br />
--without-authshadow --without-authcustom --without-authpipe --without-authmysql --without-authpgsql --with-mailuser=mailuser \<br />
--with-mailgroup=mkgroup-l-d<br />
<br />
Take a long pause... and when ready execute the following command.<br />
<br />
$ make<br />
<br />
Take again a long pause... then check the result and install the libraries<br />
<br />
$ make check<br />
$ make install<br />
<br />
==Configuration==<br />
<br />
Create authdaemonrc file: /usr/local/etc/authlib/authdaemonrc<br />
<br />
$ cp /usr/local/etc/authlib/authdaemonrc.dist /usr/local/etc/authlib/authdaemonrc<br />
<br />
Change number of daemons (I use only one) and enable DEBUG_LOGIN<br />
<br />
<source lang=text><br />
# The number of daemon processes that are started.<br />
daemons=1<br />
<br />
# DEBUG_LOGIN=2 - turn on debugging + log passwords too<br />
DEBUG_LOGIN=2<br />
</source><br />
<br />
See http://www.courier-mta.org/authlib/README.authdebug.html for details.<br />
<br />
==IMAP accounts==<br />
<br />
User accounts and settings are managed by ''userdb''. See [http://linux.die.net/man/8/makeuserdb makeuserdb] man page for details, or used the freshly new install man page - man makeuserdb<br />
<br />
Assuming ''username'' is your username, 1001 and 10545 are respectively the UID and GID of an existing user (part of your /etc/passwd and /etc/group). I use my own UID and GID. Create the mailuser home directory, if required, and create Maildir folder.<br />
<br />
$ mkdir -p /home/username<br />
$ cd /home/username<br />
$ /usr/lib/courier-imap/bin/maildirmake Maildir<br />
<br />
Create the userdb text file /usr/local/etc/authlib/userdb<br />
<br />
$ touch /usr/local/etc/authlib/userdb<br />
$ chmod 700 /usr/local/etc/authlib/userdb<br />
<br />
Edit /usr/local/etc/authlib/userdb, one line per account<br />
<br />
<source lang=text><br />
username[TAB]uid=1001|gid=10111|home=/home/username|mail=/home/username/Maildir|systempw=XXXXXX<br />
</source><br />
<br />
where XXXXXX is the encrypted password created with<br />
<br />
$ /usr/local/sbin/userdbpw.exe<br />
<br />
Create the (binary) userdb<br />
<br />
$ /usr/local/sbin/makeuserdb<br />
<br />
You should now have the following files created:<br />
<br />
* /usr/local/etc/authlib/userdb.dat<br />
* /usr/local/etc/authlib/userdbshadow.dat<br />
<br />
==Running==<br />
<br />
Install and configure syslogd. Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install inetutils (contains syslogd). Configure syslogd with the following command. It will create the /etc/syslogd.conf file and install a windows service using cygrunsrv<br />
<br />
$ syslogd-config<br />
<br />
Start the authlib and imap daemons with the following command:<br />
<br />
$ /usr/local/sbin/authdaemon start<br />
<br />
Stop the daemons with the following command:<br />
<br />
$ /usr/local/sbin/authdaemon stop<br />
<br />
You'll find log messages in /var/log/messages (default target file as specified in /etc/syslogd.conf)<br />
<br />
==Testing authlib==<br />
<br />
$ /usr/local/sbin/authtest username CCCCCC<br />
Authentication succeeded.<br />
<br />
Authenticated: username (uid 1001, gid 10545)<br />
Home Directory: /home/username<br />
Maildir: /home/username/Maildir<br />
Quota: (none)<br />
Encrypted Password: XXXXXX<br />
Cleartext Password: CCCCCC<br />
Options: (none)<br />
<br />
where username is you user name and XXXXXX is you encrypted password as provided in ''/usr/local/etc/authlib/userdb''. CCCCCC is your password in clear.<br />
<br />
==Troubleshooting==<br />
<br />
Should you have a doubt on the execution of a command (ie: no output) you can check if the application is able to load required DLL. This error is not reported. Using ''strace'', windows will complain about DLL not found, if any. To solve this problem you may need to add some path in your PATH. For example, in order to test authlib with authtest:<br />
<br />
$ strace /usr/local/sbin/authtest<br />
# This will open a dialog box to complain about DLL.<br />
$ export PATH=$PATH:/usr/local/lib/bin<br />
$ /usr/local/sbin/authtest ausername<br />
<br />
==Courier Authentication Config==<br />
<br />
$ /usr/local/bin/courierauthconfig.exe --version<br />
$ /usr/local/bin/courierauthconfig.exe --ldflags<br />
$ /usr/local/bin/courierauthconfig.exe --cppflags<br />
$ /usr/local/bin/courierauthconfig.exe --configfiles<br />
<br />
=Courier-IMAP=<br />
==Compilation and installation==<br />
<br />
Download and untar package [http://www.courier-mta.org/download.php#imap courier-imap] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-imap-4.4.1.tar.bz2 4.4.1.20080920]<br />
<br />
Apply the [{{#file:courrier-imap-4.4.1-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# incorrect usage of EXTEXT in main ''Makefile''<br />
# remove usage of /usr/lib/env in start/stop script (/usr/lib/env does not seem to work under Cygwin)<br />
<br />
<source lang=diff><br />
--- courier-imap-4.4.1.20080920/makedat/Makefile.in 2008-08-24 19:52:51.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/makedat/Makefile.in 2008-10-21 20:43:27.500000000 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-imap-4.4.1.20080920/Makefile.in 2008-09-20 14:48:46.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/Makefile.in 2008-10-21 20:59:45.156250000 +0200<br />
@@ -247,9 +247,9 @@<br />
CLEANFILES = $(databin_SCRIPTS) $(man_MANS) $(sysconf_DATA) $(sbin_SCRIPTS)<br />
databindir = $(datadir)<br />
databin_SCRIPTS = mkimapdcert mkpop3dcert<br />
-binPROGRAMS = imapd pop3d maildirmake maildiracl deliverquota maildirkw<br />
-sbinPROGRAMS = imaplogin pop3login<br />
-libexecPROGRAMS = makedatprog couriertcpd<br />
+binPROGRAMS = imapd$(EXEEXT) pop3d$(EXEEXT) maildirmake$(EXEEXT) maildiracl$(EXEEXT) deliverquota$(EXEEXT) maildirkw$(EXEEXT)<br />
+sbinPROGRAMS = imaplogin$(EXEEXT) pop3login$(EXEEXT)<br />
+libexecPROGRAMS = makedatprog$(EXEEXT) couriertcpd$(EXEEXT)<br />
bin_PROGRAMS = @binPROGRAMS_exec@<br />
sbin_PROGRAMS = @sbinPROGRAMS_exec@<br />
libexec_PROGRAMS = @libexecPROGRAMS_exec@<br />
--- courier-imap-4.4.1.20080920/imapd.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/imapd.rc.in 2008-10-26 10:17:51.359375000 +0100<br />
@@ -22,6 +22,15 @@<br />
exit 1<br />
fi<br />
<br />
+# Location for some shared libraries (cygcourierauth*.dll) from authlib<br />
+AUTHLIBDIR=/usr/local<br />
+if test ! -f $AUTHLIBDIR/lib/bin/cygcourierauth.dll<br />
+then<br />
+ echo "$AUTHLIBDIR/lib/bin/cygcourierauth.dll not found."<br />
+ exit 1<br />
+fi<br />
+export PATH=$PATH:/usr/local/lib/bin<br />
+<br />
TLS_CACHEFILE=""<br />
. @sysconfdir@/imapd-ssl<br />
. @sysconfdir@/imapd<br />
@@ -35,7 +44,7 @@<br />
<br />
umask $IMAP_UMASK<br />
@ULIMIT@ $IMAP_ULIMITD<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
--- courier-imap-4.4.1.20080920/pop3d.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/pop3d.rc.in 2008-10-26 10:18:02.187500000 +0100<br />
@@ -22,12 +22,21 @@<br />
exit 1<br />
fi<br />
<br />
+# Location for some shared libraries (cygcourierauth*.dll) from authlib<br />
+AUTHLIBDIR=/usr/local<br />
+if test ! -f $AUTHLIBDIR/lib/bin/cygcourierauth.dll<br />
+then<br />
+ echo "$AUTHLIBDIR/lib/bin/cygcourierauth.dll not found."<br />
+ exit 1<br />
+fi<br />
+export PATH=$PATH:/usr/local/lib/bin<br />
+<br />
. @sysconfdir@/pop3d-ssl<br />
. @sysconfdir@/pop3d<br />
<br />
case $1 in<br />
start)<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-imap-4.4.1-cygwin.patch<br />
<br />
Configure the package<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait<br />
<br />
Take a walk... and when ready execute the following command to build the package.<br />
<br />
$ make<br />
<br />
Time to go for some coffee... and then install the package with the usual<br />
<br />
$ make install<br />
$ make install-configure<br />
<br />
==Configuration==<br />
<br />
Setup courier-imap: $prefix/etc/imapd (where $prefix=/usr/lib/courier-imap)<br />
<br />
Set ADDRESS to a valid value (0 or 127.0.0.1) and change IMAP_ULIMITD to a value accepted by the command ulimit. I simply used the existing value returned by<br />
<br />
$ ulimit -v<br />
<br />
==Running==<br />
<br />
Syslogd service and authdaemond should be started. See above.<br />
<br />
Start the authlib and imap daemons with the following command:<br />
<br />
$ /usr/lib/courier-imap/libexec/imapd.rc start<br />
<br />
Stop the daemons with the following command:<br />
<br />
$ /usr/lib/courier-imap/libexec/imapd.rc stop<br />
<br />
You'll find log messages in /var/log/messages (default target file as specified in /etc/syslogd.conf)<br />
<br />
==Testing==<br />
When authdaemon and imapd are running you can do a simple login test:<br />
<br />
$ telnet localhost 143<br />
<br />
and type the login command<br />
<br />
a login <username> <password><br />
<br />
the server should reply<br />
<br />
a OK LOGIN Ok.<br />
<br />
to which you can reply with a logout<br />
<br />
a logout<br />
<br />
the session is terminated by the server<br />
<br />
* BYE Courier-IMAP server shutting down<br />
a OK LOGOUT completed<br />
Connection closed by foreign host.<br />
<br />
==All in one==<br />
If everything works fine you can use the following [{{#file:imapd}} startup script] to launch or stop imap and authlib daemons. It can be saved in /usr/local/sbin.<br />
<br />
<source lang=bash><br />
#! /bin/sh<br />
#<br />
# Courier imap daemon startup script.<br />
<br />
authlib=/usr/local/sbin/authdaemond<br />
imapd=/usr/lib/courier-imap/libexec/imapd.rc<br />
<br />
test ! -f $authlib && echo "File not found: $authlib" && exit 1;<br />
test ! -f $imapd && echo "File not found: $imapd" && exit 1;<br />
<br />
case $1 in<br />
start)<br />
$authlib start<br />
$imapd start<br />
;;<br />
stop)<br />
$imapd stop<br />
$authlib stop<br />
;;<br />
*)<br />
echo "Usage: $0 <start|stop>"<br />
;;<br />
esac<br />
</source><br />
<br />
==Cygwin service==<br />
Create the [{{#file:imapd-srv.sh}} service script]<br />
<br />
<source lang=bash><br />
#!/bin/sh<br />
# File: imapd-service.sh<br />
# Purpose: Courier imap daemon service script.<br />
#<br />
# This script must be excutable by SYSTEM<br />
username=username # <<<< Change me !!!<br />
<br />
function handleQuit<br />
{<br />
echo "STOPPING: /usr/local/sbin/imapd"<br />
su $username -c "/usr/local/sbin/imapd stop"<br />
exit<br />
}<br />
<br />
echo "STARTING: /usr/local/sbin/imapd as $username"<br />
su $username -c "/usr/local/sbin/imapd start"<br />
<br />
trap "handleQuit" SIGQUIT<br />
<br />
echo "WAITING"<br />
while true<br />
do<br />
sleep 1<br />
done<br />
</source><br />
<br />
Change username and save it to your favorite location, says /usr/local/sbin. The service script must be executable by SYSTEM, ie: the user that run the windows services.<br />
<br />
$ chmod +x /usr/local/sbin/imapd-srv.sh<br />
<br />
Install the new service with the following command.<br />
<br />
$ cygrunsrv --install imapd --desc "Courier IMAP daemon" --disp "CYGWIN imapd" \<br />
--path /usr/local/sbin/imapd-srv.sh --termsig QUIT --type auto --shutdown<br />
<br />
Finally, just start the service<br />
<br />
$ cygrunsrv --start imapd<br />
or<br />
$ net start imapd<br />
<br />
You should now have couple of processes related to courier-imap<br />
<br />
$ ps<br />
<br />
=Maildir=<br />
'''maildirmake''' is part of the courier-imap package<br />
<br />
$ /usr/lib/courier-imap/bin/maildirmake</div>Twalranthttps://wiki.yobi.be/index.php?title=Courier-Cygwin&diff=5242Courier-Cygwin2008-10-26T14:21:06Z<p>Twalrant: /* Cygwin service */</p>
<hr />
<div>=Pre-requisite=<br />
<br />
Courier-IMAP requires the installation of the [http://www.courier-mta.org/authlib/ Courier Authentication Library] and the following cygwin tools and packages<br />
<br />
* patch, tar, make, gcc<br />
* crypt<br />
* libgdbm-devel<br />
* libtool<br />
* inetutils<br />
* cygrunsrv<br />
<br />
Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install the required packages.<br />
<br />
=Courier Authentication Library=<br />
<br />
Installation of Courier Authentication Library using the module userdb to manage mail accounts. All other modules are disabled.<br />
<br />
==Compilation and installation==<br />
<br />
Download and untar [http://www.courier-mta.org/download.php#authlib courier-authlib] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-authlib-0.61.0.tar.bz2 0.61.0]<br />
<br />
Apply the [{{#file:courrier-authlib-0.61.0-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# add libtool flag (-no-undefined) required for DLL creation<br />
# add missing dependencies<br />
# add PATH in start script to access new DLL (installed in a different directory)<br />
<br />
Solution source: http://lists.cairographics.org/archives/cairo/2004-April/001125.html<br />
<br />
<source lang=diff><br />
--- courier-authlib-0.61.0/makedat/Makefile.in 2008-05-24 16:21:09.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/makedat/Makefile.in 2008-10-21 16:02:38.709166700 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-authlib-0.61.0/Makefile.in 2008-07-12 21:41:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/Makefile.in 2008-10-23 22:59:03.843750000 +0200<br />
@@ -213,9 +213,10 @@<br />
LTCOMPILE = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
--mode=compile $(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) \<br />
$(AM_CPPFLAGS) $(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS)<br />
-CCLD = $(CC)<br />
+CCLD = $(CC) -no-undefined<br />
+CCLDEXE = $(CC)<br />
LINK = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
- --mode=link $(CCLD) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
+ --mode=link $(CCLDEXE) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
$(LDFLAGS) -o $@<br />
SOURCES = $(libauthcustom_la_SOURCES) $(libauthldap_la_SOURCES) \<br />
$(libauthmysql_la_SOURCES) $(libauthpam_la_SOURCES) \<br />
@@ -452,9 +453,9 @@<br />
README.authdebug.html<br />
<br />
DISTCLEANFILES = dbobj.config README_authlib.html<br />
-commonlibdep = libcourierauthcommon.la<br />
+commonlibdep = libcourierauthcommon.la libcourierauth.la<br />
commonldflags = -module -rpath $(pkglibdir) -export-symbols-regex 'courier_auth.*_init' -avoid-version<br />
-commonlibadd = libcourierauthcommon.la<br />
+commonlibadd = libcourierauthcommon.la libcourierauth.la<br />
libcourierauthcommon_t = @CRYPTLIBS@<br />
libcourierauthcommon_la_SOURCES = \<br />
auth.h courierauth.h \<br />
--- courier-authlib-0.61.0/authdaemond.in 2005-07-05 14:25:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/authdaemond.in 2008-10-25 12:03:32.140625000 +0200<br />
@@ -15,4 +15,10 @@<br />
set -a<br />
. @authdaemonrc@<br />
<br />
+# Some shared libraries (DLL) are installed in @libdir@/bin<br />
+# instead of @libdir@/@PACKAGE@<br />
+# Setting LD_LIBRARY_PATH at runtime or LR_RUN_PATH at linktime doesn't<br />
+# work in cygwin, only setting PATH works. <br />
+export PATH=$PATH:@libdir@/bin<br />
+<br />
exec ${sbindir}/courierlogger -pid=@authdaemonvar@/pid $LOGGEROPTS -$1 @libexecdir@/courier-authlib/authdaemond<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-authlib-0.61.0-cygwin.patch<br />
<br />
Configure the package without most authentication modules, keeping only ''userdb''.<br />
<br />
'''Note''': replace ''mailuser'' by an existing user name (in your /etc/passwd file). I used my own username.<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait --without-authpam --without-authldap --without-authpwd \<br />
--without-authshadow --without-authcustom --without-authpipe --without-authmysql --without-authpgsql --with-mailuser=mailuser \<br />
--with-mailgroup=mkgroup-l-d<br />
<br />
Take a long pause... and when ready execute the following command.<br />
<br />
$ make<br />
<br />
Take again a long pause... then check the result and install the libraries<br />
<br />
$ make check<br />
$ make install<br />
<br />
==Configuration==<br />
<br />
Create authdaemonrc file: /usr/local/etc/authlib/authdaemonrc<br />
<br />
$ cp /usr/local/etc/authlib/authdaemonrc.dist /usr/local/etc/authlib/authdaemonrc<br />
<br />
Change number of daemons (I use only one) and enable DEBUG_LOGIN<br />
<br />
<source lang=text><br />
# The number of daemon processes that are started.<br />
daemons=1<br />
<br />
# DEBUG_LOGIN=2 - turn on debugging + log passwords too<br />
DEBUG_LOGIN=2<br />
</source><br />
<br />
See http://www.courier-mta.org/authlib/README.authdebug.html for details.<br />
<br />
==IMAP accounts==<br />
<br />
User accounts and settings are managed by ''userdb''. See [http://linux.die.net/man/8/makeuserdb makeuserdb] man page for details, or used the freshly new install man page - man makeuserdb<br />
<br />
Assuming ''username'' is your username, 1001 and 10545 are respectively the UID and GID of an existing user (part of your /etc/passwd and /etc/group). I use my own UID and GID. Create the mailuser home directory, if required, and create Maildir folder.<br />
<br />
$ mkdir -p /home/username<br />
$ cd /home/username<br />
$ /usr/lib/courier-imap/bin/maildirmake Maildir<br />
<br />
Create the userdb text file /usr/local/etc/authlib/userdb<br />
<br />
$ touch /usr/local/etc/authlib/userdb<br />
$ chmod 700 /usr/local/etc/authlib/userdb<br />
<br />
Edit /usr/local/etc/authlib/userdb, one line per account<br />
<br />
<source lang=text><br />
username[TAB]uid=1001|gid=10111|home=/home/username|mail=/home/username/Maildir|systempw=XXXXXX<br />
</source><br />
<br />
where XXXXXX is the encrypted password created with<br />
<br />
$ /usr/local/sbin/userdbpw.exe<br />
<br />
Create the (binary) userdb<br />
<br />
$ /usr/local/sbin/makeuserdb<br />
<br />
You should now have the following files created:<br />
<br />
* /usr/local/etc/authlib/userdb.dat<br />
* /usr/local/etc/authlib/userdbshadow.dat<br />
<br />
==Running==<br />
<br />
Install and configure syslogd. Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install inetutils (contains syslogd). Configure syslogd with the following command. It will create the /etc/syslogd.conf file and install a windows service using cygrunsrv<br />
<br />
$ syslogd-config<br />
<br />
Start the authlib and imap daemons with the following command:<br />
<br />
$ /usr/local/sbin/authdaemon start<br />
<br />
Stop the daemons with the following command:<br />
<br />
$ /usr/local/sbin/authdaemon stop<br />
<br />
You'll find log messages in /var/log/messages (default target file as specified in /etc/syslogd.conf)<br />
<br />
==Testing authlib==<br />
<br />
$ /usr/local/sbin/authtest username CCCCCC<br />
Authentication succeeded.<br />
<br />
Authenticated: username (uid 1001, gid 10545)<br />
Home Directory: /home/username<br />
Maildir: /home/username/Maildir<br />
Quota: (none)<br />
Encrypted Password: XXXXXX<br />
Cleartext Password: CCCCCC<br />
Options: (none)<br />
<br />
where username is you user name and XXXXXX is you encrypted password as provided in ''/usr/local/etc/authlib/userdb''. CCCCCC is your password in clear.<br />
<br />
==Troubleshooting==<br />
<br />
Should you have a doubt on the execution of a command (ie: no output) you can check if the application is able to load required DLL. This error is not reported. Using ''strace'', windows will complain about DLL not found, if any. To solve this problem you may need to add some path in your PATH. For example, in order to test authlib with authtest:<br />
<br />
$ strace /usr/local/sbin/authtest<br />
# This will open a dialog box to complain about DLL.<br />
$ export PATH=$PATH:/usr/local/lib/bin<br />
$ /usr/local/sbin/authtest ausername<br />
<br />
==Courier Authentication Config==<br />
<br />
$ /usr/local/bin/courierauthconfig.exe --version<br />
$ /usr/local/bin/courierauthconfig.exe --ldflags<br />
$ /usr/local/bin/courierauthconfig.exe --cppflags<br />
$ /usr/local/bin/courierauthconfig.exe --configfiles<br />
<br />
=Courier-IMAP=<br />
==Compilation and installation==<br />
<br />
Download and untar package [http://www.courier-mta.org/download.php#imap courier-imap] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-imap-4.4.1.tar.bz2 4.4.1.20080920]<br />
<br />
Apply the [{{#file:courrier-imap-4.4.1-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# incorrect usage of EXTEXT in main ''Makefile''<br />
# remove usage of /usr/lib/env in start/stop script (/usr/lib/env does not seem to work under Cygwin)<br />
<br />
<source lang=diff><br />
--- courier-imap-4.4.1.20080920/makedat/Makefile.in 2008-08-24 19:52:51.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/makedat/Makefile.in 2008-10-21 20:43:27.500000000 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-imap-4.4.1.20080920/Makefile.in 2008-09-20 14:48:46.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/Makefile.in 2008-10-21 20:59:45.156250000 +0200<br />
@@ -247,9 +247,9 @@<br />
CLEANFILES = $(databin_SCRIPTS) $(man_MANS) $(sysconf_DATA) $(sbin_SCRIPTS)<br />
databindir = $(datadir)<br />
databin_SCRIPTS = mkimapdcert mkpop3dcert<br />
-binPROGRAMS = imapd pop3d maildirmake maildiracl deliverquota maildirkw<br />
-sbinPROGRAMS = imaplogin pop3login<br />
-libexecPROGRAMS = makedatprog couriertcpd<br />
+binPROGRAMS = imapd$(EXEEXT) pop3d$(EXEEXT) maildirmake$(EXEEXT) maildiracl$(EXEEXT) deliverquota$(EXEEXT) maildirkw$(EXEEXT)<br />
+sbinPROGRAMS = imaplogin$(EXEEXT) pop3login$(EXEEXT)<br />
+libexecPROGRAMS = makedatprog$(EXEEXT) couriertcpd$(EXEEXT)<br />
bin_PROGRAMS = @binPROGRAMS_exec@<br />
sbin_PROGRAMS = @sbinPROGRAMS_exec@<br />
libexec_PROGRAMS = @libexecPROGRAMS_exec@<br />
--- courier-imap-4.4.1.20080920/imapd.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/imapd.rc.in 2008-10-26 10:17:51.359375000 +0100<br />
@@ -22,6 +22,15 @@<br />
exit 1<br />
fi<br />
<br />
+# Location for some shared libraries (cygcourierauth*.dll) from authlib<br />
+AUTHLIBDIR=/usr/local<br />
+if test ! -f $AUTHLIBDIR/lib/bin/cygcourierauth.dll<br />
+then<br />
+ echo "$AUTHLIBDIR/lib/bin/cygcourierauth.dll not found."<br />
+ exit 1<br />
+fi<br />
+export PATH=$PATH:/usr/local/lib/bin<br />
+<br />
TLS_CACHEFILE=""<br />
. @sysconfdir@/imapd-ssl<br />
. @sysconfdir@/imapd<br />
@@ -35,7 +44,7 @@<br />
<br />
umask $IMAP_UMASK<br />
@ULIMIT@ $IMAP_ULIMITD<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
--- courier-imap-4.4.1.20080920/pop3d.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/pop3d.rc.in 2008-10-26 10:18:02.187500000 +0100<br />
@@ -22,12 +22,21 @@<br />
exit 1<br />
fi<br />
<br />
+# Location for some shared libraries (cygcourierauth*.dll) from authlib<br />
+AUTHLIBDIR=/usr/local<br />
+if test ! -f $AUTHLIBDIR/lib/bin/cygcourierauth.dll<br />
+then<br />
+ echo "$AUTHLIBDIR/lib/bin/cygcourierauth.dll not found."<br />
+ exit 1<br />
+fi<br />
+export PATH=$PATH:/usr/local/lib/bin<br />
+<br />
. @sysconfdir@/pop3d-ssl<br />
. @sysconfdir@/pop3d<br />
<br />
case $1 in<br />
start)<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-imap-4.4.1-cygwin.patch<br />
<br />
Configure the package<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait<br />
<br />
Take a walk... and when ready execute the following command to build the package.<br />
<br />
$ make<br />
<br />
Time to go for some coffee... and then install the package with the usual<br />
<br />
$ make install<br />
$ make install-configure<br />
<br />
==Configuration==<br />
<br />
Setup courier-imap: $prefix/etc/imapd (where $prefix=/usr/lib/courier-imap)<br />
<br />
Set ADDRESS to a valid value (0 or 127.0.0.1) and change IMAP_ULIMITD to a value accepted by the command ulimit. I simply used the existing value returned by<br />
<br />
$ ulimit -v<br />
<br />
==Running==<br />
<br />
Syslogd service and authdaemond should be started. See above.<br />
<br />
Start the authlib and imap daemons with the following command:<br />
<br />
$ /usr/lib/courier-imap/libexec/imapd.rc start<br />
<br />
Stop the daemons with the following command:<br />
<br />
$ /usr/lib/courier-imap/libexec/imapd.rc stop<br />
<br />
You'll find log messages in /var/log/messages (default target file as specified in /etc/syslogd.conf)<br />
<br />
==Testing==<br />
When authdaemon and imapd are running you can do a simple login test:<br />
<br />
$ telnet localhost 143<br />
<br />
and type the login command<br />
<br />
a login <username> <password><br />
<br />
the server should reply<br />
<br />
a OK LOGIN Ok.<br />
<br />
to which you can reply with a logout<br />
<br />
a logout<br />
<br />
the session is terminated by the server<br />
<br />
* BYE Courier-IMAP server shutting down<br />
a OK LOGOUT completed<br />
Connection closed by foreign host.<br />
<br />
==All in one==<br />
If everything works fine you can use the following [{{#file:imapd}} startup script] to launch or stop imap and authlib daemons. It can be saved in /usr/local/sbin.<br />
<br />
<source lang=bash><br />
#! /bin/sh<br />
#<br />
# Courier imap daemon startup script.<br />
<br />
authlib=/usr/local/sbin/authdaemond<br />
imapd=/usr/lib/courier-imap/libexec/imapd.rc<br />
<br />
test ! -f $authlib && echo "File not found: $authlib" && exit 1;<br />
test ! -f $imapd && echo "File not found: $imapd" && exit 1;<br />
<br />
case $1 in<br />
start)<br />
$authlib start<br />
$imapd start<br />
;;<br />
stop)<br />
$imapd stop<br />
$authlib stop<br />
;;<br />
*)<br />
echo "Usage: $0 <start|stop>"<br />
;;<br />
esac<br />
</source><br />
<br />
==Cygwin service==<br />
Create the [{{#file:imapd-srv.sh}} service script]<br />
<br />
<source lang=bash><br />
#!/bin/sh<br />
# File: imapd-service.sh<br />
# Purpose: Courier imap daemon service script.<br />
#<br />
# This script must be excutable by SYSTEM<br />
username=username<br />
<br />
function handleQuit<br />
{<br />
echo "STOPPING: /usr/local/sbin/imapd"<br />
su $username -c "/usr/local/sbin/imapd stop"<br />
exit<br />
}<br />
<br />
echo "STARTING: /usr/local/sbin/imapd as $username"<br />
su $username -c "/usr/local/sbin/imapd start"<br />
<br />
trap "handleQuit" SIGQUIT<br />
<br />
echo "WAITING"<br />
while true<br />
do<br />
sleep 1<br />
done<br />
</source><br />
<br />
Change username and save it to your favorite location, says /usr/local/sbin. The service script must be executable by SYSTEM, ie: the user that run the windows services.<br />
<br />
$ chmod +x /usr/local/sbin/imapd-srv.sh<br />
<br />
Install the new service with the following command.<br />
<br />
$ cygrunsrv --install imapd --desc "Courier IMAP daemon" --disp "CYGWIN imapd" \<br />
--path /usr/local/sbin/imapd-srv.sh --termsig QUIT --type auto --shutdown<br />
<br />
Finally, just start the service<br />
<br />
$ cygrunsrv --start imapd<br />
or<br />
$ net start imapd<br />
<br />
You should now have couple of processes related to courier-imap<br />
<br />
$ ps<br />
<br />
=Maildir=<br />
'''maildirmake''' is part of the courier-imap package<br />
<br />
$ /usr/lib/courier-imap/bin/maildirmake</div>Twalranthttps://wiki.yobi.be/index.php?title=Courier-Cygwin&diff=5241Courier-Cygwin2008-10-26T14:19:26Z<p>Twalrant: /* Cygwin service */</p>
<hr />
<div>=Pre-requisite=<br />
<br />
Courier-IMAP requires the installation of the [http://www.courier-mta.org/authlib/ Courier Authentication Library] and the following cygwin tools and packages<br />
<br />
* patch, tar, make, gcc<br />
* crypt<br />
* libgdbm-devel<br />
* libtool<br />
* inetutils<br />
* cygrunsrv<br />
<br />
Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install the required packages.<br />
<br />
=Courier Authentication Library=<br />
<br />
Installation of Courier Authentication Library using the module userdb to manage mail accounts. All other modules are disabled.<br />
<br />
==Compilation and installation==<br />
<br />
Download and untar [http://www.courier-mta.org/download.php#authlib courier-authlib] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-authlib-0.61.0.tar.bz2 0.61.0]<br />
<br />
Apply the [{{#file:courrier-authlib-0.61.0-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# add libtool flag (-no-undefined) required for DLL creation<br />
# add missing dependencies<br />
# add PATH in start script to access new DLL (installed in a different directory)<br />
<br />
Solution source: http://lists.cairographics.org/archives/cairo/2004-April/001125.html<br />
<br />
<source lang=diff><br />
--- courier-authlib-0.61.0/makedat/Makefile.in 2008-05-24 16:21:09.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/makedat/Makefile.in 2008-10-21 16:02:38.709166700 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-authlib-0.61.0/Makefile.in 2008-07-12 21:41:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/Makefile.in 2008-10-23 22:59:03.843750000 +0200<br />
@@ -213,9 +213,10 @@<br />
LTCOMPILE = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
--mode=compile $(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) \<br />
$(AM_CPPFLAGS) $(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS)<br />
-CCLD = $(CC)<br />
+CCLD = $(CC) -no-undefined<br />
+CCLDEXE = $(CC)<br />
LINK = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
- --mode=link $(CCLD) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
+ --mode=link $(CCLDEXE) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
$(LDFLAGS) -o $@<br />
SOURCES = $(libauthcustom_la_SOURCES) $(libauthldap_la_SOURCES) \<br />
$(libauthmysql_la_SOURCES) $(libauthpam_la_SOURCES) \<br />
@@ -452,9 +453,9 @@<br />
README.authdebug.html<br />
<br />
DISTCLEANFILES = dbobj.config README_authlib.html<br />
-commonlibdep = libcourierauthcommon.la<br />
+commonlibdep = libcourierauthcommon.la libcourierauth.la<br />
commonldflags = -module -rpath $(pkglibdir) -export-symbols-regex 'courier_auth.*_init' -avoid-version<br />
-commonlibadd = libcourierauthcommon.la<br />
+commonlibadd = libcourierauthcommon.la libcourierauth.la<br />
libcourierauthcommon_t = @CRYPTLIBS@<br />
libcourierauthcommon_la_SOURCES = \<br />
auth.h courierauth.h \<br />
--- courier-authlib-0.61.0/authdaemond.in 2005-07-05 14:25:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/authdaemond.in 2008-10-25 12:03:32.140625000 +0200<br />
@@ -15,4 +15,10 @@<br />
set -a<br />
. @authdaemonrc@<br />
<br />
+# Some shared libraries (DLL) are installed in @libdir@/bin<br />
+# instead of @libdir@/@PACKAGE@<br />
+# Setting LD_LIBRARY_PATH at runtime or LR_RUN_PATH at linktime doesn't<br />
+# work in cygwin, only setting PATH works. <br />
+export PATH=$PATH:@libdir@/bin<br />
+<br />
exec ${sbindir}/courierlogger -pid=@authdaemonvar@/pid $LOGGEROPTS -$1 @libexecdir@/courier-authlib/authdaemond<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-authlib-0.61.0-cygwin.patch<br />
<br />
Configure the package without most authentication modules, keeping only ''userdb''.<br />
<br />
'''Note''': replace ''mailuser'' by an existing user name (in your /etc/passwd file). I used my own username.<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait --without-authpam --without-authldap --without-authpwd \<br />
--without-authshadow --without-authcustom --without-authpipe --without-authmysql --without-authpgsql --with-mailuser=mailuser \<br />
--with-mailgroup=mkgroup-l-d<br />
<br />
Take a long pause... and when ready execute the following command.<br />
<br />
$ make<br />
<br />
Take again a long pause... then check the result and install the libraries<br />
<br />
$ make check<br />
$ make install<br />
<br />
==Configuration==<br />
<br />
Create authdaemonrc file: /usr/local/etc/authlib/authdaemonrc<br />
<br />
$ cp /usr/local/etc/authlib/authdaemonrc.dist /usr/local/etc/authlib/authdaemonrc<br />
<br />
Change number of daemons (I use only one) and enable DEBUG_LOGIN<br />
<br />
<source lang=text><br />
# The number of daemon processes that are started.<br />
daemons=1<br />
<br />
# DEBUG_LOGIN=2 - turn on debugging + log passwords too<br />
DEBUG_LOGIN=2<br />
</source><br />
<br />
See http://www.courier-mta.org/authlib/README.authdebug.html for details.<br />
<br />
==IMAP accounts==<br />
<br />
User accounts and settings are managed by ''userdb''. See [http://linux.die.net/man/8/makeuserdb makeuserdb] man page for details, or used the freshly new install man page - man makeuserdb<br />
<br />
Assuming ''username'' is your username, 1001 and 10545 are respectively the UID and GID of an existing user (part of your /etc/passwd and /etc/group). I use my own UID and GID. Create the mailuser home directory, if required, and create Maildir folder.<br />
<br />
$ mkdir -p /home/username<br />
$ cd /home/username<br />
$ /usr/lib/courier-imap/bin/maildirmake Maildir<br />
<br />
Create the userdb text file /usr/local/etc/authlib/userdb<br />
<br />
$ touch /usr/local/etc/authlib/userdb<br />
$ chmod 700 /usr/local/etc/authlib/userdb<br />
<br />
Edit /usr/local/etc/authlib/userdb, one line per account<br />
<br />
<source lang=text><br />
username[TAB]uid=1001|gid=10111|home=/home/username|mail=/home/username/Maildir|systempw=XXXXXX<br />
</source><br />
<br />
where XXXXXX is the encrypted password created with<br />
<br />
$ /usr/local/sbin/userdbpw.exe<br />
<br />
Create the (binary) userdb<br />
<br />
$ /usr/local/sbin/makeuserdb<br />
<br />
You should now have the following files created:<br />
<br />
* /usr/local/etc/authlib/userdb.dat<br />
* /usr/local/etc/authlib/userdbshadow.dat<br />
<br />
==Running==<br />
<br />
Install and configure syslogd. Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install inetutils (contains syslogd). Configure syslogd with the following command. It will create the /etc/syslogd.conf file and install a windows service using cygrunsrv<br />
<br />
$ syslogd-config<br />
<br />
Start the authlib and imap daemons with the following command:<br />
<br />
$ /usr/local/sbin/authdaemon start<br />
<br />
Stop the daemons with the following command:<br />
<br />
$ /usr/local/sbin/authdaemon stop<br />
<br />
You'll find log messages in /var/log/messages (default target file as specified in /etc/syslogd.conf)<br />
<br />
==Testing authlib==<br />
<br />
$ /usr/local/sbin/authtest username CCCCCC<br />
Authentication succeeded.<br />
<br />
Authenticated: username (uid 1001, gid 10545)<br />
Home Directory: /home/username<br />
Maildir: /home/username/Maildir<br />
Quota: (none)<br />
Encrypted Password: XXXXXX<br />
Cleartext Password: CCCCCC<br />
Options: (none)<br />
<br />
where username is you user name and XXXXXX is you encrypted password as provided in ''/usr/local/etc/authlib/userdb''. CCCCCC is your password in clear.<br />
<br />
==Troubleshooting==<br />
<br />
Should you have a doubt on the execution of a command (ie: no output) you can check if the application is able to load required DLL. This error is not reported. Using ''strace'', windows will complain about DLL not found, if any. To solve this problem you may need to add some path in your PATH. For example, in order to test authlib with authtest:<br />
<br />
$ strace /usr/local/sbin/authtest<br />
# This will open a dialog box to complain about DLL.<br />
$ export PATH=$PATH:/usr/local/lib/bin<br />
$ /usr/local/sbin/authtest ausername<br />
<br />
==Courier Authentication Config==<br />
<br />
$ /usr/local/bin/courierauthconfig.exe --version<br />
$ /usr/local/bin/courierauthconfig.exe --ldflags<br />
$ /usr/local/bin/courierauthconfig.exe --cppflags<br />
$ /usr/local/bin/courierauthconfig.exe --configfiles<br />
<br />
=Courier-IMAP=<br />
==Compilation and installation==<br />
<br />
Download and untar package [http://www.courier-mta.org/download.php#imap courier-imap] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-imap-4.4.1.tar.bz2 4.4.1.20080920]<br />
<br />
Apply the [{{#file:courrier-imap-4.4.1-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# incorrect usage of EXTEXT in main ''Makefile''<br />
# remove usage of /usr/lib/env in start/stop script (/usr/lib/env does not seem to work under Cygwin)<br />
<br />
<source lang=diff><br />
--- courier-imap-4.4.1.20080920/makedat/Makefile.in 2008-08-24 19:52:51.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/makedat/Makefile.in 2008-10-21 20:43:27.500000000 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-imap-4.4.1.20080920/Makefile.in 2008-09-20 14:48:46.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/Makefile.in 2008-10-21 20:59:45.156250000 +0200<br />
@@ -247,9 +247,9 @@<br />
CLEANFILES = $(databin_SCRIPTS) $(man_MANS) $(sysconf_DATA) $(sbin_SCRIPTS)<br />
databindir = $(datadir)<br />
databin_SCRIPTS = mkimapdcert mkpop3dcert<br />
-binPROGRAMS = imapd pop3d maildirmake maildiracl deliverquota maildirkw<br />
-sbinPROGRAMS = imaplogin pop3login<br />
-libexecPROGRAMS = makedatprog couriertcpd<br />
+binPROGRAMS = imapd$(EXEEXT) pop3d$(EXEEXT) maildirmake$(EXEEXT) maildiracl$(EXEEXT) deliverquota$(EXEEXT) maildirkw$(EXEEXT)<br />
+sbinPROGRAMS = imaplogin$(EXEEXT) pop3login$(EXEEXT)<br />
+libexecPROGRAMS = makedatprog$(EXEEXT) couriertcpd$(EXEEXT)<br />
bin_PROGRAMS = @binPROGRAMS_exec@<br />
sbin_PROGRAMS = @sbinPROGRAMS_exec@<br />
libexec_PROGRAMS = @libexecPROGRAMS_exec@<br />
--- courier-imap-4.4.1.20080920/imapd.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/imapd.rc.in 2008-10-26 10:17:51.359375000 +0100<br />
@@ -22,6 +22,15 @@<br />
exit 1<br />
fi<br />
<br />
+# Location for some shared libraries (cygcourierauth*.dll) from authlib<br />
+AUTHLIBDIR=/usr/local<br />
+if test ! -f $AUTHLIBDIR/lib/bin/cygcourierauth.dll<br />
+then<br />
+ echo "$AUTHLIBDIR/lib/bin/cygcourierauth.dll not found."<br />
+ exit 1<br />
+fi<br />
+export PATH=$PATH:/usr/local/lib/bin<br />
+<br />
TLS_CACHEFILE=""<br />
. @sysconfdir@/imapd-ssl<br />
. @sysconfdir@/imapd<br />
@@ -35,7 +44,7 @@<br />
<br />
umask $IMAP_UMASK<br />
@ULIMIT@ $IMAP_ULIMITD<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
--- courier-imap-4.4.1.20080920/pop3d.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/pop3d.rc.in 2008-10-26 10:18:02.187500000 +0100<br />
@@ -22,12 +22,21 @@<br />
exit 1<br />
fi<br />
<br />
+# Location for some shared libraries (cygcourierauth*.dll) from authlib<br />
+AUTHLIBDIR=/usr/local<br />
+if test ! -f $AUTHLIBDIR/lib/bin/cygcourierauth.dll<br />
+then<br />
+ echo "$AUTHLIBDIR/lib/bin/cygcourierauth.dll not found."<br />
+ exit 1<br />
+fi<br />
+export PATH=$PATH:/usr/local/lib/bin<br />
+<br />
. @sysconfdir@/pop3d-ssl<br />
. @sysconfdir@/pop3d<br />
<br />
case $1 in<br />
start)<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-imap-4.4.1-cygwin.patch<br />
<br />
Configure the package<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait<br />
<br />
Take a walk... and when ready execute the following command to build the package.<br />
<br />
$ make<br />
<br />
Time to go for some coffee... and then install the package with the usual<br />
<br />
$ make install<br />
$ make install-configure<br />
<br />
==Configuration==<br />
<br />
Setup courier-imap: $prefix/etc/imapd (where $prefix=/usr/lib/courier-imap)<br />
<br />
Set ADDRESS to a valid value (0 or 127.0.0.1) and change IMAP_ULIMITD to a value accepted by the command ulimit. I simply used the existing value returned by<br />
<br />
$ ulimit -v<br />
<br />
==Running==<br />
<br />
Syslogd service and authdaemond should be started. See above.<br />
<br />
Start the authlib and imap daemons with the following command:<br />
<br />
$ /usr/lib/courier-imap/libexec/imapd.rc start<br />
<br />
Stop the daemons with the following command:<br />
<br />
$ /usr/lib/courier-imap/libexec/imapd.rc stop<br />
<br />
You'll find log messages in /var/log/messages (default target file as specified in /etc/syslogd.conf)<br />
<br />
==Testing==<br />
When authdaemon and imapd are running you can do a simple login test:<br />
<br />
$ telnet localhost 143<br />
<br />
and type the login command<br />
<br />
a login <username> <password><br />
<br />
the server should reply<br />
<br />
a OK LOGIN Ok.<br />
<br />
to which you can reply with a logout<br />
<br />
a logout<br />
<br />
the session is terminated by the server<br />
<br />
* BYE Courier-IMAP server shutting down<br />
a OK LOGOUT completed<br />
Connection closed by foreign host.<br />
<br />
==All in one==<br />
If everything works fine you can use the following [{{#file:imapd}} startup script] to launch or stop imap and authlib daemons. It can be saved in /usr/local/sbin.<br />
<br />
<source lang=bash><br />
#! /bin/sh<br />
#<br />
# Courier imap daemon startup script.<br />
<br />
authlib=/usr/local/sbin/authdaemond<br />
imapd=/usr/lib/courier-imap/libexec/imapd.rc<br />
<br />
test ! -f $authlib && echo "File not found: $authlib" && exit 1;<br />
test ! -f $imapd && echo "File not found: $imapd" && exit 1;<br />
<br />
case $1 in<br />
start)<br />
$authlib start<br />
$imapd start<br />
;;<br />
stop)<br />
$imapd stop<br />
$authlib stop<br />
;;<br />
*)<br />
echo "Usage: $0 <start|stop>"<br />
;;<br />
esac<br />
</source><br />
<br />
==Cygwin service==<br />
Create the [{{#file:imapd-srv.sh}} service script]<br />
<br />
<source lang=bash><br />
#!/bin/sh<br />
# File: imapd-service.sh<br />
# Purpose: Courier imap daemon service script.<br />
#<br />
# This script must be excutable by SYSTEM<br />
username=username<br />
<br />
function handleQuit<br />
{<br />
echo "STOPPING: /usr/local/sbin/imapd"<br />
su $username -c "/usr/local/sbin/imapd stop"<br />
exit<br />
}<br />
<br />
echo "STARTING: /usr/local/sbin/imapd as $username"<br />
su $username -c "/usr/local/sbin/imapd start"<br />
<br />
trap "handleQuit" SIGQUIT<br />
<br />
echo "WAITING"<br />
while true<br />
do<br />
sleep 1<br />
done<br />
</source><br />
<br />
Change username and save it to your favorite location, says /usr/local/sbin. The service script must be executable by SYSTEM, ie: the user that run the windows services.<br />
<br />
$ chmod +x /usr/local/sbin/imapd-srv.sh<br />
<br />
Install the new service with the following command.<br />
<br />
$ cygrunsrv --install imapd --desc "Courier IMAP daemon" --disp "CYGWIN imapd" \<br />
--path /usr/local/sbin/imapd-srv.sh --termsig QUIT --type auto --shutdown<br />
<br />
=Maildir=<br />
'''maildirmake''' is part of the courier-imap package<br />
<br />
$ /usr/lib/courier-imap/bin/maildirmake</div>Twalranthttps://wiki.yobi.be/index.php?title=Courier-Cygwin&diff=5240Courier-Cygwin2008-10-26T14:11:02Z<p>Twalrant: /* All in one */</p>
<hr />
<div>=Pre-requisite=<br />
<br />
Courier-IMAP requires the installation of the [http://www.courier-mta.org/authlib/ Courier Authentication Library] and the following cygwin tools and packages<br />
<br />
* patch, tar, make, gcc<br />
* crypt<br />
* libgdbm-devel<br />
* libtool<br />
* inetutils<br />
* cygrunsrv<br />
<br />
Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install the required packages.<br />
<br />
=Courier Authentication Library=<br />
<br />
Installation of Courier Authentication Library using the module userdb to manage mail accounts. All other modules are disabled.<br />
<br />
==Compilation and installation==<br />
<br />
Download and untar [http://www.courier-mta.org/download.php#authlib courier-authlib] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-authlib-0.61.0.tar.bz2 0.61.0]<br />
<br />
Apply the [{{#file:courrier-authlib-0.61.0-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# add libtool flag (-no-undefined) required for DLL creation<br />
# add missing dependencies<br />
# add PATH in start script to access new DLL (installed in a different directory)<br />
<br />
Solution source: http://lists.cairographics.org/archives/cairo/2004-April/001125.html<br />
<br />
<source lang=diff><br />
--- courier-authlib-0.61.0/makedat/Makefile.in 2008-05-24 16:21:09.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/makedat/Makefile.in 2008-10-21 16:02:38.709166700 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-authlib-0.61.0/Makefile.in 2008-07-12 21:41:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/Makefile.in 2008-10-23 22:59:03.843750000 +0200<br />
@@ -213,9 +213,10 @@<br />
LTCOMPILE = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
--mode=compile $(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) \<br />
$(AM_CPPFLAGS) $(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS)<br />
-CCLD = $(CC)<br />
+CCLD = $(CC) -no-undefined<br />
+CCLDEXE = $(CC)<br />
LINK = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
- --mode=link $(CCLD) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
+ --mode=link $(CCLDEXE) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
$(LDFLAGS) -o $@<br />
SOURCES = $(libauthcustom_la_SOURCES) $(libauthldap_la_SOURCES) \<br />
$(libauthmysql_la_SOURCES) $(libauthpam_la_SOURCES) \<br />
@@ -452,9 +453,9 @@<br />
README.authdebug.html<br />
<br />
DISTCLEANFILES = dbobj.config README_authlib.html<br />
-commonlibdep = libcourierauthcommon.la<br />
+commonlibdep = libcourierauthcommon.la libcourierauth.la<br />
commonldflags = -module -rpath $(pkglibdir) -export-symbols-regex 'courier_auth.*_init' -avoid-version<br />
-commonlibadd = libcourierauthcommon.la<br />
+commonlibadd = libcourierauthcommon.la libcourierauth.la<br />
libcourierauthcommon_t = @CRYPTLIBS@<br />
libcourierauthcommon_la_SOURCES = \<br />
auth.h courierauth.h \<br />
--- courier-authlib-0.61.0/authdaemond.in 2005-07-05 14:25:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/authdaemond.in 2008-10-25 12:03:32.140625000 +0200<br />
@@ -15,4 +15,10 @@<br />
set -a<br />
. @authdaemonrc@<br />
<br />
+# Some shared libraries (DLL) are installed in @libdir@/bin<br />
+# instead of @libdir@/@PACKAGE@<br />
+# Setting LD_LIBRARY_PATH at runtime or LR_RUN_PATH at linktime doesn't<br />
+# work in cygwin, only setting PATH works. <br />
+export PATH=$PATH:@libdir@/bin<br />
+<br />
exec ${sbindir}/courierlogger -pid=@authdaemonvar@/pid $LOGGEROPTS -$1 @libexecdir@/courier-authlib/authdaemond<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-authlib-0.61.0-cygwin.patch<br />
<br />
Configure the package without most authentication modules, keeping only ''userdb''.<br />
<br />
'''Note''': replace ''mailuser'' by an existing user name (in your /etc/passwd file). I used my own username.<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait --without-authpam --without-authldap --without-authpwd \<br />
--without-authshadow --without-authcustom --without-authpipe --without-authmysql --without-authpgsql --with-mailuser=mailuser \<br />
--with-mailgroup=mkgroup-l-d<br />
<br />
Take a long pause... and when ready execute the following command.<br />
<br />
$ make<br />
<br />
Take again a long pause... then check the result and install the libraries<br />
<br />
$ make check<br />
$ make install<br />
<br />
==Configuration==<br />
<br />
Create authdaemonrc file: /usr/local/etc/authlib/authdaemonrc<br />
<br />
$ cp /usr/local/etc/authlib/authdaemonrc.dist /usr/local/etc/authlib/authdaemonrc<br />
<br />
Change number of daemons (I use only one) and enable DEBUG_LOGIN<br />
<br />
<source lang=text><br />
# The number of daemon processes that are started.<br />
daemons=1<br />
<br />
# DEBUG_LOGIN=2 - turn on debugging + log passwords too<br />
DEBUG_LOGIN=2<br />
</source><br />
<br />
See http://www.courier-mta.org/authlib/README.authdebug.html for details.<br />
<br />
==IMAP accounts==<br />
<br />
User accounts and settings are managed by ''userdb''. See [http://linux.die.net/man/8/makeuserdb makeuserdb] man page for details, or used the freshly new install man page - man makeuserdb<br />
<br />
Assuming ''username'' is your username, 1001 and 10545 are respectively the UID and GID of an existing user (part of your /etc/passwd and /etc/group). I use my own UID and GID. Create the mailuser home directory, if required, and create Maildir folder.<br />
<br />
$ mkdir -p /home/username<br />
$ cd /home/username<br />
$ /usr/lib/courier-imap/bin/maildirmake Maildir<br />
<br />
Create the userdb text file /usr/local/etc/authlib/userdb<br />
<br />
$ touch /usr/local/etc/authlib/userdb<br />
$ chmod 700 /usr/local/etc/authlib/userdb<br />
<br />
Edit /usr/local/etc/authlib/userdb, one line per account<br />
<br />
<source lang=text><br />
username[TAB]uid=1001|gid=10111|home=/home/username|mail=/home/username/Maildir|systempw=XXXXXX<br />
</source><br />
<br />
where XXXXXX is the encrypted password created with<br />
<br />
$ /usr/local/sbin/userdbpw.exe<br />
<br />
Create the (binary) userdb<br />
<br />
$ /usr/local/sbin/makeuserdb<br />
<br />
You should now have the following files created:<br />
<br />
* /usr/local/etc/authlib/userdb.dat<br />
* /usr/local/etc/authlib/userdbshadow.dat<br />
<br />
==Running==<br />
<br />
Install and configure syslogd. Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install inetutils (contains syslogd). Configure syslogd with the following command. It will create the /etc/syslogd.conf file and install a windows service using cygrunsrv<br />
<br />
$ syslogd-config<br />
<br />
Start the authlib and imap daemons with the following command:<br />
<br />
$ /usr/local/sbin/authdaemon start<br />
<br />
Stop the daemons with the following command:<br />
<br />
$ /usr/local/sbin/authdaemon stop<br />
<br />
You'll find log messages in /var/log/messages (default target file as specified in /etc/syslogd.conf)<br />
<br />
==Testing authlib==<br />
<br />
$ /usr/local/sbin/authtest username CCCCCC<br />
Authentication succeeded.<br />
<br />
Authenticated: username (uid 1001, gid 10545)<br />
Home Directory: /home/username<br />
Maildir: /home/username/Maildir<br />
Quota: (none)<br />
Encrypted Password: XXXXXX<br />
Cleartext Password: CCCCCC<br />
Options: (none)<br />
<br />
where username is you user name and XXXXXX is you encrypted password as provided in ''/usr/local/etc/authlib/userdb''. CCCCCC is your password in clear.<br />
<br />
==Troubleshooting==<br />
<br />
Should you have a doubt on the execution of a command (ie: no output) you can check if the application is able to load required DLL. This error is not reported. Using ''strace'', windows will complain about DLL not found, if any. To solve this problem you may need to add some path in your PATH. For example, in order to test authlib with authtest:<br />
<br />
$ strace /usr/local/sbin/authtest<br />
# This will open a dialog box to complain about DLL.<br />
$ export PATH=$PATH:/usr/local/lib/bin<br />
$ /usr/local/sbin/authtest ausername<br />
<br />
==Courier Authentication Config==<br />
<br />
$ /usr/local/bin/courierauthconfig.exe --version<br />
$ /usr/local/bin/courierauthconfig.exe --ldflags<br />
$ /usr/local/bin/courierauthconfig.exe --cppflags<br />
$ /usr/local/bin/courierauthconfig.exe --configfiles<br />
<br />
=Courier-IMAP=<br />
==Compilation and installation==<br />
<br />
Download and untar package [http://www.courier-mta.org/download.php#imap courier-imap] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-imap-4.4.1.tar.bz2 4.4.1.20080920]<br />
<br />
Apply the [{{#file:courrier-imap-4.4.1-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# incorrect usage of EXTEXT in main ''Makefile''<br />
# remove usage of /usr/lib/env in start/stop script (/usr/lib/env does not seem to work under Cygwin)<br />
<br />
<source lang=diff><br />
--- courier-imap-4.4.1.20080920/makedat/Makefile.in 2008-08-24 19:52:51.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/makedat/Makefile.in 2008-10-21 20:43:27.500000000 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-imap-4.4.1.20080920/Makefile.in 2008-09-20 14:48:46.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/Makefile.in 2008-10-21 20:59:45.156250000 +0200<br />
@@ -247,9 +247,9 @@<br />
CLEANFILES = $(databin_SCRIPTS) $(man_MANS) $(sysconf_DATA) $(sbin_SCRIPTS)<br />
databindir = $(datadir)<br />
databin_SCRIPTS = mkimapdcert mkpop3dcert<br />
-binPROGRAMS = imapd pop3d maildirmake maildiracl deliverquota maildirkw<br />
-sbinPROGRAMS = imaplogin pop3login<br />
-libexecPROGRAMS = makedatprog couriertcpd<br />
+binPROGRAMS = imapd$(EXEEXT) pop3d$(EXEEXT) maildirmake$(EXEEXT) maildiracl$(EXEEXT) deliverquota$(EXEEXT) maildirkw$(EXEEXT)<br />
+sbinPROGRAMS = imaplogin$(EXEEXT) pop3login$(EXEEXT)<br />
+libexecPROGRAMS = makedatprog$(EXEEXT) couriertcpd$(EXEEXT)<br />
bin_PROGRAMS = @binPROGRAMS_exec@<br />
sbin_PROGRAMS = @sbinPROGRAMS_exec@<br />
libexec_PROGRAMS = @libexecPROGRAMS_exec@<br />
--- courier-imap-4.4.1.20080920/imapd.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/imapd.rc.in 2008-10-26 10:17:51.359375000 +0100<br />
@@ -22,6 +22,15 @@<br />
exit 1<br />
fi<br />
<br />
+# Location for some shared libraries (cygcourierauth*.dll) from authlib<br />
+AUTHLIBDIR=/usr/local<br />
+if test ! -f $AUTHLIBDIR/lib/bin/cygcourierauth.dll<br />
+then<br />
+ echo "$AUTHLIBDIR/lib/bin/cygcourierauth.dll not found."<br />
+ exit 1<br />
+fi<br />
+export PATH=$PATH:/usr/local/lib/bin<br />
+<br />
TLS_CACHEFILE=""<br />
. @sysconfdir@/imapd-ssl<br />
. @sysconfdir@/imapd<br />
@@ -35,7 +44,7 @@<br />
<br />
umask $IMAP_UMASK<br />
@ULIMIT@ $IMAP_ULIMITD<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
--- courier-imap-4.4.1.20080920/pop3d.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/pop3d.rc.in 2008-10-26 10:18:02.187500000 +0100<br />
@@ -22,12 +22,21 @@<br />
exit 1<br />
fi<br />
<br />
+# Location for some shared libraries (cygcourierauth*.dll) from authlib<br />
+AUTHLIBDIR=/usr/local<br />
+if test ! -f $AUTHLIBDIR/lib/bin/cygcourierauth.dll<br />
+then<br />
+ echo "$AUTHLIBDIR/lib/bin/cygcourierauth.dll not found."<br />
+ exit 1<br />
+fi<br />
+export PATH=$PATH:/usr/local/lib/bin<br />
+<br />
. @sysconfdir@/pop3d-ssl<br />
. @sysconfdir@/pop3d<br />
<br />
case $1 in<br />
start)<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-imap-4.4.1-cygwin.patch<br />
<br />
Configure the package<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait<br />
<br />
Take a walk... and when ready execute the following command to build the package.<br />
<br />
$ make<br />
<br />
Time to go for some coffee... and then install the package with the usual<br />
<br />
$ make install<br />
$ make install-configure<br />
<br />
==Configuration==<br />
<br />
Setup courier-imap: $prefix/etc/imapd (where $prefix=/usr/lib/courier-imap)<br />
<br />
Set ADDRESS to a valid value (0 or 127.0.0.1) and change IMAP_ULIMITD to a value accepted by the command ulimit. I simply used the existing value returned by<br />
<br />
$ ulimit -v<br />
<br />
==Running==<br />
<br />
Syslogd service and authdaemond should be started. See above.<br />
<br />
Start the authlib and imap daemons with the following command:<br />
<br />
$ /usr/lib/courier-imap/libexec/imapd.rc start<br />
<br />
Stop the daemons with the following command:<br />
<br />
$ /usr/lib/courier-imap/libexec/imapd.rc stop<br />
<br />
You'll find log messages in /var/log/messages (default target file as specified in /etc/syslogd.conf)<br />
<br />
==Testing==<br />
When authdaemon and imapd are running you can do a simple login test:<br />
<br />
$ telnet localhost 143<br />
<br />
and type the login command<br />
<br />
a login <username> <password><br />
<br />
the server should reply<br />
<br />
a OK LOGIN Ok.<br />
<br />
to which you can reply with a logout<br />
<br />
a logout<br />
<br />
the session is terminated by the server<br />
<br />
* BYE Courier-IMAP server shutting down<br />
a OK LOGOUT completed<br />
Connection closed by foreign host.<br />
<br />
==All in one==<br />
If everything works fine you can use the following [{{#file:imapd}} startup script] to launch or stop imap and authlib daemons. It can be saved in /usr/local/sbin.<br />
<br />
<source lang=bash><br />
#! /bin/sh<br />
#<br />
# Courier imap daemon startup script.<br />
<br />
authlib=/usr/local/sbin/authdaemond<br />
imapd=/usr/lib/courier-imap/libexec/imapd.rc<br />
<br />
test ! -f $authlib && echo "File not found: $authlib" && exit 1;<br />
test ! -f $imapd && echo "File not found: $imapd" && exit 1;<br />
<br />
case $1 in<br />
start)<br />
$authlib start<br />
$imapd start<br />
;;<br />
stop)<br />
$imapd stop<br />
$authlib stop<br />
;;<br />
*)<br />
echo "Usage: $0 <start|stop>"<br />
;;<br />
esac<br />
</source><br />
<br />
==Cygwin service==<br />
<br />
TODO<br />
<br />
=Maildir=<br />
'''maildirmake''' is part of the courier-imap package<br />
<br />
$ /usr/lib/courier-imap/bin/maildirmake</div>Twalranthttps://wiki.yobi.be/index.php?title=Courier-Cygwin&diff=5239Courier-Cygwin2008-10-26T10:16:15Z<p>Twalrant: </p>
<hr />
<div>=Pre-requisite=<br />
<br />
Courier-IMAP requires the installation of the [http://www.courier-mta.org/authlib/ Courier Authentication Library] and the following cygwin tools and packages<br />
<br />
* patch, tar, make, gcc<br />
* crypt<br />
* libgdbm-devel<br />
* libtool<br />
* inetutils<br />
* cygrunsrv<br />
<br />
Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install the required packages.<br />
<br />
=Courier Authentication Library=<br />
<br />
Installation of Courier Authentication Library using the module userdb to manage mail accounts. All other modules are disabled.<br />
<br />
==Compilation and installation==<br />
<br />
Download and untar [http://www.courier-mta.org/download.php#authlib courier-authlib] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-authlib-0.61.0.tar.bz2 0.61.0]<br />
<br />
Apply the [{{#file:courrier-authlib-0.61.0-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# add libtool flag (-no-undefined) required for DLL creation<br />
# add missing dependencies<br />
# add PATH in start script to access new DLL (installed in a different directory)<br />
<br />
Solution source: http://lists.cairographics.org/archives/cairo/2004-April/001125.html<br />
<br />
<source lang=diff><br />
--- courier-authlib-0.61.0/makedat/Makefile.in 2008-05-24 16:21:09.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/makedat/Makefile.in 2008-10-21 16:02:38.709166700 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-authlib-0.61.0/Makefile.in 2008-07-12 21:41:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/Makefile.in 2008-10-23 22:59:03.843750000 +0200<br />
@@ -213,9 +213,10 @@<br />
LTCOMPILE = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
--mode=compile $(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) \<br />
$(AM_CPPFLAGS) $(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS)<br />
-CCLD = $(CC)<br />
+CCLD = $(CC) -no-undefined<br />
+CCLDEXE = $(CC)<br />
LINK = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
- --mode=link $(CCLD) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
+ --mode=link $(CCLDEXE) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
$(LDFLAGS) -o $@<br />
SOURCES = $(libauthcustom_la_SOURCES) $(libauthldap_la_SOURCES) \<br />
$(libauthmysql_la_SOURCES) $(libauthpam_la_SOURCES) \<br />
@@ -452,9 +453,9 @@<br />
README.authdebug.html<br />
<br />
DISTCLEANFILES = dbobj.config README_authlib.html<br />
-commonlibdep = libcourierauthcommon.la<br />
+commonlibdep = libcourierauthcommon.la libcourierauth.la<br />
commonldflags = -module -rpath $(pkglibdir) -export-symbols-regex 'courier_auth.*_init' -avoid-version<br />
-commonlibadd = libcourierauthcommon.la<br />
+commonlibadd = libcourierauthcommon.la libcourierauth.la<br />
libcourierauthcommon_t = @CRYPTLIBS@<br />
libcourierauthcommon_la_SOURCES = \<br />
auth.h courierauth.h \<br />
--- courier-authlib-0.61.0/authdaemond.in 2005-07-05 14:25:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/authdaemond.in 2008-10-25 12:03:32.140625000 +0200<br />
@@ -15,4 +15,10 @@<br />
set -a<br />
. @authdaemonrc@<br />
<br />
+# Some shared libraries (DLL) are installed in @libdir@/bin<br />
+# instead of @libdir@/@PACKAGE@<br />
+# Setting LD_LIBRARY_PATH at runtime or LR_RUN_PATH at linktime doesn't<br />
+# work in cygwin, only setting PATH works. <br />
+export PATH=$PATH:@libdir@/bin<br />
+<br />
exec ${sbindir}/courierlogger -pid=@authdaemonvar@/pid $LOGGEROPTS -$1 @libexecdir@/courier-authlib/authdaemond<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-authlib-0.61.0-cygwin.patch<br />
<br />
Configure the package without most authentication modules, keeping only ''userdb''.<br />
<br />
'''Note''': replace ''mailuser'' by an existing user name (in your /etc/passwd file). I used my own username.<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait --without-authpam --without-authldap --without-authpwd \<br />
--without-authshadow --without-authcustom --without-authpipe --without-authmysql --without-authpgsql --with-mailuser=mailuser \<br />
--with-mailgroup=mkgroup-l-d<br />
<br />
Take a long pause... and when ready execute the following command.<br />
<br />
$ make<br />
<br />
Take again a long pause... then check the result and install the libraries<br />
<br />
$ make check<br />
$ make install<br />
<br />
==Configuration==<br />
<br />
Create authdaemonrc file: /usr/local/etc/authlib/authdaemonrc<br />
<br />
$ cp /usr/local/etc/authlib/authdaemonrc.dist /usr/local/etc/authlib/authdaemonrc<br />
<br />
Change number of daemons (I use only one) and enable DEBUG_LOGIN<br />
<br />
<source lang=text><br />
# The number of daemon processes that are started.<br />
daemons=1<br />
<br />
# DEBUG_LOGIN=2 - turn on debugging + log passwords too<br />
DEBUG_LOGIN=2<br />
</source><br />
<br />
See http://www.courier-mta.org/authlib/README.authdebug.html for details.<br />
<br />
==IMAP accounts==<br />
<br />
User accounts and settings are managed by ''userdb''. See [http://linux.die.net/man/8/makeuserdb makeuserdb] man page for details, or used the freshly new install man page - man makeuserdb<br />
<br />
Assuming ''username'' is your username, 1001 and 10545 are respectively the UID and GID of an existing user (part of your /etc/passwd and /etc/group). I use my own UID and GID. Create the mailuser home directory, if required, and create Maildir folder.<br />
<br />
$ mkdir -p /home/username<br />
$ cd /home/username<br />
$ /usr/lib/courier-imap/bin/maildirmake Maildir<br />
<br />
Create the userdb text file /usr/local/etc/authlib/userdb<br />
<br />
$ touch /usr/local/etc/authlib/userdb<br />
$ chmod 700 /usr/local/etc/authlib/userdb<br />
<br />
Edit /usr/local/etc/authlib/userdb, one line per account<br />
<br />
<source lang=text><br />
username[TAB]uid=1001|gid=10111|home=/home/username|mail=/home/username/Maildir|systempw=XXXXXX<br />
</source><br />
<br />
where XXXXXX is the encrypted password created with<br />
<br />
$ /usr/local/sbin/userdbpw.exe<br />
<br />
Create the (binary) userdb<br />
<br />
$ /usr/local/sbin/makeuserdb<br />
<br />
You should now have the following files created:<br />
<br />
* /usr/local/etc/authlib/userdb.dat<br />
* /usr/local/etc/authlib/userdbshadow.dat<br />
<br />
==Running==<br />
<br />
Install and configure syslogd. Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install inetutils (contains syslogd). Configure syslogd with the following command. It will create the /etc/syslogd.conf file and install a windows service using cygrunsrv<br />
<br />
$ syslogd-config<br />
<br />
Start the authlib and imap daemons with the following command:<br />
<br />
$ /usr/local/sbin/authdaemon start<br />
<br />
Stop the daemons with the following command:<br />
<br />
$ /usr/local/sbin/authdaemon stop<br />
<br />
You'll find log messages in /var/log/messages (default target file as specified in /etc/syslogd.conf)<br />
<br />
==Testing authlib==<br />
<br />
$ /usr/local/sbin/authtest username CCCCCC<br />
Authentication succeeded.<br />
<br />
Authenticated: username (uid 1001, gid 10545)<br />
Home Directory: /home/username<br />
Maildir: /home/username/Maildir<br />
Quota: (none)<br />
Encrypted Password: XXXXXX<br />
Cleartext Password: CCCCCC<br />
Options: (none)<br />
<br />
where username is you user name and XXXXXX is you encrypted password as provided in ''/usr/local/etc/authlib/userdb''. CCCCCC is your password in clear.<br />
<br />
==Troubleshooting==<br />
<br />
Should you have a doubt on the execution of a command (ie: no output) you can check if the application is able to load required DLL. This error is not reported. Using ''strace'', windows will complain about DLL not found, if any. To solve this problem you may need to add some path in your PATH. For example, in order to test authlib with authtest:<br />
<br />
$ strace /usr/local/sbin/authtest<br />
# This will open a dialog box to complain about DLL.<br />
$ export PATH=$PATH:/usr/local/lib/bin<br />
$ /usr/local/sbin/authtest ausername<br />
<br />
==Courier Authentication Config==<br />
<br />
$ /usr/local/bin/courierauthconfig.exe --version<br />
$ /usr/local/bin/courierauthconfig.exe --ldflags<br />
$ /usr/local/bin/courierauthconfig.exe --cppflags<br />
$ /usr/local/bin/courierauthconfig.exe --configfiles<br />
<br />
=Courier-IMAP=<br />
==Compilation and installation==<br />
<br />
Download and untar package [http://www.courier-mta.org/download.php#imap courier-imap] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-imap-4.4.1.tar.bz2 4.4.1.20080920]<br />
<br />
Apply the [{{#file:courrier-imap-4.4.1-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# incorrect usage of EXTEXT in main ''Makefile''<br />
# remove usage of /usr/lib/env in start/stop script (/usr/lib/env does not seem to work under Cygwin)<br />
<br />
<source lang=diff><br />
--- courier-imap-4.4.1.20080920/makedat/Makefile.in 2008-08-24 19:52:51.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/makedat/Makefile.in 2008-10-21 20:43:27.500000000 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-imap-4.4.1.20080920/Makefile.in 2008-09-20 14:48:46.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/Makefile.in 2008-10-21 20:59:45.156250000 +0200<br />
@@ -247,9 +247,9 @@<br />
CLEANFILES = $(databin_SCRIPTS) $(man_MANS) $(sysconf_DATA) $(sbin_SCRIPTS)<br />
databindir = $(datadir)<br />
databin_SCRIPTS = mkimapdcert mkpop3dcert<br />
-binPROGRAMS = imapd pop3d maildirmake maildiracl deliverquota maildirkw<br />
-sbinPROGRAMS = imaplogin pop3login<br />
-libexecPROGRAMS = makedatprog couriertcpd<br />
+binPROGRAMS = imapd$(EXEEXT) pop3d$(EXEEXT) maildirmake$(EXEEXT) maildiracl$(EXEEXT) deliverquota$(EXEEXT) maildirkw$(EXEEXT)<br />
+sbinPROGRAMS = imaplogin$(EXEEXT) pop3login$(EXEEXT)<br />
+libexecPROGRAMS = makedatprog$(EXEEXT) couriertcpd$(EXEEXT)<br />
bin_PROGRAMS = @binPROGRAMS_exec@<br />
sbin_PROGRAMS = @sbinPROGRAMS_exec@<br />
libexec_PROGRAMS = @libexecPROGRAMS_exec@<br />
--- courier-imap-4.4.1.20080920/imapd.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/imapd.rc.in 2008-10-26 10:17:51.359375000 +0100<br />
@@ -22,6 +22,15 @@<br />
exit 1<br />
fi<br />
<br />
+# Location for some shared libraries (cygcourierauth*.dll) from authlib<br />
+AUTHLIBDIR=/usr/local<br />
+if test ! -f $AUTHLIBDIR/lib/bin/cygcourierauth.dll<br />
+then<br />
+ echo "$AUTHLIBDIR/lib/bin/cygcourierauth.dll not found."<br />
+ exit 1<br />
+fi<br />
+export PATH=$PATH:/usr/local/lib/bin<br />
+<br />
TLS_CACHEFILE=""<br />
. @sysconfdir@/imapd-ssl<br />
. @sysconfdir@/imapd<br />
@@ -35,7 +44,7 @@<br />
<br />
umask $IMAP_UMASK<br />
@ULIMIT@ $IMAP_ULIMITD<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
--- courier-imap-4.4.1.20080920/pop3d.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/pop3d.rc.in 2008-10-26 10:18:02.187500000 +0100<br />
@@ -22,12 +22,21 @@<br />
exit 1<br />
fi<br />
<br />
+# Location for some shared libraries (cygcourierauth*.dll) from authlib<br />
+AUTHLIBDIR=/usr/local<br />
+if test ! -f $AUTHLIBDIR/lib/bin/cygcourierauth.dll<br />
+then<br />
+ echo "$AUTHLIBDIR/lib/bin/cygcourierauth.dll not found."<br />
+ exit 1<br />
+fi<br />
+export PATH=$PATH:/usr/local/lib/bin<br />
+<br />
. @sysconfdir@/pop3d-ssl<br />
. @sysconfdir@/pop3d<br />
<br />
case $1 in<br />
start)<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-imap-4.4.1-cygwin.patch<br />
<br />
Configure the package<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait<br />
<br />
Take a walk... and when ready execute the following command to build the package.<br />
<br />
$ make<br />
<br />
Time to go for some coffee... and then install the package with the usual<br />
<br />
$ make install<br />
$ make install-configure<br />
<br />
==Configuration==<br />
<br />
Setup courier-imap: $prefix/etc/imapd (where $prefix=/usr/lib/courier-imap)<br />
<br />
Set ADDRESS to a valid value (0 or 127.0.0.1) and change IMAP_ULIMITD to a value accepted by the command ulimit. I simply used the existing value returned by<br />
<br />
$ ulimit -v<br />
<br />
==Running==<br />
<br />
Syslogd service and authdaemond should be started. See above.<br />
<br />
Start the authlib and imap daemons with the following command:<br />
<br />
$ /usr/lib/courier-imap/libexec/imapd.rc start<br />
<br />
Stop the daemons with the following command:<br />
<br />
$ /usr/lib/courier-imap/libexec/imapd.rc stop<br />
<br />
You'll find log messages in /var/log/messages (default target file as specified in /etc/syslogd.conf)<br />
<br />
==All in one==<br />
If everything works fine you can use the following [{{#file:imapd}} startup script] to launch or stop imap and authlib daemons. It can be saved in /usr/local/sbin.<br />
<br />
<source lang=bash><br />
#! /bin/sh<br />
#<br />
# Courier imap daemon startup script.<br />
<br />
authlib=/usr/local/sbin/authdaemond<br />
imapd=/usr/lib/courier-imap/libexec/imapd.rc<br />
<br />
test ! -f $authlib && echo "File not found: $authlib" && exit 1;<br />
test ! -f $imapd && echo "File not found: $imapd" && exit 1;<br />
<br />
case $1 in<br />
start)<br />
$authlib start<br />
$imapd start<br />
;;<br />
stop)<br />
$imapd stop<br />
$authlib stop<br />
;;<br />
*)<br />
echo "Usage: $0 <start|stop>"<br />
;;<br />
esac<br />
</source><br />
<br />
==Cygwin service==<br />
<br />
TODO<br />
<br />
=Maildir=<br />
'''maildirmake''' is part of the courier-imap package<br />
<br />
$ /usr/lib/courier-imap/bin/maildirmake</div>Twalranthttps://wiki.yobi.be/index.php?title=Courier-Cygwin&diff=5238Courier-Cygwin2008-10-26T10:15:32Z<p>Twalrant: /* Running */</p>
<hr />
<div>=Pre-requisite=<br />
<br />
Courier-IMAP requires the installation of the [http://www.courier-mta.org/authlib/ Courier Authentication Library] and the following cygwin tools and packages<br />
<br />
* patch, tar, make, gcc<br />
* crypt<br />
* libgdbm-devel<br />
* libtool<br />
* inetutils<br />
* cygrunsrv<br />
<br />
Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install the required packages.<br />
<br />
=Courier Authentication Library=<br />
<br />
Installation of Courier Authentication Library using the module userdb to manage mail accounts. All other modules are disabled.<br />
<br />
==Compilation and installation==<br />
<br />
Download and untar [http://www.courier-mta.org/download.php#authlib courier-authlib] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-authlib-0.61.0.tar.bz2 0.61.0]<br />
<br />
Apply the [{{#file:courrier-authlib-0.61.0-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# add libtool flag (-no-undefined) required for DLL creation<br />
# add missing dependencies<br />
# add PATH in start script to access new DLL (installed in a different directory)<br />
<br />
Solution source: http://lists.cairographics.org/archives/cairo/2004-April/001125.html<br />
<br />
<source lang=diff><br />
--- courier-authlib-0.61.0/makedat/Makefile.in 2008-05-24 16:21:09.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/makedat/Makefile.in 2008-10-21 16:02:38.709166700 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-authlib-0.61.0/Makefile.in 2008-07-12 21:41:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/Makefile.in 2008-10-23 22:59:03.843750000 +0200<br />
@@ -213,9 +213,10 @@<br />
LTCOMPILE = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
--mode=compile $(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) \<br />
$(AM_CPPFLAGS) $(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS)<br />
-CCLD = $(CC)<br />
+CCLD = $(CC) -no-undefined<br />
+CCLDEXE = $(CC)<br />
LINK = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
- --mode=link $(CCLD) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
+ --mode=link $(CCLDEXE) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
$(LDFLAGS) -o $@<br />
SOURCES = $(libauthcustom_la_SOURCES) $(libauthldap_la_SOURCES) \<br />
$(libauthmysql_la_SOURCES) $(libauthpam_la_SOURCES) \<br />
@@ -452,9 +453,9 @@<br />
README.authdebug.html<br />
<br />
DISTCLEANFILES = dbobj.config README_authlib.html<br />
-commonlibdep = libcourierauthcommon.la<br />
+commonlibdep = libcourierauthcommon.la libcourierauth.la<br />
commonldflags = -module -rpath $(pkglibdir) -export-symbols-regex 'courier_auth.*_init' -avoid-version<br />
-commonlibadd = libcourierauthcommon.la<br />
+commonlibadd = libcourierauthcommon.la libcourierauth.la<br />
libcourierauthcommon_t = @CRYPTLIBS@<br />
libcourierauthcommon_la_SOURCES = \<br />
auth.h courierauth.h \<br />
--- courier-authlib-0.61.0/authdaemond.in 2005-07-05 14:25:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/authdaemond.in 2008-10-25 12:03:32.140625000 +0200<br />
@@ -15,4 +15,10 @@<br />
set -a<br />
. @authdaemonrc@<br />
<br />
+# Some shared libraries (DLL) are installed in @libdir@/bin<br />
+# instead of @libdir@/@PACKAGE@<br />
+# Setting LD_LIBRARY_PATH at runtime or LR_RUN_PATH at linktime doesn't<br />
+# work in cygwin, only setting PATH works. <br />
+export PATH=$PATH:@libdir@/bin<br />
+<br />
exec ${sbindir}/courierlogger -pid=@authdaemonvar@/pid $LOGGEROPTS -$1 @libexecdir@/courier-authlib/authdaemond<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-authlib-0.61.0-cygwin.patch<br />
<br />
Configure the package without most authentication modules, keeping only ''userdb''.<br />
<br />
'''Note''': replace ''mailuser'' by an existing user name (in your /etc/passwd file). I used my own username.<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait --without-authpam --without-authldap --without-authpwd \<br />
--without-authshadow --without-authcustom --without-authpipe --without-authmysql --without-authpgsql --with-mailuser=mailuser \<br />
--with-mailgroup=mkgroup-l-d<br />
<br />
Take a long pause... and when ready execute the following command.<br />
<br />
$ make<br />
<br />
Take again a long pause... then check the result and install the libraries<br />
<br />
$ make check<br />
$ make install<br />
<br />
==Configuration==<br />
<br />
Create authdaemonrc file: /usr/local/etc/authlib/authdaemonrc<br />
<br />
$ cp /usr/local/etc/authlib/authdaemonrc.dist /usr/local/etc/authlib/authdaemonrc<br />
<br />
Change number of daemons (I use only one) and enable DEBUG_LOGIN<br />
<br />
<source lang=text><br />
# The number of daemon processes that are started.<br />
daemons=1<br />
<br />
# DEBUG_LOGIN=2 - turn on debugging + log passwords too<br />
DEBUG_LOGIN=2<br />
</source><br />
<br />
See http://www.courier-mta.org/authlib/README.authdebug.html for details.<br />
<br />
==IMAP accounts==<br />
<br />
User accounts and settings are managed by ''userdb''. See [http://linux.die.net/man/8/makeuserdb makeuserdb] man page for details, or used the freshly new install man page - man makeuserdb<br />
<br />
Assuming ''username'' is your username, 1001 and 10545 are respectively the UID and GID of an existing user (part of your /etc/passwd and /etc/group). I use my own UID and GID. Create the mailuser home directory, if required, and create Maildir folder.<br />
<br />
$ mkdir -p /home/username<br />
$ cd /home/username<br />
$ /usr/lib/courier-imap/bin/maildirmake Maildir<br />
<br />
Create the userdb text file /usr/local/etc/authlib/userdb<br />
<br />
$ touch /usr/local/etc/authlib/userdb<br />
$ chmod 700 /usr/local/etc/authlib/userdb<br />
<br />
Edit /usr/local/etc/authlib/userdb, one line per account<br />
<br />
<source lang=text><br />
username[TAB]uid=1001|gid=10111|home=/home/username|mail=/home/username/Maildir|systempw=XXXXXX<br />
</source><br />
<br />
where XXXXXX is the encrypted password created with<br />
<br />
$ /usr/local/sbin/userdbpw.exe<br />
<br />
Create the (binary) userdb<br />
<br />
$ /usr/local/sbin/makeuserdb<br />
<br />
You should now have the following files created:<br />
<br />
* /usr/local/etc/authlib/userdb.dat<br />
* /usr/local/etc/authlib/userdbshadow.dat<br />
<br />
==Running==<br />
<br />
Install and configure syslogd. Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install inetutils (contains syslogd). Configure syslogd with the following command. It will create the /etc/syslogd.conf file and install a windows service using cygrunsrv<br />
<br />
$ syslogd-config<br />
<br />
Start the authlib and imap daemons with the following command:<br />
<br />
$ /usr/local/sbin/authdaemon start<br />
<br />
Stop the daemons with the following command:<br />
<br />
$ /usr/local/sbin/authdaemon stop<br />
<br />
You'll find log messages in /var/log/messages (default target file as specified in /etc/syslogd.conf)<br />
<br />
==Testing authlib==<br />
<br />
$ /usr/local/sbin/authtest username CCCCCC<br />
Authentication succeeded.<br />
<br />
Authenticated: username (uid 1001, gid 10545)<br />
Home Directory: /home/username<br />
Maildir: /home/username/Maildir<br />
Quota: (none)<br />
Encrypted Password: XXXXXX<br />
Cleartext Password: CCCCCC<br />
Options: (none)<br />
<br />
where username is you user name and XXXXXX is you encrypted password as provided in ''/usr/local/etc/authlib/userdb''. CCCCCC is your password in clear.<br />
<br />
==Troubleshooting==<br />
<br />
Should you have a doubt on the execution of a command (ie: no output) you can check if the application is able to load required DLL. This error is not reported. Using ''strace'', windows will complain about DLL not found, if any. To solve this problem you may need to add some path in your PATH. For example, in order to test authlib with authtest:<br />
<br />
$ strace /usr/local/sbin/authtest<br />
# This will open a dialog box to complain about DLL.<br />
$ export PATH=$PATH:/usr/local/lib/bin<br />
$ /usr/local/sbin/authtest ausername<br />
<br />
==Courier Authentication Config==<br />
<br />
$ /usr/local/bin/courierauthconfig.exe --version<br />
$ /usr/local/bin/courierauthconfig.exe --ldflags<br />
$ /usr/local/bin/courierauthconfig.exe --cppflags<br />
$ /usr/local/bin/courierauthconfig.exe --configfiles<br />
<br />
=Courier-IMAP=<br />
==Compilation and installation==<br />
<br />
Download and untar package [http://www.courier-mta.org/download.php#imap courier-imap] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-imap-4.4.1.tar.bz2 4.4.1.20080920]<br />
<br />
Apply the [{{#file:courrier-imap-4.4.1-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# incorrect usage of EXTEXT in main ''Makefile''<br />
# remove usage of /usr/lib/env in start/stop script (/usr/lib/env does not seem to work under Cygwin)<br />
<br />
<source lang=diff><br />
--- courier-imap-4.4.1.20080920/makedat/Makefile.in 2008-08-24 19:52:51.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/makedat/Makefile.in 2008-10-21 20:43:27.500000000 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-imap-4.4.1.20080920/Makefile.in 2008-09-20 14:48:46.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/Makefile.in 2008-10-21 20:59:45.156250000 +0200<br />
@@ -247,9 +247,9 @@<br />
CLEANFILES = $(databin_SCRIPTS) $(man_MANS) $(sysconf_DATA) $(sbin_SCRIPTS)<br />
databindir = $(datadir)<br />
databin_SCRIPTS = mkimapdcert mkpop3dcert<br />
-binPROGRAMS = imapd pop3d maildirmake maildiracl deliverquota maildirkw<br />
-sbinPROGRAMS = imaplogin pop3login<br />
-libexecPROGRAMS = makedatprog couriertcpd<br />
+binPROGRAMS = imapd$(EXEEXT) pop3d$(EXEEXT) maildirmake$(EXEEXT) maildiracl$(EXEEXT) deliverquota$(EXEEXT) maildirkw$(EXEEXT)<br />
+sbinPROGRAMS = imaplogin$(EXEEXT) pop3login$(EXEEXT)<br />
+libexecPROGRAMS = makedatprog$(EXEEXT) couriertcpd$(EXEEXT)<br />
bin_PROGRAMS = @binPROGRAMS_exec@<br />
sbin_PROGRAMS = @sbinPROGRAMS_exec@<br />
libexec_PROGRAMS = @libexecPROGRAMS_exec@<br />
--- courier-imap-4.4.1.20080920/imapd.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/imapd.rc.in 2008-10-26 10:17:51.359375000 +0100<br />
@@ -22,6 +22,15 @@<br />
exit 1<br />
fi<br />
<br />
+# Location for some shared libraries (cygcourierauth*.dll) from authlib<br />
+AUTHLIBDIR=/usr/local<br />
+if test ! -f $AUTHLIBDIR/lib/bin/cygcourierauth.dll<br />
+then<br />
+ echo "$AUTHLIBDIR/lib/bin/cygcourierauth.dll not found."<br />
+ exit 1<br />
+fi<br />
+export PATH=$PATH:/usr/local/lib/bin<br />
+<br />
TLS_CACHEFILE=""<br />
. @sysconfdir@/imapd-ssl<br />
. @sysconfdir@/imapd<br />
@@ -35,7 +44,7 @@<br />
<br />
umask $IMAP_UMASK<br />
@ULIMIT@ $IMAP_ULIMITD<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
--- courier-imap-4.4.1.20080920/pop3d.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/pop3d.rc.in 2008-10-26 10:18:02.187500000 +0100<br />
@@ -22,12 +22,21 @@<br />
exit 1<br />
fi<br />
<br />
+# Location for some shared libraries (cygcourierauth*.dll) from authlib<br />
+AUTHLIBDIR=/usr/local<br />
+if test ! -f $AUTHLIBDIR/lib/bin/cygcourierauth.dll<br />
+then<br />
+ echo "$AUTHLIBDIR/lib/bin/cygcourierauth.dll not found."<br />
+ exit 1<br />
+fi<br />
+export PATH=$PATH:/usr/local/lib/bin<br />
+<br />
. @sysconfdir@/pop3d-ssl<br />
. @sysconfdir@/pop3d<br />
<br />
case $1 in<br />
start)<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-imap-4.4.1-cygwin.patch<br />
<br />
Configure the package<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait<br />
<br />
Take a walk... and when ready execute the following command to build the package.<br />
<br />
$ make<br />
<br />
Time to go for some coffee... and then install the package with the usual<br />
<br />
$ make install<br />
$ make install-configure<br />
<br />
==Configuration==<br />
<br />
Setup courier-imap: $prefix/etc/imapd (where $prefix=/usr/lib/courier-imap)<br />
<br />
Set ADDRESS to a valid value (0 or 127.0.0.1) and change IMAP_ULIMITD to a value accepted by the command ulimit. I simply used the existing value returned by<br />
<br />
$ ulimit -v<br />
<br />
==Running==<br />
<br />
Syslogd service and authdaemond should be started. See above.<br />
<br />
Start the authlib and imap daemons with the following command:<br />
<br />
$ /usr/lib/courier-imap/libexec/imapd.rc start<br />
<br />
Stop the daemons with the following command:<br />
<br />
$ /usr/lib/courier-imap/libexec/imapd.rc stop<br />
<br />
==All in one==<br />
You'll find log messages in /var/log/messages (default target file as specified in /etc/syslogd.conf)<br />
<br />
If everything works fine you can use the following [{{#file:imapd}} startup script] to launch or stop imap and authlib daemons. It can be saved in /usr/local/sbin.<br />
<br />
<source lang=bash><br />
#! /bin/sh<br />
#<br />
# Courier imap daemon startup script.<br />
<br />
authlib=/usr/local/sbin/authdaemond<br />
imapd=/usr/lib/courier-imap/libexec/imapd.rc<br />
<br />
test ! -f $authlib && echo "File not found: $authlib" && exit 1;<br />
test ! -f $imapd && echo "File not found: $imapd" && exit 1;<br />
<br />
case $1 in<br />
start)<br />
$authlib start<br />
$imapd start<br />
;;<br />
stop)<br />
$imapd stop<br />
$authlib stop<br />
;;<br />
*)<br />
echo "Usage: $0 <start|stop>"<br />
;;<br />
esac<br />
</source><br />
<br />
==Cygwin service==<br />
<br />
TODO<br />
<br />
=Maildir=<br />
'''maildirmake''' is part of the courier-imap package<br />
<br />
$ /usr/lib/courier-imap/bin/maildirmake</div>Twalranthttps://wiki.yobi.be/index.php?title=Courier-Cygwin&diff=5237Courier-Cygwin2008-10-26T10:14:17Z<p>Twalrant: </p>
<hr />
<div>=Pre-requisite=<br />
<br />
Courier-IMAP requires the installation of the [http://www.courier-mta.org/authlib/ Courier Authentication Library] and the following cygwin tools and packages<br />
<br />
* patch, tar, make, gcc<br />
* crypt<br />
* libgdbm-devel<br />
* libtool<br />
* inetutils<br />
* cygrunsrv<br />
<br />
Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install the required packages.<br />
<br />
=Courier Authentication Library=<br />
<br />
Installation of Courier Authentication Library using the module userdb to manage mail accounts. All other modules are disabled.<br />
<br />
==Compilation and installation==<br />
<br />
Download and untar [http://www.courier-mta.org/download.php#authlib courier-authlib] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-authlib-0.61.0.tar.bz2 0.61.0]<br />
<br />
Apply the [{{#file:courrier-authlib-0.61.0-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# add libtool flag (-no-undefined) required for DLL creation<br />
# add missing dependencies<br />
# add PATH in start script to access new DLL (installed in a different directory)<br />
<br />
Solution source: http://lists.cairographics.org/archives/cairo/2004-April/001125.html<br />
<br />
<source lang=diff><br />
--- courier-authlib-0.61.0/makedat/Makefile.in 2008-05-24 16:21:09.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/makedat/Makefile.in 2008-10-21 16:02:38.709166700 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-authlib-0.61.0/Makefile.in 2008-07-12 21:41:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/Makefile.in 2008-10-23 22:59:03.843750000 +0200<br />
@@ -213,9 +213,10 @@<br />
LTCOMPILE = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
--mode=compile $(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) \<br />
$(AM_CPPFLAGS) $(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS)<br />
-CCLD = $(CC)<br />
+CCLD = $(CC) -no-undefined<br />
+CCLDEXE = $(CC)<br />
LINK = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
- --mode=link $(CCLD) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
+ --mode=link $(CCLDEXE) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
$(LDFLAGS) -o $@<br />
SOURCES = $(libauthcustom_la_SOURCES) $(libauthldap_la_SOURCES) \<br />
$(libauthmysql_la_SOURCES) $(libauthpam_la_SOURCES) \<br />
@@ -452,9 +453,9 @@<br />
README.authdebug.html<br />
<br />
DISTCLEANFILES = dbobj.config README_authlib.html<br />
-commonlibdep = libcourierauthcommon.la<br />
+commonlibdep = libcourierauthcommon.la libcourierauth.la<br />
commonldflags = -module -rpath $(pkglibdir) -export-symbols-regex 'courier_auth.*_init' -avoid-version<br />
-commonlibadd = libcourierauthcommon.la<br />
+commonlibadd = libcourierauthcommon.la libcourierauth.la<br />
libcourierauthcommon_t = @CRYPTLIBS@<br />
libcourierauthcommon_la_SOURCES = \<br />
auth.h courierauth.h \<br />
--- courier-authlib-0.61.0/authdaemond.in 2005-07-05 14:25:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/authdaemond.in 2008-10-25 12:03:32.140625000 +0200<br />
@@ -15,4 +15,10 @@<br />
set -a<br />
. @authdaemonrc@<br />
<br />
+# Some shared libraries (DLL) are installed in @libdir@/bin<br />
+# instead of @libdir@/@PACKAGE@<br />
+# Setting LD_LIBRARY_PATH at runtime or LR_RUN_PATH at linktime doesn't<br />
+# work in cygwin, only setting PATH works. <br />
+export PATH=$PATH:@libdir@/bin<br />
+<br />
exec ${sbindir}/courierlogger -pid=@authdaemonvar@/pid $LOGGEROPTS -$1 @libexecdir@/courier-authlib/authdaemond<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-authlib-0.61.0-cygwin.patch<br />
<br />
Configure the package without most authentication modules, keeping only ''userdb''.<br />
<br />
'''Note''': replace ''mailuser'' by an existing user name (in your /etc/passwd file). I used my own username.<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait --without-authpam --without-authldap --without-authpwd \<br />
--without-authshadow --without-authcustom --without-authpipe --without-authmysql --without-authpgsql --with-mailuser=mailuser \<br />
--with-mailgroup=mkgroup-l-d<br />
<br />
Take a long pause... and when ready execute the following command.<br />
<br />
$ make<br />
<br />
Take again a long pause... then check the result and install the libraries<br />
<br />
$ make check<br />
$ make install<br />
<br />
==Configuration==<br />
<br />
Create authdaemonrc file: /usr/local/etc/authlib/authdaemonrc<br />
<br />
$ cp /usr/local/etc/authlib/authdaemonrc.dist /usr/local/etc/authlib/authdaemonrc<br />
<br />
Change number of daemons (I use only one) and enable DEBUG_LOGIN<br />
<br />
<source lang=text><br />
# The number of daemon processes that are started.<br />
daemons=1<br />
<br />
# DEBUG_LOGIN=2 - turn on debugging + log passwords too<br />
DEBUG_LOGIN=2<br />
</source><br />
<br />
See http://www.courier-mta.org/authlib/README.authdebug.html for details.<br />
<br />
==IMAP accounts==<br />
<br />
User accounts and settings are managed by ''userdb''. See [http://linux.die.net/man/8/makeuserdb makeuserdb] man page for details, or used the freshly new install man page - man makeuserdb<br />
<br />
Assuming ''username'' is your username, 1001 and 10545 are respectively the UID and GID of an existing user (part of your /etc/passwd and /etc/group). I use my own UID and GID. Create the mailuser home directory, if required, and create Maildir folder.<br />
<br />
$ mkdir -p /home/username<br />
$ cd /home/username<br />
$ /usr/lib/courier-imap/bin/maildirmake Maildir<br />
<br />
Create the userdb text file /usr/local/etc/authlib/userdb<br />
<br />
$ touch /usr/local/etc/authlib/userdb<br />
$ chmod 700 /usr/local/etc/authlib/userdb<br />
<br />
Edit /usr/local/etc/authlib/userdb, one line per account<br />
<br />
<source lang=text><br />
username[TAB]uid=1001|gid=10111|home=/home/username|mail=/home/username/Maildir|systempw=XXXXXX<br />
</source><br />
<br />
where XXXXXX is the encrypted password created with<br />
<br />
$ /usr/local/sbin/userdbpw.exe<br />
<br />
Create the (binary) userdb<br />
<br />
$ /usr/local/sbin/makeuserdb<br />
<br />
You should now have the following files created:<br />
<br />
* /usr/local/etc/authlib/userdb.dat<br />
* /usr/local/etc/authlib/userdbshadow.dat<br />
<br />
==Running==<br />
<br />
Install and configure syslogd. Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install inetutils (contains syslogd). Configure syslogd with the following command. It will create the /etc/syslogd.conf file and install a windows service using cygrunsrv<br />
<br />
$ syslogd-config<br />
<br />
Start the authlib and imap daemons with the following command:<br />
<br />
$ /usr/local/sbin/authdaemon start<br />
<br />
Stop the daemons with the following command:<br />
<br />
$ /usr/local/sbin/authdaemon stop<br />
<br />
You'll find log messages in /var/log/messages (default target file as specified in /etc/syslogd.conf)<br />
<br />
==Testing authlib==<br />
<br />
$ /usr/local/sbin/authtest username CCCCCC<br />
Authentication succeeded.<br />
<br />
Authenticated: username (uid 1001, gid 10545)<br />
Home Directory: /home/username<br />
Maildir: /home/username/Maildir<br />
Quota: (none)<br />
Encrypted Password: XXXXXX<br />
Cleartext Password: CCCCCC<br />
Options: (none)<br />
<br />
where username is you user name and XXXXXX is you encrypted password as provided in ''/usr/local/etc/authlib/userdb''. CCCCCC is your password in clear.<br />
<br />
==Troubleshooting==<br />
<br />
Should you have a doubt on the execution of a command (ie: no output) you can check if the application is able to load required DLL. This error is not reported. Using ''strace'', windows will complain about DLL not found, if any. To solve this problem you may need to add some path in your PATH. For example, in order to test authlib with authtest:<br />
<br />
$ strace /usr/local/sbin/authtest<br />
# This will open a dialog box to complain about DLL.<br />
$ export PATH=$PATH:/usr/local/lib/bin<br />
$ /usr/local/sbin/authtest ausername<br />
<br />
==Courier Authentication Config==<br />
<br />
$ /usr/local/bin/courierauthconfig.exe --version<br />
$ /usr/local/bin/courierauthconfig.exe --ldflags<br />
$ /usr/local/bin/courierauthconfig.exe --cppflags<br />
$ /usr/local/bin/courierauthconfig.exe --configfiles<br />
<br />
=Courier-IMAP=<br />
==Compilation and installation==<br />
<br />
Download and untar package [http://www.courier-mta.org/download.php#imap courier-imap] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-imap-4.4.1.tar.bz2 4.4.1.20080920]<br />
<br />
Apply the [{{#file:courrier-imap-4.4.1-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# incorrect usage of EXTEXT in main ''Makefile''<br />
# remove usage of /usr/lib/env in start/stop script (/usr/lib/env does not seem to work under Cygwin)<br />
<br />
<source lang=diff><br />
--- courier-imap-4.4.1.20080920/makedat/Makefile.in 2008-08-24 19:52:51.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/makedat/Makefile.in 2008-10-21 20:43:27.500000000 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-imap-4.4.1.20080920/Makefile.in 2008-09-20 14:48:46.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/Makefile.in 2008-10-21 20:59:45.156250000 +0200<br />
@@ -247,9 +247,9 @@<br />
CLEANFILES = $(databin_SCRIPTS) $(man_MANS) $(sysconf_DATA) $(sbin_SCRIPTS)<br />
databindir = $(datadir)<br />
databin_SCRIPTS = mkimapdcert mkpop3dcert<br />
-binPROGRAMS = imapd pop3d maildirmake maildiracl deliverquota maildirkw<br />
-sbinPROGRAMS = imaplogin pop3login<br />
-libexecPROGRAMS = makedatprog couriertcpd<br />
+binPROGRAMS = imapd$(EXEEXT) pop3d$(EXEEXT) maildirmake$(EXEEXT) maildiracl$(EXEEXT) deliverquota$(EXEEXT) maildirkw$(EXEEXT)<br />
+sbinPROGRAMS = imaplogin$(EXEEXT) pop3login$(EXEEXT)<br />
+libexecPROGRAMS = makedatprog$(EXEEXT) couriertcpd$(EXEEXT)<br />
bin_PROGRAMS = @binPROGRAMS_exec@<br />
sbin_PROGRAMS = @sbinPROGRAMS_exec@<br />
libexec_PROGRAMS = @libexecPROGRAMS_exec@<br />
--- courier-imap-4.4.1.20080920/imapd.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/imapd.rc.in 2008-10-26 10:17:51.359375000 +0100<br />
@@ -22,6 +22,15 @@<br />
exit 1<br />
fi<br />
<br />
+# Location for some shared libraries (cygcourierauth*.dll) from authlib<br />
+AUTHLIBDIR=/usr/local<br />
+if test ! -f $AUTHLIBDIR/lib/bin/cygcourierauth.dll<br />
+then<br />
+ echo "$AUTHLIBDIR/lib/bin/cygcourierauth.dll not found."<br />
+ exit 1<br />
+fi<br />
+export PATH=$PATH:/usr/local/lib/bin<br />
+<br />
TLS_CACHEFILE=""<br />
. @sysconfdir@/imapd-ssl<br />
. @sysconfdir@/imapd<br />
@@ -35,7 +44,7 @@<br />
<br />
umask $IMAP_UMASK<br />
@ULIMIT@ $IMAP_ULIMITD<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
--- courier-imap-4.4.1.20080920/pop3d.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/pop3d.rc.in 2008-10-26 10:18:02.187500000 +0100<br />
@@ -22,12 +22,21 @@<br />
exit 1<br />
fi<br />
<br />
+# Location for some shared libraries (cygcourierauth*.dll) from authlib<br />
+AUTHLIBDIR=/usr/local<br />
+if test ! -f $AUTHLIBDIR/lib/bin/cygcourierauth.dll<br />
+then<br />
+ echo "$AUTHLIBDIR/lib/bin/cygcourierauth.dll not found."<br />
+ exit 1<br />
+fi<br />
+export PATH=$PATH:/usr/local/lib/bin<br />
+<br />
. @sysconfdir@/pop3d-ssl<br />
. @sysconfdir@/pop3d<br />
<br />
case $1 in<br />
start)<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-imap-4.4.1-cygwin.patch<br />
<br />
Configure the package<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait<br />
<br />
Take a walk... and when ready execute the following command to build the package.<br />
<br />
$ make<br />
<br />
Time to go for some coffee... and then install the package with the usual<br />
<br />
$ make install<br />
$ make install-configure<br />
<br />
==Configuration==<br />
<br />
Setup courier-imap: $prefix/etc/imapd (where $prefix=/usr/lib/courier-imap)<br />
<br />
Set ADDRESS to a valid value (0 or 127.0.0.1) and change IMAP_ULIMITD to a value accepted by the command ulimit. I simply used the existing value returned by<br />
<br />
$ ulimit -v<br />
<br />
==Running==<br />
<br />
Syslogd service and authdaemond should be started. See above.<br />
<br />
Start the authlib and imap daemons with the following command:<br />
<br />
$ /usr/lib/courier-imap/libexec/imapd.rc start<br />
<br />
Stop the daemons with the following command:<br />
<br />
$ /usr/lib/courier-imap/libexec/imapd.rc stop<br />
<br />
You'll find log messages in /var/log/messages (default target file as specified in /etc/syslogd.conf)<br />
<br />
If everything works fine you can use the following [{{#file:imapd}} startup script] to launch or stop imap and authlib daemons. It can be saved in /usr/local/sbin.<br />
<br />
<source lang=bash><br />
#! /bin/sh<br />
#<br />
# Courier imap daemon startup script.<br />
<br />
authlib=/usr/local/sbin/authdaemond<br />
imapd=/usr/lib/courier-imap/libexec/imapd.rc<br />
<br />
test ! -f $authlib && echo "File not found: $authlib" && exit 1;<br />
test ! -f $imapd && echo "File not found: $imapd" && exit 1;<br />
<br />
case $1 in<br />
start)<br />
$authlib start<br />
$imapd start<br />
;;<br />
stop)<br />
$imapd stop<br />
$authlib stop<br />
;;<br />
*)<br />
echo "Usage: $0 <start|stop>"<br />
;;<br />
esac<br />
</source><br />
<br />
=Maildir=<br />
'''maildirmake''' is part of the courier-imap package<br />
<br />
$ /usr/lib/courier-imap/bin/maildirmake</div>Twalranthttps://wiki.yobi.be/index.php?title=Courier-Cygwin&diff=5236Courier-Cygwin2008-10-26T10:12:49Z<p>Twalrant: /* Compilation and installation */</p>
<hr />
<div>=Pre-requisite=<br />
<br />
Courier-IMAP requires the installation of the [http://www.courier-mta.org/authlib/ Courier Authentication Library] and the following cygwin tools and packages<br />
<br />
* patch, tar, make, gcc<br />
* crypt<br />
* libgdbm-devel<br />
* libtool<br />
* inetutils<br />
* cygrunsrv<br />
<br />
Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install the required packages.<br />
<br />
=Courier Authentication Library=<br />
<br />
Installation of Courier Authentication Library using the module userdb to manage mail accounts. All other modules are disabled.<br />
<br />
==Compilation and installation==<br />
<br />
Download and untar [http://www.courier-mta.org/download.php#authlib courier-authlib] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-authlib-0.61.0.tar.bz2 0.61.0]<br />
<br />
Apply the [{{#file:courrier-authlib-0.61.0-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# add libtool flag (-no-undefined) required for DLL creation<br />
# add missing dependencies<br />
# add PATH in start script to access new DLL (installed in a different directory)<br />
<br />
Solution source: http://lists.cairographics.org/archives/cairo/2004-April/001125.html<br />
<br />
<source lang=diff><br />
--- courier-authlib-0.61.0/makedat/Makefile.in 2008-05-24 16:21:09.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/makedat/Makefile.in 2008-10-21 16:02:38.709166700 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-authlib-0.61.0/Makefile.in 2008-07-12 21:41:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/Makefile.in 2008-10-23 22:59:03.843750000 +0200<br />
@@ -213,9 +213,10 @@<br />
LTCOMPILE = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
--mode=compile $(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) \<br />
$(AM_CPPFLAGS) $(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS)<br />
-CCLD = $(CC)<br />
+CCLD = $(CC) -no-undefined<br />
+CCLDEXE = $(CC)<br />
LINK = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
- --mode=link $(CCLD) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
+ --mode=link $(CCLDEXE) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
$(LDFLAGS) -o $@<br />
SOURCES = $(libauthcustom_la_SOURCES) $(libauthldap_la_SOURCES) \<br />
$(libauthmysql_la_SOURCES) $(libauthpam_la_SOURCES) \<br />
@@ -452,9 +453,9 @@<br />
README.authdebug.html<br />
<br />
DISTCLEANFILES = dbobj.config README_authlib.html<br />
-commonlibdep = libcourierauthcommon.la<br />
+commonlibdep = libcourierauthcommon.la libcourierauth.la<br />
commonldflags = -module -rpath $(pkglibdir) -export-symbols-regex 'courier_auth.*_init' -avoid-version<br />
-commonlibadd = libcourierauthcommon.la<br />
+commonlibadd = libcourierauthcommon.la libcourierauth.la<br />
libcourierauthcommon_t = @CRYPTLIBS@<br />
libcourierauthcommon_la_SOURCES = \<br />
auth.h courierauth.h \<br />
--- courier-authlib-0.61.0/authdaemond.in 2005-07-05 14:25:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/authdaemond.in 2008-10-25 12:03:32.140625000 +0200<br />
@@ -15,4 +15,10 @@<br />
set -a<br />
. @authdaemonrc@<br />
<br />
+# Some shared libraries (DLL) are installed in @libdir@/bin<br />
+# instead of @libdir@/@PACKAGE@<br />
+# Setting LD_LIBRARY_PATH at runtime or LR_RUN_PATH at linktime doesn't<br />
+# work in cygwin, only setting PATH works. <br />
+export PATH=$PATH:@libdir@/bin<br />
+<br />
exec ${sbindir}/courierlogger -pid=@authdaemonvar@/pid $LOGGEROPTS -$1 @libexecdir@/courier-authlib/authdaemond<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-authlib-0.61.0-cygwin.patch<br />
<br />
Configure the package without most authentication modules, keeping only ''userdb''.<br />
<br />
'''Note''': replace ''mailuser'' by an existing user name (in your /etc/passwd file). I used my own username.<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait --without-authpam --without-authldap --without-authpwd \<br />
--without-authshadow --without-authcustom --without-authpipe --without-authmysql --without-authpgsql --with-mailuser=mailuser \<br />
--with-mailgroup=mkgroup-l-d<br />
<br />
Take a long pause... and when ready execute the following command.<br />
<br />
$ make<br />
<br />
Take again a long pause... then check the result and install the libraries<br />
<br />
$ make check<br />
$ make install<br />
<br />
==Configuration==<br />
<br />
Create authdaemonrc file: /usr/local/etc/authlib/authdaemonrc<br />
<br />
$ cp /usr/local/etc/authlib/authdaemonrc.dist /usr/local/etc/authlib/authdaemonrc<br />
<br />
Change number of daemons (I use only one) and enable DEBUG_LOGIN<br />
<br />
<source lang=text><br />
# The number of daemon processes that are started.<br />
daemons=1<br />
<br />
# DEBUG_LOGIN=2 - turn on debugging + log passwords too<br />
DEBUG_LOGIN=2<br />
</source><br />
<br />
See http://www.courier-mta.org/authlib/README.authdebug.html for details.<br />
<br />
==IMAP accounts==<br />
<br />
User accounts and settings are managed by ''userdb''. See [http://linux.die.net/man/8/makeuserdb makeuserdb] man page for details, or used the freshly new install man page - man makeuserdb<br />
<br />
Assuming ''username'' is your username, 1001 and 10545 are respectively the UID and GID of an existing user (part of your /etc/passwd and /etc/group). I use my own UID and GID. Create the mailuser home directory, if required, and create Maildir folder.<br />
<br />
$ mkdir -p /home/username<br />
$ cd /home/username<br />
$ /usr/lib/courier-imap/bin/maildirmake Maildir<br />
<br />
Create the userdb text file /usr/local/etc/authlib/userdb<br />
<br />
$ touch /usr/local/etc/authlib/userdb<br />
$ chmod 700 /usr/local/etc/authlib/userdb<br />
<br />
Edit /usr/local/etc/authlib/userdb, one line per account<br />
<br />
<source lang=text><br />
username[TAB]uid=1001|gid=10111|home=/home/username|mail=/home/username/Maildir|systempw=XXXXXX<br />
</source><br />
<br />
where XXXXXX is the encrypted password created with<br />
<br />
$ /usr/local/sbin/userdbpw.exe<br />
<br />
Create the (binary) userdb<br />
<br />
$ /usr/local/sbin/makeuserdb<br />
<br />
You should now have the following files created:<br />
<br />
* /usr/local/etc/authlib/userdb.dat<br />
* /usr/local/etc/authlib/userdbshadow.dat<br />
<br />
==Running==<br />
<br />
Install and configure syslogd. Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install inetutils (contains syslogd). Configure syslogd with the following command. It will create the /etc/syslogd.conf file and install a windows service using cygrunsrv<br />
<br />
$ syslogd-config<br />
<br />
Start the authlib and imap daemons with the following command:<br />
<br />
$ /usr/local/sbin/authdaemon start<br />
<br />
Stop the daemons with the following command:<br />
<br />
$ /usr/local/sbin/authdaemon stop<br />
<br />
You'll find log messages in /var/log/messages (default target file as specified in /etc/syslogd.conf)<br />
<br />
==Testing authlib==<br />
<br />
$ /usr/local/sbin/authtest username CCCCCC<br />
Authentication succeeded.<br />
<br />
Authenticated: username (uid 1001, gid 10545)<br />
Home Directory: /home/username<br />
Maildir: /home/username/Maildir<br />
Quota: (none)<br />
Encrypted Password: XXXXXX<br />
Cleartext Password: CCCCCC<br />
Options: (none)<br />
<br />
where username is you user name and XXXXXX is you encrypted password as provided in ''/usr/local/etc/authlib/userdb''. CCCCCC is your password in clear.<br />
<br />
==Troubleshooting==<br />
<br />
Should you have a doubt on the execution of a command (ie: no output) you can check if the application is able to load required DLL. This error is not reported. Using ''strace'', windows will complain about DLL not found, if any. To solve this problem you may need to add some path in your PATH. For example, in order to test authlib with authtest:<br />
<br />
$ strace /usr/local/sbin/authtest<br />
# This will open a dialog box to complain about DLL.<br />
$ export PATH=$PATH:/usr/local/lib/bin<br />
$ /usr/local/sbin/authtest ausername<br />
<br />
==Courier Authentication Config==<br />
<br />
$ /usr/local/bin/courierauthconfig.exe --version<br />
$ /usr/local/bin/courierauthconfig.exe --ldflags<br />
$ /usr/local/bin/courierauthconfig.exe --cppflags<br />
$ /usr/local/bin/courierauthconfig.exe --configfiles<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
=Courier-IMAP=<br />
==Compilation and installation==<br />
<br />
Download and untar package [http://www.courier-mta.org/download.php#imap courier-imap] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-imap-4.4.1.tar.bz2 4.4.1.20080920]<br />
<br />
Apply the [{{#file:courrier-imap-4.4.1-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# incorrect usage of EXTEXT in main ''Makefile''<br />
# remove usage of /usr/lib/env in start/stop script (/usr/lib/env does not seem to work under Cygwin)<br />
<br />
<source lang=diff><br />
--- courier-imap-4.4.1.20080920/makedat/Makefile.in 2008-08-24 19:52:51.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/makedat/Makefile.in 2008-10-21 20:43:27.500000000 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-imap-4.4.1.20080920/Makefile.in 2008-09-20 14:48:46.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/Makefile.in 2008-10-21 20:59:45.156250000 +0200<br />
@@ -247,9 +247,9 @@<br />
CLEANFILES = $(databin_SCRIPTS) $(man_MANS) $(sysconf_DATA) $(sbin_SCRIPTS)<br />
databindir = $(datadir)<br />
databin_SCRIPTS = mkimapdcert mkpop3dcert<br />
-binPROGRAMS = imapd pop3d maildirmake maildiracl deliverquota maildirkw<br />
-sbinPROGRAMS = imaplogin pop3login<br />
-libexecPROGRAMS = makedatprog couriertcpd<br />
+binPROGRAMS = imapd$(EXEEXT) pop3d$(EXEEXT) maildirmake$(EXEEXT) maildiracl$(EXEEXT) deliverquota$(EXEEXT) maildirkw$(EXEEXT)<br />
+sbinPROGRAMS = imaplogin$(EXEEXT) pop3login$(EXEEXT)<br />
+libexecPROGRAMS = makedatprog$(EXEEXT) couriertcpd$(EXEEXT)<br />
bin_PROGRAMS = @binPROGRAMS_exec@<br />
sbin_PROGRAMS = @sbinPROGRAMS_exec@<br />
libexec_PROGRAMS = @libexecPROGRAMS_exec@<br />
--- courier-imap-4.4.1.20080920/imapd.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/imapd.rc.in 2008-10-26 10:17:51.359375000 +0100<br />
@@ -22,6 +22,15 @@<br />
exit 1<br />
fi<br />
<br />
+# Location for some shared libraries (cygcourierauth*.dll) from authlib<br />
+AUTHLIBDIR=/usr/local<br />
+if test ! -f $AUTHLIBDIR/lib/bin/cygcourierauth.dll<br />
+then<br />
+ echo "$AUTHLIBDIR/lib/bin/cygcourierauth.dll not found."<br />
+ exit 1<br />
+fi<br />
+export PATH=$PATH:/usr/local/lib/bin<br />
+<br />
TLS_CACHEFILE=""<br />
. @sysconfdir@/imapd-ssl<br />
. @sysconfdir@/imapd<br />
@@ -35,7 +44,7 @@<br />
<br />
umask $IMAP_UMASK<br />
@ULIMIT@ $IMAP_ULIMITD<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
--- courier-imap-4.4.1.20080920/pop3d.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/pop3d.rc.in 2008-10-26 10:18:02.187500000 +0100<br />
@@ -22,12 +22,21 @@<br />
exit 1<br />
fi<br />
<br />
+# Location for some shared libraries (cygcourierauth*.dll) from authlib<br />
+AUTHLIBDIR=/usr/local<br />
+if test ! -f $AUTHLIBDIR/lib/bin/cygcourierauth.dll<br />
+then<br />
+ echo "$AUTHLIBDIR/lib/bin/cygcourierauth.dll not found."<br />
+ exit 1<br />
+fi<br />
+export PATH=$PATH:/usr/local/lib/bin<br />
+<br />
. @sysconfdir@/pop3d-ssl<br />
. @sysconfdir@/pop3d<br />
<br />
case $1 in<br />
start)<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-imap-4.4.1-cygwin.patch<br />
<br />
Configure the package<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait<br />
<br />
Take a walk... and when ready execute the following command to build the package.<br />
<br />
$ make<br />
<br />
Time to go for some coffee... and then install the package with the usual<br />
<br />
$ make install<br />
$ make install-configure<br />
<br />
==Configuration==<br />
<br />
Setup courier-imap: $prefix/etc/imapd (where $prefix=/usr/lib/courier-imap)<br />
<br />
Set ADDRESS to a valid value (0 or 127.0.0.1) and change IMAP_ULIMITD to a value accepted by the command ulimit. I simply used the existing value returned by<br />
<br />
$ ulimit -v<br />
<br />
==Running==<br />
<br />
Syslogd service and authdaemond should be started. See above.<br />
<br />
Start the authlib and imap daemons with the following command:<br />
<br />
$ /usr/lib/courier-imap/libexec/imapd.rc start<br />
<br />
Stop the daemons with the following command:<br />
<br />
$ /usr/lib/courier-imap/libexec/imapd.rc stop<br />
<br />
You'll find log messages in /var/log/messages (default target file as specified in /etc/syslogd.conf)<br />
<br />
If everything works fine you can use the following [{{#file:imapd}} startup script] to launch or stop imap and authlib daemons. It can be saved in /usr/local/sbin.<br />
<br />
<source lang=bash><br />
#! /bin/sh<br />
#<br />
# Courier imap daemon startup script.<br />
<br />
authlib=/usr/local/sbin/authdaemond<br />
imapd=/usr/lib/courier-imap/libexec/imapd.rc<br />
<br />
test ! -f $authlib && echo "File not found: $authlib" && exit 1;<br />
test ! -f $imapd && echo "File not found: $imapd" && exit 1;<br />
<br />
case $1 in<br />
start)<br />
$authlib start<br />
$imapd start<br />
;;<br />
stop)<br />
$imapd stop<br />
$authlib stop<br />
;;<br />
*)<br />
echo "Usage: $0 <start|stop>"<br />
;;<br />
esac<br />
</source><br />
<br />
=Maildir=<br />
'''maildirmake''' is part of the courier-imap package<br />
<br />
$ /usr/lib/courier-imap/bin/maildirmake</div>Twalranthttps://wiki.yobi.be/index.php?title=Courier-Cygwin&diff=5235Courier-Cygwin2008-10-26T10:10:23Z<p>Twalrant: </p>
<hr />
<div>=Pre-requisite=<br />
<br />
Courier-IMAP requires the installation of the [http://www.courier-mta.org/authlib/ Courier Authentication Library] and the following cygwin tools and packages<br />
<br />
* patch, tar, make, gcc<br />
* crypt<br />
* libgdbm-devel<br />
* libtool<br />
* inetutils<br />
* cygrunsrv<br />
<br />
Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install the required packages.<br />
<br />
=Courier Authentication Library=<br />
<br />
Installation of Courier Authentication Library using the module userdb to manage mail accounts. All other modules are disabled.<br />
<br />
==Compilation and installation==<br />
<br />
Download and untar [http://www.courier-mta.org/download.php#authlib courier-authlib] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-authlib-0.61.0.tar.bz2 0.61.0]<br />
<br />
Apply the [{{#file:courrier-authlib-0.61.0-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# add libtool flag (-no-undefined) required for DLL creation<br />
# add missing dependencies<br />
# add PATH in start script to access new DLL (installed in a different directory)<br />
<br />
Solution source: http://lists.cairographics.org/archives/cairo/2004-April/001125.html<br />
<br />
<source lang=diff><br />
--- courier-authlib-0.61.0/makedat/Makefile.in 2008-05-24 16:21:09.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/makedat/Makefile.in 2008-10-21 16:02:38.709166700 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-authlib-0.61.0/Makefile.in 2008-07-12 21:41:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/Makefile.in 2008-10-23 22:59:03.843750000 +0200<br />
@@ -213,9 +213,10 @@<br />
LTCOMPILE = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
--mode=compile $(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) \<br />
$(AM_CPPFLAGS) $(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS)<br />
-CCLD = $(CC)<br />
+CCLD = $(CC) -no-undefined<br />
+CCLDEXE = $(CC)<br />
LINK = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
- --mode=link $(CCLD) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
+ --mode=link $(CCLDEXE) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
$(LDFLAGS) -o $@<br />
SOURCES = $(libauthcustom_la_SOURCES) $(libauthldap_la_SOURCES) \<br />
$(libauthmysql_la_SOURCES) $(libauthpam_la_SOURCES) \<br />
@@ -452,9 +453,9 @@<br />
README.authdebug.html<br />
<br />
DISTCLEANFILES = dbobj.config README_authlib.html<br />
-commonlibdep = libcourierauthcommon.la<br />
+commonlibdep = libcourierauthcommon.la libcourierauth.la<br />
commonldflags = -module -rpath $(pkglibdir) -export-symbols-regex 'courier_auth.*_init' -avoid-version<br />
-commonlibadd = libcourierauthcommon.la<br />
+commonlibadd = libcourierauthcommon.la libcourierauth.la<br />
libcourierauthcommon_t = @CRYPTLIBS@<br />
libcourierauthcommon_la_SOURCES = \<br />
auth.h courierauth.h \<br />
--- courier-authlib-0.61.0/authdaemond.in 2005-07-05 14:25:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/authdaemond.in 2008-10-25 12:03:32.140625000 +0200<br />
@@ -15,4 +15,10 @@<br />
set -a<br />
. @authdaemonrc@<br />
<br />
+# Some shared libraries (DLL) are installed in @libdir@/bin<br />
+# instead of @libdir@/@PACKAGE@<br />
+# Setting LD_LIBRARY_PATH at runtime or LR_RUN_PATH at linktime doesn't<br />
+# work in cygwin, only setting PATH works. <br />
+export PATH=$PATH:@libdir@/bin<br />
+<br />
exec ${sbindir}/courierlogger -pid=@authdaemonvar@/pid $LOGGEROPTS -$1 @libexecdir@/courier-authlib/authdaemond<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-authlib-0.61.0-cygwin.patch<br />
<br />
Configure the package without most authentication modules, keeping only ''userdb''.<br />
<br />
'''Note''': replace ''mailuser'' by an existing user name (in your /etc/passwd file). I used my own username.<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait --without-authpam --without-authldap --without-authpwd \<br />
--without-authshadow --without-authcustom --without-authpipe --without-authmysql --without-authpgsql --with-mailuser=mailuser \<br />
--with-mailgroup=mkgroup-l-d<br />
<br />
Take a long pause... and when ready execute the following command.<br />
<br />
$ make<br />
<br />
Take again a long pause... then check the result and install the libraries<br />
<br />
$ make check<br />
$ make install<br />
<br />
==Configuration==<br />
<br />
Create authdaemonrc file: /usr/local/etc/authlib/authdaemonrc<br />
<br />
$ cp /usr/local/etc/authlib/authdaemonrc.dist /usr/local/etc/authlib/authdaemonrc<br />
<br />
Change number of daemons (I use only one) and enable DEBUG_LOGIN<br />
<br />
<source lang=text><br />
# The number of daemon processes that are started.<br />
daemons=1<br />
<br />
# DEBUG_LOGIN=2 - turn on debugging + log passwords too<br />
DEBUG_LOGIN=2<br />
</source><br />
<br />
See http://www.courier-mta.org/authlib/README.authdebug.html for details.<br />
<br />
==IMAP accounts==<br />
<br />
User accounts and settings are managed by ''userdb''. See [http://linux.die.net/man/8/makeuserdb makeuserdb] man page for details, or used the freshly new install man page - man makeuserdb<br />
<br />
Assuming ''username'' is your username, 1001 and 10545 are respectively the UID and GID of an existing user (part of your /etc/passwd and /etc/group). I use my own UID and GID. Create the mailuser home directory, if required, and create Maildir folder.<br />
<br />
$ mkdir -p /home/username<br />
$ cd /home/username<br />
$ /usr/lib/courier-imap/bin/maildirmake Maildir<br />
<br />
Create the userdb text file /usr/local/etc/authlib/userdb<br />
<br />
$ touch /usr/local/etc/authlib/userdb<br />
$ chmod 700 /usr/local/etc/authlib/userdb<br />
<br />
Edit /usr/local/etc/authlib/userdb, one line per account<br />
<br />
<source lang=text><br />
username[TAB]uid=1001|gid=10111|home=/home/username|mail=/home/username/Maildir|systempw=XXXXXX<br />
</source><br />
<br />
where XXXXXX is the encrypted password created with<br />
<br />
$ /usr/local/sbin/userdbpw.exe<br />
<br />
Create the (binary) userdb<br />
<br />
$ /usr/local/sbin/makeuserdb<br />
<br />
You should now have the following files created:<br />
<br />
* /usr/local/etc/authlib/userdb.dat<br />
* /usr/local/etc/authlib/userdbshadow.dat<br />
<br />
==Running==<br />
<br />
Install and configure syslogd. Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install inetutils (contains syslogd). Configure syslogd with the following command. It will create the /etc/syslogd.conf file and install a windows service using cygrunsrv<br />
<br />
$ syslogd-config<br />
<br />
Start the authlib and imap daemons with the following command:<br />
<br />
$ /usr/local/sbin/authdaemon start<br />
<br />
Stop the daemons with the following command:<br />
<br />
$ /usr/local/sbin/authdaemon stop<br />
<br />
You'll find log messages in /var/log/messages (default target file as specified in /etc/syslogd.conf)<br />
<br />
==Testing authlib==<br />
<br />
$ /usr/local/sbin/authtest username CCCCCC<br />
Authentication succeeded.<br />
<br />
Authenticated: username (uid 1001, gid 10545)<br />
Home Directory: /home/username<br />
Maildir: /home/username/Maildir<br />
Quota: (none)<br />
Encrypted Password: XXXXXX<br />
Cleartext Password: CCCCCC<br />
Options: (none)<br />
<br />
where username is you user name and XXXXXX is you encrypted password as provided in ''/usr/local/etc/authlib/userdb''. CCCCCC is your password in clear.<br />
<br />
==Troubleshooting==<br />
<br />
Should you have a doubt on the execution of a command (ie: no output) you can check if the application is able to load required DLL. This error is not reported. Using ''strace'', windows will complain about DLL not found, if any. To solve this problem you may need to add some path in your PATH. For example, in order to test authlib with authtest:<br />
<br />
$ strace /usr/local/sbin/authtest<br />
# This will open a dialog box to complain about DLL.<br />
$ export PATH=$PATH:/usr/local/lib/bin<br />
$ /usr/local/sbin/authtest ausername<br />
<br />
==Courier Authentication Config==<br />
<br />
$ /usr/local/bin/courierauthconfig.exe --version<br />
$ /usr/local/bin/courierauthconfig.exe --ldflags<br />
$ /usr/local/bin/courierauthconfig.exe --cppflags<br />
$ /usr/local/bin/courierauthconfig.exe --configfiles<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
<br />
=Courier-IMAP=<br />
==Compilation and installation==<br />
<br />
Download and untar package [http://www.courier-mta.org/download.php#imap courier-imap] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-imap-4.4.1.tar.bz2 4.4.1.20080920]<br />
<br />
Apply the [{{#file:courrier-imap-4.4.1-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# incorrect usage of EXTEXT in main ''Makefile''<br />
# remove usage of /usr/lib/env in start/stop script (/usr/lib/env does not seem to work under Cygwin)<br />
<br />
<source lang=diff><br />
--- courier-imap-4.4.1.20080920/makedat/Makefile.in 2008-08-24 19:52:51.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/makedat/Makefile.in 2008-10-21 20:43:27.500000000 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-imap-4.4.1.20080920/Makefile.in 2008-09-20 14:48:46.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/Makefile.in 2008-10-21 20:59:45.156250000 +0200<br />
@@ -247,9 +247,9 @@<br />
CLEANFILES = $(databin_SCRIPTS) $(man_MANS) $(sysconf_DATA) $(sbin_SCRIPTS)<br />
databindir = $(datadir)<br />
databin_SCRIPTS = mkimapdcert mkpop3dcert<br />
-binPROGRAMS = imapd pop3d maildirmake maildiracl deliverquota maildirkw<br />
-sbinPROGRAMS = imaplogin pop3login<br />
-libexecPROGRAMS = makedatprog couriertcpd<br />
+binPROGRAMS = imapd$(EXEEXT) pop3d$(EXEEXT) maildirmake$(EXEEXT) maildiracl$(EXEEXT) deliverquota$(EXEEXT) maildirkw$(EXEEXT)<br />
+sbinPROGRAMS = imaplogin$(EXEEXT) pop3login$(EXEEXT)<br />
+libexecPROGRAMS = makedatprog$(EXEEXT) couriertcpd$(EXEEXT)<br />
bin_PROGRAMS = @binPROGRAMS_exec@<br />
sbin_PROGRAMS = @sbinPROGRAMS_exec@<br />
libexec_PROGRAMS = @libexecPROGRAMS_exec@<br />
--- courier-imap-4.4.1.20080920/imapd.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/imapd.rc.in 2008-10-21 23:00:30.781250000 +0200<br />
@@ -35,7 +35,7 @@<br />
<br />
umask $IMAP_UMASK<br />
@ULIMIT@ $IMAP_ULIMITD<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
--- courier-imap-4.4.1.20080920/pop3d.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/pop3d.rc.in 2008-10-21 23:00:49.875000000 +0200<br />
@@ -27,7 +27,7 @@<br />
<br />
case $1 in<br />
start)<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-imap-4.4.1-cygwin.patch<br />
<br />
Configure the package<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait<br />
<br />
Take a walk... and when ready execute the following command to build the package.<br />
<br />
$ make<br />
<br />
Time to go for some coffee... and then install the package with the usual<br />
<br />
$ make install<br />
$ make install-configure<br />
<br />
==Configuration==<br />
<br />
Setup courier-imap: $prefix/etc/imapd (where $prefix=/usr/lib/courier-imap)<br />
<br />
Set ADDRESS to a valid value (0 or 127.0.0.1) and change IMAP_ULIMITD to a value accepted by the command ulimit. I simply used the existing value returned by<br />
<br />
$ ulimit -v<br />
<br />
==Running==<br />
<br />
Syslogd service and authdaemond should be started. See above.<br />
<br />
Start the authlib and imap daemons with the following command:<br />
<br />
$ /usr/lib/courier-imap/libexec/imapd.rc start<br />
<br />
Stop the daemons with the following command:<br />
<br />
$ /usr/lib/courier-imap/libexec/imapd.rc stop<br />
<br />
You'll find log messages in /var/log/messages (default target file as specified in /etc/syslogd.conf)<br />
<br />
If everything works fine you can use the following [{{#file:imapd}} startup script] to launch or stop imap and authlib daemons. It can be saved in /usr/local/sbin.<br />
<br />
<source lang=bash><br />
#! /bin/sh<br />
#<br />
# Courier imap daemon startup script.<br />
<br />
authlib=/usr/local/sbin/authdaemond<br />
imapd=/usr/lib/courier-imap/libexec/imapd.rc<br />
<br />
test ! -f $authlib && echo "File not found: $authlib" && exit 1;<br />
test ! -f $imapd && echo "File not found: $imapd" && exit 1;<br />
<br />
case $1 in<br />
start)<br />
$authlib start<br />
$imapd start<br />
;;<br />
stop)<br />
$imapd stop<br />
$authlib stop<br />
;;<br />
*)<br />
echo "Usage: $0 <start|stop>"<br />
;;<br />
esac<br />
</source><br />
<br />
=Maildir=<br />
'''maildirmake''' is part of the courier-imap package<br />
<br />
$ /usr/lib/courier-imap/bin/maildirmake</div>Twalranthttps://wiki.yobi.be/index.php?title=Courier-Cygwin&diff=5234Courier-Cygwin2008-10-26T09:31:02Z<p>Twalrant: /* Running */</p>
<hr />
<div>=Courier-IMAP=<br />
<br />
Courier-IMAP requires the installation of the [http://www.courier-mta.org/authlib/ Courier Authentication Library] and the following cygwin tools and packages<br />
<br />
* patch, tar, make, gcc<br />
* crypt<br />
* libgdbm-devel<br />
* libtool (version 1.5.27a-1)<br />
* inetutils<br />
* cygrunsrv<br />
<br />
Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install the required packages.<br />
<br />
==Courier Authentication Library==<br />
<br />
Download and untar [http://www.courier-mta.org/download.php#authlib courier-authlib] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-authlib-0.61.0.tar.bz2 0.61.0]<br />
<br />
Apply the [{{#file:courrier-authlib-0.61.0-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# add libtool flag (-no-undefined) required for DLL creation<br />
# add missing dependencies<br />
# add PATH in start script to access new DLL (installed in a different directory)<br />
<br />
Solution source: http://lists.cairographics.org/archives/cairo/2004-April/001125.html<br />
<br />
<source lang=diff><br />
--- courier-authlib-0.61.0/makedat/Makefile.in 2008-05-24 16:21:09.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/makedat/Makefile.in 2008-10-21 16:02:38.709166700 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-authlib-0.61.0/Makefile.in 2008-07-12 21:41:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/Makefile.in 2008-10-23 22:59:03.843750000 +0200<br />
@@ -213,9 +213,10 @@<br />
LTCOMPILE = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
--mode=compile $(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) \<br />
$(AM_CPPFLAGS) $(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS)<br />
-CCLD = $(CC)<br />
+CCLD = $(CC) -no-undefined<br />
+CCLDEXE = $(CC)<br />
LINK = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
- --mode=link $(CCLD) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
+ --mode=link $(CCLDEXE) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
$(LDFLAGS) -o $@<br />
SOURCES = $(libauthcustom_la_SOURCES) $(libauthldap_la_SOURCES) \<br />
$(libauthmysql_la_SOURCES) $(libauthpam_la_SOURCES) \<br />
@@ -452,9 +453,9 @@<br />
README.authdebug.html<br />
<br />
DISTCLEANFILES = dbobj.config README_authlib.html<br />
-commonlibdep = libcourierauthcommon.la<br />
+commonlibdep = libcourierauthcommon.la libcourierauth.la<br />
commonldflags = -module -rpath $(pkglibdir) -export-symbols-regex 'courier_auth.*_init' -avoid-version<br />
-commonlibadd = libcourierauthcommon.la<br />
+commonlibadd = libcourierauthcommon.la libcourierauth.la<br />
libcourierauthcommon_t = @CRYPTLIBS@<br />
libcourierauthcommon_la_SOURCES = \<br />
auth.h courierauth.h \<br />
--- courier-authlib-0.61.0/authdaemond.in 2005-07-05 14:25:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/authdaemond.in 2008-10-25 12:03:32.140625000 +0200<br />
@@ -15,4 +15,10 @@<br />
set -a<br />
. @authdaemonrc@<br />
<br />
+# Some shared libraries (DLL) are installed in @libdir@/bin<br />
+# instead of @libdir@/@PACKAGE@<br />
+# Setting LD_LIBRARY_PATH at runtime or LR_RUN_PATH at linktime doesn't<br />
+# work in cygwin, only setting PATH works. <br />
+export PATH=$PATH:@libdir@/bin<br />
+<br />
exec ${sbindir}/courierlogger -pid=@authdaemonvar@/pid $LOGGEROPTS -$1 @libexecdir@/courier-authlib/authdaemond<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-authlib-0.61.0-cygwin.patch<br />
<br />
Configure the package without most authentication modules, keeping only ''userdb''.<br />
<br />
'''Note''': replace ''mailuser'' by an existing user name (in your /etc/passwd file). I used my own username.<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait --without-authpam --without-authldap --without-authpwd \<br />
--without-authshadow --without-authcustom --without-authpipe --without-authmysql --without-authpgsql --with-mailuser=mailuser \<br />
--with-mailgroup=mkgroup-l-d<br />
<br />
Take a long pause... and when ready execute the following command.<br />
<br />
$ make<br />
<br />
Take again a long pause... then check the result and install the libraries<br />
<br />
$ make check<br />
$ make install<br />
<br />
==Compilation and installation==<br />
<br />
Download and untar package [http://www.courier-mta.org/download.php#imap courier-imap] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-imap-4.4.1.tar.bz2 4.4.1.20080920]<br />
<br />
Apply the [{{#file:courrier-imap-4.4.1-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# incorrect usage of EXTEXT in main ''Makefile''<br />
# remove usage of /usr/lib/env in start/stop script (/usr/lib/env does not seem to work under Cygwin)<br />
<br />
<source lang=diff><br />
--- courier-imap-4.4.1.20080920/makedat/Makefile.in 2008-08-24 19:52:51.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/makedat/Makefile.in 2008-10-21 20:43:27.500000000 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-imap-4.4.1.20080920/Makefile.in 2008-09-20 14:48:46.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/Makefile.in 2008-10-21 20:59:45.156250000 +0200<br />
@@ -247,9 +247,9 @@<br />
CLEANFILES = $(databin_SCRIPTS) $(man_MANS) $(sysconf_DATA) $(sbin_SCRIPTS)<br />
databindir = $(datadir)<br />
databin_SCRIPTS = mkimapdcert mkpop3dcert<br />
-binPROGRAMS = imapd pop3d maildirmake maildiracl deliverquota maildirkw<br />
-sbinPROGRAMS = imaplogin pop3login<br />
-libexecPROGRAMS = makedatprog couriertcpd<br />
+binPROGRAMS = imapd$(EXEEXT) pop3d$(EXEEXT) maildirmake$(EXEEXT) maildiracl$(EXEEXT) deliverquota$(EXEEXT) maildirkw$(EXEEXT)<br />
+sbinPROGRAMS = imaplogin$(EXEEXT) pop3login$(EXEEXT)<br />
+libexecPROGRAMS = makedatprog$(EXEEXT) couriertcpd$(EXEEXT)<br />
bin_PROGRAMS = @binPROGRAMS_exec@<br />
sbin_PROGRAMS = @sbinPROGRAMS_exec@<br />
libexec_PROGRAMS = @libexecPROGRAMS_exec@<br />
--- courier-imap-4.4.1.20080920/imapd.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/imapd.rc.in 2008-10-21 23:00:30.781250000 +0200<br />
@@ -35,7 +35,7 @@<br />
<br />
umask $IMAP_UMASK<br />
@ULIMIT@ $IMAP_ULIMITD<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
--- courier-imap-4.4.1.20080920/pop3d.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/pop3d.rc.in 2008-10-21 23:00:49.875000000 +0200<br />
@@ -27,7 +27,7 @@<br />
<br />
case $1 in<br />
start)<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-imap-4.4.1-cygwin.patch<br />
<br />
Configure the package<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait<br />
<br />
Take a walk... and when ready execute the following command to build the package.<br />
<br />
$ make<br />
<br />
Time to go for some coffee... and then install the package with the usual<br />
<br />
$ make install<br />
$ make install-configure<br />
<br />
==Configuration==<br />
<br />
Setup courier-imap: $prefix/etc/imapd (where $prefix=/usr/lib/courier-imap)<br />
<br />
Set ADDRESS to a valid value (0 or 127.0.0.1) and change IMAP_ULIMITD to a value accepted by the command ulimit. I simply used the existing value returned by<br />
<br />
$ ulimit -v<br />
<br />
Setup authdaemon: /usr/local/etc/authlib/authdaemonrc. Create authdaemonrc file<br />
<br />
$ cp /usr/local/etc/authlib/authdaemonrc.dist /usr/local/etc/authlib/authdaemonrc<br />
<br />
Change number of daemons (I use only one) and enable DEBUG_LOGIN<br />
<br />
<source lang=text><br />
# The number of daemon processes that are started.<br />
daemons=1<br />
<br />
# DEBUG_LOGIN=2 - turn on debugging + log passwords too<br />
DEBUG_LOGIN=2<br />
</source><br />
<br />
==IMAP accounts==<br />
<br />
User accounts and settings are managed by ''userdb''. See [http://linux.die.net/man/8/makeuserdb makeuserdb] man page for details, or used the freshly new install man page - man makeuserdb<br />
<br />
Assuming ''username'' is your username, 1001 and 10545 are respectively the UID and GID of an existing user (part of your /etc/passwd and /etc/group). I use my own UID and GID. Create the mailuser home directory, if required. Create Maildir folder.<br />
<br />
$ mkdir -p /home/username<br />
$ cd /home/username<br />
$ /usr/lib/courier-imap/bin/maildirmake Maildir<br />
<br />
Create the userdb text file /usr/local/etc/authlib/userdb<br />
<br />
$ touch /usr/local/etc/authlib/userdb<br />
$ chmod 700 /usr/local/etc/authlib/userdb<br />
<br />
Edit /usr/local/etc/authlib/userdb, one line per account<br />
<br />
<source lang=text><br />
username[TAB]uid=1001|gid=10111|home=/home/username|mail=/home/username/Maildir|systempw=XXXXXX<br />
</source><br />
<br />
where XXXXXX is the encrypted password created with<br />
<br />
$ /usr/local/sbin/userdbpw.exe<br />
<br />
Create the (binary) userdb<br />
<br />
$ /usr/local/sbin/makeuserdb<br />
<br />
You should now have the following files created:<br />
<br />
* /usr/local/etc/authlib/userdb.dat<br />
* /usr/local/etc/authlib/userdbshadow.dat<br />
<br />
==Running==<br />
<br />
Install and configure syslogd. Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install inetutils (contains syslogd). Configure syslogd with the following command. It will create the /etc/syslogd.conf file and install a windows service using cygrunsrv<br />
<br />
$ syslogd-config<br />
<br />
Start the authlib and imap daemons with the following command:<br />
<br />
$ /usr/local/sbin/authdaemon start<br />
$ /usr/lib/courier-imap/libexec/imapd.rc start<br />
<br />
Stop the daemons with the following command:<br />
<br />
$ /usr/lib/courier-imap/libexec/imapd.rc stop<br />
$ /usr/local/sbin/authdaemon stop<br />
<br />
You'll find log messages in /var/log/messages (default target file as specified in /etc/syslogd.conf)<br />
<br />
<br />
<source lang=bash><br />
#! /bin/sh<br />
#<br />
# Courier imap daemon startup script.<br />
<br />
authlib=/usr/local/sbin/authdaemond<br />
imapd=/usr/lib/courier-imap/libexec/imapd.rc<br />
<br />
test ! -f $authlib && echo "File not found: $authlib" && exit 1;<br />
test ! -f $imapd && echo "File not found: $imapd" && exit 1;<br />
<br />
case $1 in<br />
start)<br />
$authlib start<br />
$imapd start<br />
;;<br />
stop)<br />
$imapd stop<br />
$authlib stop<br />
;;<br />
*)<br />
echo "Usage: $0 <start|stop>"<br />
;;<br />
esac<br />
</source><br />
<br />
==Testing authlib==<br />
<br />
$ /usr/local/sbin/authtest username CCCCCC<br />
Authentication succeeded.<br />
<br />
Authenticated: username (uid 1001, gid 10111)<br />
Home Directory: /home/username<br />
Maildir: /home/username/Maildir<br />
Quota: (none)<br />
Encrypted Password: XXXXXX<br />
Cleartext Password: CCCCCC<br />
Options: (none)<br />
<br />
where username is you user name and XXXXXX is you encrypted password as provided in ''userbd'' text file. CCCCCC is your password in clear.<br />
<br />
==Troubleshooting==<br />
<br />
Should you have a doubt on the execution of a command (ie: no output) you can check if the application is able to load required DLL. This error is not reported. Using ''strace'', windows will complain about DLL not found, if any. To solve this problem you may need to add some path in your PATH. For example, in order to test authlib with authtest:<br />
<br />
$ strace /usr/local/sbin/authtest<br />
# This will open a dialog box to complain about DLL.<br />
$ export PATH=$PATH:/usr/local/lib/bin<br />
$ /usr/local/sbin/authtest ausername<br />
<br />
=Maildir=<br />
'''maildirmake''' is part of the courier-imap package<br />
<br />
$ /usr/lib/courier-imap/bin/maildirmake</div>Twalranthttps://wiki.yobi.be/index.php?title=Courier-Cygwin&diff=5233Courier-Cygwin2008-10-26T08:10:16Z<p>Twalrant: /* Running */</p>
<hr />
<div>=Courier-IMAP=<br />
<br />
Courier-IMAP requires the installation of the [http://www.courier-mta.org/authlib/ Courier Authentication Library] and the following cygwin tools and packages<br />
<br />
* patch, tar, make, gcc<br />
* crypt<br />
* libgdbm-devel<br />
* libtool (version 1.5.27a-1)<br />
* inetutils<br />
* cygrunsrv<br />
<br />
Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install the required packages.<br />
<br />
==Courier Authentication Library==<br />
<br />
Download and untar [http://www.courier-mta.org/download.php#authlib courier-authlib] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-authlib-0.61.0.tar.bz2 0.61.0]<br />
<br />
Apply the [{{#file:courrier-authlib-0.61.0-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# add libtool flag (-no-undefined) required for DLL creation<br />
# add missing dependencies<br />
# add PATH in start script to access new DLL (installed in a different directory)<br />
<br />
Solution source: http://lists.cairographics.org/archives/cairo/2004-April/001125.html<br />
<br />
<source lang=diff><br />
--- courier-authlib-0.61.0/makedat/Makefile.in 2008-05-24 16:21:09.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/makedat/Makefile.in 2008-10-21 16:02:38.709166700 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-authlib-0.61.0/Makefile.in 2008-07-12 21:41:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/Makefile.in 2008-10-23 22:59:03.843750000 +0200<br />
@@ -213,9 +213,10 @@<br />
LTCOMPILE = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
--mode=compile $(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) \<br />
$(AM_CPPFLAGS) $(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS)<br />
-CCLD = $(CC)<br />
+CCLD = $(CC) -no-undefined<br />
+CCLDEXE = $(CC)<br />
LINK = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
- --mode=link $(CCLD) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
+ --mode=link $(CCLDEXE) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
$(LDFLAGS) -o $@<br />
SOURCES = $(libauthcustom_la_SOURCES) $(libauthldap_la_SOURCES) \<br />
$(libauthmysql_la_SOURCES) $(libauthpam_la_SOURCES) \<br />
@@ -452,9 +453,9 @@<br />
README.authdebug.html<br />
<br />
DISTCLEANFILES = dbobj.config README_authlib.html<br />
-commonlibdep = libcourierauthcommon.la<br />
+commonlibdep = libcourierauthcommon.la libcourierauth.la<br />
commonldflags = -module -rpath $(pkglibdir) -export-symbols-regex 'courier_auth.*_init' -avoid-version<br />
-commonlibadd = libcourierauthcommon.la<br />
+commonlibadd = libcourierauthcommon.la libcourierauth.la<br />
libcourierauthcommon_t = @CRYPTLIBS@<br />
libcourierauthcommon_la_SOURCES = \<br />
auth.h courierauth.h \<br />
--- courier-authlib-0.61.0/authdaemond.in 2005-07-05 14:25:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/authdaemond.in 2008-10-25 12:03:32.140625000 +0200<br />
@@ -15,4 +15,10 @@<br />
set -a<br />
. @authdaemonrc@<br />
<br />
+# Some shared libraries (DLL) are installed in @libdir@/bin<br />
+# instead of @libdir@/@PACKAGE@<br />
+# Setting LD_LIBRARY_PATH at runtime or LR_RUN_PATH at linktime doesn't<br />
+# work in cygwin, only setting PATH works. <br />
+export PATH=$PATH:@libdir@/bin<br />
+<br />
exec ${sbindir}/courierlogger -pid=@authdaemonvar@/pid $LOGGEROPTS -$1 @libexecdir@/courier-authlib/authdaemond<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-authlib-0.61.0-cygwin.patch<br />
<br />
Configure the package without most authentication modules, keeping only ''userdb''.<br />
<br />
'''Note''': replace ''mailuser'' by an existing user name (in your /etc/passwd file). I used my own username.<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait --without-authpam --without-authldap --without-authpwd \<br />
--without-authshadow --without-authcustom --without-authpipe --without-authmysql --without-authpgsql --with-mailuser=mailuser \<br />
--with-mailgroup=mkgroup-l-d<br />
<br />
Take a long pause... and when ready execute the following command.<br />
<br />
$ make<br />
<br />
Take again a long pause... then check the result and install the libraries<br />
<br />
$ make check<br />
$ make install<br />
<br />
==Compilation and installation==<br />
<br />
Download and untar package [http://www.courier-mta.org/download.php#imap courier-imap] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-imap-4.4.1.tar.bz2 4.4.1.20080920]<br />
<br />
Apply the [{{#file:courrier-imap-4.4.1-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# incorrect usage of EXTEXT in main ''Makefile''<br />
# remove usage of /usr/lib/env in start/stop script (/usr/lib/env does not seem to work under Cygwin)<br />
<br />
<source lang=diff><br />
--- courier-imap-4.4.1.20080920/makedat/Makefile.in 2008-08-24 19:52:51.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/makedat/Makefile.in 2008-10-21 20:43:27.500000000 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-imap-4.4.1.20080920/Makefile.in 2008-09-20 14:48:46.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/Makefile.in 2008-10-21 20:59:45.156250000 +0200<br />
@@ -247,9 +247,9 @@<br />
CLEANFILES = $(databin_SCRIPTS) $(man_MANS) $(sysconf_DATA) $(sbin_SCRIPTS)<br />
databindir = $(datadir)<br />
databin_SCRIPTS = mkimapdcert mkpop3dcert<br />
-binPROGRAMS = imapd pop3d maildirmake maildiracl deliverquota maildirkw<br />
-sbinPROGRAMS = imaplogin pop3login<br />
-libexecPROGRAMS = makedatprog couriertcpd<br />
+binPROGRAMS = imapd$(EXEEXT) pop3d$(EXEEXT) maildirmake$(EXEEXT) maildiracl$(EXEEXT) deliverquota$(EXEEXT) maildirkw$(EXEEXT)<br />
+sbinPROGRAMS = imaplogin$(EXEEXT) pop3login$(EXEEXT)<br />
+libexecPROGRAMS = makedatprog$(EXEEXT) couriertcpd$(EXEEXT)<br />
bin_PROGRAMS = @binPROGRAMS_exec@<br />
sbin_PROGRAMS = @sbinPROGRAMS_exec@<br />
libexec_PROGRAMS = @libexecPROGRAMS_exec@<br />
--- courier-imap-4.4.1.20080920/imapd.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/imapd.rc.in 2008-10-21 23:00:30.781250000 +0200<br />
@@ -35,7 +35,7 @@<br />
<br />
umask $IMAP_UMASK<br />
@ULIMIT@ $IMAP_ULIMITD<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
--- courier-imap-4.4.1.20080920/pop3d.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/pop3d.rc.in 2008-10-21 23:00:49.875000000 +0200<br />
@@ -27,7 +27,7 @@<br />
<br />
case $1 in<br />
start)<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-imap-4.4.1-cygwin.patch<br />
<br />
Configure the package<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait<br />
<br />
Take a walk... and when ready execute the following command to build the package.<br />
<br />
$ make<br />
<br />
Time to go for some coffee... and then install the package with the usual<br />
<br />
$ make install<br />
$ make install-configure<br />
<br />
==Configuration==<br />
<br />
Setup courier-imap: $prefix/etc/imapd (where $prefix=/usr/lib/courier-imap)<br />
<br />
Set ADDRESS to a valid value (0 or 127.0.0.1) and change IMAP_ULIMITD to a value accepted by the command ulimit. I simply used the existing value returned by<br />
<br />
$ ulimit -v<br />
<br />
Setup authdaemon: /usr/local/etc/authlib/authdaemonrc. Create authdaemonrc file<br />
<br />
$ cp /usr/local/etc/authlib/authdaemonrc.dist /usr/local/etc/authlib/authdaemonrc<br />
<br />
Change number of daemons (I use only one) and enable DEBUG_LOGIN<br />
<br />
<source lang=text><br />
# The number of daemon processes that are started.<br />
daemons=1<br />
<br />
# DEBUG_LOGIN=2 - turn on debugging + log passwords too<br />
DEBUG_LOGIN=2<br />
</source><br />
<br />
==IMAP accounts==<br />
<br />
User accounts and settings are managed by ''userdb''. See [http://linux.die.net/man/8/makeuserdb makeuserdb] man page for details, or used the freshly new install man page - man makeuserdb<br />
<br />
Assuming ''username'' is your username, 1001 and 10545 are respectively the UID and GID of an existing user (part of your /etc/passwd and /etc/group). I use my own UID and GID. Create the mailuser home directory, if required. Create Maildir folder.<br />
<br />
$ mkdir -p /home/username<br />
$ cd /home/username<br />
$ /usr/lib/courier-imap/bin/maildirmake Maildir<br />
<br />
Create the userdb text file /usr/local/etc/authlib/userdb<br />
<br />
$ touch /usr/local/etc/authlib/userdb<br />
$ chmod 700 /usr/local/etc/authlib/userdb<br />
<br />
Edit /usr/local/etc/authlib/userdb, one line per account<br />
<br />
<source lang=text><br />
username[TAB]uid=1001|gid=10111|home=/home/username|mail=/home/username/Maildir|systempw=XXXXXX<br />
</source><br />
<br />
where XXXXXX is the encrypted password created with<br />
<br />
$ /usr/local/sbin/userdbpw.exe<br />
<br />
Create the (binary) userdb<br />
<br />
$ /usr/local/sbin/makeuserdb<br />
<br />
You should now have the following files created:<br />
<br />
* /usr/local/etc/authlib/userdb.dat<br />
* /usr/local/etc/authlib/userdbshadow.dat<br />
<br />
==Running==<br />
<br />
Install and configure syslogd. Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install inetutils (contains syslogd). Configure syslogd with the following command. It will create the /etc/syslogd.conf file and install a windows service using cygrunsrv<br />
<br />
$ syslogd-config<br />
<br />
Start the authlib and imap daemons with the following command:<br />
<br />
$ /usr/local/sbin/authdaemon start<br />
$ /usr/lib/courier-imap/libexec/imapd.rc start<br />
<br />
Stop the daemons with the following command:<br />
<br />
$ /usr/lib/courier-imap/libexec/imapd.rc stop<br />
$ /usr/local/sbin/authdaemon stop<br />
<br />
You'll find log messages in /var/log/messages (default target file as specified in /etc/syslogd.conf)<br />
<br />
<br />
$ strace /usr/local/sbin/authtest<br />
# This will open a dialog box to complain about DLL.<br />
$ export PATH=$PATH:/usr/local/lib/bin<br />
$ /usr/local/sbin/authtest ausername<br />
<br />
==Testing authlib==<br />
<br />
$ /usr/local/sbin/authtest username CCCCCC<br />
Authentication succeeded.<br />
<br />
Authenticated: username (uid 1001, gid 10111)<br />
Home Directory: /home/username<br />
Maildir: /home/username/Maildir<br />
Quota: (none)<br />
Encrypted Password: XXXXXX<br />
Cleartext Password: CCCCCC<br />
Options: (none)<br />
<br />
where username is you user name and XXXXXX is you encrypted password as provided in ''userbd'' text file. CCCCCC is your password in clear.<br />
<br />
==Troubleshooting==<br />
<br />
Should you have a doubt on the execution of a command (ie: no output) you can check if the application is able to load required DLL. This error is not reported. Using ''strace'', windows will complain about DLL not found, if any. To solve this problem you may need to add some path in your PATH. For example, in order to test authlib with authtest:<br />
<br />
$ strace /usr/local/sbin/authtest<br />
# This will open a dialog box to complain about DLL.<br />
$ export PATH=$PATH:/usr/local/lib/bin<br />
$ /usr/local/sbin/authtest ausername<br />
<br />
=Maildir=<br />
'''maildirmake''' is part of the courier-imap package<br />
<br />
$ /usr/lib/courier-imap/bin/maildirmake</div>Twalranthttps://wiki.yobi.be/index.php?title=Courier-Cygwin&diff=5232Courier-Cygwin2008-10-25T15:02:03Z<p>Twalrant: /* Running */</p>
<hr />
<div>=Courier-IMAP=<br />
<br />
Courier-IMAP requires the installation of the [http://www.courier-mta.org/authlib/ Courier Authentication Library] and the following cygwin tools and packages<br />
<br />
* patch, tar, make, gcc<br />
* crypt<br />
* libgdbm-devel<br />
* libtool (version 1.5.27a-1)<br />
* inetutils<br />
* cygrunsrv<br />
<br />
Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install the required packages.<br />
<br />
==Courier Authentication Library==<br />
<br />
Download and untar [http://www.courier-mta.org/download.php#authlib courier-authlib] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-authlib-0.61.0.tar.bz2 0.61.0]<br />
<br />
Apply the [{{#file:courrier-authlib-0.61.0-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# add libtool flag (-no-undefined) required for DLL creation<br />
# add missing dependencies<br />
# add PATH in start script to access new DLL (installed in a different directory)<br />
<br />
Solution source: http://lists.cairographics.org/archives/cairo/2004-April/001125.html<br />
<br />
<source lang=diff><br />
--- courier-authlib-0.61.0/makedat/Makefile.in 2008-05-24 16:21:09.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/makedat/Makefile.in 2008-10-21 16:02:38.709166700 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-authlib-0.61.0/Makefile.in 2008-07-12 21:41:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/Makefile.in 2008-10-23 22:59:03.843750000 +0200<br />
@@ -213,9 +213,10 @@<br />
LTCOMPILE = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
--mode=compile $(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) \<br />
$(AM_CPPFLAGS) $(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS)<br />
-CCLD = $(CC)<br />
+CCLD = $(CC) -no-undefined<br />
+CCLDEXE = $(CC)<br />
LINK = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
- --mode=link $(CCLD) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
+ --mode=link $(CCLDEXE) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
$(LDFLAGS) -o $@<br />
SOURCES = $(libauthcustom_la_SOURCES) $(libauthldap_la_SOURCES) \<br />
$(libauthmysql_la_SOURCES) $(libauthpam_la_SOURCES) \<br />
@@ -452,9 +453,9 @@<br />
README.authdebug.html<br />
<br />
DISTCLEANFILES = dbobj.config README_authlib.html<br />
-commonlibdep = libcourierauthcommon.la<br />
+commonlibdep = libcourierauthcommon.la libcourierauth.la<br />
commonldflags = -module -rpath $(pkglibdir) -export-symbols-regex 'courier_auth.*_init' -avoid-version<br />
-commonlibadd = libcourierauthcommon.la<br />
+commonlibadd = libcourierauthcommon.la libcourierauth.la<br />
libcourierauthcommon_t = @CRYPTLIBS@<br />
libcourierauthcommon_la_SOURCES = \<br />
auth.h courierauth.h \<br />
--- courier-authlib-0.61.0/authdaemond.in 2005-07-05 14:25:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/authdaemond.in 2008-10-25 12:03:32.140625000 +0200<br />
@@ -15,4 +15,10 @@<br />
set -a<br />
. @authdaemonrc@<br />
<br />
+# Some shared libraries (DLL) are installed in @libdir@/bin<br />
+# instead of @libdir@/@PACKAGE@<br />
+# Setting LD_LIBRARY_PATH at runtime or LR_RUN_PATH at linktime doesn't<br />
+# work in cygwin, only setting PATH works. <br />
+export PATH=$PATH:@libdir@/bin<br />
+<br />
exec ${sbindir}/courierlogger -pid=@authdaemonvar@/pid $LOGGEROPTS -$1 @libexecdir@/courier-authlib/authdaemond<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-authlib-0.61.0-cygwin.patch<br />
<br />
Configure the package without most authentication modules, keeping only ''userdb''.<br />
<br />
'''Note''': replace ''mailuser'' by an existing user name (in your /etc/passwd file). I used my own username.<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait --without-authpam --without-authldap --without-authpwd \<br />
--without-authshadow --without-authcustom --without-authpipe --without-authmysql --without-authpgsql --with-mailuser=mailuser \<br />
--with-mailgroup=mkgroup-l-d<br />
<br />
Take a long pause... and when ready execute the following command.<br />
<br />
$ make<br />
<br />
Take again a long pause... then check the result and install the libraries<br />
<br />
$ make check<br />
$ make install<br />
<br />
==Compilation and installation==<br />
<br />
Download and untar package [http://www.courier-mta.org/download.php#imap courier-imap] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-imap-4.4.1.tar.bz2 4.4.1.20080920]<br />
<br />
Apply the [{{#file:courrier-imap-4.4.1-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# incorrect usage of EXTEXT in main ''Makefile''<br />
# remove usage of /usr/lib/env in start/stop script (/usr/lib/env does not seem to work under Cygwin)<br />
<br />
<source lang=diff><br />
--- courier-imap-4.4.1.20080920/makedat/Makefile.in 2008-08-24 19:52:51.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/makedat/Makefile.in 2008-10-21 20:43:27.500000000 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-imap-4.4.1.20080920/Makefile.in 2008-09-20 14:48:46.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/Makefile.in 2008-10-21 20:59:45.156250000 +0200<br />
@@ -247,9 +247,9 @@<br />
CLEANFILES = $(databin_SCRIPTS) $(man_MANS) $(sysconf_DATA) $(sbin_SCRIPTS)<br />
databindir = $(datadir)<br />
databin_SCRIPTS = mkimapdcert mkpop3dcert<br />
-binPROGRAMS = imapd pop3d maildirmake maildiracl deliverquota maildirkw<br />
-sbinPROGRAMS = imaplogin pop3login<br />
-libexecPROGRAMS = makedatprog couriertcpd<br />
+binPROGRAMS = imapd$(EXEEXT) pop3d$(EXEEXT) maildirmake$(EXEEXT) maildiracl$(EXEEXT) deliverquota$(EXEEXT) maildirkw$(EXEEXT)<br />
+sbinPROGRAMS = imaplogin$(EXEEXT) pop3login$(EXEEXT)<br />
+libexecPROGRAMS = makedatprog$(EXEEXT) couriertcpd$(EXEEXT)<br />
bin_PROGRAMS = @binPROGRAMS_exec@<br />
sbin_PROGRAMS = @sbinPROGRAMS_exec@<br />
libexec_PROGRAMS = @libexecPROGRAMS_exec@<br />
--- courier-imap-4.4.1.20080920/imapd.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/imapd.rc.in 2008-10-21 23:00:30.781250000 +0200<br />
@@ -35,7 +35,7 @@<br />
<br />
umask $IMAP_UMASK<br />
@ULIMIT@ $IMAP_ULIMITD<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
--- courier-imap-4.4.1.20080920/pop3d.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/pop3d.rc.in 2008-10-21 23:00:49.875000000 +0200<br />
@@ -27,7 +27,7 @@<br />
<br />
case $1 in<br />
start)<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-imap-4.4.1-cygwin.patch<br />
<br />
Configure the package<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait<br />
<br />
Take a walk... and when ready execute the following command to build the package.<br />
<br />
$ make<br />
<br />
Time to go for some coffee... and then install the package with the usual<br />
<br />
$ make install<br />
$ make install-configure<br />
<br />
==Configuration==<br />
<br />
Setup courier-imap: $prefix/etc/imapd (where $prefix=/usr/lib/courier-imap)<br />
<br />
Set ADDRESS to a valid value (0 or 127.0.0.1) and change IMAP_ULIMITD to a value accepted by the command ulimit. I simply used the existing value returned by<br />
<br />
$ ulimit -v<br />
<br />
Setup authdaemon: /usr/local/etc/authlib/authdaemonrc. Create authdaemonrc file<br />
<br />
$ cp /usr/local/etc/authlib/authdaemonrc.dist /usr/local/etc/authlib/authdaemonrc<br />
<br />
Change number of daemons (I use only one) and enable DEBUG_LOGIN<br />
<br />
<source lang=text><br />
# The number of daemon processes that are started.<br />
daemons=1<br />
<br />
# DEBUG_LOGIN=2 - turn on debugging + log passwords too<br />
DEBUG_LOGIN=2<br />
</source><br />
<br />
==IMAP accounts==<br />
<br />
User accounts and settings are managed by ''userdb''. See [http://linux.die.net/man/8/makeuserdb makeuserdb] man page for details, or used the freshly new install man page - man makeuserdb<br />
<br />
Assuming ''username'' is your username, 1001 and 10545 are respectively the UID and GID of an existing user (part of your /etc/passwd and /etc/group). I use my own UID and GID. Create the mailuser home directory, if required. Create Maildir folder.<br />
<br />
$ mkdir -p /home/username<br />
$ cd /home/username<br />
$ /usr/lib/courier-imap/bin/maildirmake Maildir<br />
<br />
Create the userdb text file /usr/local/etc/authlib/userdb<br />
<br />
$ touch /usr/local/etc/authlib/userdb<br />
$ chmod 700 /usr/local/etc/authlib/userdb<br />
<br />
Edit /usr/local/etc/authlib/userdb, one line per account<br />
<br />
<source lang=text><br />
username[TAB]uid=1001|gid=10111|home=/home/username|mail=/home/username/Maildir|systempw=XXXXXX<br />
</source><br />
<br />
where XXXXXX is the encrypted password created with<br />
<br />
$ /usr/local/sbin/userdbpw.exe<br />
<br />
Create the (binary) userdb<br />
<br />
$ /usr/local/sbin/makeuserdb<br />
<br />
You should now have the following files created:<br />
<br />
* /usr/local/etc/authlib/userdb.dat<br />
* /usr/local/etc/authlib/userdbshadow.dat<br />
<br />
==Running==<br />
<br />
Install and configure syslogd. Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install inetutils (contains syslogd). Configure syslogd with the following command. It will create the /etc/syslogd.conf file and install a windows service using cygrunsrv<br />
<br />
$ syslogd-config<br />
<br />
Start the authlib and imap daemons with the following command:<br />
<br />
$ /usr/local/sbin/authdaemon start<br />
$ /usr/lib/courier-imap/libexec/imapd.rc start<br />
<br />
Stop the daemons with the following command:<br />
<br />
$ /usr/lib/courier-imap/libexec/imapd.rc stop<br />
$ /usr/local/sbin/authdaemon stop<br />
<br />
You'll find log messages in /var/log/messages (default target file as specified in /etc/syslogd.conf)<br />
<br />
'''NOTE:''' should you have a doubt on the execution of a command (ie: no output) you can check if the application is able to load required DLL. This error is not reported. Using ''strace'' windows will complain about DLL not found, if any. To solve this problem you may need to add some path in your PATH. For example, in order to test authlib with authtest:<br />
<br />
$ strace /usr/local/sbin/authtest<br />
# This will open a dialog box to complain about DLL.<br />
$ export PATH=$PATH:/usr/local/lib/bin<br />
$ /usr/local/sbin/authtest ausername<br />
<br />
=Maildir=<br />
'''maildirmake''' is part of the courier-imap package<br />
<br />
$ /usr/lib/courier-imap/bin/maildirmake</div>Twalranthttps://wiki.yobi.be/index.php?title=Courier-Cygwin&diff=5231Courier-Cygwin2008-10-25T14:57:06Z<p>Twalrant: /* Running */</p>
<hr />
<div>=Courier-IMAP=<br />
<br />
Courier-IMAP requires the installation of the [http://www.courier-mta.org/authlib/ Courier Authentication Library] and the following cygwin tools and packages<br />
<br />
* patch, tar, make, gcc<br />
* crypt<br />
* libgdbm-devel<br />
* libtool (version 1.5.27a-1)<br />
* inetutils<br />
* cygrunsrv<br />
<br />
Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install the required packages.<br />
<br />
==Courier Authentication Library==<br />
<br />
Download and untar [http://www.courier-mta.org/download.php#authlib courier-authlib] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-authlib-0.61.0.tar.bz2 0.61.0]<br />
<br />
Apply the [{{#file:courrier-authlib-0.61.0-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# add libtool flag (-no-undefined) required for DLL creation<br />
# add missing dependencies<br />
# add PATH in start script to access new DLL (installed in a different directory)<br />
<br />
Solution source: http://lists.cairographics.org/archives/cairo/2004-April/001125.html<br />
<br />
<source lang=diff><br />
--- courier-authlib-0.61.0/makedat/Makefile.in 2008-05-24 16:21:09.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/makedat/Makefile.in 2008-10-21 16:02:38.709166700 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-authlib-0.61.0/Makefile.in 2008-07-12 21:41:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/Makefile.in 2008-10-23 22:59:03.843750000 +0200<br />
@@ -213,9 +213,10 @@<br />
LTCOMPILE = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
--mode=compile $(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) \<br />
$(AM_CPPFLAGS) $(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS)<br />
-CCLD = $(CC)<br />
+CCLD = $(CC) -no-undefined<br />
+CCLDEXE = $(CC)<br />
LINK = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
- --mode=link $(CCLD) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
+ --mode=link $(CCLDEXE) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
$(LDFLAGS) -o $@<br />
SOURCES = $(libauthcustom_la_SOURCES) $(libauthldap_la_SOURCES) \<br />
$(libauthmysql_la_SOURCES) $(libauthpam_la_SOURCES) \<br />
@@ -452,9 +453,9 @@<br />
README.authdebug.html<br />
<br />
DISTCLEANFILES = dbobj.config README_authlib.html<br />
-commonlibdep = libcourierauthcommon.la<br />
+commonlibdep = libcourierauthcommon.la libcourierauth.la<br />
commonldflags = -module -rpath $(pkglibdir) -export-symbols-regex 'courier_auth.*_init' -avoid-version<br />
-commonlibadd = libcourierauthcommon.la<br />
+commonlibadd = libcourierauthcommon.la libcourierauth.la<br />
libcourierauthcommon_t = @CRYPTLIBS@<br />
libcourierauthcommon_la_SOURCES = \<br />
auth.h courierauth.h \<br />
--- courier-authlib-0.61.0/authdaemond.in 2005-07-05 14:25:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/authdaemond.in 2008-10-25 12:03:32.140625000 +0200<br />
@@ -15,4 +15,10 @@<br />
set -a<br />
. @authdaemonrc@<br />
<br />
+# Some shared libraries (DLL) are installed in @libdir@/bin<br />
+# instead of @libdir@/@PACKAGE@<br />
+# Setting LD_LIBRARY_PATH at runtime or LR_RUN_PATH at linktime doesn't<br />
+# work in cygwin, only setting PATH works. <br />
+export PATH=$PATH:@libdir@/bin<br />
+<br />
exec ${sbindir}/courierlogger -pid=@authdaemonvar@/pid $LOGGEROPTS -$1 @libexecdir@/courier-authlib/authdaemond<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-authlib-0.61.0-cygwin.patch<br />
<br />
Configure the package without most authentication modules, keeping only ''userdb''.<br />
<br />
'''Note''': replace ''mailuser'' by an existing user name (in your /etc/passwd file). I used my own username.<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait --without-authpam --without-authldap --without-authpwd \<br />
--without-authshadow --without-authcustom --without-authpipe --without-authmysql --without-authpgsql --with-mailuser=mailuser \<br />
--with-mailgroup=mkgroup-l-d<br />
<br />
Take a long pause... and when ready execute the following command.<br />
<br />
$ make<br />
<br />
Take again a long pause... then check the result and install the libraries<br />
<br />
$ make check<br />
$ make install<br />
<br />
==Compilation and installation==<br />
<br />
Download and untar package [http://www.courier-mta.org/download.php#imap courier-imap] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-imap-4.4.1.tar.bz2 4.4.1.20080920]<br />
<br />
Apply the [{{#file:courrier-imap-4.4.1-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# incorrect usage of EXTEXT in main ''Makefile''<br />
# remove usage of /usr/lib/env in start/stop script (/usr/lib/env does not seem to work under Cygwin)<br />
<br />
<source lang=diff><br />
--- courier-imap-4.4.1.20080920/makedat/Makefile.in 2008-08-24 19:52:51.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/makedat/Makefile.in 2008-10-21 20:43:27.500000000 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-imap-4.4.1.20080920/Makefile.in 2008-09-20 14:48:46.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/Makefile.in 2008-10-21 20:59:45.156250000 +0200<br />
@@ -247,9 +247,9 @@<br />
CLEANFILES = $(databin_SCRIPTS) $(man_MANS) $(sysconf_DATA) $(sbin_SCRIPTS)<br />
databindir = $(datadir)<br />
databin_SCRIPTS = mkimapdcert mkpop3dcert<br />
-binPROGRAMS = imapd pop3d maildirmake maildiracl deliverquota maildirkw<br />
-sbinPROGRAMS = imaplogin pop3login<br />
-libexecPROGRAMS = makedatprog couriertcpd<br />
+binPROGRAMS = imapd$(EXEEXT) pop3d$(EXEEXT) maildirmake$(EXEEXT) maildiracl$(EXEEXT) deliverquota$(EXEEXT) maildirkw$(EXEEXT)<br />
+sbinPROGRAMS = imaplogin$(EXEEXT) pop3login$(EXEEXT)<br />
+libexecPROGRAMS = makedatprog$(EXEEXT) couriertcpd$(EXEEXT)<br />
bin_PROGRAMS = @binPROGRAMS_exec@<br />
sbin_PROGRAMS = @sbinPROGRAMS_exec@<br />
libexec_PROGRAMS = @libexecPROGRAMS_exec@<br />
--- courier-imap-4.4.1.20080920/imapd.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/imapd.rc.in 2008-10-21 23:00:30.781250000 +0200<br />
@@ -35,7 +35,7 @@<br />
<br />
umask $IMAP_UMASK<br />
@ULIMIT@ $IMAP_ULIMITD<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
--- courier-imap-4.4.1.20080920/pop3d.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/pop3d.rc.in 2008-10-21 23:00:49.875000000 +0200<br />
@@ -27,7 +27,7 @@<br />
<br />
case $1 in<br />
start)<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-imap-4.4.1-cygwin.patch<br />
<br />
Configure the package<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait<br />
<br />
Take a walk... and when ready execute the following command to build the package.<br />
<br />
$ make<br />
<br />
Time to go for some coffee... and then install the package with the usual<br />
<br />
$ make install<br />
$ make install-configure<br />
<br />
==Configuration==<br />
<br />
Setup courier-imap: $prefix/etc/imapd (where $prefix=/usr/lib/courier-imap)<br />
<br />
Set ADDRESS to a valid value (0 or 127.0.0.1) and change IMAP_ULIMITD to a value accepted by the command ulimit. I simply used the existing value returned by<br />
<br />
$ ulimit -v<br />
<br />
Setup authdaemon: /usr/local/etc/authlib/authdaemonrc. Create authdaemonrc file<br />
<br />
$ cp /usr/local/etc/authlib/authdaemonrc.dist /usr/local/etc/authlib/authdaemonrc<br />
<br />
Change number of daemons (I use only one) and enable DEBUG_LOGIN<br />
<br />
<source lang=text><br />
# The number of daemon processes that are started.<br />
daemons=1<br />
<br />
# DEBUG_LOGIN=2 - turn on debugging + log passwords too<br />
DEBUG_LOGIN=2<br />
</source><br />
<br />
==IMAP accounts==<br />
<br />
User accounts and settings are managed by ''userdb''. See [http://linux.die.net/man/8/makeuserdb makeuserdb] man page for details, or used the freshly new install man page - man makeuserdb<br />
<br />
Assuming ''username'' is your username, 1001 and 10545 are respectively the UID and GID of an existing user (part of your /etc/passwd and /etc/group). I use my own UID and GID. Create the mailuser home directory, if required. Create Maildir folder.<br />
<br />
$ mkdir -p /home/username<br />
$ cd /home/username<br />
$ /usr/lib/courier-imap/bin/maildirmake Maildir<br />
<br />
Create the userdb text file /usr/local/etc/authlib/userdb<br />
<br />
$ touch /usr/local/etc/authlib/userdb<br />
$ chmod 700 /usr/local/etc/authlib/userdb<br />
<br />
Edit /usr/local/etc/authlib/userdb, one line per account<br />
<br />
<source lang=text><br />
username[TAB]uid=1001|gid=10111|home=/home/username|mail=/home/username/Maildir|systempw=XXXXXX<br />
</source><br />
<br />
where XXXXXX is the encrypted password created with<br />
<br />
$ /usr/local/sbin/userdbpw.exe<br />
<br />
Create the (binary) userdb<br />
<br />
$ /usr/local/sbin/makeuserdb<br />
<br />
You should now have the following files created:<br />
<br />
* /usr/local/etc/authlib/userdb.dat<br />
* /usr/local/etc/authlib/userdbshadow.dat<br />
<br />
==Running==<br />
<br />
Install and configure syslogd. Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install inetutils (contains syslogd). Configure syslogd with the following command. It will create the /etc/syslogd.conf file and install a windows service using cygrunsrv<br />
<br />
$ syslogd-config<br />
<br />
Start the authlib and imap daemons with the following command:<br />
<br />
$ /usr/local/sbin/authdaemon start<br />
$ /usr/lib/courier-imap/libexec/imapd.rc start<br />
<br />
Stop the daemons with the following command:<br />
<br />
$ /usr/lib/courier-imap/libexec/imapd.rc stop<br />
$ /usr/local/sbin/authdaemon stop<br />
<br />
You'll find log messages in /var/log/messages (default target file as specified in /etc/syslogd.conf)<br />
<br />
'''NOTE:''' should you have a doubt on the execution of a command you can check if the application is able to load required DLL. This error is not reported. Using ''strace'' windows will complain about DLL not found, if any. To solve this problem you may need to add some path in your PATH. For example, in order to test authlib with authtest:<br />
<br />
$ strace /usr/local/sbin/authtest<br />
# This will open a dialog box to complain about DLL.<br />
$ export PATH=$PATH:/usr/local/lib/bin<br />
$ /usr/local/sbin/authtest ausername<br />
<br />
=Maildir=<br />
'''maildirmake''' is part of the courier-imap package<br />
<br />
$ /usr/lib/courier-imap/bin/maildirmake</div>Twalranthttps://wiki.yobi.be/index.php?title=Courier-Cygwin&diff=5230Courier-Cygwin2008-10-25T13:10:20Z<p>Twalrant: /* Configuration */</p>
<hr />
<div>=Courier-IMAP=<br />
<br />
Courier-IMAP requires the installation of the [http://www.courier-mta.org/authlib/ Courier Authentication Library] and the following cygwin tools and packages<br />
<br />
* patch, tar, make, gcc<br />
* crypt<br />
* libgdbm-devel<br />
* libtool (version 1.5.27a-1)<br />
* inetutils<br />
* cygrunsrv<br />
<br />
Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install the required packages.<br />
<br />
==Courier Authentication Library==<br />
<br />
Download and untar [http://www.courier-mta.org/download.php#authlib courier-authlib] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-authlib-0.61.0.tar.bz2 0.61.0]<br />
<br />
Apply the [{{#file:courrier-authlib-0.61.0-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# add libtool flag (-no-undefined) required for DLL creation<br />
# add missing dependencies<br />
# add PATH in start script to access new DLL (installed in a different directory)<br />
<br />
Solution source: http://lists.cairographics.org/archives/cairo/2004-April/001125.html<br />
<br />
<source lang=diff><br />
--- courier-authlib-0.61.0/makedat/Makefile.in 2008-05-24 16:21:09.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/makedat/Makefile.in 2008-10-21 16:02:38.709166700 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-authlib-0.61.0/Makefile.in 2008-07-12 21:41:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/Makefile.in 2008-10-23 22:59:03.843750000 +0200<br />
@@ -213,9 +213,10 @@<br />
LTCOMPILE = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
--mode=compile $(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) \<br />
$(AM_CPPFLAGS) $(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS)<br />
-CCLD = $(CC)<br />
+CCLD = $(CC) -no-undefined<br />
+CCLDEXE = $(CC)<br />
LINK = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
- --mode=link $(CCLD) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
+ --mode=link $(CCLDEXE) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
$(LDFLAGS) -o $@<br />
SOURCES = $(libauthcustom_la_SOURCES) $(libauthldap_la_SOURCES) \<br />
$(libauthmysql_la_SOURCES) $(libauthpam_la_SOURCES) \<br />
@@ -452,9 +453,9 @@<br />
README.authdebug.html<br />
<br />
DISTCLEANFILES = dbobj.config README_authlib.html<br />
-commonlibdep = libcourierauthcommon.la<br />
+commonlibdep = libcourierauthcommon.la libcourierauth.la<br />
commonldflags = -module -rpath $(pkglibdir) -export-symbols-regex 'courier_auth.*_init' -avoid-version<br />
-commonlibadd = libcourierauthcommon.la<br />
+commonlibadd = libcourierauthcommon.la libcourierauth.la<br />
libcourierauthcommon_t = @CRYPTLIBS@<br />
libcourierauthcommon_la_SOURCES = \<br />
auth.h courierauth.h \<br />
--- courier-authlib-0.61.0/authdaemond.in 2005-07-05 14:25:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/authdaemond.in 2008-10-25 12:03:32.140625000 +0200<br />
@@ -15,4 +15,10 @@<br />
set -a<br />
. @authdaemonrc@<br />
<br />
+# Some shared libraries (DLL) are installed in @libdir@/bin<br />
+# instead of @libdir@/@PACKAGE@<br />
+# Setting LD_LIBRARY_PATH at runtime or LR_RUN_PATH at linktime doesn't<br />
+# work in cygwin, only setting PATH works. <br />
+export PATH=$PATH:@libdir@/bin<br />
+<br />
exec ${sbindir}/courierlogger -pid=@authdaemonvar@/pid $LOGGEROPTS -$1 @libexecdir@/courier-authlib/authdaemond<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-authlib-0.61.0-cygwin.patch<br />
<br />
Configure the package without most authentication modules, keeping only ''userdb''.<br />
<br />
'''Note''': replace ''mailuser'' by an existing user name (in your /etc/passwd file). I used my own username.<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait --without-authpam --without-authldap --without-authpwd \<br />
--without-authshadow --without-authcustom --without-authpipe --without-authmysql --without-authpgsql --with-mailuser=mailuser \<br />
--with-mailgroup=mkgroup-l-d<br />
<br />
Take a long pause... and when ready execute the following command.<br />
<br />
$ make<br />
<br />
Take again a long pause... then check the result and install the libraries<br />
<br />
$ make check<br />
$ make install<br />
<br />
==Compilation and installation==<br />
<br />
Download and untar package [http://www.courier-mta.org/download.php#imap courier-imap] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-imap-4.4.1.tar.bz2 4.4.1.20080920]<br />
<br />
Apply the [{{#file:courrier-imap-4.4.1-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# incorrect usage of EXTEXT in main ''Makefile''<br />
# remove usage of /usr/lib/env in start/stop script (/usr/lib/env does not seem to work under Cygwin)<br />
<br />
<source lang=diff><br />
--- courier-imap-4.4.1.20080920/makedat/Makefile.in 2008-08-24 19:52:51.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/makedat/Makefile.in 2008-10-21 20:43:27.500000000 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-imap-4.4.1.20080920/Makefile.in 2008-09-20 14:48:46.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/Makefile.in 2008-10-21 20:59:45.156250000 +0200<br />
@@ -247,9 +247,9 @@<br />
CLEANFILES = $(databin_SCRIPTS) $(man_MANS) $(sysconf_DATA) $(sbin_SCRIPTS)<br />
databindir = $(datadir)<br />
databin_SCRIPTS = mkimapdcert mkpop3dcert<br />
-binPROGRAMS = imapd pop3d maildirmake maildiracl deliverquota maildirkw<br />
-sbinPROGRAMS = imaplogin pop3login<br />
-libexecPROGRAMS = makedatprog couriertcpd<br />
+binPROGRAMS = imapd$(EXEEXT) pop3d$(EXEEXT) maildirmake$(EXEEXT) maildiracl$(EXEEXT) deliverquota$(EXEEXT) maildirkw$(EXEEXT)<br />
+sbinPROGRAMS = imaplogin$(EXEEXT) pop3login$(EXEEXT)<br />
+libexecPROGRAMS = makedatprog$(EXEEXT) couriertcpd$(EXEEXT)<br />
bin_PROGRAMS = @binPROGRAMS_exec@<br />
sbin_PROGRAMS = @sbinPROGRAMS_exec@<br />
libexec_PROGRAMS = @libexecPROGRAMS_exec@<br />
--- courier-imap-4.4.1.20080920/imapd.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/imapd.rc.in 2008-10-21 23:00:30.781250000 +0200<br />
@@ -35,7 +35,7 @@<br />
<br />
umask $IMAP_UMASK<br />
@ULIMIT@ $IMAP_ULIMITD<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
--- courier-imap-4.4.1.20080920/pop3d.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/pop3d.rc.in 2008-10-21 23:00:49.875000000 +0200<br />
@@ -27,7 +27,7 @@<br />
<br />
case $1 in<br />
start)<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-imap-4.4.1-cygwin.patch<br />
<br />
Configure the package<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait<br />
<br />
Take a walk... and when ready execute the following command to build the package.<br />
<br />
$ make<br />
<br />
Time to go for some coffee... and then install the package with the usual<br />
<br />
$ make install<br />
$ make install-configure<br />
<br />
==Configuration==<br />
<br />
Setup courier-imap: $prefix/etc/imapd (where $prefix=/usr/lib/courier-imap)<br />
<br />
Set ADDRESS to a valid value (0 or 127.0.0.1) and change IMAP_ULIMITD to a value accepted by the command ulimit. I simply used the existing value returned by<br />
<br />
$ ulimit -v<br />
<br />
Setup authdaemon: /usr/local/etc/authlib/authdaemonrc. Create authdaemonrc file<br />
<br />
$ cp /usr/local/etc/authlib/authdaemonrc.dist /usr/local/etc/authlib/authdaemonrc<br />
<br />
Change number of daemons (I use only one) and enable DEBUG_LOGIN<br />
<br />
<source lang=text><br />
# The number of daemon processes that are started.<br />
daemons=1<br />
<br />
# DEBUG_LOGIN=2 - turn on debugging + log passwords too<br />
DEBUG_LOGIN=2<br />
</source><br />
<br />
==IMAP accounts==<br />
<br />
User accounts and settings are managed by ''userdb''. See [http://linux.die.net/man/8/makeuserdb makeuserdb] man page for details, or used the freshly new install man page - man makeuserdb<br />
<br />
Assuming ''username'' is your username, 1001 and 10545 are respectively the UID and GID of an existing user (part of your /etc/passwd and /etc/group). I use my own UID and GID. Create the mailuser home directory, if required. Create Maildir folder.<br />
<br />
$ mkdir -p /home/username<br />
$ cd /home/username<br />
$ /usr/lib/courier-imap/bin/maildirmake Maildir<br />
<br />
Create the userdb text file /usr/local/etc/authlib/userdb<br />
<br />
$ touch /usr/local/etc/authlib/userdb<br />
$ chmod 700 /usr/local/etc/authlib/userdb<br />
<br />
Edit /usr/local/etc/authlib/userdb, one line per account<br />
<br />
<source lang=text><br />
username[TAB]uid=1001|gid=10111|home=/home/username|mail=/home/username/Maildir|systempw=XXXXXX<br />
</source><br />
<br />
where XXXXXX is the encrypted password created with<br />
<br />
$ /usr/local/sbin/userdbpw.exe<br />
<br />
Create the (binary) userdb<br />
<br />
$ /usr/local/sbin/makeuserdb<br />
<br />
You should now have the following files created:<br />
<br />
* /usr/local/etc/authlib/userdb.dat<br />
* /usr/local/etc/authlib/userdbshadow.dat<br />
<br />
==Running==<br />
<br />
Install and configure syslogd. Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install inetutils (contains syslogd). Configure syslogd with the following command. It will create the /etc/syslogd.conf file and install a windows service using cygrunsrv<br />
<br />
$ syslogd-config<br />
<br />
Start the authlib and imap daemons with the following command:<br />
<br />
$ /usr/local/sbin/authdaemon start<br />
$ /usr/lib/courier-imap/libexec/imapd.rc start<br />
<br />
Stop the daemons with the following command:<br />
<br />
$ /usr/lib/courier-imap/libexec/imapd.rc stop<br />
$ /usr/local/sbin/authdaemon stop<br />
<br />
You'll find log messages in /var/log/messages (default target file as specified in /etc/syslogd.conf)<br />
<br />
=Maildir=<br />
'''maildirmake''' is part of the courier-imap package<br />
<br />
$ /usr/lib/courier-imap/bin/maildirmake</div>Twalranthttps://wiki.yobi.be/index.php?title=Courier-Cygwin&diff=5228Courier-Cygwin2008-10-25T11:05:16Z<p>Twalrant: /* Courier Authentication Library */</p>
<hr />
<div>=Courier-IMAP=<br />
<br />
Courier-IMAP requires the installation of the [http://www.courier-mta.org/authlib/ Courier Authentication Library] and the following cygwin tools and packages<br />
<br />
* patch, tar, make, gcc<br />
* crypt<br />
* libgdbm-devel<br />
* libtool (version 1.5.27a-1)<br />
* inetutils<br />
* cygrunsrv<br />
<br />
Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install the required packages.<br />
<br />
==Courier Authentication Library==<br />
<br />
Download and untar [http://www.courier-mta.org/download.php#authlib courier-authlib] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-authlib-0.61.0.tar.bz2 0.61.0]<br />
<br />
Apply the [{{#file:courrier-authlib-0.61.0-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# add libtool flag (-no-undefined) required for DLL creation<br />
# add missing dependencies<br />
# add PATH in start script to access new DLL (installed in a different directory)<br />
<br />
Solution source: http://lists.cairographics.org/archives/cairo/2004-April/001125.html<br />
<br />
<source lang=diff><br />
--- courier-authlib-0.61.0/makedat/Makefile.in 2008-05-24 16:21:09.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/makedat/Makefile.in 2008-10-21 16:02:38.709166700 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-authlib-0.61.0/Makefile.in 2008-07-12 21:41:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/Makefile.in 2008-10-23 22:59:03.843750000 +0200<br />
@@ -213,9 +213,10 @@<br />
LTCOMPILE = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
--mode=compile $(CC) $(DEFS) $(DEFAULT_INCLUDES) $(INCLUDES) \<br />
$(AM_CPPFLAGS) $(CPPFLAGS) $(AM_CFLAGS) $(CFLAGS)<br />
-CCLD = $(CC)<br />
+CCLD = $(CC) -no-undefined<br />
+CCLDEXE = $(CC)<br />
LINK = $(LIBTOOL) --tag=CC $(AM_LIBTOOLFLAGS) $(LIBTOOLFLAGS) \<br />
- --mode=link $(CCLD) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
+ --mode=link $(CCLDEXE) $(AM_CFLAGS) $(CFLAGS) $(AM_LDFLAGS) \<br />
$(LDFLAGS) -o $@<br />
SOURCES = $(libauthcustom_la_SOURCES) $(libauthldap_la_SOURCES) \<br />
$(libauthmysql_la_SOURCES) $(libauthpam_la_SOURCES) \<br />
@@ -452,9 +453,9 @@<br />
README.authdebug.html<br />
<br />
DISTCLEANFILES = dbobj.config README_authlib.html<br />
-commonlibdep = libcourierauthcommon.la<br />
+commonlibdep = libcourierauthcommon.la libcourierauth.la<br />
commonldflags = -module -rpath $(pkglibdir) -export-symbols-regex 'courier_auth.*_init' -avoid-version<br />
-commonlibadd = libcourierauthcommon.la<br />
+commonlibadd = libcourierauthcommon.la libcourierauth.la<br />
libcourierauthcommon_t = @CRYPTLIBS@<br />
libcourierauthcommon_la_SOURCES = \<br />
auth.h courierauth.h \<br />
--- courier-authlib-0.61.0/authdaemond.in 2005-07-05 14:25:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/authdaemond.in 2008-10-25 12:03:32.140625000 +0200<br />
@@ -15,4 +15,10 @@<br />
set -a<br />
. @authdaemonrc@<br />
<br />
+# Some shared libraries (DLL) are installed in @libdir@/bin<br />
+# instead of @libdir@/@PACKAGE@<br />
+# Setting LD_LIBRARY_PATH at runtime or LR_RUN_PATH at linktime doesn't<br />
+# work in cygwin, only setting PATH works. <br />
+export PATH=$PATH:@libdir@/bin<br />
+<br />
exec ${sbindir}/courierlogger -pid=@authdaemonvar@/pid $LOGGEROPTS -$1 @libexecdir@/courier-authlib/authdaemond<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-authlib-0.61.0-cygwin.patch<br />
<br />
Configure the package without most authentication modules, keeping only ''userdb''.<br />
<br />
'''Note''': replace ''mailuser'' by an existing user name (in your /etc/passwd file). I used my own username.<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait --without-authpam --without-authldap --without-authpwd \<br />
--without-authshadow --without-authcustom --without-authpipe --without-authmysql --without-authpgsql --with-mailuser=mailuser \<br />
--with-mailgroup=mkgroup-l-d<br />
<br />
Take a long pause... and when ready execute the following command.<br />
<br />
$ make<br />
<br />
Take again a long pause... then check the result and install the libraries<br />
<br />
$ make check<br />
$ make install<br />
<br />
==Compilation and installation==<br />
<br />
Download and untar package [http://www.courier-mta.org/download.php#imap courier-imap] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-imap-4.4.1.tar.bz2 4.4.1.20080920]<br />
<br />
Apply the [{{#file:courrier-imap-4.4.1-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# incorrect usage of EXTEXT in main ''Makefile''<br />
# remove usage of /usr/lib/env in start/stop script (/usr/lib/env does not seem to work under Cygwin)<br />
<br />
<source lang=diff><br />
--- courier-imap-4.4.1.20080920/makedat/Makefile.in 2008-08-24 19:52:51.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/makedat/Makefile.in 2008-10-21 20:43:27.500000000 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-imap-4.4.1.20080920/Makefile.in 2008-09-20 14:48:46.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/Makefile.in 2008-10-21 20:59:45.156250000 +0200<br />
@@ -247,9 +247,9 @@<br />
CLEANFILES = $(databin_SCRIPTS) $(man_MANS) $(sysconf_DATA) $(sbin_SCRIPTS)<br />
databindir = $(datadir)<br />
databin_SCRIPTS = mkimapdcert mkpop3dcert<br />
-binPROGRAMS = imapd pop3d maildirmake maildiracl deliverquota maildirkw<br />
-sbinPROGRAMS = imaplogin pop3login<br />
-libexecPROGRAMS = makedatprog couriertcpd<br />
+binPROGRAMS = imapd$(EXEEXT) pop3d$(EXEEXT) maildirmake$(EXEEXT) maildiracl$(EXEEXT) deliverquota$(EXEEXT) maildirkw$(EXEEXT)<br />
+sbinPROGRAMS = imaplogin$(EXEEXT) pop3login$(EXEEXT)<br />
+libexecPROGRAMS = makedatprog$(EXEEXT) couriertcpd$(EXEEXT)<br />
bin_PROGRAMS = @binPROGRAMS_exec@<br />
sbin_PROGRAMS = @sbinPROGRAMS_exec@<br />
libexec_PROGRAMS = @libexecPROGRAMS_exec@<br />
--- courier-imap-4.4.1.20080920/imapd.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/imapd.rc.in 2008-10-21 23:00:30.781250000 +0200<br />
@@ -35,7 +35,7 @@<br />
<br />
umask $IMAP_UMASK<br />
@ULIMIT@ $IMAP_ULIMITD<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
--- courier-imap-4.4.1.20080920/pop3d.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/pop3d.rc.in 2008-10-21 23:00:49.875000000 +0200<br />
@@ -27,7 +27,7 @@<br />
<br />
case $1 in<br />
start)<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-imap-4.4.1-cygwin.patch<br />
<br />
Configure the package<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait<br />
<br />
Take a walk... and when ready execute the following command to build the package.<br />
<br />
$ make<br />
<br />
Time to go for some coffee... and then install the package with the usual<br />
<br />
$ make install<br />
$ make install-configure<br />
<br />
==Configuration==<br />
<br />
Set ADDRESS to a valid value (0 or 127.0.0.1) and change IMAP_ULIMITD in $prefix/etc/imapd (where $prefix=/usr/lib/courier-imap) to a value accepted by the command ulimit. I simply used the existing value returned by<br />
<br />
$ ulimit -v<br />
<br />
Setup authdaemon. Create authdaemonrc file<br />
<br />
$ cp /usr/local/etc/authlib/authdaemonrc.dist /usr/local/etc/authlib/authdaemonrc<br />
<br />
Change number of daemons (I use only one) and enable DEBUG_LOGIN<br />
<br />
<source lang=text><br />
# The number of daemon processes that are started.<br />
daemons=1<br />
# DEBUG_LOGIN=2 - turn on debugging + log passwords too<br />
DEBUG_LOGIN=2<br />
</source><br />
<br />
==IMAP accounts==<br />
<br />
User accounts and settings are managed by ''userdb''. See [http://linux.die.net/man/8/makeuserdb makeuserdb] man page for details, or used the freshly new install man page - man makeuserdb<br />
<br />
Assuming ''username'' is your username, 1001 and 10545 are respectively the UID and GID of an existing user (part of your /etc/passwd and /etc/group). I use my own UID and GID. Create the mailuser home directory, if required. Create Maildir folder.<br />
<br />
$ mkdir -p /home/username<br />
$ cd /home/username<br />
$ /usr/lib/courier-imap/bin/maildirmake Maildir<br />
<br />
Create the userdb text file /usr/local/etc/authlib/userdb<br />
<br />
$ touch /usr/local/etc/authlib/userdb<br />
$ chmod 700 /usr/local/etc/authlib/userdb<br />
<br />
Edit /usr/local/etc/authlib/userdb, one line per account<br />
<br />
<source lang=text><br />
username[TAB]uid=1001|gid=10111|home=/home/username|mail=/home/username/Maildir|systempw=XXXXXX<br />
</source><br />
<br />
where XXXXXX is the encrypted password created with<br />
<br />
$ /usr/local/sbin/userdbpw.exe<br />
<br />
Create the (binary) userdb<br />
<br />
$ /usr/local/sbin/makeuserdb<br />
<br />
You should now have the following files created:<br />
<br />
* /usr/local/etc/authlib/userdb.dat<br />
* /usr/local/etc/authlib/userdbshadow.dat<br />
<br />
==Running==<br />
<br />
Install and configure syslogd. Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install inetutils (contains syslogd). Configure syslogd with the following command. It will create the /etc/syslogd.conf file and install a windows service using cygrunsrv<br />
<br />
$ syslogd-config<br />
<br />
Start the authlib and imap daemons with the following command:<br />
<br />
$ /usr/local/sbin/authdaemon start<br />
$ /usr/lib/courier-imap/libexec/imapd.rc start<br />
<br />
Stop the daemons with the following command:<br />
<br />
$ /usr/lib/courier-imap/libexec/imapd.rc stop<br />
$ /usr/local/sbin/authdaemon stop<br />
<br />
You'll find log messages in /var/log/messages (default target file as specified in /etc/syslogd.conf)<br />
<br />
=Maildir=<br />
'''maildirmake''' is part of the courier-imap package<br />
<br />
$ /usr/lib/courier-imap/bin/maildirmake</div>Twalranthttps://wiki.yobi.be/index.php?title=Courier-Cygwin&diff=5225Courier-Cygwin2008-10-22T10:05:41Z<p>Twalrant: /* IMAP accounts */</p>
<hr />
<div>=Courier-IMAP=<br />
<br />
Courier-IMAP requires the installation of the [http://www.courier-mta.org/authlib/ Courier Authentication Library] and the following cygwin tools and packages<br />
<br />
* patch, tar, make, gcc<br />
* crypt<br />
* libgdbm-devel<br />
* libtool (version 1.5.27a-1)<br />
* inetutils<br />
* cygrunsrv<br />
<br />
Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install the required packages.<br />
<br />
==Courier Authentication Library==<br />
<br />
Download and untar [http://www.courier-mta.org/download.php#authlib courier-authlib] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-authlib-0.61.0.tar.bz2 0.61.0]<br />
<br />
Apply the [{{#file:courrier-authlib-0.61.0-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# missing ''crypt'' library in main ''Makefile''<br />
# incorrect or incompatible (text-)format of install library files (*.la). Unix like library name (as provided by 'dlname') are not used under cygwin. Hence skip the related operation in the installation.<br />
<br />
<source lang=diff><br />
--- courier-authlib-0.61.0/makedat/Makefile.in 2008-05-24 16:21:09.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/makedat/Makefile.in 2008-10-21 16:02:38.709166700 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-authlib-0.61.0/Makefile.in 2008-07-12 21:41:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/Makefile.in 2008-10-21 18:51:47.093466600 +0200<br />
@@ -1659,7 +1659,6 @@<br />
$(DESTDIR)$(sbindir)/userdbpw ; \<br />
$(INSTALL_SCRIPT) userdb-test-cram-md5.pl \<br />
$(DESTDIR)$(sbindir)/userdb-test-cram-md5<br />
- for f in $(pkglib_LTLIBRARIES); do . $$f; rm -f $(DESTDIR)$(pkglibdir)/$$dlname.0 $(DESTDIR)$(pkglibdir)/$$dlname.0.0; ln -s $$dlname $(DESTDIR)$(pkglibdir)/$$dlname.0; done<br />
<br />
uninstall-hook: uninstall-authldaprc uninstall-authdaemonrc uninstall-authmysqlrc uninstall-authpgsqlrc<br />
rm -f $(DESTDIR)$(pkglibexecdir)/authdaemond<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-authlib-0.61.0-cygwin.patch<br />
<br />
Configure the package without most authentication modules, keeping only ''userdb''.<br />
<br />
'''Note''': replace ''mailuser'' by an existing user name (in your /etc/passwd file). I used my own username.<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait --without-authpam --without-authldap --without-authpwd \<br />
--without-authshadow --without-custom --without-authpipe --without-authmysql --without-authpgsql --with-mailuser=mailuser \<br />
--with-mailgroup=mkgroup-l-d<br />
<br />
Take a long pause... and when ready execute the following command. The ''LDFLAGS'' and ''LIBS'' variables are used to correct the second issue.<br />
<br />
$ make LDFLAGS=-lcrypt LIBS=-lcrypt<br />
<br />
Take again a long pause... then check the result and install the libraries<br />
<br />
$ make check<br />
$ make install<br />
<br />
==Compilation and installation==<br />
<br />
Download and untar package [http://www.courier-mta.org/download.php#imap courier-imap] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-imap-4.4.1.tar.bz2 4.4.1.20080920]<br />
<br />
Apply the [{{#file:courrier-imap-4.4.1-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# incorrect usage of EXTEXT in main ''Makefile''<br />
# remove usage of /usr/lib/env in start/stop script (/usr/lib/env does not seem to work under Cygwin)<br />
<br />
<source lang=diff><br />
--- courier-imap-4.4.1.20080920/makedat/Makefile.in 2008-08-24 19:52:51.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/makedat/Makefile.in 2008-10-21 20:43:27.500000000 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-imap-4.4.1.20080920/Makefile.in 2008-09-20 14:48:46.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/Makefile.in 2008-10-21 20:59:45.156250000 +0200<br />
@@ -247,9 +247,9 @@<br />
CLEANFILES = $(databin_SCRIPTS) $(man_MANS) $(sysconf_DATA) $(sbin_SCRIPTS)<br />
databindir = $(datadir)<br />
databin_SCRIPTS = mkimapdcert mkpop3dcert<br />
-binPROGRAMS = imapd pop3d maildirmake maildiracl deliverquota maildirkw<br />
-sbinPROGRAMS = imaplogin pop3login<br />
-libexecPROGRAMS = makedatprog couriertcpd<br />
+binPROGRAMS = imapd$(EXEEXT) pop3d$(EXEEXT) maildirmake$(EXEEXT) maildiracl$(EXEEXT) deliverquota$(EXEEXT) maildirkw$(EXEEXT)<br />
+sbinPROGRAMS = imaplogin$(EXEEXT) pop3login$(EXEEXT)<br />
+libexecPROGRAMS = makedatprog$(EXEEXT) couriertcpd$(EXEEXT)<br />
bin_PROGRAMS = @binPROGRAMS_exec@<br />
sbin_PROGRAMS = @sbinPROGRAMS_exec@<br />
libexec_PROGRAMS = @libexecPROGRAMS_exec@<br />
--- courier-imap-4.4.1.20080920/imapd.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/imapd.rc.in 2008-10-21 23:00:30.781250000 +0200<br />
@@ -35,7 +35,7 @@<br />
<br />
umask $IMAP_UMASK<br />
@ULIMIT@ $IMAP_ULIMITD<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
--- courier-imap-4.4.1.20080920/pop3d.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/pop3d.rc.in 2008-10-21 23:00:49.875000000 +0200<br />
@@ -27,7 +27,7 @@<br />
<br />
case $1 in<br />
start)<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-imap-4.4.1-cygwin.patch<br />
<br />
Configure the package<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait<br />
<br />
Take a walk... and when ready execute the following command to build the package.<br />
<br />
$ make<br />
<br />
Time to go for some coffee... and then install the package with the usual<br />
<br />
$ make install<br />
$ make install-configure<br />
<br />
==Configuration==<br />
<br />
Set ADDRESS to a valid value (0 or 127.0.0.1) and change IMAP_ULIMITD in $prefix/etc/imapd (where $prefix=/usr/lib/courier-imap) to a value accepted by the command ulimit. I simply used the existing value returned by<br />
<br />
$ ulimit -v<br />
<br />
Setup authdaemon. Create authdaemonrc file<br />
<br />
$ cp /usr/local/etc/authlib/authdaemonrc.dist /usr/local/etc/authlib/authdaemonrc<br />
<br />
Change number of daemons (I use only one) and enable DEBUG_LOGIN<br />
<br />
<source lang=text><br />
# The number of daemon processes that are started.<br />
daemons=1<br />
# DEBUG_LOGIN=2 - turn on debugging + log passwords too<br />
DEBUG_LOGIN=2<br />
</source><br />
<br />
==IMAP accounts==<br />
<br />
User accounts and settings are managed by ''userdb''. See [http://linux.die.net/man/8/makeuserdb makeuserdb] man page for details, or used the freshly new install man page - man makeuserdb<br />
<br />
Assuming ''username'' is your username, 1001 and 10545 are respectively the UID and GID of an existing user (part of your /etc/passwd and /etc/group). I use my own UID and GID. Create the mailuser home directory, if required. Create Maildir folder.<br />
<br />
$ mkdir -p /home/username<br />
$ cd /home/username<br />
$ /usr/lib/courier-imap/bin/maildirmake Maildir<br />
<br />
Create the userdb text file /usr/local/etc/authlib/userdb<br />
<br />
$ touch /usr/local/etc/authlib/userdb<br />
$ chmod 700 /usr/local/etc/authlib/userdb<br />
<br />
Edit /usr/local/etc/authlib/userdb, one line per account<br />
<br />
<source lang=text><br />
username[TAB]uid=1001|gid=10111|home=/home/username|mail=/home/username/Maildir|systempw=XXXXXX<br />
</source><br />
<br />
where XXXXXX is the encrypted password created with<br />
<br />
$ /usr/local/sbin/userdbpw.exe<br />
<br />
Create the (binary) userdb<br />
<br />
$ /usr/local/sbin/makeuserdb<br />
<br />
You should now have the following files created:<br />
<br />
* /usr/local/etc/authlib/userdb.dat<br />
* /usr/local/etc/authlib/userdbshadow.dat<br />
<br />
==Running==<br />
<br />
Install and configure syslogd. Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install inetutils (contains syslogd). Configure syslogd with the following command. It will create the /etc/syslogd.conf file and install a windows service using cygrunsrv<br />
<br />
$ syslogd-config<br />
<br />
Start the authlib and imap daemons with the following command:<br />
<br />
$ /usr/local/sbin/authdaemon start<br />
$ /usr/lib/courier-imap/libexec/imapd.rc start<br />
<br />
Stop the daemons with the following command:<br />
<br />
$ /usr/lib/courier-imap/libexec/imapd.rc stop<br />
$ /usr/local/sbin/authdaemon stop<br />
<br />
You'll find log messages in /var/log/messages (default target file as specified in /etc/syslogd.conf)<br />
<br />
=Maildir=<br />
'''maildirmake''' is part of the courier-imap package<br />
<br />
$ /usr/lib/courier-imap/bin/maildirmake</div>Twalranthttps://wiki.yobi.be/index.php?title=Courier-Cygwin&diff=5224Courier-Cygwin2008-10-22T09:54:23Z<p>Twalrant: </p>
<hr />
<div>=Courier-IMAP=<br />
<br />
Courier-IMAP requires the installation of the [http://www.courier-mta.org/authlib/ Courier Authentication Library] and the following cygwin tools and packages<br />
<br />
* patch, tar, make, gcc<br />
* crypt<br />
* libgdbm-devel<br />
* libtool (version 1.5.27a-1)<br />
* inetutils<br />
* cygrunsrv<br />
<br />
Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install the required packages.<br />
<br />
==Courier Authentication Library==<br />
<br />
Download and untar [http://www.courier-mta.org/download.php#authlib courier-authlib] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-authlib-0.61.0.tar.bz2 0.61.0]<br />
<br />
Apply the [{{#file:courrier-authlib-0.61.0-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# missing ''crypt'' library in main ''Makefile''<br />
# incorrect or incompatible (text-)format of install library files (*.la). Unix like library name (as provided by 'dlname') are not used under cygwin. Hence skip the related operation in the installation.<br />
<br />
<source lang=diff><br />
--- courier-authlib-0.61.0/makedat/Makefile.in 2008-05-24 16:21:09.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/makedat/Makefile.in 2008-10-21 16:02:38.709166700 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-authlib-0.61.0/Makefile.in 2008-07-12 21:41:08.000000000 +0200<br />
+++ courier-authlib-0.61.0-cygwin/Makefile.in 2008-10-21 18:51:47.093466600 +0200<br />
@@ -1659,7 +1659,6 @@<br />
$(DESTDIR)$(sbindir)/userdbpw ; \<br />
$(INSTALL_SCRIPT) userdb-test-cram-md5.pl \<br />
$(DESTDIR)$(sbindir)/userdb-test-cram-md5<br />
- for f in $(pkglib_LTLIBRARIES); do . $$f; rm -f $(DESTDIR)$(pkglibdir)/$$dlname.0 $(DESTDIR)$(pkglibdir)/$$dlname.0.0; ln -s $$dlname $(DESTDIR)$(pkglibdir)/$$dlname.0; done<br />
<br />
uninstall-hook: uninstall-authldaprc uninstall-authdaemonrc uninstall-authmysqlrc uninstall-authpgsqlrc<br />
rm -f $(DESTDIR)$(pkglibexecdir)/authdaemond<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-authlib-0.61.0-cygwin.patch<br />
<br />
Configure the package without most authentication modules, keeping only ''userdb''.<br />
<br />
'''Note''': replace ''mailuser'' by an existing user name (in your /etc/passwd file). I used my own username.<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait --without-authpam --without-authldap --without-authpwd \<br />
--without-authshadow --without-custom --without-authpipe --without-authmysql --without-authpgsql --with-mailuser=mailuser \<br />
--with-mailgroup=mkgroup-l-d<br />
<br />
Take a long pause... and when ready execute the following command. The ''LDFLAGS'' and ''LIBS'' variables are used to correct the second issue.<br />
<br />
$ make LDFLAGS=-lcrypt LIBS=-lcrypt<br />
<br />
Take again a long pause... then check the result and install the libraries<br />
<br />
$ make check<br />
$ make install<br />
<br />
==Compilation and installation==<br />
<br />
Download and untar package [http://www.courier-mta.org/download.php#imap courier-imap] in your favorite sandbox.<br />
Version used: [http://prdownloads.sourceforge.net/courier/courier-imap-4.4.1.tar.bz2 4.4.1.20080920]<br />
<br />
Apply the [{{#file:courrier-imap-4.4.1-cygwin.patch}} patch] before configuration to correct following issues:<br />
<br />
# incorrect usage of EXEEXT in ''makedat/Makefile''<br />
# incorrect usage of EXTEXT in main ''Makefile''<br />
# remove usage of /usr/lib/env in start/stop script (/usr/lib/env does not seem to work under Cygwin)<br />
<br />
<source lang=diff><br />
--- courier-imap-4.4.1.20080920/makedat/Makefile.in 2008-08-24 19:52:51.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/makedat/Makefile.in 2008-10-21 20:43:27.500000000 +0200<br />
@@ -182,7 +182,7 @@<br />
libexecdir = @libexecdir@<br />
localedir = @localedir@<br />
localstatedir = @localstatedir@<br />
-makedatprog_target = @makedatprog_target@<br />
+makedatprog_target = @makedatprog_target@$(EXEEXT)<br />
makedatprogpath = @makedatprogpath@<br />
mandir = @mandir@<br />
mkdir_p = @mkdir_p@<br />
@@ -198,7 +198,7 @@<br />
target_alias = @target_alias@<br />
top_builddir = @top_builddir@<br />
top_srcdir = @top_srcdir@<br />
-noinst_PROGRAMS = @makedatprog_target@<br />
+noinst_PROGRAMS = @makedatprog_target@$(EXEEXT)<br />
makedatprog_SOURCES = makedatprog.c<br />
makedatprog_DEPENDENCIES = @dblibrary@<br />
makedatprog_LDADD = @dblibrary@<br />
--- courier-imap-4.4.1.20080920/Makefile.in 2008-09-20 14:48:46.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/Makefile.in 2008-10-21 20:59:45.156250000 +0200<br />
@@ -247,9 +247,9 @@<br />
CLEANFILES = $(databin_SCRIPTS) $(man_MANS) $(sysconf_DATA) $(sbin_SCRIPTS)<br />
databindir = $(datadir)<br />
databin_SCRIPTS = mkimapdcert mkpop3dcert<br />
-binPROGRAMS = imapd pop3d maildirmake maildiracl deliverquota maildirkw<br />
-sbinPROGRAMS = imaplogin pop3login<br />
-libexecPROGRAMS = makedatprog couriertcpd<br />
+binPROGRAMS = imapd$(EXEEXT) pop3d$(EXEEXT) maildirmake$(EXEEXT) maildiracl$(EXEEXT) deliverquota$(EXEEXT) maildirkw$(EXEEXT)<br />
+sbinPROGRAMS = imaplogin$(EXEEXT) pop3login$(EXEEXT)<br />
+libexecPROGRAMS = makedatprog$(EXEEXT) couriertcpd$(EXEEXT)<br />
bin_PROGRAMS = @binPROGRAMS_exec@<br />
sbin_PROGRAMS = @sbinPROGRAMS_exec@<br />
libexec_PROGRAMS = @libexecPROGRAMS_exec@<br />
--- courier-imap-4.4.1.20080920/imapd.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/imapd.rc.in 2008-10-21 23:00:30.781250000 +0200<br />
@@ -35,7 +35,7 @@<br />
<br />
umask $IMAP_UMASK<br />
@ULIMIT@ $IMAP_ULIMITD<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
--- courier-imap-4.4.1.20080920/pop3d.rc.in 2008-05-04 15:12:47.000000000 +0200<br />
+++ courier-imap-4.4.1.20080920-cygwin/pop3d.rc.in 2008-10-21 23:00:49.875000000 +0200<br />
@@ -27,7 +27,7 @@<br />
<br />
case $1 in<br />
start)<br />
- @SETENV@ -i @SHELL@ -c " set -a ;<br />
+ @SHELL@ -c " set -a ;<br />
prefix=@prefix@ ;<br />
exec_prefix=@exec_prefix@ ;<br />
bindir=@bindir@ ;<br />
</source><br />
<br />
Install the patch<br />
<br />
$ patch -Np1 < courrier-imap-4.4.1-cygwin.patch<br />
<br />
Configure the package<br />
<br />
$ ./configure --disable-root-check --with-waitfunc=wait<br />
<br />
Take a walk... and when ready execute the following command to build the package.<br />
<br />
$ make<br />
<br />
Time to go for some coffee... and then install the package with the usual<br />
<br />
$ make install<br />
$ make install-configure<br />
<br />
==Configuration==<br />
<br />
Set ADDRESS to a valid value (0 or 127.0.0.1) and change IMAP_ULIMITD in $prefix/etc/imapd (where $prefix=/usr/lib/courier-imap) to a value accepted by the command ulimit. I simply used the existing value returned by<br />
<br />
$ ulimit -v<br />
<br />
Setup authdaemon. Create authdaemonrc file<br />
<br />
$ cp /usr/local/etc/authlib/authdaemonrc.dist /usr/local/etc/authlib/authdaemonrc<br />
<br />
Change number of daemons (I use only one) and enable DEBUG_LOGIN<br />
<br />
<source lang=text><br />
# The number of daemon processes that are started.<br />
daemons=1<br />
# DEBUG_LOGIN=2 - turn on debugging + log passwords too<br />
DEBUG_LOGIN=2<br />
</source><br />
<br />
==IMAP accounts==<br />
<br />
User accounts and settings are managed by ''userdb''. See http://linux.die.net/man/8/makeuserdb for details, or used the freshly new install man page - man makeuserdb<br />
<br />
Assuming ''username'' is your username, 1001 and 10545 are respectively the UID and GID of an existing user (part of your /etc/passwd and /etc/group). I use my own UID and GID. Create the mailuser home directory, if required. Create Maildir folder.<br />
<br />
$ mkdir -p /home/username<br />
$ cd /home/username<br />
$ /usr/lib/courier-imap/bin/maildirmake Maildir<br />
<br />
Create the userdb text file /usr/local/etc/authlib/userdb<br />
<br />
$ touch /usr/local/etc/authlib/userdb<br />
$ chmod 700 /usr/local/etc/authlib/userdb<br />
<br />
Edit /usr/local/etc/authlib/userdb, one line per account<br />
<br />
<source lang=text><br />
username[TAB]uid=1001|gid=10111|home=/home/username|mail=/home/username/Maildir|systempw=XXXXXX<br />
</source><br />
<br />
where XXXXXX is the encrypted password created with<br />
<br />
$ /usr/local/sbin/userdbpw.exe<br />
<br />
Create the (binary) userdb<br />
<br />
$ /usr/local/sbin/makeuserdb<br />
<br />
You should now have the following files created:<br />
<br />
* /usr/local/etc/authlib/userdb.dat<br />
* /usr/local/etc/authlib/userdbshadow.dat<br />
<br />
==Running==<br />
<br />
Install and configure syslogd. Run the [http://www.cygwin.com/setup.exe Cygwin setup] program. Locate, select and install inetutils (contains syslogd). Configure syslogd with the following command. It will create the /etc/syslogd.conf file and install a windows service using cygrunsrv<br />
<br />
$ syslogd-config<br />
<br />
Start the authlib and imap daemons with the following command:<br />
<br />
$ /usr/local/sbin/authdaemon start<br />
$ /usr/lib/courier-imap/libexec/imapd.rc start<br />
<br />
Stop the daemons with the following command:<br />
<br />
$ /usr/lib/courier-imap/libexec/imapd.rc stop<br />
$ /usr/local/sbin/authdaemon stop<br />
<br />
You'll find log messages in /var/log/messages (default target file as specified in /etc/syslogd.conf)<br />
<br />
=Maildir=<br />
'''maildirmake''' is part of the courier-imap package<br />
<br />
$ /usr/lib/courier-imap/bin/maildirmake</div>Twalrant