mirror of
				https://github.com/ohmyzsh/ohmyzsh.git
				synced 2025-11-04 21:31:19 +08:00 
			
		
		
		
	ubuntu: update plugin README (#7199)
This commit is contained in:
		
							parent
							
								
									5ce96c3f77
								
							
						
					
					
						commit
						2d967d66e6
					
				
							
								
								
									
										52
									
								
								plugins/ubuntu/README.md
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										52
									
								
								plugins/ubuntu/README.md
									
									
									
									
									
										Normal file
									
								
							@ -0,0 +1,52 @@
 | 
			
		||||
# Ubuntu plugin
 | 
			
		||||
 | 
			
		||||
This plugin adds completions and aliases for [Ubuntu](https://www.ubuntu.com/).
 | 
			
		||||
 | 
			
		||||
To use it, add `ubuntu` to the plugins array in your zshrc file: 
 | 
			
		||||
 | 
			
		||||
```zsh
 | 
			
		||||
plugins=(... ubuntu)
 | 
			
		||||
```
 | 
			
		||||
 | 
			
		||||
## Aliases
 | 
			
		||||
 | 
			
		||||
Commands that use `$APT` will use apt if installed or defer to apt-get otherwise. 
 | 
			
		||||
 | 
			
		||||
| Alias   | Command                                                                | Description                                                                                       |
 | 
			
		||||
|---------|------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------|
 | 
			
		||||
| acs     | `apt-cache search`                                                     | Search the apt-cache with the specified criteria                                                  |
 | 
			
		||||
| acp     | `apt-cache policy`                                                     | Display the package source priorities                                                             | 
 | 
			
		||||
| afs     | `apt-file search --regexp`                                             | Perform a regular expression apt-file search                                                      |
 | 
			
		||||
| afu     | `sudo apt-file update`                                                 | Generates or updates the apt-file package database                                                | 
 | 
			
		||||
| ag      | `sudo $APT`                                                            | Run apt-get with sudo                                                                             | 
 | 
			
		||||
| aga     | `sudo $APT autoclean`                                                  | Clears out the local reposityory of retrieved package files that can no longer be downloaded      | 
 | 
			
		||||
| agb     | `sudo $APT build-dep <source_pkg>`                                     | Installs/Removes packages to satisfy the dependencies of a specified build pkg                    | 
 | 
			
		||||
| agc     | `sudo $APT clean`                                                      | Clears out the local repository of retrieved package files leaving everything from the lock files | 
 | 
			
		||||
| agd     | `sudo $APT dselect-upgrade`                                            | Follows dselect choices for package installation                                                  | 
 | 
			
		||||
| agi     | `sudo $APT install <pkg>`                                              | Install the specified package                                                                     | 
 | 
			
		||||
| agli    | `apt list --installed`                                                 | List the installed packages                                                                       | 
 | 
			
		||||
| aglu    | `sudo apt-get -u upgrade --assume-no`                                  | Run an apt-get upgrade assuming no to all prompts                                                 | 
 | 
			
		||||
| agp     | `sudo $APT purge <pkg>`                                                | Remove a package including any configuration files                                                | 
 | 
			
		||||
| agr     | `sudo $APT remove <pkg>`                                               | Remove a package                                                                                  | 
 | 
			
		||||
| ags     | `$APT source <pkg>`                                                    | Fetch the source for the specified package                                                        | 
 | 
			
		||||
| agu     | `sudo $APT update`                                                     | Update package list                                                                               | 
 | 
			
		||||
| agud    | `sudo $APT update && sudo $APT dist-upgrade`                           | Update packages list and perform a distribution upgrade                                           | 
 | 
			
		||||
| agug    | `sudo $APT upgrade`                                                    | Upgrade available packages                                                                        | 
 | 
			
		||||
| agar    | `sudo $APT autoremove`                                                 | Remove automatically installed packages no longer needed                                          | 
 | 
			
		||||
| aguu    | `sudo $APT update && sudo $APT upgrade`                                | Update packages list and upgrade available packages                                               | 
 | 
			
		||||
| allpkgs | `dpkg --get-selections \| grep -v deinstall`                           | Print all installed packages                                                                      | 
 | 
			
		||||
| kclean  | `sudo aptitude remove -P ?and(~i~nlinux-(ima\|hea) ?not(~n$(uname -r)))`  |Remove ALL kernel images and headers EXCEPT the one in use                                         |
 | 
			
		||||
| mydeb   | `time dpkg-buildpackage -rfakeroot -us -uc`                            | Create a basic .deb package                                                                       |
 | 
			
		||||
| ppap    | `sudo ppa-purge <ppa>`                                                 | Remove the specified PPA                                                                          | 
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
## Functions
 | 
			
		||||
 | 
			
		||||
| Function          | Usage                                 |Description                                                               |
 | 
			
		||||
|-------------------|---------------------------------------|--------------------------------------------------------------------------|
 | 
			
		||||
| aar               | `aar ppa:xxxxxx/xxxxxx [packagename]` | apt-add-repository with automatic install/upgrade of the desired package |
 | 
			
		||||
| apt-history       | `apt-history <action>`                | Prints the Apt history of the specified action                           |
 | 
			
		||||
| apt-list-packages | `apt-list-packages`                   | List packages by size                                                    |
 | 
			
		||||
| kerndeb           | `kerndeb`                             | Kernel-package building shortcut                                         | 
 | 
			
		||||
 | 
			
		||||
 | 
			
		||||
@ -1,21 +0,0 @@
 | 
			
		||||
This plugin was created because the aliases in the debian plugin are inconsistent and hard to remember. Also this apt-priority detection that switched between apt-get and aptitude was dropped to keep it simpler. This plugin uses apt-get for everything but a few things that are only possible with aptitude I guess. Ubuntu does not have aptitude installed by default.
 | 
			
		||||
 | 
			
		||||
acs = Apt-Cache Search  
 | 
			
		||||
acp = Apt-Cache Policy
 | 
			
		||||
 | 
			
		||||
ag  = sudo Apt-Get  
 | 
			
		||||
agi = sudo Apt-Get Install  
 | 
			
		||||
agd = sudo Apt-Get Dselect-upgrade  
 | 
			
		||||
By now you already can guess almost all aliases  
 | 
			
		||||
 | 
			
		||||
There are two exeptions since ...  
 | 
			
		||||
agu  = sudo Apt-Get Update  - we have ...  
 | 
			
		||||
agug = sudo Apt-Get UpGrade - as the exceptional 4 letter alias for a single command.
 | 
			
		||||
 | 
			
		||||
afs = Apt-File Search --regexp - this has the regexp switch on without being represented in the alias, I guess this makes sense since the debian plugin has it, I never used that command.
 | 
			
		||||
 | 
			
		||||
Then there are the 2 other 4 letter aliases for combined commands, that are straight forward and easy to remember.  
 | 
			
		||||
aguu = sudo Apt-Get Update && sudo apt-get Upgrade      - better then adg or not?  
 | 
			
		||||
agud = sudo Apt-Get Update && sudo apt-get full-upgrade
 | 
			
		||||
 | 
			
		||||
For a full list aliases and the functions just watch the plugins code https://github.com/robbyrussell/oh-my-zsh/blob/master/plugins/ubuntu/ubuntu.plugin.zsh, look at the comments if you want to switch from the debian plugin. Ubuntu, Mint and & co users will like the new aar function to install packages from ppas with a single command.
 | 
			
		||||
		Loading…
	
	
			
			x
			
			
		
	
		Reference in New Issue
	
	Block a user