home *** CD-ROM | disk | FTP | other *** search
/ ftp.uv.es / 2014.11.ftp.uv.es.tar / ftp.uv.es / pub / unix / pine4.10.tar.gz / pine4.10.tar / pine4.10 / imap / docs / naming.txt < prev    next >
Text File  |  1998-05-19  |  3KB  |  101 lines
  1.                Mailbox Name Conventions
  2.                  Mark Crispin
  3.                  19 May 1998
  4.  
  5.  
  6. Please refer to the file drivers.txt for related information.
  7.  
  8.  
  9. I. Special names
  10.  
  11. Special names appear by themselves.
  12.  
  13. I.a. INBOX
  14.  
  15. The name INBOX is special and refers to primary incoming message
  16. mailbox on the local system.
  17.  
  18.  
  19. I.b. #mhinbox (UNIX only)
  20.  
  21. The name #mhinbox is special and refers to the primary incoming mh
  22. format mailbox on the local system.  Don't worry about this if you
  23. don't know what mh format is.
  24.  
  25.  
  26. II.  Special prefixes
  27.  
  28. All names which start with a "#" have a "special prefix" which
  29. identifies an alternative namespace.  Special prefixes appear in front
  30. of some additional text which constitutes a suffix.
  31.  
  32. II.a. #mh/ (UNIX only)
  33.  
  34. The prefix #mh/ is special and refers to the mh format mailbox named
  35. with the suffix.  For example, #mh/foo refers to the mh format mailbox
  36. named foo.  Don't worry about this if you don't know what mh format is.
  37.  
  38.  
  39. II.b. #news. (UNIX only)
  40.  
  41. The prefix #news. is special and refers to the newsgroup named with
  42. the suffix.  For example, #news.comp.mail.misc refers to the newsgroup
  43. named comp.mail.misc.
  44.  
  45.  
  46. II.c. #ftp/ (UNIX only)
  47.  
  48. The prefix #ftp/ is special and refers to the anonymous ftp filesystem
  49. named with the suffix.  For example, #ftp/foo/bar refers to the file
  50. /foo/bar in the anonymous FTP filesystem.  Anonymous FTP files are
  51. available to anonymous IMAP logins.
  52.  
  53.  
  54. II.d. #public/ (UNIX only)
  55.  
  56. The prefix #publis/ is special and refers to the public files
  57. filesystem named with the suffix.  For example, #public/foo/bar refers
  58. to the file /foo/bar in the public filesystem.  Public files are
  59. available to anonymous IMAP logins.
  60.  
  61.  
  62. II.e. #shared/ (UNIX only)
  63.  
  64. The prefix #shared/ is special and refers to the shared files
  65. filesystem named with the suffix.  For example, #shared/foo/bar
  66. frefers to the file /foo/bar in the shared filesystem.
  67.  
  68.  
  69. III. Remote names
  70.  
  71. All names which start with "{" are remote names, and are in the form
  72.     "{" remote_system_name [":" port] [flags] "}" [mailbox_name]
  73. where:
  74.  remote_system_name    Internet domain name or bracketed IP address
  75.              of server.
  76.  port            optional TCP port number, default is the
  77.              default port for that service        
  78.  flags            optional flags, one of the following:
  79.   "/service=" service    mailbox access service, default is "imap"
  80.   "/user=" user        remote user name for login on the server
  81.   "/anonymous"        remote access as anonymous user
  82.   "/debug"        record protocol telemetry in application's
  83.              debug log
  84.   "/secure"        do not transmit a plaintext password over
  85.              the network
  86.   "/imap", "/imap2", "/imap2bis", "/imap4", "/imap4rev1"
  87.             equivalent to /service=imap
  88.   "/pop3"        equivalent to /service=pop3
  89.   "/nntp"        equivalent to /service=nntp
  90.  mailbox_name        remote mailbox name, default is INBOX
  91.  
  92. For example:
  93.     {imap.foo.com}INBOX
  94. opens an IMAP connection to system imap.foo.com and selects INBOX.
  95.  
  96.  
  97. IV. All other names
  98.  
  99. All other names are treated as local file names, relative to the
  100. user's home directory.  Read drivers.txt for more details.
  101.