From cabb0b3401dbeee5ed20179340e367e93169a2b8 Mon Sep 17 00:00:00 2001 From: xengineering Date: Wed, 16 Aug 2023 20:25:31 +0200 Subject: Make article names shorter --- content/articles/modemmanager-essentials.md | 112 --------------------------- content/articles/modemmanager.md | 115 ++++++++++++++++++++++++++++ content/articles/pacman-essentials.md | 93 ---------------------- content/articles/pacman.md | 96 +++++++++++++++++++++++ 4 files changed, 211 insertions(+), 205 deletions(-) delete mode 100644 content/articles/modemmanager-essentials.md create mode 100644 content/articles/modemmanager.md delete mode 100644 content/articles/pacman-essentials.md create mode 100644 content/articles/pacman.md diff --git a/content/articles/modemmanager-essentials.md b/content/articles/modemmanager-essentials.md deleted file mode 100644 index 81eae74..0000000 --- a/content/articles/modemmanager-essentials.md +++ /dev/null @@ -1,112 +0,0 @@ -{ - "title": "ModemManager essentials", - "subtitle": "Handling modems from the Linux command line" -} - -#### Introduction - -The software [ModemManager][4] handles modems on Linux operating systems. It -has the `mmcli` command line utility included which exposes its functionality. - -It is possible to use `mmcli` to setup mobile internet connections, make phone -calls and send SMS. - -This article summarizes some basic `mmcli` commands. It was written to further -debug the issue described in [this postmarketOS issue][5]. - -#### Get modem summary - -With this command a summary about the modem is printed. It assumes just one -connected modem (`-m any`) which should be given on nearly all devices: - -``` -mmcli -m any -``` - -#### Unlock a SIM card - -To actually do something with the modem it might be necessary to unlock the -inserted SIM card: - -``` -# this command needs appropriate polkit authentication or root permissions -mmcli -i "/org/freedesktop/ModemManager1/SIM/0" --pin "1234" -``` - -Use the SIM path listed in the summary (see section above). - -#### Enable modem - -In addition to unlocking the SIM card it is required to enable the modem: - -``` -# this command needs appropriate polkit authentication or root permissions -mmcli -m any -e -``` - -#### List calls - -This command lists active, ringing, terminated and other calls: - -``` -mmcli -m any --voice-list-calls -``` - -The idea is that calls are tracked with the identifiers printed by this command -which allows to send additional commands like accept or hangup. - -#### Accept a call - -An incoming call can be accepted like this: - -``` -# this command needs appropriate polkit authentication or root permissions -mmcli -m any -o "/org/freedesktop/ModemManager1/Call/0" --accept -``` - -#### Hangup a call - -Any active call can be hung up like this: - -``` -# this command needs appropriate polkit authentication or root permissions -mmcli -m any -o "/org/freedesktop/ModemManager1/Call/0" --hangup -``` - -#### Create a call - -To create a call one can use the following command. Take care to select the -right phone number format. Given is an example phone number with German -international prefix `+49`. - -``` -mmcli -m any --voice-create-call "number=+49123456789" -``` - -This command just registeres a new call. To actually start it one has to get -its identifier with listing all calls and then start it like this: - -``` -# this command needs appropriate polkit authentication or root permissions -mmcli -m any -o "/org/freedesktop/ModemManager1/Call/4" --start -``` - -It can be hung up like incoming calls. - -#### Further documentation - -Running `mmcli --help` and the there listed help commands provide a summary of -all the functionality ModemManager provides. This article is just a brief -subset of it. - -The [SXMO modem scripts][1] from the [SXMO project][2] helped me a lot to write -this summary aswell as the [Chromium mmcli help page][3]. - -Of course the [ModemManager homepage][4] is the most official entry point to -search for further documentation. - -[1]: https://git.sr.ht/~mil/sxmo-utils/tree/master/item/scripts/modem -[2]: https://sxmo.org/ -[3]: https://www.chromium.org/chromium-os/how-tos-and-troubleshooting/debugging-3g/modem-debugging-with-mmcli/ -[4]: https://www.freedesktop.org/wiki/Software/ModemManager/ -[5]: https://gitlab.com/postmarketOS/pmaports/-/issues/2113 diff --git a/content/articles/modemmanager.md b/content/articles/modemmanager.md new file mode 100644 index 0000000..129280c --- /dev/null +++ b/content/articles/modemmanager.md @@ -0,0 +1,115 @@ +{ + "title": "modemmanager", + "subtitle": "Handling modems from the Linux command line", + "aliases": [ + "/articles/modemmanager-essentials" + ] +} + +#### Introduction + +The software [ModemManager][4] handles modems on Linux operating systems. It +has the `mmcli` command line utility included which exposes its functionality. + +It is possible to use `mmcli` to setup mobile internet connections, make phone +calls and send SMS. + +This article summarizes some basic `mmcli` commands. It was written to further +debug the issue described in [this postmarketOS issue][5]. + +#### Get modem summary + +With this command a summary about the modem is printed. It assumes just one +connected modem (`-m any`) which should be given on nearly all devices: + +``` +mmcli -m any +``` + +#### Unlock a SIM card + +To actually do something with the modem it might be necessary to unlock the +inserted SIM card: + +``` +# this command needs appropriate polkit authentication or root permissions +mmcli -i "/org/freedesktop/ModemManager1/SIM/0" --pin "1234" +``` + +Use the SIM path listed in the summary (see section above). + +#### Enable modem + +In addition to unlocking the SIM card it is required to enable the modem: + +``` +# this command needs appropriate polkit authentication or root permissions +mmcli -m any -e +``` + +#### List calls + +This command lists active, ringing, terminated and other calls: + +``` +mmcli -m any --voice-list-calls +``` + +The idea is that calls are tracked with the identifiers printed by this command +which allows to send additional commands like accept or hangup. + +#### Accept a call + +An incoming call can be accepted like this: + +``` +# this command needs appropriate polkit authentication or root permissions +mmcli -m any -o "/org/freedesktop/ModemManager1/Call/0" --accept +``` + +#### Hangup a call + +Any active call can be hung up like this: + +``` +# this command needs appropriate polkit authentication or root permissions +mmcli -m any -o "/org/freedesktop/ModemManager1/Call/0" --hangup +``` + +#### Create a call + +To create a call one can use the following command. Take care to select the +right phone number format. Given is an example phone number with German +international prefix `+49`. + +``` +mmcli -m any --voice-create-call "number=+49123456789" +``` + +This command just registeres a new call. To actually start it one has to get +its identifier with listing all calls and then start it like this: + +``` +# this command needs appropriate polkit authentication or root permissions +mmcli -m any -o "/org/freedesktop/ModemManager1/Call/4" --start +``` + +It can be hung up like incoming calls. + +#### Further documentation + +Running `mmcli --help` and the there listed help commands provide a summary of +all the functionality ModemManager provides. This article is just a brief +subset of it. + +The [SXMO modem scripts][1] from the [SXMO project][2] helped me a lot to write +this summary aswell as the [Chromium mmcli help page][3]. + +Of course the [ModemManager homepage][4] is the most official entry point to +search for further documentation. + +[1]: https://git.sr.ht/~mil/sxmo-utils/tree/master/item/scripts/modem +[2]: https://sxmo.org/ +[3]: https://www.chromium.org/chromium-os/how-tos-and-troubleshooting/debugging-3g/modem-debugging-with-mmcli/ +[4]: https://www.freedesktop.org/wiki/Software/ModemManager/ +[5]: https://gitlab.com/postmarketOS/pmaports/-/issues/2113 diff --git a/content/articles/pacman-essentials.md b/content/articles/pacman-essentials.md deleted file mode 100644 index d8b65bd..0000000 --- a/content/articles/pacman-essentials.md +++ /dev/null @@ -1,93 +0,0 @@ -{ - "title": "Pacman essentials", - "subtitle": "Arch Linux package manager explained for everyday users" -} - -#### Introduction - -The program `pacman` is the package manager of the [Arch Linux][1] -distribution. It should be exclusively used to install, update and remove -software on an Arch Linux system. - -New Arch Linux users should be able to manage the software on their system in -most cases with an open terminal and this article. - -#### Full system update - -Use the following command to update all the software on an Arch Linux system. -This includes the operating system aswell as applications: - -``` -sudo pacman -Syu -``` - -If this fails because of errors related to signing keys and GPG it can be fixed -by running this command: - -``` -sudo pacman -Sy archlinux-keyring && sudo pacman -Su -``` - -This error can be avoided by updating the system regularly. - -#### Package search - -One can search for existing packages with this command: - -``` -pacman -Ss -``` - -`` should be replaced by keywords like `firefox`. Furthermore the -package search on the [Arch Linux homepage][1] in the upper right corner can be -used. - -The Arch Linux wiki contains also a long [list of applications][2] which is an -excellent place to search for needed programs by category. - -#### Package installation - -Installing a package is simple: - -``` -sudo pacman -S -``` - -`` should be replaced by the lower case package name found with the -package search (see above) like `firefox` or `gimp`. - -If this fails because the packages cannot be retrieved via the HTTP protocol -the error can be fixed by updating the whole system first as described above. - -#### Package removal - -The recommended command to remove a package is: - -``` -sudo pacman -Rs -``` - -While `R` selects removal `s` is the recursive option. This additionally -removes packages which were needed for the selected package to work. - -The recursive option is smart enough to leave a dependency on the system if it -is needed by another explicitly installed package. - -#### Further documentation - -This page is just a little cheat sheet especially targeted at new Arch Linux -users. The following references point to the official documentation about -pacman: - -- The manual page of pacman: `man pacman` (exit with `q`) -- Arch Wiki: [pacman][3] -- Arch Wiki: [pacman/Tips and tricks][4] - -They should be consulted to get further information and should be trusted more -than this page if in conflict with its content. - - -[1]: https://archlinux.org/ -[2]: https://wiki.archlinux.org/title/List_of_applications -[3]: https://wiki.archlinux.org/title/Pacman -[4]: https://wiki.archlinux.org/title/Pacman/Tips_and_tricks diff --git a/content/articles/pacman.md b/content/articles/pacman.md new file mode 100644 index 0000000..5a193d5 --- /dev/null +++ b/content/articles/pacman.md @@ -0,0 +1,96 @@ +{ + "title": "pacman", + "subtitle": "Arch Linux package manager explained for everyday users", + "aliases": [ + "/articles/pacman-essentials" + ] +} + +#### Introduction + +The program `pacman` is the package manager of the [Arch Linux][1] +distribution. It should be exclusively used to install, update and remove +software on an Arch Linux system. + +New Arch Linux users should be able to manage the software on their system in +most cases with an open terminal and this article. + +#### Full system update + +Use the following command to update all the software on an Arch Linux system. +This includes the operating system aswell as applications: + +``` +sudo pacman -Syu +``` + +If this fails because of errors related to signing keys and GPG it can be fixed +by running this command: + +``` +sudo pacman -Sy archlinux-keyring && sudo pacman -Su +``` + +This error can be avoided by updating the system regularly. + +#### Package search + +One can search for existing packages with this command: + +``` +pacman -Ss +``` + +`` should be replaced by keywords like `firefox`. Furthermore the +package search on the [Arch Linux homepage][1] in the upper right corner can be +used. + +The Arch Linux wiki contains also a long [list of applications][2] which is an +excellent place to search for needed programs by category. + +#### Package installation + +Installing a package is simple: + +``` +sudo pacman -S +``` + +`` should be replaced by the lower case package name found with the +package search (see above) like `firefox` or `gimp`. + +If this fails because the packages cannot be retrieved via the HTTP protocol +the error can be fixed by updating the whole system first as described above. + +#### Package removal + +The recommended command to remove a package is: + +``` +sudo pacman -Rs +``` + +While `R` selects removal `s` is the recursive option. This additionally +removes packages which were needed for the selected package to work. + +The recursive option is smart enough to leave a dependency on the system if it +is needed by another explicitly installed package. + +#### Further documentation + +This page is just a little cheat sheet especially targeted at new Arch Linux +users. The following references point to the official documentation about +pacman: + +- The manual page of pacman: `man pacman` (exit with `q`) +- Arch Wiki: [pacman][3] +- Arch Wiki: [pacman/Tips and tricks][4] + +They should be consulted to get further information and should be trusted more +than this page if in conflict with its content. + + +[1]: https://archlinux.org/ +[2]: https://wiki.archlinux.org/title/List_of_applications +[3]: https://wiki.archlinux.org/title/Pacman +[4]: https://wiki.archlinux.org/title/Pacman/Tips_and_tricks -- cgit v1.2.3-70-g09d2