TODO

   1 -*- indented-text -*-
   2
   3 URGENT ---------------------------------------------------------------
   4
   5
   6 IMPORTANT ------------------------------------------------------------
   7
   8 Cross-test versions
   9
  10   Part of the regression suite should be making sure that we don't
  11   break backwards compatibility: old clients vs new servers and so
  12   on.  Ideally we would test the cross product of versions.
  13
  14   It might be sufficient to test downloads from well-known public
  15   rsync servers running different versions of rsync.  This will give
  16   some testing and also be the most common case for having different
  17   versions and not being able to upgrade.
  18
  19 use chroot
  20
  21   If the platform doesn't support it, then don't even try.
  22
  23   If running as non-root, then don't fail, just give a warning.
  24   (There was a thread about this a while ago?)
  25
  26     http://lists.samba.org/pipermail/rsync/2001-August/thread.html
  27     http://lists.samba.org/pipermail/rsync/2001-September/thread.html
  28
  29 --files-from
  30
  31   Avoids traversal.  Better option than a pile of --include statements
  32   for people who want to generate the file list using a find(1)
  33   command or a script.
  34
  35 Performance
  36
  37   Traverse just one directory at a time.  Tridge says it's possible.
  38
  39   Can possibly also be smarter about memory use while looking for hard
  40   links by reducing the refcount as we find alternative names.
  41
  42 IPv6
  43
  44   Define a syntax for IPv6 literal addresses.  Since they include
  45   colons, they tend to break most naming systems, including ours.
  46   Based on the HTTP IPv6 syntax, I think we should use
  47
  48      rsync://[::1]/foo/bar
  49      [::1]::bar
  50
  51   which should just take a small change to the parser code.
  52
  53 Errors
  54
  55   If we hang or get SIGINT, then explain where we were up to.  Perhaps
  56   have a static buffer that contains the current function name, or
  57   some kind of description of what we were trying to do.  This is a
  58   little easier on people than needing to run strace/truss.
  59
  60   "The dungeon collapses!  You are killed."  Rather than "unexpected
  61   eof" give a message that is more detailed if possible and also more
  62   helpful.
  63
  64 File attributes
  65
  66   Device major/minor numbers should be at least 32 bits each.  See
  67   http://lists.samba.org/pipermail/rsync/2001-November/005357.html
  68
  69   Transfer ACLs.  Need to think of a standard representation.
  70   Probably better not to even try to convert between NT and POSIX.
  71   Possibly can share some code with Samba.
  72
  73 Empty directories
  74
  75   With the current common --include '*/' --exclude '*' pattern, people
  76   can end up with many empty directories.  We might avoid this by
  77   lazily creating such directories.
  78
  79 zlib
  80
  81   Perhaps don't use our own zlib.  Will we actually be incompatible,
  82   or just be slightly less efficient?
  83
  84 logging
  85
  86   Perhaps flush stdout after each filename, so that people trying to
  87   monitor progress in a log file can do so more easily.  See
  88   http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=48108
  89
  90 PLATFORMS ------------------------------------------------------------
  91
  92 Win32
  93
  94   Don't detach, because this messes up --srvany.
  95
  96   http://sources.redhat.com/ml/cygwin/2001-08/msg00234.html
  97
  98   According to "Effective TCP/IP Programming" (??) close() on a socket
  99   has incorrect behaviour on Windows -- it sends a RST packet to the
 100   other side, which gives a "connection reset by peer" error.  On that
 101   platform we should probably do shutdown() instead.  However, on Unix
 102   we are correct to call close(), because shutdown() discards
 103   untransmitted data.
 104
 105 BUILD FARM -----------------------------------------------------------
 106
 107 Add machines
 108
 109   AMDAHL UTS (Dave Dykstra)
 110
 111   Cygwin (on different versions of Win32?)
 112
 113   HP-UX variants (via HP?)
 114
 115   SCO
 116
 117 NICE -----------------------------------------------------------------
 118
 119 --no-detach and --no-fork options
 120
 121   Very useful for debugging.  Also good when running under a
 122   daemon-monitoring process that tries to restart the service when the
 123   parent exits.
 124
 125 hang/timeout friendliness
 126
 127   On
 128
 129 internationalization
 130
 131   Change to using gettext().  Probably need to ship this for platforms
 132   that don't have it.
 133
 134   Solicit translations.
 135
 136   Does anyone care?
 137
 138 rsyncsh
 139
 140    Write a small emulation of interactive ftp as a Pythonn program
 141    that calls rsync.  Commands such as "cd", "ls", "ls *.c" etc map
 142    fairly directly into rsync commands: it just needs to remember the
 143    current host, directory and so on.  We can probably even do
 144    completion of remote filenames.
 145