From 25548774774d31db6d3a0ac2ce9574122437e1f7 Mon Sep 17 00:00:00 2001 From: Andrea Luzzardi Date: Wed, 12 Sep 2007 18:08:00 +0000 Subject: [PATCH] Doc update --- pam_usb/doc/CONFIGURATION | 28 +++++++++++++++++----------- pam_usb/doc/FAQ | 6 ++++++ pam_usb/doc/QUICKSTART | 18 +++++++++++++++++- pam_usb/doc/pamusb-agent.1.gz | Bin 564 -> 567 bytes pam_usb/doc/pamusb-check.1.gz | Bin 855 -> 880 bytes pam_usb/doc/pamusb-conf.1.gz | Bin 452 -> 478 bytes 6 files changed, 40 insertions(+), 12 deletions(-) diff --git a/pam_usb/doc/CONFIGURATION b/pam_usb/doc/CONFIGURATION index da72e85..3409630 100644 --- a/pam_usb/doc/CONFIGURATION +++ b/pam_usb/doc/CONFIGURATION @@ -1,8 +1,9 @@ ====== Configuration ====== - - - +Configuration is done through the pamusb-conf tool, as explained in the +[[quickstart]] section. Most users don't have to manually change pamusb.conf, +however if you want to change some default settings, this document explains the +syntax of the pamusb.conf configuration file. ===== Introduction ===== @@ -48,6 +49,7 @@ pamusb-agent -c /some/other/path.conf + ===== Options ===== ^ Name ^ Type ^ Default value ^ Description ^ @@ -61,8 +63,10 @@ output) | | | one_time_pad | Boolean | true | Enable the use of one time pads | -| probe_timeout | Integer | 10 | Time (in seconds) to -wait for the volume to be detected| +| probe_timeout | Time | 10s | Time to wait for the +volume to be detected| +| pad_expiration| Time | 1h | Time between pads +regeneration| | hostname | String | Computer's hostname | Computer name. Must be unique accross computers using the same device | @@ -129,6 +133,7 @@ SNDKXXXXXXXXXXXXXXXX | + ===== Users ===== ^ Name ^ Type ^ Description ^ @@ -147,12 +152,12 @@ below | -gnome-screensaver-command --lock -beep-media-player --pause +gnome-screensaver-command --lock +beep-media-player --pause -gnome-screensaver-command --deactivate -beep-media-player --play +gnome-screensaver-command --deactivate +beep-media-player --play ===== Services ===== @@ -169,6 +174,7 @@ beep-media-player --> + ===== Full example ===== This example demonstrates how to write a pam_usb configuration file and how to @@ -226,8 +232,8 @@ override the "quiet" option --> - gnome-screensaver-command --lock - gnome-screensaver-command --deactivate + gnome-screensaver-command --lock + gnome-screensaver-command --deactivate diff --git a/pam_usb/doc/FAQ b/pam_usb/doc/FAQ index 37c76f3..f64308a 100644 --- a/pam_usb/doc/FAQ +++ b/pam_usb/doc/FAQ @@ -19,3 +19,9 @@ soon as you authenticate. > Q: Is my USB drive compatible with pam_usb ? >> A: About every USB flash drive will work with pam_usb. + +> Q: I can't authenticate anymore, pam_usb gives me the following error: Pad +checking failed. What should I do ? +>> A: It's a machine/device synchronization issue. To get rid of that error you +have to reset the pads of your system by removing the .pamusb folder located on +your home (/root/.pamusb/, /home/foobar/.pamusb/, etc). diff --git a/pam_usb/doc/QUICKSTART b/pam_usb/doc/QUICKSTART index d502914..75e011c 100644 --- a/pam_usb/doc/QUICKSTART +++ b/pam_usb/doc/QUICKSTART @@ -6,6 +6,22 @@ using an older version of pam_usb. ===== Installing ==== +==== Gentoo Linux ==== + +pam_usb 0.4.1 is currently keyword masked (~arch) on Gentoo, so you'll have to +unmask it before installing: + +# echo "sys-auth/pam_usb" >> /etc/portage/package.keywords +# emerge -av ">=sys-auth/pam_usb-0.4.1" + + +==== Debian GNU/Linux ==== + +pam_usb is available on Debian testing (lenny) and unstable (sid). + +# apt-get install libpam-usb pamusb-tools + + ==== Installing from sources ==== * Step 1: Download the latest release * Step 2: Unpack the distribution tarball @@ -15,7 +31,7 @@ $ cd pam_usb- * Step 3: Make sure that you have installed the required dependencies -pam_usb depends on libxml2, PAM and HAL. pam_usb's tools (pamusb-agent, +pam_usb depends on libxml2, PAM, HAL and pmount. pam_usb's tools (pamusb-agent, pamusb-conf) depends on python, python-celementtree and python-gobject. * Step 3: Compile and install diff --git a/pam_usb/doc/pamusb-agent.1.gz b/pam_usb/doc/pamusb-agent.1.gz index 6fad245b362fe80a8c5e9d5e289917d1081ca677..f40be71c4371273ca2f5f74a117c9438bac87d2e 100644 GIT binary patch delta 486 zcmV9offPiOEjxxZtN`SfD?F;4~&?}{9B;Z{kceuvg8 zDqa~ak&)*mp^@j&X1TiK)eG00NC^JC;$Ke delta 483 zcmV<90UZ9f1hfPPABzYGTM`hF2O$EroslX)f4`}PW_&e+M%2M=27($qjG;Gatg2u% zzJ{C8=wlCh^dyt}r*%5*F~-vwJWTHI*keAun0(BWLBx8Z65uwLN};m~Z99|xdRQds zJY`(xjOU_;+qV#e0Kcg=7?fBw^!MlZD~--oL4_}k@a3tR39OAiZ!1wgzjk#?R`gOW ze}V6J>Fsi!tmcb{_ZBM$N`owgEf7o&xJMbh(gjFUlU136&=?Km0%W*V5~<&z^@@sD zMoVPmcS&gEcXZj8)`X%wS<(l>085m&qT-Av2}=>7^uGDD+wFMAhZ|cAGb4wD?I|`9 z;XjndH&rMgH#RQyHpp0aK&wl$182v}AD3Zy(9f>y)NgNT|&NuXev%`(jO~dn+ ze(T?K{Uc>bg@W`tq#QSthQ-F%ZnRs_oqjD;70;$p&Ufxl)~nfK$tF6pDBx#!c@Z{K Z@YzYT|K?ON9>>_fvcI;K=ykXQ0012a>VE(L diff --git a/pam_usb/doc/pamusb-check.1.gz b/pam_usb/doc/pamusb-check.1.gz index 898bd3c269d711d002a57598769a3de78c71bbb1..63b3cf3f940ccebd278a58e2d27814c4a3f7fc2d 100644 GIT binary patch literal 880 zcmV-$1CRV4iwFq2D(FT418`w&b#r1ZV`yb#Yc4SWy;a+8+c*$?=T{7b0&4?_8mA8n z1Z`30g2q6TsFe+Lu_+8n8cD=Tq{2%Q_v?2^#;NS}zU;#S25b)JdN}7eO<;-77Pzyj z=T?-w>o(A!M9nQ$P;9_H+tZ#)mM*Vh;Jq`&aoJ+|7tA2Zaj@7Is9|<`1g9q_zbBB; zC!61_SNVCuSejqM?fmA7-Ph;i=x~w$aeJ5Li=3shW@*iPxL_;88$5&idNFptuQT|Q zQXC(**bQ|0@p7!NaLwpkDp?C}_%LwWZmkCOqbSjvCGYVy*!3Y7i^m5i(1u*^9YuK0 zkFl*KeTmTW_HX0?I~6 zOxePMFhEsn*Fmi`6v~n(8Y^T2gVTdDXkcO$MDWK+;>=EmGVDp%RyhkTfAp~wVf6;Q z6*$w#I~cTTH1DTJP>>(*j0z=9sm0*yr3cXe%>X_NOSLNWt)76WeG_bN$R}>VxUxiJ zXp|#b5*h^clQ82c!(zQupy!qrb_T1^zg8LmzxqDE$-Z3W?9HK_Fr|8C=^}&sN#Wof zo9}j`@xc*>VLbn&kobTECjU$|9jCbr4M0*7URFF};`=6;C6=BQlSZj(n(h=1BLm?o z$%C%4>~P2X`)J&M9>Tc)wdohOytGTM7vsGHfBmaR??fHOISe=GcCx)`m9d`p zWF(;xuHRmmjUlD;xz?4?gs9RRa!TV=zqb*=w4;D?OTSp&swd)6 z-*e)wszD7NW0UTLZM84PU2fwHgbV2DZHZiaL9YTCqe>sOG8lN*(ALOZIe}Vq2$KqH z?mBBcPv4>~-^Phj?@K$ix70DU@yn7&BY04KaDkEkeo^+MV_f8bwoZ3vkINV-1ibfT`D8>ho25!OAKBjwx`KX| G2LJ$#HN5Nq literal 855 zcmV-d1E~BTiwFo>5)eiJ18`w&b#r1ZV`yb#Yc4SWy;R$7+eQ$5->(=D1u6kHBc%@o zj3lUhK`kJ*nNR{+)P=AlhvcHloCo+U-A&ZfXum`IXiRW2v+#&K?ZMH z=~XV9W(yT+w9;b%*%th(f7?ne;?*s5vJEaf&uh&8fjLBr&Z-7x^D}rmoBbL=M1RTR zZnI7=BO&7S7VZ~!H{!9p9B1~9^w0Z;BweN=)}@F`*}|1rJ6YicJeJFG_+y#CUsU4! zyvC-ZufKPnxzVMn$nd_CzTR6M+Gmv`o3(6lZ!SVR&V33BJ%5XLfigJq!vJGNKdOg# zeUn~&UM8#M!@W3xDVG|YYC}UzF@ZH|CeSOR!PnM=s-|CL(l(R`s4Jy07E2Gx0d*}y z1EsN$8BdYuywVkP!FI->gNZjV5Irt3%p7drM!YCro8Y0A&zwsc-fn@dAcaNQKxa*5 zWjj5CjN)YDOyAPwR(0GjKEd|S4)9fZ>Qx{^oq;MDgg6@VMLKXH&(S#=<%|}B20{Cx z+<3}JUgaY6)>|CXAL%Ut&WAj*j^ubwet+(fg+oG)Nf8BHK)h;-AXk!{Mtr=F zE`0Y8F8ol?yKC9OrO>PK-T}M6VdNk}ILvwKe5V(r9*KxA1!|c!C@yGE1MZClW}zZm zN$dI5*dOSzF*l8|o5oZ}6^zD>S1oQjSsc0O0J6bJheE#jZ11U!^L+PYBwr$MIh1z%?&)9z z=7*Cr98Q_v{741HO-{(<^k9tLUJacJ9^#r;iKjTgKgd;KKpWp{8etgq#e<@IEgz~r zan(<3f|dlVe~8QV@2N-{l*E`rO_CHUy0y;Oft#_ywo)}Lrj2rbkfp_Xb^GvHEObHF h1|P$hFVYqY-tpf5=2SJG$HrD4#J?0}dOJ-A008zEp&$u*0C+HC8LitDf{u0?4*s`fx*_R^YNbNm`0G}&H{5*wakiwHO(F> zl&G0S4x2sLot?H!5}MDUW34lrxKOf$2}Buo7TXPKm`u-MdU^RZg2+EW)UGY zo5M1>yCIL|>@@kYOyf}P*((qfQ90jHC<#`nrq9d%ELUl^$Ox4sp(ShK`a>CC1s=Q< z$2B&cKRq3eThtq6@I)DUc;TvJwmzzi^Vk{GL6@vW_)Fe&j$2XS@#bl8ko%YD-Tl1D zuJ0FVzE~~)<4PD{{UpHAh)Q~tRzYxigeznPw#EZe+EW>UAf;%K_Pthp8xJB+37wJC ziO(UNYX3#DTD^dAZOil?R0*mJWegpqy^|R-w;}WQAcAtXb9NN}#%%~MLipN;2J4mB zqWrMEU>d$~ESYPp@k5gfw8h2AlxJf@Bh*6^9-1VadxXQyr-Z}KhH&>D9`v5rZ2c=E zX@ksLH7Na$>?+XMDczeolJ9@NmWd{8qY=gqypwf4U)_^La*Ygb-RmpUT);O|sNE00 U&dG!-U41A204uC*w>|>^08FawNB{r; literal 452 zcmV;#0XzO5iwFo?5)eiJ18`w&b#r1ZV{dL|E-?UYl3#1vFcih#^(iiX+MrgGzU*Zi zbGotw*2L7#!&pmEt!rB#OGbaXr0l~_l9Mj!1_oP4y7!#>vuFl2?i?`h^uU~Gn3Q|y zP@!QCIXvyb?cCMC6ruGJMmBi+ls8(nFo&!djgT;#U%=ID_925TJY{kFxUCi$A+%b; zy12a|_wC}e@V+hc*y%AS5Eaq+;3l*Jr?pIV)sOY2tX37FswK2#16;pp6S~09Amw?F zaty17!*c2vgij-L{ZVC{=iZ`;x?%&uZ+O)?K8psAI}ejz9bO`3`Fc}b->u4ewORis zgRsC-Zs2G|rvfymA!a&a6siN);{hH`49>w;hpDiMgWRQ&`>i6SL>8i2RN)Hx4h)Xkq)GBLr$VgWT u>n481wq9=TNTIkv2H*Y53o~56N89M#m+*V$bE-}Enfw8q4X^b00ssJ#Kj7j3