auth-ja.texi

   1 \input texinfo                  @c -*-texinfo-*-
   2
   3 @setfilename auth-ja
   4 @settitle Emacs auth-source Library @value{VERSION}
   5 @set VERSION 0.1
   6
   7 @dircategory Emacs
   8 @direntry
   9 * Auth-source-ja: (auth-ja).   The Emacs auth-source library (Japanese).
  10 @end direntry
  11
  12 @copying
  13 \e$B$3$N%U%!%$%k$O\e(B Emacs auth-source \e$B%i%$%V%i%j!<$r@bL@$7$^$9!#\e(B
  14
  15 Copyright @copyright{} 2008, 2009
  16 Free Software Foundation, Inc.
  17
  18 @quotation
  19 Permission is granted to copy, distribute and/or modify this document
  20 under the terms of the GNU Free Documentation License, Version 1.3 or
  21 any later version published by the Free Software Foundation; with no
  22 Invariant Sections, with the Front-Cover texts being ``A GNU Manual,''
  23 and with the Back-Cover Texts as in (a) below.  A copy of the license
  24 is included in the section entitled ``GNU Free Documentation License''
  25 in the Emacs manual.
  26
  27 \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
  28 \e$BBh\e(B 1.3 \e$BHG$^$?$O$=$l0J9_$NHG$,Dj$a$k>r7o$N2<$GJ#@=!"G[I[!"$"$k$$$OJQ99$9\e(B
  29 \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
  30 \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
  31 \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
  32 \e$B$$$^$9!#\e(B
  33
  34 (a) The FSF's Back-Cover Text is: ``You have the freedom to copy and
  35 modify this GNU manual.  Buying copies from the FSF supports it in
  36 developing GNU and promoting software freedom.''
  37
  38 (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
  39 \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
  40 \e$B$NB%?J$r;Y1g$7$^$9!#!W\e(B
  41
  42 This document is part of a collection distributed under the GNU Free
  43 Documentation License.  If you want to distribute this document
  44 separately from the collection, you can do so by adding a copy of the
  45 license to the document, as described in section 6 of the license.
  46
  47 \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
  48 \e$B$N0lIt$G$9!#$b$7$"$J$?$,$3$NJ8=q$r<}=8Cx:nJ*$+$iJ,N%$7$FG[I[$7$?$$$H$-$O!"\e(B
  49 \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
  50 \e$B$K$h$C$F!"9T$J$&$3$H$,$G$-$^$9!#\e(B
  51 @end quotation
  52 @end copying
  53
  54 @tex
  55
  56 @titlepage
  57 @title Emacs auth-source Library
  58
  59 @author by Ted Zlatanov
  60 @page
  61
  62 @vskip 0pt plus 1filll
  63 @insertcopying
  64 @end titlepage
  65 @page
  66
  67 @end tex
  68
  69 @node Top
  70 @top Emacs auth-source
  71 \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
  72
  73 \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
  74 \e$B$"$k\e(B) \e$B0l$D$N@_Dj$r6&M-$9$k$?$a$N<jCJ$G$9!#\e(B
  75
  76 @menu
  77 * Overview::                    auth-source \e$B%i%$%V%i%j!<$N35MW\e(B
  78 * Help for users::
  79 * Help for developers::
  80 * Index::
  81 * Function Index::
  82 * Variable Index::
  83 @end menu
  84
  85 @node Overview
  86 @chapter \e$B35MW\e(B
  87
  88 To be done.
  89
  90 @node Help for users
  91 @chapter \e$BMxMQ<T$N$?$a$N%X%k%W\e(B
  92
  93 \e$B$b$7%]!<%H$GLdBj$,$"$k$N$J$i!"\e(B@code{gnus-verbose} \e$B$NCM$rBg$-$/$7$F!"$=$N\e(B
  94 \e$B%i%$%V%i%j!<$,$I$N%]!<%H$r%A%'%C%/$7$F$$$k$+$r8+$F$/$@$5$$!#F1MM$KB>$N$I\e(B
  95 \e$B$s$JLdBj$K$D$$$F$b!"2?$,%A%'%C%/$5$l$F$$$k$+$rD4$Y$k$N$,!"$"$J$?$NBh0lJb\e(B
  96 \e$B$G$9!#\e(B
  97
  98 \e$B@_Dj\e(B:
  99
 100 @lisp
 101 (require 'auth-source)
 102 (customize-variable 'auth-sources) ;; \e$BG$0U!"0l2s$@$19T$J$C$F$/$@$5$$\e(B
 103 @end lisp
 104
 105 @defvar auth-sources
 106 @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
 107 \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
 108 \e$B$&$K$G$b$G$-$^$9$,!"%G%#%U%)%k%H$N:G$b4J7i$J@_Dj$O<!$NDL$j$G$9\e(B:
 109
 110 @lisp
 111 (setq auth-sources '((:source "~/.authinfo.gpg" :host t :protocol t)))
 112 @end lisp
 113
 114 \e$B8D!9$N%[%9%H$^$?$O%W%m%H%3%k$N$?$a$NJ#?t$N9`L\$r$=$N%j%9%H$K2C$($k$3$H$K\e(B
 115 \e$B$h$C$F!"$=$N%[%9%H$d%W%m%H%3%k$N$?$a$NFCDj$N\e(B netrc \e$B%U%!%$%k$r;}$D$3$H$,\e(B
 116 \e$B$G$-$^$9!#\e(B
 117 @end defvar
 118
 119 ``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:
 120 @example
 121 machine mymachine login myloginname password mypassword port myport
 122 @end example
 123
 124 \e$B%]!<%H$N;XDj$OL5$/$F$b9=$$$^$;$s!#L5$$>l9g!"\e(Bauth-source \e$B$O$I$s$J%]!<%H\e(B
 125 \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
 126 \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
 127 \e$B%k\e(B ``imap'' \e$B$N$?$a$N9`L\$rJL!9$K;}$D$3$H$,$G$-$^$9!#\e(B
 128
 129 \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
 130 \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
 131 \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
 132 \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
 133 \e$B$=$l$,6/$/?d>)$5$l$^$9!#\e(B
 134
 135 @lisp
 136 (require 'epa-file)
 137 (epa-file-enable)
 138 (setq epa-file-cache-passphrase-for-symmetric-encryption t) ; \e$B$H$F$b=EMW\e(B
 139 @end lisp
 140
 141 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
 142 \e$BI,MW$,$"$j$^$9\e(B:
 143
 144 @example
 145 machine yourmachine.com:80 port http login testuser password testpass
 146 @end example
 147
 148 \e$B$3$l$O$I$s$J3&LL$HG'>ZJ}<0\e(B (basic \e$B$^$?$O\e(B digest) \e$B$K$b9gCW$7$^$9!#$b$C$H\e(B
 149 \e$B>\:Y$J@)8f$,I,MW$J>l9g$O!"\e(Burl-auth \e$B$N%=!<%9%3!<%I$HJQ?t$rD4$Y$F$/$@$5$$!#\e(B
 150
 151 Tramp \e$B$NG'>Z$K$O$3$l$r;H$C$F$/$@$5$$\e(B:
 152
 153 @example
 154 machine yourmachine.com port scp login testuser password testpass
 155 @end example
 156
 157 \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
 158 \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
 159 \e$B$7$^$9!#\e(B
 160
 161 @node Help for developers
 162 @chapter \e$B3+H/<T$N$?$a$N%X%k%W\e(B
 163
 164 auth-source \e$B%i%$%V%i%j!<$K$O!"30It$G;H$&$?$a$N4X?t$O0l$D$7$+$"$j$^$;$s!#\e(B
 165
 166 @defun auth-source-user-or-password mode host port
 167 \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
 168 \e$BE,@Z$JG'>Z%H!<%/%s$r<h$j9~$_$^$9!#\e(B@code{gnus-verbose} \e$B$,\e(B 9 \e$B0J>e$G$"$l$P!"\e(B
 169 \e$B%G%P%C%0$N$?$a$N%a%C%;!<%8$rI=<($7$^$9!#\e(B
 170
 171 \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
 172 \e$B$O\e(B @code{nil} \e$B$rJV$7$^$9!#$=$l$,$?$@$NJ8;zNs$J$i$P!"4X?t$O0l$D$NJ8;zNs\e(B
 173 \e$B$+\e(B @code{nil} \e$B$rJV$7$^$9!#:#$N$H$3$m\e(B mode \e$B$H$7\e(B
 174 \e$B$F\e(B ``login'' \e$B$H\e(B ``password'' \e$B$@$1$rG'<1$7$^$9$,!">-Mh$O$b$C$H2C$($i$l$k\e(B
 175 \e$B$G$7$g$&!#\e(B
 176
 177 @var{host} \e$B$O%[%9%HL>$NJ8;zNs$G$9!#\e(B
 178
 179 @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
 180 \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
 181
 182 @example
 183 ;; IMAP example
 184 (setq auth (auth-source-user-or-password
 185             '("login" "password")
 186             "anyhostnamehere"
 187             "imap"))
 188 (nth 0 auth) ; \e$B%m%0%$%sL>\e(B
 189 (nth 1 auth) ; \e$B%Q%9%o!<%I\e(B
 190 @end example
 191 @end defun
 192
 193 @node Index
 194 @chapter Index
 195 @printindex cp
 196
 197 @node Function Index
 198 @chapter Function Index
 199 @printindex fn
 200
 201 @node Variable Index
 202 @chapter Variable Index
 203 @printindex vr
 204
 205 @summarycontents
 206 @contents
 207 @bye
 208
 209 @c Local Variables:
 210 @c coding: iso-2022-7bit
 211 @c fill-column: 72
 212 @c mode: texinfo
 213 @c use-kuten-for-period: t
 214 @c use-touten-for-comma: t
 215 @c End: