deploy: 1159296a8a

_sources/index.rst.txt

@@ -62,6 +62,13 @@ need to use a live USB to get into a chroot environment to do any of these thing
 Snapper has a ``snapper rollback`` feature, but your setup has to be properly configured to
 use it. The exact procedure depends on your specific setup. Be careful.
 
+Note that the pre transaction hooks occur before the pacman transaction but after the
+pacman database is synced, if applicable. In other words, if you run `pacman -Syu` and
+roll back the upgrade according to the above instructions, you will not have rolled back
+the pacman database to the previous state. Thus, if, after upgrading and rolling back
+the upgrade, you then install a package, it will possibly be a partial upgrade, which is
+unsupported.
+
 .. toctree::
    :maxdepth: 1
 

index.html

@@ -141,6 +141,12 @@ snapshot and making it the default subvolume or mounting it as /. Most likely yo
 need to use a live USB to get into a chroot environment to do any of these things.
 Snapper has a <code class="docutils literal notranslate"><span class="pre">snapper</span> <span class="pre">rollback</span></code> feature, but your setup has to be properly configured to
 use it. The exact procedure depends on your specific setup. Be careful.</p>
+<p>Note that the pre transaction hooks occur before the pacman transaction but after the
+pacman database is synced, if applicable. In other words, if you run <cite>pacman -Syu</cite> and
+roll back the upgrade according to the above instructions, you will not have rolled back
+the pacman database to the previous state. Thus, if, after upgrading and rolling back
+the upgrade, you then install a package, it will possibly be a partial upgrade, which is
+unsupported.</p>
 <div class="toctree-wrapper compound">
 <ul>
 <li class="toctree-l1"><a class="reference internal" href="installation.html">Installation</a></li>

searchindex.js

@@ -1 +1 @@
-Search.setIndex({docnames:["configuration","examples","faq","index","installation","troubleshooting"],envversion:{"sphinx.domains.c":2,"sphinx.domains.changeset":1,"sphinx.domains.citation":1,"sphinx.domains.cpp":3,"sphinx.domains.index":1,"sphinx.domains.javascript":2,"sphinx.domains.math":2,"sphinx.domains.python":2,"sphinx.domains.rst":2,"sphinx.domains.std":2,sphinx:56},filenames:["configuration.rst","examples.rst","faq.rst","index.rst","installation.rst","troubleshooting.rst"],objects:{},objnames:{},objtypes:{},terms:{"100":[1,3],"1033":1,"1034":1,"2016":1,"2489":3,"7394":3,"7395":3,"8535cef3f3c38ee69555bf67e4b5e45aa3b8c5c3":4,"boolean":0,"case":0,"default":[0,3,5],"final":4,"import":0,"true":0,"while":5,For:[0,3,4],That:5,The:[0,1,3,4,5],Then:[0,1,4],Use:2,abov:1,access:4,action:2,add:[0,2,5],added:0,addit:0,addition:[0,3,4],after:[1,3,5],alia:3,all:[0,1,4],along:1,also:[0,1],altern:4,ani:[0,3,5],appli:0,apr:1,arm:3,arthur:0,aur:3,automat:[2,3],avail:[1,3],avzq:2,awk:2,back:[2,3],backup:2,bash:2,becaus:3,befor:[0,1,3],behavior:[2,5],being:[0,5],bin:[1,2],boot:2,bootbackup:2,breakag:3,btrf:2,build:4,cach:3,call:[0,3],can:[0,1,2,3,4,5],care:3,caus:3,cdt:1,chang:[1,3],check:[1,3],chroot:3,command:[0,3],comment:0,commit:4,conditionneedsupd:3,configur:[1,3,5],conflict:[1,3],consid:5,continu:1,copi:0,correspond:0,creat:[1,3],databas:5,delet:[1,2],depend:[1,3],desc_limit:0,descript:[0,2,3],desktop:3,detail:3,diff:[1,5],differ:0,directli:3,disk:[1,3],doc:[1,4],doe:[2,3],doesn:3,don:0,done:0,download:4,dure:[1,3],each:[0,1,3],easili:3,edit:0,editor:0,end:2,entri:0,environ:3,error:1,etc:[0,1,5],everi:0,exact:3,exampl:3,exec:2,expect:5,explanatori:0,extrem:3,f7b28c61944fe30dabeeb0b01070bcc98c18bd66:4,fals:0,faq:[1,3],favorit:0,featur:3,file:[0,1,3,5],filter:5,find:[2,3],fingerprint:4,follow:[0,1,2,3,5],found:1,fri:1,from:[0,3,5],full:0,fuller:[0,3],gener:4,get:3,give:5,given:1,gone:3,gpg:4,handl:0,has:[3,5],have:[0,3,4],helper:3,here:[0,1],home:0,hook:[0,1,2,3,5],how:[1,2,3],html:[1,4],icon:3,important_command:0,important_packag:0,index:4,inform:5,ini:0,instal:[0,1,2,3],instruct:5,integ:0,integr:[1,3],involv:0,its:5,kei:[0,1,3,4],kernel:2,keyr:[1,3],later:0,latest:4,length:0,lib:2,like:[2,3],link:2,linux:[0,2],list:[0,1,2],live:3,load:[1,3],locat:[0,4],lock:5,log:[1,3],longer:[1,2],look:[1,3],lts:0,mai:[0,3],make:[3,4],man8:4,man:4,manpag:4,mark:0,matter:3,maximum:0,mean:1,method:3,mib:[1,3],mime:3,modifi:1,modul:2,more:[3,5],most:[0,3],mount:3,name:0,nano:1,nanorc:1,need:[0,3,4],net:3,non:2,note:0,now:1,number:[1,3,4],off:0,old:2,one:0,onli:[0,5],onlin:4,opensus:3,oper:2,option:0,other:[0,5],otherwis:0,output:[1,3],overridden:0,own:4,pac:[0,1,2,4,5],packag:[0,1,2,3,4],pacman:[0,1,2,3,4,5],pair:0,parent:0,part:[0,2],partit:2,perform:[0,1,3,5],pgp:4,post:[0,1,3,5],post_descript:0,posttransact:2,pre:[0,1,3,5],pre_descript:0,pretransact:2,prevent:0,previou:4,print:2,proce:[1,3],procedur:3,process:[1,3],properli:3,provid:3,pytest:4,python:[0,4],reason:3,releas:4,remov:[0,2,3,5],requestid:0,requir:4,resolv:[1,3],resort:3,restor:5,result:4,revert:3,rnano:1,rollback:[1,3],root:[0,1,2,3,5],rsync:2,run:[1,3,4,5],same:1,screen:3,script:3,section:[0,5],see:[1,3,5],self:0,separ:0,set:[0,3,5],setup:3,sever:[0,3],share:1,she:3,should:0,sig:4,sign:4,signatur:4,similar:3,simpl:3,simpli:4,sinc:0,singl:0,size:[1,3],snap:[0,1,2,4,5],snap_pac_skip:0,snaphot:5,snapper:[0,1,2,3,4,5],snapshot:[0,1,2,3,5],some:3,someth:2,space:[0,1,3],specif:3,sphinx:4,start:4,statu:[1,5],string:0,subvolum:3,sudo:[0,3],suitabl:0,symbol:1,symlink:2,system:[0,3],syu:0,tail:1,take:[3,5],taken:5,tar:4,tarbal:4,target:2,temporarili:0,theme:3,thi:[0,1,2,3,4,5],thing:3,through:3,total:[1,3],transact:[0,1,3],trigger:2,troubleshoot:3,truncat:[0,1],turn:0,type:[2,3],typic:4,unam:2,under:4,undo:[1,3],undochang:[1,3,5],unless:0,updat:3,upgrad:[0,2,3],usb:3,use:3,used:[1,3],user:[0,3],userdata:0,using:[3,4],usr:[1,2],valu:0,variabl:3,verifi:4,version:4,via:0,vim:3,visit:4,wai:[1,3],want:3,well:3,were:0,what:1,when:[0,2,3,5],where:4,whether:[0,3],which:[3,4,5],won:5,would:2,xtype:2,yast:3,yes:[0,5],you:[0,1,2,3,4,5],your:[0,3,4]},titles:["Configuration","Example","FAQ","snap-pac","Installation","Troubleshooting"],titleterms:{configur:0,depend:4,document:4,environ:0,exampl:[0,1],faq:2,instal:4,pac:3,snap:3,test:4,troubleshoot:5,variabl:0}})
+Search.setIndex({docnames:["configuration","examples","faq","index","installation","troubleshooting"],envversion:{"sphinx.domains.c":2,"sphinx.domains.changeset":1,"sphinx.domains.citation":1,"sphinx.domains.cpp":3,"sphinx.domains.index":1,"sphinx.domains.javascript":2,"sphinx.domains.math":2,"sphinx.domains.python":2,"sphinx.domains.rst":2,"sphinx.domains.std":2,sphinx:56},filenames:["configuration.rst","examples.rst","faq.rst","index.rst","installation.rst","troubleshooting.rst"],objects:{},objnames:{},objtypes:{},terms:{"100":[1,3],"1033":1,"1034":1,"2016":1,"2489":3,"7394":3,"7395":3,"8535cef3f3c38ee69555bf67e4b5e45aa3b8c5c3":4,"boolean":0,"case":0,"default":[0,3,5],"final":4,"import":0,"true":0,"while":5,For:[0,3,4],That:5,The:[0,1,3,4,5],Then:[0,1,4],Use:2,abov:[1,3],access:4,accord:3,action:2,add:[0,2,5],added:0,addit:0,addition:[0,3,4],after:[1,3,5],alia:3,all:[0,1,4],along:1,also:[0,1],altern:4,ani:[0,3,5],appli:0,applic:3,apr:1,arm:3,arthur:0,aur:3,automat:[2,3],avail:[1,3],avzq:2,awk:2,back:[2,3],backup:2,bash:2,becaus:3,befor:[0,1,3],behavior:[2,5],being:[0,5],bin:[1,2],boot:2,bootbackup:2,breakag:3,btrf:2,build:4,cach:3,call:[0,3],can:[0,1,2,3,4,5],care:3,caus:3,cdt:1,chang:[1,3],check:[1,3],chroot:3,command:[0,3],comment:0,commit:4,conditionneedsupd:3,configur:[1,3,5],conflict:[1,3],consid:5,continu:1,copi:0,correspond:0,creat:[1,3],databas:[3,5],delet:[1,2],depend:[1,3],desc_limit:0,descript:[0,2,3],desktop:3,detail:3,diff:[1,5],differ:0,directli:3,disk:[1,3],doc:[1,4],doe:[2,3],doesn:3,don:0,done:0,download:4,dure:[1,3],each:[0,1,3],easili:3,edit:0,editor:0,end:2,entri:0,environ:3,error:1,etc:[0,1,5],everi:0,exact:3,exampl:3,exec:2,expect:5,explanatori:0,extrem:3,f7b28c61944fe30dabeeb0b01070bcc98c18bd66:4,fals:0,faq:[1,3],favorit:0,featur:3,file:[0,1,3,5],filter:5,find:[2,3],fingerprint:4,follow:[0,1,2,3,5],found:1,fri:1,from:[0,3,5],full:0,fuller:[0,3],gener:4,get:3,give:5,given:1,gone:3,gpg:4,handl:0,has:[3,5],have:[0,3,4],helper:3,here:[0,1],home:0,hook:[0,1,2,3,5],how:[1,2,3],html:[1,4],icon:3,important_command:0,important_packag:0,index:4,inform:5,ini:0,instal:[0,1,2,3],instruct:[3,5],integ:0,integr:[1,3],involv:0,its:5,kei:[0,1,3,4],kernel:2,keyr:[1,3],later:0,latest:4,length:0,lib:2,like:[2,3],link:2,linux:[0,2],list:[0,1,2],live:3,load:[1,3],locat:[0,4],lock:5,log:[1,3],longer:[1,2],look:[1,3],lts:0,mai:[0,3],make:[3,4],man8:4,man:4,manpag:4,mark:0,matter:3,maximum:0,mean:1,method:3,mib:[1,3],mime:3,modifi:1,modul:2,more:[3,5],most:[0,3],mount:3,name:0,nano:1,nanorc:1,need:[0,3,4],net:3,non:2,note:[0,3],now:1,number:[1,3,4],occur:3,off:0,old:2,one:0,onli:[0,5],onlin:4,opensus:3,oper:2,option:0,other:[0,3,5],otherwis:0,output:[1,3],overridden:0,own:4,pac:[0,1,2,4,5],packag:[0,1,2,3,4],pacman:[0,1,2,3,4,5],pair:0,parent:0,part:[0,2],partial:3,partit:2,perform:[0,1,3,5],pgp:4,possibl:3,post:[0,1,3,5],post_descript:0,posttransact:2,pre:[0,1,3,5],pre_descript:0,pretransact:2,prevent:0,previou:[3,4],print:2,proce:[1,3],procedur:3,process:[1,3],properli:3,provid:3,pytest:4,python:[0,4],reason:3,releas:4,remov:[0,2,3,5],requestid:0,requir:4,resolv:[1,3],resort:3,restor:5,result:4,revert:3,rnano:1,roll:3,rollback:[1,3],root:[0,1,2,3,5],rsync:2,run:[1,3,4,5],same:1,screen:3,script:3,section:[0,5],see:[1,3,5],self:0,separ:0,set:[0,3,5],setup:3,sever:[0,3],share:1,she:3,should:0,sig:4,sign:4,signatur:4,similar:3,simpl:3,simpli:4,sinc:0,singl:0,size:[1,3],snap:[0,1,2,4,5],snap_pac_skip:0,snaphot:5,snapper:[0,1,2,3,4,5],snapshot:[0,1,2,3,5],some:3,someth:2,space:[0,1,3],specif:3,sphinx:4,start:4,state:3,statu:[1,5],string:0,subvolum:3,sudo:[0,3],suitabl:0,symbol:1,symlink:2,sync:3,system:[0,3],syu:[0,3],tail:1,take:[3,5],taken:5,tar:4,tarbal:4,target:2,temporarili:0,theme:3,thi:[0,1,2,3,4,5],thing:3,through:3,thu:3,total:[1,3],transact:[0,1,3],trigger:2,troubleshoot:3,truncat:[0,1],turn:0,type:[2,3],typic:4,unam:2,under:4,undo:[1,3],undochang:[1,3,5],unless:0,unsupport:3,updat:3,upgrad:[0,2,3],usb:3,use:3,used:[1,3],user:[0,3],userdata:0,using:[3,4],usr:[1,2],valu:0,variabl:3,verifi:4,version:4,via:0,vim:3,visit:4,wai:[1,3],want:3,well:3,were:0,what:1,when:[0,2,3,5],where:4,whether:[0,3],which:[3,4,5],won:5,word:3,would:2,xtype:2,yast:3,yes:[0,5],you:[0,1,2,3,4,5],your:[0,3,4]},titles:["Configuration","Example","FAQ","snap-pac","Installation","Troubleshooting"],titleterms:{configur:0,depend:4,document:4,environ:0,exampl:[0,1],faq:2,instal:4,pac:3,snap:3,test:4,troubleshoot:5,variabl:0}})