sortix-mirror/share/man/man5/session.5
Jonas 'Sortie' Termansen 917722cf70 Add display server.
This change adds the display(1) graphical user interface and desktop
environment with basic windowing support and the graphical terminal(1)
emulator along with integrations in chkblayout(1), chvideomode(1),
sysinstall(8), sysupgrade(8), as well as the games and ports.

Adopt the Aurora procedural wallpaper in display(1) and login(8).

Remove the obsolete dispd.

Juhani contributed keyboard and video mode APIs to the display protocol
and other miscellaneous changes.

dzwdz contributed the initial functioning window buttons, improved title
bar, window tiling, and minor bug fixes

Co-authored-by: Juhani Krekelä <juhani@krekelä.fi>
Co-authored-by: dzwdz <kg67199@gmail.com>
2023-06-24 00:43:36 +02:00

66 lines
1.3 KiB
Groff

.Dd September 18, 2022
.Dt SESSION 5
.Os
.Sh NAME
.Nm session
.Nd user login ession
.Sh SYNOPSIS
.Nm ~/.session
.Nm /etc/session
.Sh DESCRIPTION
.Xr login 8
creates the user's session by running the user's
.Nm
script, which normally
executes a command line or graphical user environment.
The session concludes once the session script exits and
.Xr login 8
reclaims control.
.Pp
The session script is found by searching for an executable script in the
following paths:
.Bl -bullet -compact
.It
.Pa ~/.session
.It
.Pa /etc/session
.El
.Pp
The user's shell from
.Xr passwd 5
is used as a fallback session.
.Sh EXAMPLES
The user's
.Pa ~/.session
file can be created in any text editor and then made executable:
.Bd -literal -offset indent
editor ~/.session
chmod +x ~/.session
.Ed
.Ss Graphical User Interface
.Xr display 1
can be selected as the user's graphical user interface with this executable
.Pa ~/.session
script:
.Bd -literal -offset indent
#!/bin/sh
exec display
.Ed
.Pp
.Xr display 1
will run the
.Xr displayrc 5
script on startup, which can be used to start applications.
.Ss Trianglix
.Xr trianglix 1
can be selected as the user's triangle environment with this executable
.Pa ~/.session
script:
.Bd -literal -offset indent
#!/bin/sh
exec trianglix
.Ed
.Sh SEE ALSO
.Xr passwd 5 ,
.Xr login 8