Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Add notice to use sudo on linux + add micro guide for udev rule. (#10)
* Add notice of sudo to guide * Add instructions for udev rules * Shorter menu item * Add oreos advice. * `eudev` isnt `udev`, it's just an implementation of it.
- Loading branch information
Showing
3 changed files
with
41 additions
and
2 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,38 @@ | ||
# Linux - Run payload sender without root | ||
|
||
This section details how to add an udev rule to let you send a payload to the Nintendo Switch without needing to use `sudo`. | ||
|
||
!!! tip "" | ||
The following instructions are not for beginners. Only do this if you are confident in what you are doing. | ||
|
||
!!! tip "" | ||
The following instructions only work if you have a system that implements `udev`. Most modern distros come with `systemd` already installed, which includes a `udev` implementation. | ||
|
||
There are differing implementations of the following commands on different distros. The commands below are assumed to be ran on Ubuntu. Check your distros manual if you are not running Ubuntu for the equivalent commands. | ||
|
||
!!! tip "" | ||
Do the following instructions while your Switch is _not_ connected to your computer. | ||
|
||
## Creating a new group | ||
|
||
To start, we will create a new group and add ourselves to it. The group the Nintendo Switch device will be owned by on Linux will be set to this group. | ||
|
||
1. Open a terminal. | ||
2. Enter the following command: `sudo groupadd nintendo_switch`. | ||
3. Enter your password when prompted. | ||
4. Enter the following command: `sudo usermod -a -G nintendo_switch $USER`. Make sure that the `G` is capitalized! | ||
5. Close the terminal. | ||
|
||
## Adding a udev rule | ||
|
||
Next we're gonna add a new udev rule. udev is a device manager for the linux kernel. The rule we're gonna specify is that if the Switch is connected in RCM mode, the group the Switch belongs to will be the group we made in the previous section. | ||
|
||
1. Open a terminal. | ||
2. Change to the root user with the following command: `sudo su`. Enter your password when prompted. | ||
3. Enter the following command: `mkdir -p /etc/udev/rules.d`. | ||
4. Enter the following command: `echo 'SUBSYSTEMS=="usb", ATTRS{manufacturer}=="NVIDIA Corp.", ATTRS{product}=="APX", GROUP="nintendo_switch"' > /etc/udev/rules.d/10-switch.rules`. | ||
5. Enter the following command: `udevadm control --reload`. | ||
6. Enter the following command: `udevadm trigger`. | ||
7. Logout and log back in. | ||
|
||
You should now be able to run the payload sender without having to use `sudo`. |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters