diff --git a/.doctrees/environment.pickle b/.doctrees/environment.pickle index 1d97769..ad2caa3 100644 Binary files a/.doctrees/environment.pickle and b/.doctrees/environment.pickle differ diff --git a/.doctrees/index.doctree b/.doctrees/index.doctree index ab53500..25f7286 100644 Binary files a/.doctrees/index.doctree and b/.doctrees/index.doctree differ diff --git a/_sources/index.rst.txt b/_sources/index.rst.txt index d723988..b090fc4 100644 --- a/_sources/index.rst.txt +++ b/_sources/index.rst.txt @@ -20,6 +20,38 @@ are output to the screen and to the pacman log for each snapper configuration du pacman transaction, so that the user can easily find which changes he or she may want to revert. +.. code-block:: none + :caption: When you run pacman, the snapper pre/post snapshots are created automatically. For a fuller example see :doc:`examples`. + :emphasize-lines: 17,18,25,26 + + $ sudo pacman -S vim + resolving dependencies... + looking for conflicting packages... + + Packages (1) vim-8.2.2489-1 + + Total Installed Size: 3.79 MiB + Net Upgrade Size: 0.00 MiB + + :: Proceed with installation? [Y/n] + (1/1) checking keys in keyring [############] 100% + (1/1) checking package integrity [############] 100% + (1/1) loading package files [############] 100% + (1/1) checking for file conflicts [############] 100% + (1/1) checking available disk space [############] 100% + :: Running pre-transaction hooks... + (1/1) Performing snapper pre snapshots for the following configurations... + ==> root: 7394 + :: Processing package changes... + (1/1) installing vim [############] 100% + :: Running post-transaction hooks... + (1/4) Arming ConditionNeedsUpdate... + (2/4) Updating icon theme caches... + (3/4) Updating the desktop file MIME type cache... + (4/4) Performing snapper post snapshots for the following configurations... + ==> root: 7395 + + To undo changes from a pacman transaction, use ``snapper undochange``. See the :manpage:`snapper(8)` for more details as well as examples. diff --git a/index.html b/index.html index 4960793..e7b05a9 100644 --- a/index.html +++ b/index.html @@ -102,6 +102,37 @@ logged in the snapper description for the snapshots. Additionally the snapshot n are output to the screen and to the pacman log for each snapper configuration during the pacman transaction, so that the user can easily find which changes he or she may want to revert.

+
+
When you run pacman, the snapper pre/post snapshots are created automatically. For a fuller example see Example.
+
$ sudo pacman -S vim
+resolving dependencies...
+looking for conflicting packages...
+
+Packages (1) vim-8.2.2489-1
+
+Total Installed Size:  3.79 MiB
+Net Upgrade Size:      0.00 MiB
+
+:: Proceed with installation? [Y/n]
+(1/1) checking keys in keyring                     [############] 100%
+(1/1) checking package integrity                   [############] 100%
+(1/1) loading package files                        [############] 100%
+(1/1) checking for file conflicts                  [############] 100%
+(1/1) checking available disk space                [############] 100%
+:: Running pre-transaction hooks...
+(1/1) Performing snapper pre snapshots for the following configurations...
+==> root: 7394
+:: Processing package changes...
+(1/1) installing vim                               [############] 100%
+:: Running post-transaction hooks...
+(1/4) Arming ConditionNeedsUpdate...
+(2/4) Updating icon theme caches...
+(3/4) Updating the desktop file MIME type cache...
+(4/4) Performing snapper post snapshots for the following configurations...
+==> root: 7395
+
+
+

To undo changes from a pacman transaction, use snapper undochange. See the snapper(8) for more details as well as examples.

If you have severe breakage—like snapper is gone for some reason and you can’t get it diff --git a/searchindex.js b/searchindex.js index bbcf5f8..916a0c9 100644 --- a/searchindex.js +++ b/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,"1033":1,"1034":1,"2016":1,"8535cef3f3c38ee69555bf67e4b5e45aa3b8c5c3":4,"boolean":0,"case":0,"default":[0,3,5],"final":4,"import":0,"true":0,"while":5,For:[0,4],That:5,The:[0,1,3,4,5],Then:[0,1,4],Use:2,abov:1,action:2,add:[0,2,5],added:0,addit:0,addition:[0,3],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,arthur:0,aur:3,automat:[2,3],avail:1,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,call:[0,3],can:[0,1,2,3,4,5],care:3,caus:3,cdt:1,chang:[1,3],check:1,chroot:3,command:[0,3],comment:0,commit:4,configur:[1,3,5],conflict:1,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],detail:3,diff:[1,5],differ:0,directli:3,disk:1,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,5],filter:5,find:[2,3],fingerprint:4,follow:[0,1,2,5],found:1,fri:1,from:[0,3,5],full:0,fuller:0,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],important_command:0,important_packag:0,index:4,inform:5,ini:0,instal:[0,1,2,3],instruct:5,integ:0,integr:1,involv:0,its:5,kei:[0,1,4],kernel:2,keyr:1,later:0,latest:4,length:0,lib:2,like:[2,3],link:2,linux:[0,2],list:[0,1,2],live:3,load:1,locat:[0,4],lock:5,log:[1,3],longer:[1,2],look:1,lts:0,mai:[0,3],make:[3,4],mark:0,matter:3,maximum:0,mean:1,method:3,mib:1,modifi:1,modul:2,more:[3,5],most:[0,3],mount:3,name:0,nano:1,nanorc:1,need:[0,3],non:2,note:0,now:1,number:[1,3,4],off:0,old:2,one:0,onli:[0,5],opensus:3,oper:2,option:0,other:[0,5],otherwis:0,output:[1,3],overridden:0,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,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,procedur:3,process:1,properli:3,provid:3,pytest:4,python:[0,4],reason:3,releas:4,remov:[0,2,3,5],requestid:0,requir:4,resolv:1,resort:3,restor:5,result:4,revert:3,rnano:1,rollback:[1,3],root:[0,1,2,5],rsync:2,run:[1,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,sinc:0,singl:0,size:1,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,sourc:4,space:[0,1],specif:3,sphinx:4,start:4,statu:[1,5],string:0,subvolum:3,sudo:0,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,thi:[0,1,2,3,5],thing:3,through:3,total:1,transact:[0,1,3],trigger:2,troubleshoot:3,truncat:[0,1],turn:0,type:2,unam:2,undo:[1,3],undochang:[1,3,5],unless:0,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,wai:[1,3],want:3,well:3,were:0,what:1,when:[0,2,3,5],where:4,whether:[0,3],which:[3,5],won:5,would:2,xtype:2,yast:3,yes:[0,5],you:[0,1,2,3,4,5],your:[0,3]},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}}) \ No newline at end of file +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,action:2,add:[0,2,5],added:0,addit:0,addition:[0,3],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],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],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],net:3,non:2,note:0,now:1,number:[1,3,4],off:0,old:2,one:0,onli:[0,5],opensus:3,oper:2,option:0,other:[0,5],otherwis:0,output:[1,3],overridden:0,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,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,sourc:4,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,5],thing:3,through:3,total:[1,3],transact:[0,1,3],trigger:2,troubleshoot:3,truncat:[0,1],turn:0,type:[2,3],unam:2,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,wai:[1,3],want:3,well:3,were:0,what:1,when:[0,2,3,5],where:4,whether:[0,3],which:[3,5],won:5,would:2,xtype:2,yast:3,yes:[0,5],you:[0,1,2,3,4,5],your:[0,3]},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}}) \ No newline at end of file