auth-ja.texi

   1 \input texinfo                  @c -*-texinfo-*-
   2 @setfilename auth-ja
   3 @settitle Emacs auth-source Library @value{VERSION}
   4
   5 @set VERSION 0.2
   6
   7 @copying
   8 \e$B$3$N%U%!%$%k$O\e(B Emacs auth-source \e$B%i%$%V%i%j!<$r@bL@$7$^$9!#\e(B
   9
  10 Copyright @copyright{} 2008, 2009 Free Software Foundation, Inc.
  11
  12 @quotation
  13 Permission is granted to copy, distribute and/or modify this document
  14 under the terms of the GNU Free Documentation License, Version 1.3 or
  15 any later version published by the Free Software Foundation; with no
  16 Invariant Sections, with the Front-Cover texts being ``A GNU Manual,''
  17 and with the Back-Cover Texts as in (a) below.  A copy of the license
  18 is included in the section entitled ``GNU Free Documentation License''
  19 in the Emacs manual.
  20
  21 \e$B$3$NJ8=q$r!"%U%j!<%=%U%H%&%'%":bCDH/9T$N\e(B GNU \e$B%U%j!<J8=qMxMQ5vBz7@Ls=q\e(B
  22 \e$BBh\e(B 1.3 \e$BHG$^$?$O$=$l0J9_$NHG$,Dj$a$k>r7o$N2<$GJ#@=!"G[I[!"$"$k$$$OJQ99$9\e(B
  23 \e$B$k$3$H$r5v2D$7$^$9!#JQ99IT2DItJ,$O;XDj$7$^$;$s!#!H\e(BA GNU Manual\e$B!I$OI=I=;f\e(B
  24 \e$B%F%-%9%H!"0J2<$N\e(B (a) \e$B$ON"I=;f%F%-%9%H$G$9!#$3$NMxMQ5vBz7@Ls=q$NJ#<L\e(B
  25 \e$B$O\e(B Emacs \e$B%^%K%e%"%k$N!V\e(BGNU \e$B%U%j!<J8=qMxMQ5vBz7@Ls=q!W$H$$$&>O$K4^$^$l$F\e(B
  26 \e$B$$$^$9!#\e(B
  27
  28 (a) The FSF's Back-Cover Text is: ``You have the freedom to copy and
  29 modify this GNU manual.  Buying copies from the FSF supports it in
  30 developing GNU and promoting software freedom.''
  31
  32 (a) FSF \e$B$NN"I=;f%F%-%9%H\e(B:\e$B!V$"$J$?$K$O$3$N\e(B GNU Manual \e$B$rJ#@=$7$?$jJQ99$9\e(B
  33 \e$B$k<+M3$,$"$j$^$9!#\e(BFSF \e$B$+$i$NJ#<L$N9XF~$O\e(B GNU \e$B$N3+H/$H%=%U%H%&%'%"$N<+M3\e(B
  34 \e$B$NB%?J$r;Y1g$7$^$9!#!W\e(B
  35
  36 This document is part of a collection distributed under the GNU Free
  37 Documentation License.  If you want to distribute this document
  38 separately from the collection, you can do so by adding a copy of the
  39 license to the document, as described in section 6 of the license.
  40
  41 \e$B$3$NJ8=q$O!V\e(BGNU \e$B%U%j!<J8=qMxMQ5vBz7@Ls=q!W$K4p$E$$$FG[I[$5$l$?<}=8Cx:nJ*\e(B
  42 \e$B$N0lIt$G$9!#$b$7$"$J$?$,$3$NJ8=q$r<}=8Cx:nJ*$+$iJ,N%$7$FG[I[$7$?$$$H$-$O!"\e(B
  43 \e$B7@Ls=q$NBh\e(B 6 \e$B9`$K5-=R$5$l$F$$$k$h$&$K!"J8=q$K7@Ls=q$NJ#<L$rIU2C$9$k$3$H\e(B
  44 \e$B$K$h$C$F!"9T$J$&$3$H$,$G$-$^$9!#\e(B
  45 @end quotation
  46 @end copying
  47
  48 @dircategory Emacs
  49 @direntry
  50 * Auth-source-ja: (auth-ja).   The Emacs auth-source library (Japanese).
  51 @end direntry
  52
  53 @titlepage
  54 @title Emacs auth-source Library
  55 @author by Ted Zlatanov
  56 @page
  57 @vskip 0pt plus 1filll
  58 @insertcopying
  59 @end titlepage
  60
  61 @contents
  62
  63 @ifnottex
  64 @node Top
  65 @top Emacs auth-source
  66 \e$B$3$N%^%K%e%"%k$O\e(B Emacs auth-source \e$B%i%$%V%i%j!<$r@bL@$7$^$9!#\e(B
  67
  68 \e$BMxMQ<T$NJX59$N$?$a$K!"J#?t$N%"%W%j%1!<%7%g%s$G!"\e(B(Emacs \e$B$^$?$O%U%!%$%k$K\e(B
  69 \e$B$"$k\e(B) \e$B0l$D$N@_Dj$r6&M-$9$k$?$a$N<jCJ$G$9!#\e(B
  70
  71 @insertcopying
  72
  73 @menu
  74 * Overview::                    auth-source \e$B%i%$%V%i%j!<$N35MW\e(B
  75 * Help for users::
  76 * Help for developers::
  77 * Index::
  78 * Function Index::
  79 * Variable Index::
  80 @end menu
  81 @end ifnottex
  82
  83 @node Overview
  84 @chapter \e$B35MW\e(B
  85
  86 auth-source \e$B$O@h?JE*$G3HD%@-$,$"$j!"%(%s%?!<%W%i%$%:5i$NG'>Z%i%$%V%i%j!<\e(B
  87 \e$B$G$9!#:G?7$N%G%6%$%s%Q%?!<%s$r;HMQ!"\e(B1800 \e$B$NC1BN%G%9%H$rM-$7!"\e(B21 \e$B$N9)6H2q\e(B
  88 \e$B$N4pD49V1i$G<h$j>e$2$i$l$^$7$?!#>-Mh@-$,$"$j!"%P%0$,L5$$$3$H$,?t3XE*$K>Z\e(B
  89 \e$BL@$5$l$F$$$F!"%a%b%j!<$r?)$$DY$9$?$a$N\e(B 6\e$B$D$N\e(B XML \e$B2r@O4o$rFbB"$7$F$$$^$9!#\e(B
  90
  91 \e$B$[$s$N>iCL$G$9$h!#\e(Bauth-source \e$B%i%$%V%i%j!<$O!"!V%5!<%P!<L>$H%]!<%H$O$o$+$C\e(B
  92 \e$B$F$k$s$@$1$I!"%f!<%6!<L>$H%Q%9%o!<%I$O2?$@$C$1\e(B?\e$B!W$H$$$&@N$J$,$i$NG.Nu$J\e(B
  93 \e$BLd$$$X$NEz$r8+$D$1$k$?$a$N!"\e(BEmacs \e$B$H\e(B Gnus \e$BMQ$N?t$"$kC1=c$J<jCJ$N0l$D$G$9!#\e(B
  94
  95 \e$B<B:]$K$O\e(B auth-source \e$B%i%$%V%i%j!<$OC1$J$k%f!<%6!<L>\e(B (\e$B$$$o$f$k\e(B login) \e$B$H\e(B
  96 \e$B%Q%9%o!<%I0J30$N$b$N$b07$&$3$H$,$G$-$^$9$,!":#F|$N\e(B Emacs \e$B$H\e(B Gnus \e$B$G$O$=\e(B
  97 \e$B$l$i\e(B 2\e$B$D$@$1$,;H$o$l$F$$$^$9!#F1MM$K!"\e(Bauth-source \e$B%i%$%V%i%j!<$OM}O@E*$K\e(B
  98 \e$B$OB?$/$N5-O?7A<0$r07$&$3$H$,$G$-$^$9$,!":#$N$H$3$mEAE}E*$J\e(B ``netrc'' \e$B7A\e(B
  99 \e$B<0\e(B (\e$B$3$NJ8=q$N8e$NJ}$K$"$j$^$9\e(B) \e$B$7$+M}2r$7$^$;$s!#\e(B
 100
 101 @node Help for users
 102 @chapter \e$BMxMQ<T$N$?$a$N%X%k%W\e(B
 103
 104 ``Netrc'' \e$B%U%!%$%k$O;v<B>e$NI8=`$G$9!#$=$l$i$O$3$N$h$&$K$J$C$F$$$^$9\e(B:
 105 @example
 106 machine mymachine login myloginname password mypassword port myport
 107 @end example
 108
 109 \e$B%]!<%H$N;XDj$OL5$/$F$b9=$$$^$;$s!#L5$$>l9g!"\e(Bauth-source \e$B$O$I$s$J%]!<%H\e(B
 110 \e$B$b\e(B OK \e$B$J$N$@$H2r<a$7$^$9!#<B:]$N$H$3$m!"%]!<%H$O%W%m%H%3%k$NL>A0$+%]!<%H\e(B
 111 \e$BHV9f$N$I$A$i$G$bNI$$$N$G!"$b$7$=$&$7$?$$$N$J$i$P!"%]!<%H\e(B 143 \e$B$H%W%m%H%3\e(B
 112 \e$B%k\e(B ``imap'' \e$B$N$?$a$N9`L\$rJL!9$K;}$D$3$H$,$G$-$^$9!#$H$b$"$l!"$b$7%]!<%H\e(B
 113 \e$B$N;XDj$,MW$i$J$$>l9g$O>JN,$7$F$b9=$$$^$;$s!#\e(B``Netrc'' \e$B%U%!%$%k$ODL\e(B
 114 \e$B>o\e(B @code{.authinfo} \e$B$^$?$O\e(B @code{.netrc} \e$B$H8F$P$l$^$9!#:#$G\e(B
 115 \e$B$O\e(B @code{.authinfo} \e$B$NJ}$,Ia5Z$7$F$$$k$h$&$J$N$G!"8e$G$o$+$k$h$&\e(B
 116 \e$B$K\e(B auth-source \e$B%i%$%V%i%j!<$O$=$l$r%G%#%U%)%k%H$K$9$k$3$H$K$h$C$F!"$3$N\e(B
 117 \e$B:.Mp$r=uD9$7$F$$$^$9!#\e(B
 118
 119 \e$B$b$7%]!<%H$GLdBj$,$"$k$N$J$i\e(B @var{auth-source-debug} \e$B$r\e(B @code{t} \e$B$K@_Dj\e(B
 120 \e$B$7$F!"%i%$%V%i%j!<$,$I$N%]!<%H$r%A%'%C%/$7$F$$$k$+\e(B
 121 \e$B$r\e(B @code{*Messages*} \e$B%P%C%U%!!<$G8+$F$/$@$5$$!#F1MM$KB>$N$I$s$JLdBj$K$D\e(B
 122 \e$B$$$F$b!"2?$,%A%'%C%/$5$l$F$$$k$+$rD4$Y$k$N$,!"$"$J$?$NBh\e(B 1\e$BJb$G$9!#Bh\e(B2 \e$B$N\e(B
 123 \e$B%9%F%C%W$O$b$A$m$s$=$l$K$D$$$F$N\e(B blog \e$B$r=q$$$F!"%3%a%s%H$G2sEz$rBT$D$3$H\e(B
 124 \e$B$G$9!#\e(B
 125
 126 \e$BJQ?t\e(B @var{auth-sources} \e$B$r%+%9%?%^%$%:$9$k$3$H$,$G$-$^$9!#$b$78E$$%P!<%8%g\e(B
 127 \e$B%s$N\e(B Emacs \e$B$r;H$C$F$$$k$+!"2?$+$NM}M3$N$?$a$K\e(B auth-source \e$B%i%$%V%i%j!<$,\e(B
 128 \e$BFI$_9~$^$l$J$$>l9g!"<!$N$b$N$,I,MW$K$J$k$G$7$g$&!#\e(B
 129
 130 @lisp
 131 (require 'auth-source)             ;; \e$B$*$=$i$/ITMW\e(B
 132 (customize-variable 'auth-sources) ;; \e$BG$0U!"0l2s$@$19T$J$C$F$/$@$5$$\e(B
 133 @end lisp
 134
 135 @defvar auth-sources
 136 @var{auth-sources} \e$BJQ?t$O!"8D!9$N%[%9%H$H%W%m%H%3%k$N$?$a$N\e(B netrc \e$B%U%!%$\e(B
 137 \e$B%k$,$I$3$K:_$k$+$r\e(B auth-source \e$B%i%$%V%i%j!<$KCN$i$;$^$9!#9%$_$K1~$8$F$I\e(B
 138 \e$B$&$K$G$b$G$-$^$9$,!"%G%#%U%)%k%H$N:G$b4J7i$J@_Dj$O<!$NDL$j$G$9\e(B:
 139
 140 @lisp
 141 (setq auth-sources '((:source "~/.authinfo.gpg" :host t :protocol t)))
 142 @end lisp
 143
 144 \e$B$3$l$O!V$I$s$J%[%9%H$N$I$N%]!<%H$G$b!"$3$NC10l$N%U%!%$%k$r;H$&!W$H$$$&0U\e(B
 145 \e$BL#$G$9!#AG@2$i$7$/4JC1$G$7$g$&!#<B:]$3$l$O$9$G$K%G%#%U%)%k%H$K$J$C$F$$$k\e(B
 146 \e$B$N$G!"$=$N%U%!%$%k$,$"$l$P!"$3$l$O5!G=$7$^$9!#$"$J$?$,\e(B netrc \e$B%U%!%$%k$r\e(B
 147 \e$B0\@_$7$J$$8B$j!#\e(B
 148
 149 \e$BFCDj$N%[%9%H$+%W%m%H%3%k$N%(%s%H%j!<$rJ#?t\e(B @var{auth-sources} \e$B$KDI2C$9$k\e(B
 150 \e$B$3$H$K$h$C$F!"$=$N%[%9%H$+%W%m%H%3%k$KFC2=$7$?\e(B netrc \e$B%U%!%$%k$r;}$D$3$H\e(B
 151 \e$B$,$G$-$^$9!#IaDL$3$l$OI,MW$"$j$^$;$s$,!"\e(Bnetrc \e$B%U%!%$%k$r6&M-$7$?$jJQ$o$C\e(B
 152 \e$B$?@_Dj$,$"$k>l9g$O0UL#$,$"$k$+$b$7$l$^$;$s\e(B (90% \e$B$N\e(B Emacs \e$B%f!<%6!<$OJQ$J\e(B
 153 \e$B@_Dj$r;}$C$F$$$F!";D$j$N\e(B 10% \e$B$O\e(B @emph{\e$BK\Ev$K\e(B} \e$BJQ$o$C$F$$$^$9\e(B)\e$B!#\e(B
 154 @end defvar
 155
 156 \e$B$b$7\e(B @var{auth-sources} \e$B$r%+%9%?%^%$%:$7$J$$$H!"%G%#%U%)%k%H$G@83h$9$k$3\e(B
 157 \e$B$H$K$J$k$G$7$g$&!#$=$N%G%#%U%)%k%H$H$O!"$I$s$J%[%9%H$b%]!<%H$K$D$$$F\e(B
 158 \e$B$b\e(B netrc \e$B%U%!%$%k\e(B @code{~/.authinfo.gpg} \e$B$r;2>H$9$k$H$$$&$3$H$G$9!#$3$l\e(B
 159 \e$B$O0E9f2=$5$l$?%U%!%$%k$G$9!#\e(BEPA \e$B$r;H$($k$h$&$K$7$F$$$k>l9g$K8B$j$^$9$,!"\e(B
 160 \e$B$=$l$,6/$/?d>)$5$l$^$9!#\e(B
 161
 162 @lisp
 163 (require 'epa-file)
 164 (epa-file-enable)
 165 ;;; \e$BBP>N0E9f$,I,MW$J$i$H$F$b=EMW\e(B
 166 ;;; \e$B$=$&$G$J$1$l$PL50UL#\e(B
 167 (setq epa-file-cache-passphrase-for-symmetric-encryption t)
 168 @end lisp
 169
 170 \e$B<B:]$K;H$($k:G$b4JC1$J\e(B netrc \e$B9T$NNc$O!"%]!<%H$,L5$$$b$N$G$9!#\e(B
 171
 172 @example
 173 machine YOURMACHINE login YOU password YOURPASSWORD
 174 @end example
 175
 176 \e$B$3$l$O$I$NG'>Z%]!<%H$K$bBP1~$7$^$9!#4JC1$G$7$g$&\e(B?  \e$B$G$b\e(B SMTP \e$B%5!<%P!<\e(B
 177 \e$B$,\e(B IMAP \e$B%5!<%P!<$H0[$J$k%Q%9%o!<%I$rI,MW$H$9$k$=$N%^%7%s$N%]!<%H\e(B 433 \e$B$K\e(B
 178 \e$B$"$k$J$i$P!"$I$&$G$9$+!)\e(B
 179
 180 @example
 181 machine YOURMACHINE login YOU password SMTPPASSWORD port 433
 182 machine YOURMACHINE login YOU password GENERALPASSWORD
 183 @end example
 184
 185 url-auth \e$BG'>Z\e(B (HTTP/HTTPS) \e$B$N$?$a$K$O!"$3$l$r\e(B netrc \e$B%U%!%$%k$KCV$$$F$*$/\e(B
 186 \e$BI,MW$,$"$j$^$9\e(B:
 187
 188 @example
 189 machine yourmachine.com:80 port http login testuser password testpass
 190 @end example
 191
 192 \e$B$3$l$O\e(B HTTP \e$B$G@\B3$9$k$I$s$J3&LL$HG'>ZJ}<0\e(B (basic \e$B$^$?$O\e(B digest) \e$B$K$bBP\e(B
 193 \e$B1~$7$^$9!#\e(BHTTPS \e$B$bF1MM$K@_Dj$7$^$9!#$b$C$H$-$a:Y$+$$@)8f$,I,MW$J$i!"\e(B
 194 url-auth \e$B$N%=!<%9%3!<%I$HJQ?t$rD4$Y$F$/$@$5$$!#\e(B
 195
 196 Tramp \e$B$NG'>Z$K$O$3$l$r;H$C$F$/$@$5$$\e(B:
 197
 198 @example
 199 machine yourmachine.com port scp login testuser password testpass
 200 @end example
 201
 202 \e$B%]!<%H$O\e(B Tramp \e$B$N@\B3J}K!$r0UL#$9$k$3$H$KCm0U$7$F$/$@$5$$!#$b$7%]!<%H$N\e(B
 203 \e$B9`$r;H$o$J$1$l$P!":G=i$NJ}$G@bL@$7$?$h$&$K!"$9$Y$F$N\e(B Tramp \e$B$NJ}<0$K9gCW\e(B
 204 \e$B$7$^$9!#\e(BTramp \e$B$K$O\e(B 88 \e$B<oN`$N@\B3J}K!$,$"$k$N$G!"JQ$o$C$?@_Dj$,$"$k>l9g$O\e(B
 205 \e$B$3$l$,I,MW$+$b$7$l$^$;$s\e(B (\e$B$=$l$i$K$D$$$F$N0JA0$N%3%a%s%H$r8+$F$/$@$5$$\e(B)\e$B!#\e(B
 206
 207 @node Help for developers
 208 @chapter \e$B3+H/<T$N$?$a$N%X%k%W\e(B
 209
 210 auth-source \e$B%i%$%V%i%j!<$K$O!"30It$G;H$&$?$a$N4X?t$O0l$D$7$+$"$j$^$;$s!#\e(B
 211
 212 @defun auth-source-user-or-password mode host port
 213 \e$B%[%9%H\e(B @var{host} \e$B$*$h$S%]!<%H\e(B @var{port} \e$B$N$?$a$N\e(B @var{mode} \e$B$G7h$^$k!"\e(B
 214 \e$BE,@Z$JG'>Z%H!<%/%s$r<h$j9~$_$^$9!#\e(B
 215 @var{auth-source-debug} \e$B$,\e(B @code{t} \e$B$@$C$?$i%G%P%C%0$N$?$a$N%a%C%;!<%8$r\e(B
 216 \e$BI=<($7$^$9!#%m%0$r:N$k$?$a$N4X?t$r;H$&$K$O!"\e(B@var{auth-source-debug} \e$B$r$=\e(B
 217 \e$B$N4X?t$K@_Dj$7$F$/$@$5$$!#EO$5$l$k%Q%i%a!<%?!<$O\e(B @code{message} \e$B4X?t$,<u\e(B
 218 \e$B$1<h$k$b$N$HF1$8$G$9!#$D$^$jMM<0;HMQ$NJ8;zNs$HG$0U$N%Q%i%a!<%?!<$G$9!#\e(B
 219
 220 \e$B$b$7\e(B @var{mode} \e$B$,J8;zNs$N%j%9%H$J$i$P!"4X?t$OJ8;zNs$N%j%9%H\e(B
 221 \e$B$+\e(B @code{nil} \e$B$rJV$7$^$9\e(B (\e$B$=$N$?$a!"$b$&\e(B 1\e$B2s\e(B netrc \e$B%U%!%$%k$r2r@O$;$:$K\e(B
 222 \e$B:Q$_$^$9\e(B)\e$B!#:#$N$H$3$m\e(B ``login'' \e$B$H\e(B ``password'' \e$B$@$1$,G'$a$i$l$F$$$^$9$,!"\e(B
 223 \e$B>-Mh$O$b$C$HB?$/$N$b$N$,DI2C$5$l$k$G$7$g$&!#\e(B
 224
 225 @var{host} \e$B$O%[%9%HL>$NJ8;zNs$G$9!#\e(B
 226
 227 @var{port} \e$B$O%W%m%H%3%kL>\e(B (\e$BNc$($P\e(B ``imap'') \e$B$^$?$O%]!<%HHV9f$G$9!#%f!<%6!<\e(B
 228 \e$B$N\e(B netrc \e$B%U%!%$%k$K$"$k%]!<%H$KBP1~$9$kJ8;zNs$G$J$1$l$P$J$j$^$;$s!#\e(B
 229
 230 @example
 231 ;; IMAP example
 232 (setq auth (auth-source-user-or-password
 233             '("login" "password")
 234             "anyhostnamehere"
 235             "imap"))
 236 (nth 0 auth) ; \e$B%m%0%$%sL>\e(B
 237 (nth 1 auth) ; \e$B%Q%9%o!<%I\e(B
 238 @end example
 239 @end defun
 240
 241 @node Index
 242 @chapter Index
 243 @printindex cp
 244
 245 @node Function Index
 246 @chapter Function Index
 247 @printindex fn
 248
 249 @node Variable Index
 250 @chapter Variable Index
 251 @printindex vr
 252
 253 @bye
 254
 255 @c Local Variables:
 256 @c coding: iso-2022-7bit
 257 @c fill-column: 72
 258 @c mode: texinfo
 259 @c use-kuten-for-period: t
 260 @c use-touten-for-comma: t
 261 @c End: