diff --git a/modules/ROOT/pages/dnf-package-manager-quick-reference.adoc b/modules/ROOT/pages/dnf-package-manager-quick-reference.adoc new file mode 100644 index 0000000..97267ea --- /dev/null +++ b/modules/ROOT/pages/dnf-package-manager-quick-reference.adoc @@ -0,0 +1,222 @@ += DNF Package Manager Quick Reference +Peter Boy (pboy) ; The Fedora Docs Team +:revnumber: F37 onwards +:revdate: 2023-08-29 +:category: Administration +:tags: How-to, DNF, Quick Reference + +This sections lists the most useful commands provided by the *dnf* utility. For a complete list of commands, options, and their syntax, see the *dnf*(8) man page. + +*dnf help _command_*:: Displays detailed information about a command. ++ +[literal,subs="+quotes,attributes"] +---- +$ *dnf help _upgrade_* +upgrade [PACKAGE...] + +upgrade a package or packages on your system +alias: update +---- + +*dnf upgrade*:: Upgrades all packages on the system to the latest version available. ++ +[literal,subs="+quotes,attributes"] +---- +# *dnf upgrade* +Last metadata expiration check: 1:09:32 ago on Thu Dec 14 09:20:48 2017. +Dependencies resolved. +Nothing to do. +Complete! +---- + +*dnf upgrade _package_name_*:: Upgrades a package to the latest version available. ++ +[literal,subs="+quotes,attributes"] +---- +# *dnf upgrade _dia_* +Last metadata expiration check: 1:11:26 ago on Thu Dec 14 09:20:48 2017. +Dependencies resolved. +Nothing to do. +Complete! +---- + +*dnf install _package_name_*:: Installs a package. + +[literal,subs="+quotes,attributes"] +---- +# *dnf install _dia_* +Last metadata expiration check: 1:07:19 ago on Thu Dec 14 09:20:48 2017. +Dependencies resolved. +============================================================================= + Package Arch Version Repository Size +============================================================================= +Installing: + dia x86_64 1:0.97.3-5.fc24 fedora 4.2 M + libart_lgpl x86_64 2.3.21-15.fc25 fedora 71 k + +Transaction Summary +============================================================================= +Install 2 Packages + +Total download size: 4.2 M +Installed size: 18 M +Is this ok [y/N]: *y* +[... output truncated ...] +Installed: + dia.x86_64 1:0.97.3-5.fc24 libart_lgpl.x86_64 2.3.21-15.fc25 + +Complete! +---- + +*dnf remove _package_name_*:: Uninstalls a package. ++ +[literal,subs="+quotes,attributes"] +---- +# *dnf remove _dia_* +Dependencies resolved. +============================================================================= + Package Arch Version Repository Size +============================================================================= +Removing: + dia x86_64 1:0.97.3-5.fc24 @fedora 18 M + libart_lgpl x86_64 2.3.21-15.fc25 @fedora 126 k + +Transaction Summary +============================================================================= +Remove 2 Packages + +Installed size: 18 M +Is this ok [y/N]: *y* +[... output truncated ...] +Removed: + dia.x86_64 1:0.97.3-5.fc24 libart_lgpl.x86_64 2.3.21-15.fc25 + +Complete! +---- + +*dnf check-update*:: Checks if any updates are available for all packages in the enabled repositories. ++ +[literal,subs="+quotes,attributes"] +---- +389-ds-base.x86_64 1.3.7.5-11.el7 @updates +389-ds-base-libs.x86_64 1.3.7.5-11.el7 @updates +NetworkManager.x86_64 1:1.10.2-3.el7 @updates +NetworkManager-config-server.noarch 1:1.10.2-3.el7 @updates +[... output truncated ...] +---- + +*dnf search _keyword_*:: Search package metadata in the enabled repositories for the specified keyword. By default, the commands searches only in package names and summaries. ++ +[literal,subs="+quotes,attributes"] +---- +# *dnf search _freeipa_* +Last metadata expiration check: 1:12:31 ago on Thu Dec 14 09:20:48 2017. +======================================================================== +freeipa-client.x86_64 : IPA authentication for use on clients +freeipa-common.noarch : Common files used by IPA +freeipa-server.x86_64 : The IPA authentication server +freeipa-server-dns.noarch : IPA integrated DNS server with support for automatic DNSSEC signing +freeipa-client-common.noarch : Common files used by IPA client +freeipa-python-compat.noarch : Compatiblity package for Python libraries used by IPA +freeipa-server-common.noarch : Common files used by IPA server +freeipa-server-trust-ad.x86_64 : Virtual package to install packages required for Active Directory trusts +libsss_idmap.x86_64 : FreeIPA Idmap library +[... output truncated ...] +---- + +*dnf info _package_name_*:: Shows details for a package. ++ +[literal,subs="+quotes,attributes"] +---- +[root@localhost ~]# *dnf info _freeipa-server_* +Last metadata expiration check: 1:13:14 ago on Thu Dec 14 09:20:48 2017. +Available Packages +Name : freeipa-server +Arch : x86_64 +Epoch : 0 +Version : 4.4.4 +Release : 1.fc25 +Size : 380 k +Repo : updates +Summary : The IPA authentication server +URL : https://www.freeipa.org/ +License : GPLv3+ +Description : IPA is an integrated solution to provide centrally managed Identity (users, + : hosts, services), Authentication (SSO, 2FA), and Authorization + : (host access control, SELinux user roles, services). The solution provides + : features for further integration with Linux based clients (SUDO, automount) + : and integration with Active Directory based infrastructures (Trusts). + : If you are installing an IPA server, you need to install this package. +---- + + +*dnf provides _command_or_file_*:: Shows which package provides the specified command or file. ++ +To specify a command: ++ +[literal,subs="+quotes,attributes"] +---- +# *dnf provides */_ipa-server-install_* +Last metadata expiration check: 1:14:12 ago on Thu Dec 14 09:20:48 2017. +freeipa-server-4.4.1-1.fc25.x86_64 : The IPA authentication server +Repo : fedora + +freeipa-server-4.4.4-1.fc25.x86_64 : The IPA authentication server +Repo : updates +---- ++ +To specify a file: ++ +[literal,subs="+quotes,attributes"] +---- +# *dnf provides _/etc/sssd/sssd.conf_* +Last metadata expiration check: 1:14:58 ago on Thu Dec 14 09:20:48 2017. +sssd-common-1.16.0-4.fc25.x86_64 : Common files for the SSSD +Repo : @System + +sssd-common-1.16.0-4.fc25.x86_64 : Common files for the SSSD +Repo : updates + +sssd-common-1.14.2-1.fc25.i686 : Common files for the SSSD +Repo : fedora + +sssd-common-1.14.2-1.fc25.x86_64 : Common files for the SSSD +Repo : fedora +---- + +*dnf history*:: Displays a report of the past transactions. ++ +[literal,subs="+quotes,attributes"] +---- +# *dnf history* +ID | Command line | Date and time | Action(s) | Altered + ------------------------------------------------------------------------------- + 9 | update -y | 2017-10-17 12:35 | I, U | 17 EE + 8 | install midori | 2017-10-13 10:44 | Install | 3 > + 7 | update -y | 2017-10-12 15:59 | Update | 7 + 6 | install keepass | 2017-10-11 13:40 | Install | 13 < + 5 | install thunderbird | 2017-10-10 16:33 | Install | 1 > + 4 | install sssd krb5-workst | 2017-10-10 15:30 | Install | 3 > + 3 | install xchat | 2017-10-10 15:19 | Install | 4 + 2 | update | 2017-10-10 13:44 | I, O, U | 752 EE + 1 | | 2017-10-10 13:34 | Install | 1373 EE +---- + +*dnf list installed*:: Lists all packages installed on the system. ++ +[literal,subs="+quotes,attributes"] +---- +# *dnf list installed* +Last metadata expiration check: 1:17:33 ago on Thu Dec 14 09:20:48 2017. +Installed Packages +GConf2.x86_64 3.2.6-16.fc24 @anaconda +GeoIP.x86_64 1.6.11-1.fc25 @updates +GeoIP-GeoLite-data.noarch 2017.10-1.fc25 @updates +ImageMagick.x86_64 6.9.9.19-1.fc25 @updates +ImageMagick-libs.x86_64 6.9.9.19-1.fc25 @updates +LibRaw.x86_64 0.17.2-2.fc25 @updates +ModemManager.x86_64 1.6.4-1.fc25 @updates +ModemManager-glib.x86_64 1.6.4-1.fc25 @updates +NetworkManager.x86_64 1:1.4.6-1.fc25 @updates +[... output truncated ...] +---- diff --git a/modules/ROOT/pages/network-manager-quick-reference.adoc b/modules/ROOT/pages/network-manager-quick-reference.adoc new file mode 100644 index 0000000..7d34d76 --- /dev/null +++ b/modules/ROOT/pages/network-manager-quick-reference.adoc @@ -0,0 +1,219 @@ += Network Manager Quick Reference +Peter Boy (pboy); The Fedora Docs Team +:revnumber: F37 onwards +:revdate: 2023-08-29 +:category: Administration +:tags: How-to, Network, NetworkManager, Quick Refeence +//:page-aliases: + + +== NetworkManager status + +Overall status of NetworkManager:: ++ +---- +$ nmcli general status +---- + +Display active connections:: +---- +$ nmcli connection show --active +---- + +Display all configured connections:: +---- +$ nmcli connection show configured +---- + +== Connect/disconnect to an already configured connection + +Connect to a configured connection by name:: +---- +$ nmcli connection up id +---- + +Disconnection by name:: +---- +$ nmcli connection down id +---- + + +== Wi-Fi + +Get Wi-Fi status:: +---- +$ nmcli radio wifi +---- + +Turn Wi-Fi on or off:: +---- +$ nmcli radio wifi _on|off_ +---- + +Available access points (AP):: +---- +$ nmcli device wifi list +---- + +Refresh the previous list:: +---- +$ nmcli device wifi rescan +---- + +Create a new connection to an open AP:: +---- +$ nmcli device wifi connect +---- + +Create a new connection to a protected AP:: +---- +$ nmcli device wifi connect password +---- + + +== Network interfaces + +List available devices and their status:: +---- +$ nmcli device status +---- + +Disconnect an interface:: +---- +$ nmcli device disconnect iface +---- + + +== Create or modify a connection + +To create a new connection using an interactive editor +---- +$ nmcli connection edit con-name +---- + +To edit an already existing connection using an interactive editor: +---- +$ nmcli connection edit +---- + +[[exampletutorial]] +=== Example/Tutorial + +Create a new connection: +---- +$ nmcli connection edit con-name _name of new connection_ +---- + +It asks us to define a connection type: +---- +Valid connection types: 802-3-ethernet (ethernet), 802-11-wireless (wifi), wimax, gsm, cdma, infiniband, adsl, bluetooth, vpn, 802-11-olpc-mesh (olpc-mesh), vlan, bond, team, bridge, bond-slave, team-slave, bridge-slave +Enter connection type: +---- + +In this example, we use ethernet: +---- +Enter connection type: ethernet +---- + +The following message appears, note that `nmcli>` is a prompt and that it lists the main settings available: +---- +===| nmcli interactive connection editor |=== + +Adding a new '802-3-ethernet' connection + +Type 'help' or '?' for available commands. +Type 'describe [.]' for detailed property description. + +You may edit the following settings: connection, 802-3-ethernet (ethernet), 802-1x, ipv4, ipv6 +nmcli> +---- + +Edit the setting `ipv4`: +---- +nmcli> goto ipv4 +---- + +Note that after this our prompt has changed to indicate that we are currently editing the `ipv4` setting: +---- +nmcli ipv4> +---- + +List available properties under the `ipv4` setting and describe the `method` property: +---- +nmcli ipv4> describe + +Available properties: method, dns, dns-search, addresses, routes, ignore-auto-routes, ignore-auto-dns, dhcp-client-id, dhcp-send-hostname, dhcp-hostname, never-default, may-fail +Property name? + +Property name? method +---- + +Set property `method` to `auto`: +---- +nmcli ipv4> set method auto +---- + +The `ipv4` setting is now finished. Go back to the main level. Enter the following command until the prompt looks like `nmcli>`: +---- +nmcli ipv4> back +---- + +To list the main settings again, use the `goto` command without any arguments. After that, press `Enter` and ignore the error. +---- +nmcli> goto + +Available settings: connection, 802-3-ethernet (ethernet), 802-1x, ipv4, ipv6 +Setting name? +---- + +It is possible to set a value for a property directly from the main level: +---- +nmcli> set __setting__.__property__ _value_ +---- + +For example: +---- +nmcli> set connection.autoconnect TRUE + +nmcli> set connection.interface-name _interface name this connection is bound to_ + +nmcli> set ethernet.cloned-mac-address _Spoofed MAC address_ +---- + +Finally, check the connection details, save and exit: +---- +nmcli> print + +nmcli> save + +nmcli> quit +---- + + +=== Manually editing + +To manually edit an `ifcfg` connection configuration, open or create with a text editor the configuration file of the connection located in `/etc/sysconfig/network-scripts/ifcfg-`. + +A description of most common configuration options is available in the link:https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/6/html/deployment_guide/s1-networkscripts-interfaces[RHEL6 Deployment Guide]. + +To modify a connection password, open with a text editor and edit the file `keys-` located in `/etc/sysconfig/network-scripts/`. The password is stored in plain text. For example: +---- +$ cat /etc/sysconfig/network-scripts/keys-__connection name__ +WPA_PSK='password' +---- + +Or, if using keyfile, simply edit the connection file located inside `/etc/NetworkManager/system-connections/` + +Finally, save the files and to apply changes to an already active connection execute. +---- +nmcli connection up id _connection name_ +---- + +[[delete-a-connection-configuration]] +== Delete a connection configuration + +Delete the connection: +---- +nmcli connection delete id +---- +Please note that this also deactivates the connection.