You are viewing a plain text version of this content. The canonical link for it is here.
Posted to site-dev@james.apache.org by er...@apache.org on 2012/04/12 19:37:33 UTC
svn commit: r1325397 [4/4] - in /james/site/trunk/www/server: css/ images/
js/ js/fancybox/ js/jquery/ js/jquery/css/ js/jquery/css/custom-theme/
js/jquery/css/custom-theme/images/ js/jquery/js/ rfclist/lmtp/
Added: james/site/trunk/www/server/js/jquery/js/jquery-ui-1.8.5.custom.min.js
URL: http://svn.apache.org/viewvc/james/site/trunk/www/server/js/jquery/js/jquery-ui-1.8.5.custom.min.js?rev=1325397&view=auto
==============================================================================
--- james/site/trunk/www/server/js/jquery/js/jquery-ui-1.8.5.custom.min.js (added)
+++ james/site/trunk/www/server/js/jquery/js/jquery-ui-1.8.5.custom.min.js Thu Apr 12 17:37:31 2012
@@ -0,0 +1,68 @@
+/*!
+ * jQuery UI 1.8.5
+ *
+ * Copyright 2010, AUTHORS.txt (http://jqueryui.com/about)
+ * Dual licensed under the MIT or GPL Version 2 licenses.
+ * http://jquery.org/license
+ *
+ * http://docs.jquery.com/UI
+ */
+(function(c,j){function k(a){return!c(a).parents().andSelf().filter(function(){return c.curCSS(this,"visibility")==="hidden"||c.expr.filters.hidden(this)}).length}c.ui=c.ui||{};if(!c.ui.version){c.extend(c.ui,{version:"1.8.5",keyCode:{ALT:18,BACKSPACE:8,CAPS_LOCK:20,COMMA:188,COMMAND:91,COMMAND_LEFT:91,COMMAND_RIGHT:93,CONTROL:17,DELETE:46,DOWN:40,END:35,ENTER:13,ESCAPE:27,HOME:36,INSERT:45,LEFT:37,MENU:93,NUMPAD_ADD:107,NUMPAD_DECIMAL:110,NUMPAD_DIVIDE:111,NUMPAD_ENTER:108,NUMPAD_MULTIPLY:106,
+NUMPAD_SUBTRACT:109,PAGE_DOWN:34,PAGE_UP:33,PERIOD:190,RIGHT:39,SHIFT:16,SPACE:32,TAB:9,UP:38,WINDOWS:91}});c.fn.extend({_focus:c.fn.focus,focus:function(a,b){return typeof a==="number"?this.each(function(){var d=this;setTimeout(function(){c(d).focus();b&&b.call(d)},a)}):this._focus.apply(this,arguments)},scrollParent:function(){var a;a=c.browser.msie&&/(static|relative)/.test(this.css("position"))||/absolute/.test(this.css("position"))?this.parents().filter(function(){return/(relative|absolute|fixed)/.test(c.curCSS(this,
+"position",1))&&/(auto|scroll)/.test(c.curCSS(this,"overflow",1)+c.curCSS(this,"overflow-y",1)+c.curCSS(this,"overflow-x",1))}).eq(0):this.parents().filter(function(){return/(auto|scroll)/.test(c.curCSS(this,"overflow",1)+c.curCSS(this,"overflow-y",1)+c.curCSS(this,"overflow-x",1))}).eq(0);return/fixed/.test(this.css("position"))||!a.length?c(document):a},zIndex:function(a){if(a!==j)return this.css("zIndex",a);if(this.length){a=c(this[0]);for(var b;a.length&&a[0]!==document;){b=a.css("position");
+if(b==="absolute"||b==="relative"||b==="fixed"){b=parseInt(a.css("zIndex"));if(!isNaN(b)&&b!=0)return b}a=a.parent()}}return 0},disableSelection:function(){return this.bind("mousedown.ui-disableSelection selectstart.ui-disableSelection",function(a){a.preventDefault()})},enableSelection:function(){return this.unbind(".ui-disableSelection")}});c.each(["Width","Height"],function(a,b){function d(f,g,l,m){c.each(e,function(){g-=parseFloat(c.curCSS(f,"padding"+this,true))||0;if(l)g-=parseFloat(c.curCSS(f,
+"border"+this+"Width",true))||0;if(m)g-=parseFloat(c.curCSS(f,"margin"+this,true))||0});return g}var e=b==="Width"?["Left","Right"]:["Top","Bottom"],h=b.toLowerCase(),i={innerWidth:c.fn.innerWidth,innerHeight:c.fn.innerHeight,outerWidth:c.fn.outerWidth,outerHeight:c.fn.outerHeight};c.fn["inner"+b]=function(f){if(f===j)return i["inner"+b].call(this);return this.each(function(){c.style(this,h,d(this,f)+"px")})};c.fn["outer"+b]=function(f,g){if(typeof f!=="number")return i["outer"+b].call(this,f);return this.each(function(){c.style(this,
+h,d(this,f,true,g)+"px")})}});c.extend(c.expr[":"],{data:function(a,b,d){return!!c.data(a,d[3])},focusable:function(a){var b=a.nodeName.toLowerCase(),d=c.attr(a,"tabindex");if("area"===b){b=a.parentNode;d=b.name;if(!a.href||!d||b.nodeName.toLowerCase()!=="map")return false;a=c("img[usemap=#"+d+"]")[0];return!!a&&k(a)}return(/input|select|textarea|button|object/.test(b)?!a.disabled:"a"==b?a.href||!isNaN(d):!isNaN(d))&&k(a)},tabbable:function(a){var b=c.attr(a,"tabindex");return(isNaN(b)||b>=0)&&c(a).is(":focusable")}});
+c(function(){var a=document.createElement("div"),b=document.body;c.extend(a.style,{minHeight:"100px",height:"auto",padding:0,borderWidth:0});c.support.minHeight=b.appendChild(a).offsetHeight===100;b.removeChild(a).style.display="none"});c.extend(c.ui,{plugin:{add:function(a,b,d){a=c.ui[a].prototype;for(var e in d){a.plugins[e]=a.plugins[e]||[];a.plugins[e].push([b,d[e]])}},call:function(a,b,d){if((b=a.plugins[b])&&a.element[0].parentNode)for(var e=0;e<b.length;e++)a.options[b[e][0]]&&b[e][1].apply(a.element,
+d)}},contains:function(a,b){return document.compareDocumentPosition?a.compareDocumentPosition(b)&16:a!==b&&a.contains(b)},hasScroll:function(a,b){if(c(a).css("overflow")==="hidden")return false;b=b&&b==="left"?"scrollLeft":"scrollTop";var d=false;if(a[b]>0)return true;a[b]=1;d=a[b]>0;a[b]=0;return d},isOverAxis:function(a,b,d){return a>b&&a<b+d},isOver:function(a,b,d,e,h,i){return c.ui.isOverAxis(a,d,h)&&c.ui.isOverAxis(b,e,i)}})}})(jQuery);
+;/*!
+ * jQuery UI Widget 1.8.5
+ *
+ * Copyright 2010, AUTHORS.txt (http://jqueryui.com/about)
+ * Dual licensed under the MIT or GPL Version 2 licenses.
+ * http://jquery.org/license
+ *
+ * http://docs.jquery.com/UI/Widget
+ */
+(function(b,j){if(b.cleanData){var k=b.cleanData;b.cleanData=function(a){for(var c=0,d;(d=a[c])!=null;c++)b(d).triggerHandler("remove");k(a)}}else{var l=b.fn.remove;b.fn.remove=function(a,c){return this.each(function(){if(!c)if(!a||b.filter(a,[this]).length)b("*",this).add([this]).each(function(){b(this).triggerHandler("remove")});return l.call(b(this),a,c)})}}b.widget=function(a,c,d){var e=a.split(".")[0],f;a=a.split(".")[1];f=e+"-"+a;if(!d){d=c;c=b.Widget}b.expr[":"][f]=function(h){return!!b.data(h,
+a)};b[e]=b[e]||{};b[e][a]=function(h,g){arguments.length&&this._createWidget(h,g)};c=new c;c.options=b.extend(true,{},c.options);b[e][a].prototype=b.extend(true,c,{namespace:e,widgetName:a,widgetEventPrefix:b[e][a].prototype.widgetEventPrefix||a,widgetBaseClass:f},d);b.widget.bridge(a,b[e][a])};b.widget.bridge=function(a,c){b.fn[a]=function(d){var e=typeof d==="string",f=Array.prototype.slice.call(arguments,1),h=this;d=!e&&f.length?b.extend.apply(null,[true,d].concat(f)):d;if(e&&d.substring(0,1)===
+"_")return h;e?this.each(function(){var g=b.data(this,a);if(!g)throw"cannot call methods on "+a+" prior to initialization; attempted to call method '"+d+"'";if(!b.isFunction(g[d]))throw"no such method '"+d+"' for "+a+" widget instance";var i=g[d].apply(g,f);if(i!==g&&i!==j){h=i;return false}}):this.each(function(){var g=b.data(this,a);g?g.option(d||{})._init():b.data(this,a,new c(d,this))});return h}};b.Widget=function(a,c){arguments.length&&this._createWidget(a,c)};b.Widget.prototype={widgetName:"widget",
+widgetEventPrefix:"",options:{disabled:false},_createWidget:function(a,c){b.data(c,this.widgetName,this);this.element=b(c);this.options=b.extend(true,{},this.options,b.metadata&&b.metadata.get(c)[this.widgetName],a);var d=this;this.element.bind("remove."+this.widgetName,function(){d.destroy()});this._create();this._init()},_create:function(){},_init:function(){},destroy:function(){this.element.unbind("."+this.widgetName).removeData(this.widgetName);this.widget().unbind("."+this.widgetName).removeAttr("aria-disabled").removeClass(this.widgetBaseClass+
+"-disabled ui-state-disabled")},widget:function(){return this.element},option:function(a,c){var d=a,e=this;if(arguments.length===0)return b.extend({},e.options);if(typeof a==="string"){if(c===j)return this.options[a];d={};d[a]=c}b.each(d,function(f,h){e._setOption(f,h)});return e},_setOption:function(a,c){this.options[a]=c;if(a==="disabled")this.widget()[c?"addClass":"removeClass"](this.widgetBaseClass+"-disabled ui-state-disabled").attr("aria-disabled",c);return this},enable:function(){return this._setOption("disabled",
+false)},disable:function(){return this._setOption("disabled",true)},_trigger:function(a,c,d){var e=this.options[a];c=b.Event(c);c.type=(a===this.widgetEventPrefix?a:this.widgetEventPrefix+a).toLowerCase();d=d||{};if(c.originalEvent){a=b.event.props.length;for(var f;a;){f=b.event.props[--a];c[f]=c.originalEvent[f]}}this.element.trigger(c,d);return!(b.isFunction(e)&&e.call(this.element[0],c,d)===false||c.isDefaultPrevented())}}})(jQuery);
+;/*
+ * jQuery UI Tabs 1.8.5
+ *
+ * Copyright 2010, AUTHORS.txt (http://jqueryui.com/about)
+ * Dual licensed under the MIT or GPL Version 2 licenses.
+ * http://jquery.org/license
+ *
+ * http://docs.jquery.com/UI/Tabs
+ *
+ * Depends:
+ * jquery.ui.core.js
+ * jquery.ui.widget.js
+ */
+(function(d,p){function u(){return++v}function w(){return++x}var v=0,x=0;d.widget("ui.tabs",{options:{add:null,ajaxOptions:null,cache:false,cookie:null,collapsible:false,disable:null,disabled:[],enable:null,event:"click",fx:null,idPrefix:"ui-tabs-",load:null,panelTemplate:"<div></div>",remove:null,select:null,show:null,spinner:"<em>Loading…</em>",tabTemplate:"<li><a href='#{href}'><span>#{label}</span></a></li>"},_create:function(){this._tabify(true)},_setOption:function(a,e){if(a=="selected")this.options.collapsible&&
+e==this.options.selected||this.select(e);else{this.options[a]=e;this._tabify()}},_tabId:function(a){return a.title&&a.title.replace(/\s/g,"_").replace(/[^\w\u00c0-\uFFFF-]/g,"")||this.options.idPrefix+u()},_sanitizeSelector:function(a){return a.replace(/:/g,"\\:")},_cookie:function(){var a=this.cookie||(this.cookie=this.options.cookie.name||"ui-tabs-"+w());return d.cookie.apply(null,[a].concat(d.makeArray(arguments)))},_ui:function(a,e){return{tab:a,panel:e,index:this.anchors.index(a)}},_cleanup:function(){this.lis.filter(".ui-state-processing").removeClass("ui-state-processing").find("span:data(label.tabs)").each(function(){var a=
+d(this);a.html(a.data("label.tabs")).removeData("label.tabs")})},_tabify:function(a){function e(g,f){g.css("display","");!d.support.opacity&&f.opacity&&g[0].style.removeAttribute("filter")}var b=this,c=this.options,h=/^#.+/;this.list=this.element.find("ol,ul").eq(0);this.lis=d(" > li:has(a[href])",this.list);this.anchors=this.lis.map(function(){return d("a",this)[0]});this.panels=d([]);this.anchors.each(function(g,f){var i=d(f).attr("href"),l=i.split("#")[0],q;if(l&&(l===location.toString().split("#")[0]||
+(q=d("base")[0])&&l===q.href)){i=f.hash;f.href=i}if(h.test(i))b.panels=b.panels.add(b._sanitizeSelector(i));else if(i&&i!=="#"){d.data(f,"href.tabs",i);d.data(f,"load.tabs",i.replace(/#.*$/,""));i=b._tabId(f);f.href="#"+i;f=d("#"+i);if(!f.length){f=d(c.panelTemplate).attr("id",i).addClass("ui-tabs-panel ui-widget-content ui-corner-bottom").insertAfter(b.panels[g-1]||b.list);f.data("destroy.tabs",true)}b.panels=b.panels.add(f)}else c.disabled.push(g)});if(a){this.element.addClass("ui-tabs ui-widget ui-widget-content ui-corner-all");
+this.list.addClass("ui-tabs-nav ui-helper-reset ui-helper-clearfix ui-widget-header ui-corner-all");this.lis.addClass("ui-state-default ui-corner-top");this.panels.addClass("ui-tabs-panel ui-widget-content ui-corner-bottom");if(c.selected===p){location.hash&&this.anchors.each(function(g,f){if(f.hash==location.hash){c.selected=g;return false}});if(typeof c.selected!=="number"&&c.cookie)c.selected=parseInt(b._cookie(),10);if(typeof c.selected!=="number"&&this.lis.filter(".ui-tabs-selected").length)c.selected=
+this.lis.index(this.lis.filter(".ui-tabs-selected"));c.selected=c.selected||(this.lis.length?0:-1)}else if(c.selected===null)c.selected=-1;c.selected=c.selected>=0&&this.anchors[c.selected]||c.selected<0?c.selected:0;c.disabled=d.unique(c.disabled.concat(d.map(this.lis.filter(".ui-state-disabled"),function(g){return b.lis.index(g)}))).sort();d.inArray(c.selected,c.disabled)!=-1&&c.disabled.splice(d.inArray(c.selected,c.disabled),1);this.panels.addClass("ui-tabs-hide");this.lis.removeClass("ui-tabs-selected ui-state-active");
+if(c.selected>=0&&this.anchors.length){this.panels.eq(c.selected).removeClass("ui-tabs-hide");this.lis.eq(c.selected).addClass("ui-tabs-selected ui-state-active");b.element.queue("tabs",function(){b._trigger("show",null,b._ui(b.anchors[c.selected],b.panels[c.selected]))});this.load(c.selected)}d(window).bind("unload",function(){b.lis.add(b.anchors).unbind(".tabs");b.lis=b.anchors=b.panels=null})}else c.selected=this.lis.index(this.lis.filter(".ui-tabs-selected"));this.element[c.collapsible?"addClass":
+"removeClass"]("ui-tabs-collapsible");c.cookie&&this._cookie(c.selected,c.cookie);a=0;for(var j;j=this.lis[a];a++)d(j)[d.inArray(a,c.disabled)!=-1&&!d(j).hasClass("ui-tabs-selected")?"addClass":"removeClass"]("ui-state-disabled");c.cache===false&&this.anchors.removeData("cache.tabs");this.lis.add(this.anchors).unbind(".tabs");if(c.event!=="mouseover"){var k=function(g,f){f.is(":not(.ui-state-disabled)")&&f.addClass("ui-state-"+g)},n=function(g,f){f.removeClass("ui-state-"+g)};this.lis.bind("mouseover.tabs",
+function(){k("hover",d(this))});this.lis.bind("mouseout.tabs",function(){n("hover",d(this))});this.anchors.bind("focus.tabs",function(){k("focus",d(this).closest("li"))});this.anchors.bind("blur.tabs",function(){n("focus",d(this).closest("li"))})}var m,o;if(c.fx)if(d.isArray(c.fx)){m=c.fx[0];o=c.fx[1]}else m=o=c.fx;var r=o?function(g,f){d(g).closest("li").addClass("ui-tabs-selected ui-state-active");f.hide().removeClass("ui-tabs-hide").animate(o,o.duration||"normal",function(){e(f,o);b._trigger("show",
+null,b._ui(g,f[0]))})}:function(g,f){d(g).closest("li").addClass("ui-tabs-selected ui-state-active");f.removeClass("ui-tabs-hide");b._trigger("show",null,b._ui(g,f[0]))},s=m?function(g,f){f.animate(m,m.duration||"normal",function(){b.lis.removeClass("ui-tabs-selected ui-state-active");f.addClass("ui-tabs-hide");e(f,m);b.element.dequeue("tabs")})}:function(g,f){b.lis.removeClass("ui-tabs-selected ui-state-active");f.addClass("ui-tabs-hide");b.element.dequeue("tabs")};this.anchors.bind(c.event+".tabs",
+function(){var g=this,f=d(g).closest("li"),i=b.panels.filter(":not(.ui-tabs-hide)"),l=d(b._sanitizeSelector(g.hash));if(f.hasClass("ui-tabs-selected")&&!c.collapsible||f.hasClass("ui-state-disabled")||f.hasClass("ui-state-processing")||b.panels.filter(":animated").length||b._trigger("select",null,b._ui(this,l[0]))===false){this.blur();return false}c.selected=b.anchors.index(this);b.abort();if(c.collapsible)if(f.hasClass("ui-tabs-selected")){c.selected=-1;c.cookie&&b._cookie(c.selected,c.cookie);b.element.queue("tabs",
+function(){s(g,i)}).dequeue("tabs");this.blur();return false}else if(!i.length){c.cookie&&b._cookie(c.selected,c.cookie);b.element.queue("tabs",function(){r(g,l)});b.load(b.anchors.index(this));this.blur();return false}c.cookie&&b._cookie(c.selected,c.cookie);if(l.length){i.length&&b.element.queue("tabs",function(){s(g,i)});b.element.queue("tabs",function(){r(g,l)});b.load(b.anchors.index(this))}else throw"jQuery UI Tabs: Mismatching fragment identifier.";d.browser.msie&&this.blur()});this.anchors.bind("click.tabs",
+function(){return false})},_getIndex:function(a){if(typeof a=="string")a=this.anchors.index(this.anchors.filter("[href$="+a+"]"));return a},destroy:function(){var a=this.options;this.abort();this.element.unbind(".tabs").removeClass("ui-tabs ui-widget ui-widget-content ui-corner-all ui-tabs-collapsible").removeData("tabs");this.list.removeClass("ui-tabs-nav ui-helper-reset ui-helper-clearfix ui-widget-header ui-corner-all");this.anchors.each(function(){var e=d.data(this,"href.tabs");if(e)this.href=
+e;var b=d(this).unbind(".tabs");d.each(["href","load","cache"],function(c,h){b.removeData(h+".tabs")})});this.lis.unbind(".tabs").add(this.panels).each(function(){d.data(this,"destroy.tabs")?d(this).remove():d(this).removeClass("ui-state-default ui-corner-top ui-tabs-selected ui-state-active ui-state-hover ui-state-focus ui-state-disabled ui-tabs-panel ui-widget-content ui-corner-bottom ui-tabs-hide")});a.cookie&&this._cookie(null,a.cookie);return this},add:function(a,e,b){if(b===p)b=this.anchors.length;
+var c=this,h=this.options;e=d(h.tabTemplate.replace(/#\{href\}/g,a).replace(/#\{label\}/g,e));a=!a.indexOf("#")?a.replace("#",""):this._tabId(d("a",e)[0]);e.addClass("ui-state-default ui-corner-top").data("destroy.tabs",true);var j=d("#"+a);j.length||(j=d(h.panelTemplate).attr("id",a).data("destroy.tabs",true));j.addClass("ui-tabs-panel ui-widget-content ui-corner-bottom ui-tabs-hide");if(b>=this.lis.length){e.appendTo(this.list);j.appendTo(this.list[0].parentNode)}else{e.insertBefore(this.lis[b]);
+j.insertBefore(this.panels[b])}h.disabled=d.map(h.disabled,function(k){return k>=b?++k:k});this._tabify();if(this.anchors.length==1){h.selected=0;e.addClass("ui-tabs-selected ui-state-active");j.removeClass("ui-tabs-hide");this.element.queue("tabs",function(){c._trigger("show",null,c._ui(c.anchors[0],c.panels[0]))});this.load(0)}this._trigger("add",null,this._ui(this.anchors[b],this.panels[b]));return this},remove:function(a){a=this._getIndex(a);var e=this.options,b=this.lis.eq(a).remove(),c=this.panels.eq(a).remove();
+if(b.hasClass("ui-tabs-selected")&&this.anchors.length>1)this.select(a+(a+1<this.anchors.length?1:-1));e.disabled=d.map(d.grep(e.disabled,function(h){return h!=a}),function(h){return h>=a?--h:h});this._tabify();this._trigger("remove",null,this._ui(b.find("a")[0],c[0]));return this},enable:function(a){a=this._getIndex(a);var e=this.options;if(d.inArray(a,e.disabled)!=-1){this.lis.eq(a).removeClass("ui-state-disabled");e.disabled=d.grep(e.disabled,function(b){return b!=a});this._trigger("enable",null,
+this._ui(this.anchors[a],this.panels[a]));return this}},disable:function(a){a=this._getIndex(a);var e=this.options;if(a!=e.selected){this.lis.eq(a).addClass("ui-state-disabled");e.disabled.push(a);e.disabled.sort();this._trigger("disable",null,this._ui(this.anchors[a],this.panels[a]))}return this},select:function(a){a=this._getIndex(a);if(a==-1)if(this.options.collapsible&&this.options.selected!=-1)a=this.options.selected;else return this;this.anchors.eq(a).trigger(this.options.event+".tabs");return this},
+load:function(a){a=this._getIndex(a);var e=this,b=this.options,c=this.anchors.eq(a)[0],h=d.data(c,"load.tabs");this.abort();if(!h||this.element.queue("tabs").length!==0&&d.data(c,"cache.tabs"))this.element.dequeue("tabs");else{this.lis.eq(a).addClass("ui-state-processing");if(b.spinner){var j=d("span",c);j.data("label.tabs",j.html()).html(b.spinner)}this.xhr=d.ajax(d.extend({},b.ajaxOptions,{url:h,success:function(k,n){d(e._sanitizeSelector(c.hash)).html(k);e._cleanup();b.cache&&d.data(c,"cache.tabs",
+true);e._trigger("load",null,e._ui(e.anchors[a],e.panels[a]));try{b.ajaxOptions.success(k,n)}catch(m){}},error:function(k,n){e._cleanup();e._trigger("load",null,e._ui(e.anchors[a],e.panels[a]));try{b.ajaxOptions.error(k,n,a,c)}catch(m){}}}));e.element.dequeue("tabs");return this}},abort:function(){this.element.queue([]);this.panels.stop(false,true);this.element.queue("tabs",this.element.queue("tabs").splice(-2,2));if(this.xhr){this.xhr.abort();delete this.xhr}this._cleanup();return this},url:function(a,
+e){this.anchors.eq(a).removeData("cache.tabs").data("load.tabs",e);return this},length:function(){return this.anchors.length}});d.extend(d.ui.tabs,{version:"1.8.5"});d.extend(d.ui.tabs.prototype,{rotation:null,rotate:function(a,e){var b=this,c=this.options,h=b._rotate||(b._rotate=function(j){clearTimeout(b.rotation);b.rotation=setTimeout(function(){var k=c.selected;b.select(++k<b.anchors.length?k:0)},a);j&&j.stopPropagation()});e=b._unrotate||(b._unrotate=!e?function(j){j.clientX&&b.rotate(null)}:
+function(){t=c.selected;h()});if(a){this.element.bind("tabsshow",h);this.anchors.bind(c.event+".tabs",e);h()}else{clearTimeout(b.rotation);this.element.unbind("tabsshow",h);this.anchors.unbind(c.event+".tabs",e);delete this._rotate;delete this._unrotate}return this}})})(jQuery);
+;
\ No newline at end of file
Added: james/site/trunk/www/server/rfclist/lmtp/rfc2033.txt
URL: http://svn.apache.org/viewvc/james/site/trunk/www/server/rfclist/lmtp/rfc2033.txt?rev=1325397&view=auto
==============================================================================
--- james/site/trunk/www/server/rfclist/lmtp/rfc2033.txt (added)
+++ james/site/trunk/www/server/rfclist/lmtp/rfc2033.txt Thu Apr 12 17:37:31 2012
@@ -0,0 +1,395 @@
+
+
+
+
+
+
+Network Working Group J. Myers
+Request for Comments: 2033 Carnegie Mellon
+Category: Informational October 1996
+
+
+ Local Mail Transfer Protocol
+
+Status of this Memo
+
+ This memo provides information for the Internet community. This memo
+ does not specify an Internet standard of any kind. Distribution of
+ this memo is unlimited.
+
+1. Abstract
+
+ SMTP [SMTP] [HOST-REQ] and its service extensions [ESMTP] provide a
+ mechanism for transferring mail reliably and efficiently. The design
+ of the SMTP protocol effectively requires the server to manage a mail
+ delivery queue.
+
+ In some limited circumstances, outside the area of mail exchange
+ between independent hosts on public networks, it is desirable to
+ implement a system where a mail receiver does not manage a queue.
+ This document describes the LMTP protocol for transporting mail into
+ such systems.
+
+ Although LMTP is an alternative protocol to ESMTP, it uses (with a
+ few changes) the syntax and semantics of ESMTP. This design permits
+ LMTP to utilize the extensions defined for ESMTP. LMTP should be
+ used only by specific prior arrangement and configuration, and it
+ MUST NOT be used on TCP port 25.
+
+Table of Contents
+
+ 1. Abstract ................................................ 1
+ 2. Conventions Used in this Document ....................... 2
+ 3. Introduction and Overview ............................... 2
+ 4. The LMTP protocol ....................................... 3
+ 4.1. The LHLO, HELO and EHLO commands ........................ 4
+ 4.2. The DATA command ........................................ 4
+ 4.3. The BDAT command ........................................ 5
+ 5. Implementation requirements ............................. 6
+ 6. Acknowledgments ......................................... 6
+ 7. References .............................................. 7
+ 8. Security Considerations ................................. 7
+ 9. Author's Address ........................................ 7
+
+
+
+
+
+Myers Informational [Page 1]
+
+RFC 2033 LMTP October 1996
+
+
+2. Conventions Used in this Document
+
+ In examples, "C:" and "S:" indicate lines sent by the client and
+ server respectively.
+
+3. Introduction and Overview
+
+ The design of the SMTP protocol effectively requires the server to
+ manage a mail delivery queue. This is because a single mail
+ transaction may specify multiple recipients and the final "." of the
+ DATA command may return only one reply code, to indicate the status
+ of the entire transaction. If, for example, a server is given a
+ transaction for two recipients, delivery to the first succeeds, and
+ delivery to the second encounters a temporary failure condition,
+ there is no mechanism to inform the client of the situation. The
+ server must queue the message and later attempt to deliver it to the
+ second recipient.
+
+ This queuing requirement is beneficial in the situation for which
+ SMTP was originally designed: store-and-forward relay of mail between
+ networked hosts. In some limited situations, it is desirable to have
+ a server which does not manage a queue, instead relying on the client
+ to perform queue management. As an example, consider a hypothetical
+ host with a mail system designed as follows:
+
+
+
+ TCP port 25 +-----------------+
+ ---------------------->| | #########
+ | Queue |<># Mail #
+ TCP port 25 | Manager | # Queue #
+ <----------------------| | #########
+ +-----------------+
+ Local * ^ Local * Local
+ IPC * | IPC * IPC
+ * | *
+ * | *
+ * | *
+ V | V
+ Non-SMTP +----------+ +----------+
+ Protocol | Gateway | | Local | #########
+ <==============>| Delivery | | Delivery |>># Mail #
+ | Agent | | Agent | # Spool #
+ +----------+ +----------+ #########
+
+
+ The host's mail system has three independent, communicating
+ subsystems. The first is a queue manager, which acts as a
+
+
+
+Myers Informational [Page 2]
+
+RFC 2033 LMTP October 1996
+
+
+ traditional SMTP agent, transferring messages to and from other hosts
+ over TCP and managing a mail queue in persistent storage. The other
+ two are agents which handle delivery for addresses in domains for
+ which the host takes responsibility. One agent performs gatewaying
+ to and from some other mail system. The other agent delivers the
+ message into a persistent mail spool.
+
+ It would be desirable to use SMTP over a local inter-process
+ communication channel to transfer messages from the queue manager to
+ the delivery agents. It would, however, significantly increase the
+ complexity of the delivery agents to require them to manage their own
+ mail queues.
+
+ The common practice of invoking a delivery agent with the envelope
+ address(es) as command-line arguments, then having the delivery agent
+ communicate status with an exit code has three serious problems: the
+ agent can only return one exit code to be applied to all recipients,
+ it is difficult to extend the interface to deal with ESMTP extensions
+ such as DSN [DSN] and ENHANCEDSTATUSCODES [ENHANCEDSTATUSCODES], and
+ exits performed by system libraries due to temporary conditions
+ frequently get interpreted as permanent errors.
+
+ The LMTP protocol causes the server to return, after the final "." of
+ the DATA command, one reply for each recipient. Therefore, if the
+ queue manager is configured to use LMTP instead of SMTP when
+ transferring messages to the delivery agents, then the delivery
+ agents may attempt delivery to each recipient after the final "." and
+ individually report the status for each recipient. Connections which
+ should use the LMTP protocol are drawn in the diagram above using
+ asterisks.
+
+ Note that it is not beneficial to use the LMTP protocol when
+ transferring messages to the queue manager, either from the network
+ or from a delivery agent. The queue manager does implement a mail
+ queue, so it may store the message and take responsibility for later
+ delivering it.
+
+4. The LMTP protocol
+
+ The LMTP protocol is identical to the SMTP protocol SMTP [SMTP]
+ [HOST-REQ] with its service extensions [ESMTP], except as modified by
+ this document.
+
+ A "successful" RCPT command is defined as an RCPT command which
+ returns a Positive Completion reply code.
+
+ A "Positive Completion reply code" is defined in Appendix E of STD
+ 10, RFC 821 [SMTP] as a reply code which "2" as the first digit.
+
+
+
+Myers Informational [Page 3]
+
+RFC 2033 LMTP October 1996
+
+
+4.1. The LHLO, HELO and EHLO commands
+
+ The HELO and EHLO commands of ESMTP are replaced by the LHLO command.
+ This permits a misconfiguration where both parties are not using the
+ same protocol to be detected.
+
+ The LHLO command has identical semantics to the EHLO command of ESMTP
+ [ESMTP].
+
+ The HELO and EHLO commands of ESMTP are not present in LMTP. A LMTP
+ server MUST NOT return a Postive Completion reply code to these
+ commands. The 500 reply code is recommended.
+
+4.2. The DATA command
+
+ In the LMTP protocol, there is one additional restriction placed on
+ the DATA command, and one change to how replies to the final "." are
+ sent.
+
+ The additional restriction is that when there have been no successful
+ RCPT commands in the mail transaction, the DATA command MUST fail
+ with a 503 reply code.
+
+ The change is that after the final ".", the server returns one reply
+ for each previously successful RCPT command in the mail transaction,
+ in the order that the RCPT commands were issued. Even if there were
+ multiple successful RCPT commands giving the same forward-path, there
+ must be one reply for each successful RCPT command.
+
+ When one of these replies to the final "." is a Positive Completion
+ reply, the server is accepting responsibility for delivering or
+ relying the message to the corresponding recipient. It must take
+ this responsibility seriously, i.e., it MUST NOT lose the message for
+ frivolous reasons, e.g., because the host later crashes or because of
+ a predictable resource shortage.
+
+ A multiline reply is still considered a single reply and corresponds
+ to a single RCPT command.
+
+ EXAMPLE:
+
+ S: 220 foo.edu LMTP server ready
+ C: LHLO foo.edu
+ S: 250-foo.edu
+ S: 250-PIPELINING
+ S: 250 SIZE
+ C: MAIL FROM:<ch...@bar.com>
+ S: 250 OK
+
+
+
+Myers Informational [Page 4]
+
+RFC 2033 LMTP October 1996
+
+
+ C: RCPT TO:<pa...@foo.edu>
+ S: 250 OK
+ C: RCPT TO:<jo...@foo.edu>
+ S: 550 No such user here
+ C: RCPT TO:<gr...@foo.edu>
+ S: 250 OK
+ C: DATA
+ S: 354 Start mail input; end with <CRLF>.<CRLF>
+ C: Blah blah blah...
+ C: ...etc. etc. etc.
+ C: .
+ S: 250 OK
+ S: 452 <gr...@foo.edu> is temporarily over quota
+ C: QUIT
+ S: 221 foo.edu closing connection
+
+
+NOTE: in the above example, the domain names of both the client and
+ server are identical. This is because in the example the client and
+ server are different subsystems of the same mail domain.
+
+4.3. The BDAT command
+
+ If the server supports the ESMTP CHUNKING extension [BINARYMIME], a
+ BDAT command containing the LAST parameter returns one reply for each
+ previously successful RCPT command in the mail transaction, in the
+ order that the RCPT commands were issued. Even if there were
+ multiple successful RCPT commands giving the same forward-path, there
+ must be one reply for each successful RCPT command. If there were no
+ previously successful RCPT commands in the mail transaction, then the
+ BDAT LAST command returns zero replies.
+
+ When one of these replies to the BDAT LAST command is a Positive
+ Completion reply, the server is accepting responsibility for
+ delivering or relaying the message to the corresponding recipient.
+ It must take this responsibility seriously, i.e., it MUST NOT lose
+ the message for frivolous reasons, e.g., because the host later
+ crashes or because of a predictable resource shortage.
+
+ A multiline reply is still considered a single reply and corresponds
+ to a single RCPT command.
+
+ The behavior of BDAT commands without the LAST parameter is not
+ changed; they still return exactly one reply.
+
+
+
+
+
+
+
+Myers Informational [Page 5]
+
+RFC 2033 LMTP October 1996
+
+
+5. Implementation requirements
+
+ As LMTP is a different protocol than SMTP, it MUST NOT be used on the
+ TCP service port 25.
+
+ A server implementation MUST implement the PIPELINING [PIPELINING]
+ and ENHANCEDSTATUSCODES [ENHANCEDSTATUSCODES] ESMTP extensions. A
+ server implementation SHOULD implement the 8BITMIME [8BITMIME]
+ extension.
+
+ Use of LMTP can aggravate the situation described in [DUP-MSGS]. To
+ avoid this synchronization problem, the following requirements are
+ made of implementations:
+
+ A server implementation which is capable of quickly accepting
+ responsibility for delivering or relaying a message to multiple
+ recipients and which is capable of sending any necessary notification
+ messages SHOULD NOT implement the LMTP protocol.
+
+ The LMTP protocol SHOULD NOT be used over wide area networks.
+
+ The server SHOULD send each reply as soon as possible. If it is
+ going to spend a nontrivial amount of time handling delivery for the
+ next recipient, it SHOULD flush any outgoing LMTP buffer, so the
+ reply may be quickly received by the client.
+
+ The client SHOULD process the replies as they come in, instead of
+ waiting for all of the replies to arrive before processing any of
+ them. If the connection closes after replies for some, but not all,
+ recipients have arrived, the client MUST process the replies that
+ arrived and treat the rest as temporary failures.
+
+6. Acknowledgments
+
+ This work is a refinement of the MULT extension, which was invented
+ by Jeff Michaud and was used in implementing gateways to the Mail-11
+ mail system.
+
+ Many thanks to Matt Thomas for assisting me in understanding the
+ semantics of the Mail-11 MULT extension.
+
+
+
+
+
+
+
+
+
+
+
+Myers Informational [Page 6]
+
+RFC 2033 LMTP October 1996
+
+
+7. References
+
+ [8BITMIME] Klensin, J., et. al, "SMTP Service Extension for 8bit-MIME
+ transport", RFC 1652, July 1994.
+
+ [BINARYMIME] Vaudreuil, G., "SMTP Service Extensions for Transmission
+ of Large and Binary MIME Messages", RFC 1830, August 1995.
+
+ [DSN] Moore, K., Vaudreuil, G., "An Extensible Message Format for
+ Delivery Status Notifications", RFC 1894, January 1996.
+
+ [DUP-MSGS] Partridge, C., "Duplicate messages and SMTP", RFC 1047,
+ February 1988.
+
+ [ENHANCEDSTATUSCODES] Freed, N., "SMTP Service Extension for
+ Returning Enhanced Error Codes", RFC 2034, October 1996.
+
+ [ESMTP] Rose, M., Stefferud, E., Crocker, C., Klensin, J., Freed, N.,
+ "SMTP Service Extensions", RFC 1869, November 1995.
+
+ [HOST-REQ] Braden, R., "Requirements for Internet hosts - application
+ and support", STD 3, RFC 1123 section 5, October 1989.
+
+ [PIPELINING] Freed, N., Cargille, A, "SMTP Service Extension for
+ Command Pipelining", RFC 1854, October 1995.
+
+ [SMTP] Postel, J., "Simple Mail Transfer Protocol", STD 10, RFC 821,
+ August 1982.
+
+
+ There are no known security issues with the issues in this memo.
+
+9. Author's Address
+
+ John G. Myers
+ Carnegie-Mellon University
+ 5000 Forbes Ave.
+ Pittsburgh PA, 15213-3890
+
+ EMail: jgm+@cmu.edu
+
+
+
+
+
+
+
+
+
+
+
+Myers Informational [Page 7]
+