This commit is contained in:
wesbarnett 2021-03-14 22:00:27 +00:00
parent 1320a57893
commit b69920d80e
5 changed files with 64 additions and 1 deletions

Binary file not shown.

Binary file not shown.

View file

@ -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.

View file

@ -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.</p>
<div class="literal-block-wrapper docutils container" id="id1">
<div class="code-block-caption"><span class="caption-text">When you run pacman, the snapper pre/post snapshots are created automatically. For a fuller example see <a class="reference internal" href="examples.html"><span class="doc">Example</span></a>.</span><a class="headerlink" href="#id1" title="Permalink to this code"></a></div>
<div class="highlight-none notranslate"><div class="highlight"><pre><span></span>$ 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...
<span class="hll">(1/1) Performing snapper pre snapshots for the following configurations...
</span><span class="hll">==&gt; root: 7394
</span>:: 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...
<span class="hll">(4/4) Performing snapper post snapshots for the following configurations...
</span><span class="hll">==&gt; root: 7395
</span></pre></div>
</div>
</div>
<p>To undo changes from a pacman transaction, use <code class="docutils literal notranslate"><span class="pre">snapper</span> <span class="pre">undochange</span></code>. See the <em class="manpage"><a class="manpage reference external" href="https://man.archlinux.org/man/snapper.8">snapper(8)</a></em>
for more details as well as examples.</p>
<p>If you have severe breakage—like snapper is gone for some reason and you cant get it

View file

@ -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}})
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}})