#!/bin/cat
$Id: FAQ.Passwords_on_Unix.txt,v 1.6 2019/04/02 17:19:21 gilles Exp gilles $

This document is also available online at
https://imapsync.lamiral.info/FAQ.d/
https://imapsync.lamiral.info/FAQ.d/FAQ.Passwords_on_Unix.txt


=======================================================================
              Imapsync issues with passwords on Unix.
=======================================================================


=======================================================================
Q. On Unix, some passwords contain some weird *(),;&~ characters. 
   Login fails.

R1. Enclose the password within single-quotes in the imapsync
    command line:

    imapsync ... --password1 'passw*(),;&rd~'

R2. If R1 fails, with very old imapsync or old Mail::IMAPClient Perl module,
    try also using double-quotes within single-quotes. It will enclose
    the password within double-quotes in the imap LOGIN command:

    imapsync ... --password1 '"passw*(),;&rd~"'

Old Mail::IMAPClient 3.37 is a bad horse having this issue solved
by this double-quotes trick.
fixed in 3.38 https://metacpan.org/changes/distribution/Mail-IMAPClient
version 3.38: Tue Feb  9 02:48:21 UTC 2016
        - rt.cpan.org#110273: failure to quote password values
          (regression introduced in 3.36 via fix for rt.cpan.org#100601)

R3. Change the password to keep only f...ing normal characters.
    Make it long and random if strong security is your concern

=======================================================================
=======================================================================