mirror of
https://github.com/BoredDevNL/BoredOS.git
synced 2026-05-15 10:48:38 +00:00
ed5f10eb7d
Some checks are pending
Nightly Build / build-and-release (push) Waiting to run
* add lsblk disk listing command * fix lsblk placeholder labels * fix fat32 volume labels * doc lsblk command * add lsblk to help * doc lsblk usage
61 lines
2 KiB
Markdown
61 lines
2 KiB
Markdown
# Terminal & Command Line
|
|
|
|
The BoredOS Terminal provides a powerful command-line interface (CLI) for advanced users and developers. It supports standard Unix-like features and provides direct access to the kernel's system calls.
|
|
|
|
## The Shell
|
|
|
|
The default shell in BoredOS is **BoredShell (Bsh)**, a userspace shell with a dedicated terminal app. It features:
|
|
- **ANSI Color Support**: Rich text output with colors and styles.
|
|
- **Command History**: Use the **Up** and **Down** arrow keys to navigate through your previous commands (up to 64 history entries).
|
|
- **Output Redirection**:
|
|
- `command > file`: Write output to a new file (or overwrite existing).
|
|
- `command >> file`: Append output to an existing file.
|
|
- **Piping**:
|
|
- `command1 | command2`: Pass the output of the first command as input to the second.
|
|
|
|
### Bsh Configuration
|
|
|
|
Bsh loads its configuration from:
|
|
|
|
`/Library/bsh/bshrc`
|
|
|
|
This file is similar to `.zshrc` or `.bashrc` and can define:
|
|
- `PATH` for command lookup
|
|
- `STARTUP` for interactive shell startup scripts
|
|
- `BOOT_SCRIPT` for a once-per-boot script
|
|
- prompt templates (`PROMPT_LEFT`, `PROMPT_RIGHT`)
|
|
|
|
Prompt tokens:
|
|
- `%n` username
|
|
- `%h` hostname
|
|
- `%~` cwd ("~" for `/root`)
|
|
- `%T` time (HH:MM)
|
|
|
|
Example:
|
|
|
|
```
|
|
PATH=/bin:/root/Apps
|
|
PROMPT_LEFT=%n@%h:%~$
|
|
STARTUP=/Library/bsh/startup.bsh
|
|
BOOT_SCRIPT=/Library/bsh/boot.bsh
|
|
```
|
|
|
|
## Common Commands
|
|
|
|
Below are some of the most used commands available in `/bin`:
|
|
|
|
| Command | Description |
|
|
| :--- | :--- |
|
|
| `ls` | List files and directories in the current path. |
|
|
| `cd` | Change the current working directory. |
|
|
| `cat` | Display the contents of a file. |
|
|
| `ls` | List directory contents. |
|
|
| `rm` | Remove a file. |
|
|
| `mkdir` | Create a new directory. |
|
|
| `man` | View the manual for a specific command (e.g., `man ls`). |
|
|
| `lsblk` | List block devices and partitions with size, type, filesystem, label, and flags. |
|
|
| `sysfetch` | Display system and hardware information. |
|
|
|
|
|
|
---
|
|
[Return to Documentation Index](../README.md)
|