Stowage/ladybird
2
0
Fork 0
mirror of https://github.com/LadybirdBrowser/ladybird.git synced 2025-11-12 03:01:04 +00:00
Code Issues Projects Releases Packages Wiki Activity
ladybird/Kernel/TTY/MasterPTY.h

54 lines
1.6 KiB
C
Raw Normal View History

Meta: Add license header to source files As suggested by Joshua, this commit adds the 2-clause BSD license as a comment block to the top of every source file. For the first pass, I've just added myself for simplicity. I encourage everyone to add themselves as copyright holders of any file they've added or modified in some significant way. If I've added myself in error somewhere, feel free to replace it with the appropriate copyright holder instead. Going forward, all new source files should include a license header.
2020-01-18 09:38:21 +01:00
/*
* Copyright (c) 2018-2020, Andreas Kling <kling@serenityos.org>
*
Everything: Move to SPDX license identifiers in all files. SPDX License Identifiers are a more compact / standardized way of representing file license information. See: https://spdx.dev/resources/use/#identifiers This was done with the `ambr` search and replace tool. ambr --no-parent-ignore --key-from-file --rep-from-file key.txt rep.txt *
2021-04-22 01:24:48 -07:00
* SPDX-License-Identifier: BSD-2-Clause
Meta: Add license header to source files As suggested by Joshua, this commit adds the 2-clause BSD license as a comment block to the top of every source file. For the first pass, I've just added myself for simplicity. I encourage everyone to add themselves as copyright holders of any file they've added or modified in some significant way. If I've added myself in error somewhere, feel free to replace it with the appropriate copyright holder instead. Going forward, all new source files should include a license header.
2020-01-18 09:38:21 +01:00
*/
Add basic PTY support. For now, there are four hard-coded PTYs: /dev/pt{m,s}[0123] Use this in the Terminal to open a pty pair and spawn a shell.
2019-01-15 06:30:19 +01:00
#pragma once
Deallocate PTY's when they close. This required a fair bit of plumbing. The CharacterDevice::close() virtual will now be closed by ~FileDescriptor(), allowing device implementations to do custom cleanup at that point. One big problem remains: if the master PTY is closed before the slave PTY, we go into crashy land.
2019-01-30 18:26:19 +01:00
#include <AK/Badge.h>
Kernel: Move devices into Kernel/Devices/.
2019-04-03 12:36:40 +02:00
#include <Kernel/Devices/CharacterDevice.h>
Deallocate PTY's when they close. This required a fair bit of plumbing. The CharacterDevice::close() virtual will now be closed by ~FileDescriptor(), allowing device implementations to do custom cleanup at that point. One big problem remains: if the master PTY is closed before the slave PTY, we go into crashy land.
2019-01-30 18:26:19 +01:00
#include <Kernel/DoubleBuffer.h>
Add basic PTY support. For now, there are four hard-coded PTYs: /dev/pt{m,s}[0123] Use this in the Terminal to open a pty pair and spawn a shell.
2019-01-15 06:30:19 +01:00
Kernel: Move all code into the Kernel namespace
2020-02-16 01:27:42 +01:00
namespace Kernel {
Add basic PTY support. For now, there are four hard-coded PTYs: /dev/pt{m,s}[0123] Use this in the Terminal to open a pty pair and spawn a shell.
2019-01-15 06:30:19 +01:00
class SlavePTY;
class MasterPTY final : public CharacterDevice {
public:
explicit MasterPTY(unsigned index);
virtual ~MasterPTY() override;
Add a PTY multiplexer (/dev/ptmx) device. When you open /dev/ptmx, you get a file descriptor pointing to one of the available MasterPTY's. If none are available, you get an EBUSY. This makes it possible to open multiple (up to 4) Terminals. :^) To support this, I also added a CharacterDevice::open() that gets control when VFS is opening a CharacterDevice. This is useful when we want to return a custom FileDescriptor like we do here.
2019-01-16 13:36:10 +01:00
unsigned index() const { return m_index; }
Add basic PTY support. For now, there are four hard-coded PTYs: /dev/pt{m,s}[0123] Use this in the Terminal to open a pty pair and spawn a shell.
2019-01-15 06:30:19 +01:00
String pts_name() const;
Kernel: Make copy_to/from_user safe and remove unnecessary checks Since the CPU already does almost all necessary validation steps for us, we don't really need to attempt to do this. Doing it ourselves doesn't really work very reliably, because we'd have to account for other processors modifying virtual memory, and we'd have to account for e.g. pages not being able to be allocated due to insufficient resources. So change the copy_to/from_user (and associated helper functions) to use the new safe_memcpy, which will return whether it succeeded or not. The only manual validation step needed (which the CPU can't perform for us) is making sure the pointers provided by user mode aren't pointing to kernel mappings. To make it easier to read/write from/to either kernel or user mode data add the UserOrKernelBuffer helper class, which will internally either use copy_from/to_user or directly memcpy, or pass the data through directly using a temporary buffer on the stack. Last but not least we need to keep syscall params trivial as we need to copy them from/to user mode using copy_from/to_user.
2020-09-11 21:11:07 -06:00
ssize_t on_slave_write(const UserOrKernelBuffer&, ssize_t);
PTY: Disallow infinite writing to slaves. This way we don't buffer ungodly amounts of output in the kernel when doing e.g "cat /dev/random" on a PTY.
2019-01-25 00:13:54 +01:00
bool can_write_from_slave() const;
Deallocate PTY's when they close. This required a fair bit of plumbing. The CharacterDevice::close() virtual will now be closed by ~FileDescriptor(), allowing device implementations to do custom cleanup at that point. One big problem remains: if the master PTY is closed before the slave PTY, we go into crashy land.
2019-01-30 18:26:19 +01:00
void notify_slave_closed(Badge<SlavePTY>);
Kernel: Reading from a slave PTY should give EOF if master PTY is closed.
2019-02-05 12:27:32 +01:00
bool is_closed() const { return m_closed; }
Add basic PTY support. For now, there are four hard-coded PTYs: /dev/pt{m,s}[0123] Use this in the Terminal to open a pty pair and spawn a shell.
2019-01-15 06:30:19 +01:00
Kernel: Customize absolute_path() for more file types
2019-08-10 19:10:36 +03:00
virtual String absolute_path(const FileDescription&) const override;
Kernel: Add a method to determine the desired permissions of a Device This method will be used later in DevFS, to set the appropriate permissions for each device node.
2020-12-25 19:01:19 +02:00
// ^Device
virtual mode_t required_mode() const override { return 0640; }
Kernel: Make device generate their own names Besides removing the monolithic DevFSDeviceInode::determine_name() method, being able to determine a device's name inside the /dev hierarchy outside of DevFS has its uses.
2021-01-21 18:49:56 +01:00
virtual String device_name() const override;
Kernel: Add a method to determine the desired permissions of a Device This method will be used later in DevFS, to set the appropriate permissions for each device node.
2020-12-25 19:01:19 +02:00
Add basic PTY support. For now, there are four hard-coded PTYs: /dev/pt{m,s}[0123] Use this in the Terminal to open a pty pair and spawn a shell.
2019-01-15 06:30:19 +01:00
private:
Kernel: Make /proc/PID/fds display something useful for character devices.
2019-01-21 02:33:01 +01:00
// ^CharacterDevice
Kernel: Refactor storage stack with u64 as file operations offset
2021-03-17 13:18:51 +01:00
virtual KResultOr<size_t> read(FileDescription&, u64, UserOrKernelBuffer&, size_t) override;
virtual KResultOr<size_t> write(FileDescription&, u64, const UserOrKernelBuffer&, size_t) override;
Kernel: Add explicit offset parameter to File::read etc
2020-04-10 19:44:42 +10:00
virtual bool can_read(const FileDescription&, size_t) const override;
virtual bool can_write(const FileDescription&, size_t) const override;
Kernel: Allow File::close() to fail And pass the result through to sys$close() return value. Fixes https://github.com/SerenityOS/serenity/issues/427
2020-06-02 19:20:05 +03:00
virtual KResult close() override;
Kernel: Reading from a slave PTY should give EOF if master PTY is closed.
2019-02-05 12:27:32 +01:00
virtual bool is_master_pty() const override { return true; }
Kernel: Use a FlatPtr for the "argument" to ioctl() Since it's often used to pass pointers, it should really be a FlatPtr.
2020-05-23 13:17:58 +02:00
virtual int ioctl(FileDescription&, unsigned request, FlatPtr arg) override;
Kernel: Make /proc/PID/fds display something useful for character devices.
2019-01-21 02:33:01 +01:00
virtual const char* class_name() const override { return "MasterPTY"; }
AK: Rename RetainPtr => RefPtr and Retained => NonnullRefPtr.
2019-06-21 18:37:47 +02:00
RefPtr<SlavePTY> m_slave;
Add basic PTY support. For now, there are four hard-coded PTYs: /dev/pt{m,s}[0123] Use this in the Terminal to open a pty pair and spawn a shell.
2019-01-15 06:30:19 +01:00
unsigned m_index;
Kernel: Reading from a slave PTY should give EOF if master PTY is closed.
2019-02-05 12:27:32 +01:00
bool m_closed { false };
Add basic PTY support. For now, there are four hard-coded PTYs: /dev/pt{m,s}[0123] Use this in the Terminal to open a pty pair and spawn a shell.
2019-01-15 06:30:19 +01:00
DoubleBuffer m_buffer;
Kernel: Have TTY subclasses cache their tty_name/pts_name.
2019-04-16 00:35:02 +02:00
String m_pts_name;
Add basic PTY support. For now, there are four hard-coded PTYs: /dev/pt{m,s}[0123] Use this in the Terminal to open a pty pair and spawn a shell.
2019-01-15 06:30:19 +01:00
};
Kernel: Move all code into the Kernel namespace
2020-02-16 01:27:42 +01:00
}
Reference in a new issue Copy permalink