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   Implement suggestions from http://www.kame.net/newsletter/19980604/
  45   and ftp://ftp.iij.ad.jp/pub/RFC/rfc2553.txt
  46
  47   If a host has multiple addresses, then listen try to connect to all
  48   in order until we get through.  (getaddrinfo may return multiple
  49   addresses.)  This is kind of implemented already.
  50
  51   Possibly also when starting as a server we may need to listen on
  52   multiple passive addresses.  This might be a bit harder, because we
  53   may need to select on all of them.  Hm.
  54
  55   Define a syntax for IPv6 literal addresses.  Since they include
  56   colons, they tend to break most naming systems, including ours.
  57   Based on the HTTP IPv6 syntax, I think we should use
  58
  59      rsync://[::1]/foo/bar
  60      [::1]::bar
  61
  62   which should just take a small change to the parser code.
  63
  64 Errors
  65
  66   If we hang or get SIGINT, then explain where we were up to.  Perhaps
  67   have a static buffer that contains the current function name, or
  68   some kind of description of what we were trying to do.  This is a
  69   little easier on people than needing to run strace/truss.
  70
  71   "The dungeon collapses!  You are killed."  Rather than "unexpected
  72   eof" give a message that is more detailed if possible and also more
  73   helpful.
  74
  75 File attributes
  76
  77   Device major/minor numbers should be at least 32 bits each.  See
  78   http://lists.samba.org/pipermail/rsync/2001-November/005357.html
  79
  80   Transfer ACLs.  Need to think of a standard representation.
  81   Probably better not to even try to convert between NT and POSIX.
  82   Possibly can share some code with Samba.
  83
  84 Empty directories
  85
  86   With the current common --include '*/' --exclude '*' pattern, people
  87   can end up with many empty directories.  We might avoid this by
  88   lazily creating such directories.
  89
  90 zlib
  91
  92   Perhaps don't use our own zlib.  Will we actually be incompatible,
  93   or just be slightly less efficient?
  94
  95 logging
  96
  97   Perhaps flush stdout after each filename, so that people trying to
  98   monitor progress in a log file can do so more easily.  See
  99   http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=48108
 100
 101 rsyncd over ssh
 102
 103   There are already some patches to do this.
 104
 105 PLATFORMS ------------------------------------------------------------
 106
 107 Win32
 108
 109   Don't detach, because this messes up --srvany.
 110
 111   http://sources.redhat.com/ml/cygwin/2001-08/msg00234.html
 112
 113   According to "Effective TCP/IP Programming" (??) close() on a socket
 114   has incorrect behaviour on Windows -- it sends a RST packet to the
 115   other side, which gives a "connection reset by peer" error.  On that
 116   platform we should probably do shutdown() instead.  However, on Unix
 117   we are correct to call close(), because shutdown() discards
 118   untransmitted data.
 119
 120 DOCUMENTATION --------------------------------------------------------
 121
 122 Update README
 123
 124 BUILD FARM -----------------------------------------------------------
 125
 126 Add machines
 127
 128   AMDAHL UTS (Dave Dykstra)
 129
 130   Cygwin (on different versions of Win32?)
 131
 132   HP-UX variants (via HP?)
 133
 134   SCO
 135
 136 NICE -----------------------------------------------------------------
 137
 138 SIGHUP
 139
 140   Re-read config file (just exec() ourselves) rather than exiting.
 141
 142 --no-detach and --no-fork options
 143
 144   Very useful for debugging.  Also good when running under a
 145   daemon-monitoring process that tries to restart the service when the
 146   parent exits.
 147
 148 hang/timeout friendliness
 149
 150   On
 151
 152 internationalization
 153
 154   Change to using gettext().  Probably need to ship this for platforms
 155   that don't have it.
 156
 157   Solicit translations.
 158
 159   Does anyone care?
 160
 161 rsyncsh
 162
 163    Write a small emulation of interactive ftp as a Pythonn program
 164    that calls rsync.  Commands such as "cd", "ls", "ls *.c" etc map
 165    fairly directly into rsync commands: it just needs to remember the
 166    current host, directory and so on.  We can probably even do
 167    completion of remote filenames.
 168