定义了会话管理的接口更多...

#include <dloginsession.h>

类 Dtk::Login::DLoginSession 继承关系图:

Dtk::Login::DLoginSession 的协作图:

Public 槽
DExpected< void >	activate ()
	对 Manger对象的相应调用对应Login上的Activate方法, 类似Manger对象的相应调用

DExpected< void >	kill (DTK_LOGIN_NAMESPACE::SessionRole who, qint32 signalNumber)
	和Manager相应对象调用类似对应Login上的Kill方法, 和Manager对象相应调用类似

DExpected< void >	lock ()
	和Manager相应对象调用类似对应Login上的Kill方法, 和Manager对象相应调用类似

DExpected< void >	setIdleHint (bool idle)
	改变session的空闲状态由session对象调用时候以便更改会话的空闲状态

DExpected< void >	setType (DTK_LOGIN_NAMESPACE::SessionType type)
	更改session的类型更多...

DExpected< void >	terminate ()
	和Manger对象的相应工作方式类似和Manger对象的相应工作方式类似

DExpected< QStringList >	autostartList ()
	列出所有自启动应用名更多...

DExpected< bool >	isAutostart (const QString &fileName)
	是否自动启动更多...

DExpected< bool >	removeAutostart (const QString &fileName)
	移除自动启动更多...

DExpected< bool >	addAutostart (const QString &fileName)
	添加自动启动更多...

信号
void	lockedChanged (bool locked)
	锁屏切换信号更多...

void	autostartAdded (const QString &fileName)
	自启应用被添加信号更多...

void	autostartRemoved (const QString &fileName)
	自启应用被删除信号更多...

Public 成员函数
bool	active () const
	读取 active 属性更多...

bool	idleHint () const
	读取session的闲置状态更多...

bool	locked () const
	读取session的锁定状态更多...

bool	remote () const
	判断session是本地的还是远程的更多...

SessionClass	sessionClass () const
	返回session的class类型更多...

QString	desktop () const
	返回当前session正在运行的桌面环境(如果是已知的话) 更多...

QString	display () const
	返回x11显示名字的编码更多...

QString	id () const
	编码当前session的id 更多...

QString	name () const
	用户名称更多...

QString	remoteHost () const
	远程用户的host名称更多...

QString	remoteUser () const
	远程session的用户名更多...

QString	scope () const
	当前session的scope名字更多...

QString	service () const
	返回注册使用身份认证的服务更多...

SessionState	state () const
	编码session的状态更多...

QString	TTY () const
	如果为文本登陆返回对应内核的tty路径更多...

SessionType	type () const
	当前session类型的编码 TTY, X11, Mir, Wayland, Unspecified其中一种更多...

QString	seat () const
	编码这个session所处的位置更多...

quint32	user () const
	编码此会话所属用户的用户 ID 更多...

quint32	audit () const
	返回此session ID的内核审计会话更多...

quint32	leader () const
	注册当前session进程的编码更多...

quint32	VTNr () const
	当前session的虚拟终端号更多...

QDateTime	idleSinceHint () const
	session空闲状态更多...

quint64	idleSinceHintMonotonic () const
	session空闲状态更多...

QDateTime	createdTime () const
	获取session创建时间更多...

quint64	createdTimeMonotonic () const
	以CLOCK_MONOTONIC的形式获取session创建的时间戳更多...

属性
bool	active
	是否活动状态 Acitve是一个布尔类型, 如果为真代表这个session为活跃状态。这说明, 正在最前面显示。这个字段在这里有趣State字段是半冗余的。

bool	idleHint
	该会话的空闲提示状态封装了当前session idle hint 状态, 和整个manager对象上各个属性如何为整个对象运作类似

bool	locked
	session 的锁定状态更多...

bool	remote
	是否为远程状态更多...

SessionClass	sessionClass
	session的class 更多...

QString	desktop
	当前session运行的桌面环境

QString	display
	x11显示名字的编码更多...

QString	id
	当前session的id

QString	name
	用户名称更多...

QString	remoteHost
	远程用户的host名称如果当前session是远程,返回远程系统的host名, 否则返回空

QString	remoteUser
	远程用户的User名更多...

QString	scope
	当前session的scope名字

QString	service
	注册使用身份认证的PAM服务

SessionState	state
	编码session的状态更多...

QString	TTY
	如果为文本登陆返回对应内核的tty路径更多...

SessionType	type
	当前session类型的编码更多...

QString	seat
	编码这个session所处的位置更多...

quint32	user
	编码此会话所属用户的用户 ID 更多...

quint32	audit
	此session ID的内核审计会话更多...

quint32	leader
	注册当前session进程的编码

quint32	VTNr
	当前session的虚拟终端号

QDateTime	idleSinceHint
	session空闲状态更多...

quint64	idleSinceHintMonotonic
	session空闲状态更多...

QDateTime	createdTime
	返回会话的创建时间更多...

quint64	createdTimeMonotonic
	以CLOCK_MONOTONIC的形式获取session创建的时间戳更多...

友元
class	DLoginManager

详细描述

定义了会话管理的接口

成员函数说明

◆ active()

bool DLoginSession::active ( ) const

读取 active 属性

返回: 活跃的状态

◆ addAutostart

bool DLoginSession::addAutostart ( const QString & fileName )

slot

添加自动启动

参数

[in] fileName 传入一个文件名将添加这个文件的自动启动

返回: 布尔值, 操作是否成功

◆ audit()

quint32 DLoginSession::audit ( ) const

返回此session ID的内核审计会话

返回: 该session的内核审计会话 ID

◆ autostartAdded

void DLoginSession::autostartAdded ( const QString & fileName )

signal

自启应用被添加信号

参数

fileName 自启应用的desktop文件

◆ autostartList

QStringList DLoginSession::autostartList ( )

slot

列出所有自启动应用名

返回: 返回一个列表

◆ autostartRemoved

void DLoginSession::autostartRemoved ( const QString & fileName )

signal

自启应用被删除信号

参数

fileName 自启应用的desktop文件

◆ createdTime()

QDateTime DLoginSession::createdTime ( ) const

获取session创建时间

返回: session创建时间

◆ createdTimeMonotonic()

quint64 DLoginSession::createdTimeMonotonic ( ) const

以CLOCK_MONOTONIC的形式获取session创建的时间戳

返回: 创建session的时间戳

◆ desktop()

QString DLoginSession::desktop ( ) const

返回当前session正在运行的桌面环境(如果是已知的话)

返回: 当前session桌面环境的名字

◆ display()

QString DLoginSession::display ( ) const

返回x11显示名字的编码

返回: 图形并且x11登陆的显示名称

◆ id()

QString DLoginSession::id ( ) const

编码当前session的id

返回: session的id

◆ idleHint()

bool DLoginSession::idleHint ( ) const

读取session的闲置状态

返回: DLoginSession 闲置状态

◆ idleSinceHint()

QDateTime DLoginSession::idleSinceHint ( ) const

session空闲状态

返回: session的空闲状态

◆ idleSinceHintMonotonic()

quint64 DLoginSession::idleSinceHintMonotonic ( ) const

session空闲状态

返回: session的空闲状态

◆ isAutostart

bool DLoginSession::isAutostart ( const QString & fileName )

slot

是否自动启动

参数

[in] fileName 传入一个文件名将判断这个文件是否自动启动

返回: 布尔值

◆ leader()

quint32 DLoginSession::leader ( ) const

注册当前session进程的编码

返回: 注册了当前session进程的编码

◆ locked()

bool DLoginSession::locked ( ) const

读取session的锁定状态

返回: session的锁定状态

◆ lockedChanged

void DLoginSession::lockedChanged ( bool locked )

signal

锁屏切换信号

参数

locked 是否锁屏

◆ name()

QString DLoginSession::name ( ) const

用户名称

返回: 当前登陆用户名称

◆ remote()

bool DLoginSession::remote ( ) const

判断session是本地的还是远程的

返回: session是否是远程

◆ remoteHost()

QString DLoginSession::remoteHost ( ) const

远程用户的host名称

返回: 远程系统的host名

◆ remoteUser()

QString DLoginSession::remoteUser ( ) const

远程session的用户名

返回: 远程session的用户名

◆ removeAutostart

bool DLoginSession::removeAutostart ( const QString & fileName )

slot

移除自动启动

参数

[in] fileName 传入一个文件名将移除这个文件的自动启动

返回: 布尔值, 操作是否成功

◆ scope()

QString DLoginSession::scope ( ) const

当前session的scope名字

返回: 当前scope 名字

◆ seat()

QString DLoginSession::seat ( ) const

编码这个session所处的位置

返回: 当前session所处的位置

◆ service()

QString DLoginSession::service ( ) const

返回注册使用身份认证的服务

返回: 注册了这个session的PAM服务

◆ sessionClass()

SessionClass DLoginSession::sessionClass ( ) const

返回session的class类型

返回: session的会话类型如 User, Greeter, LockScreen, Unknown中的任意一种

◆ setType

void DLoginSession::setType ( DTK_LOGIN_NAMESPACE::SessionType type )

slot

更改session的类型

对应Login上的SetType() 方法。该方法允许动态改变会话类型, 只能由session当前的控制器调用。如果尚未调用TakeControl()方法, 这个方法会失效。此外, 一旦控制被释放, session类型会重置, 或者使用ReleaseControl方法或者关闭D-Bus连接可以实现重置的效果。这个应该有助于防止session进入不一致的状态, 比如控制器崩溃时候。唯一的参数 argument type是指的新的session 类型。

◆ state()

SessionState DLoginSession::state ( ) const

编码session的状态

返回: session的状态 Online, Active, Closing, Unknown 其中一种

◆ TTY()

QString DLoginSession::TTY ( ) const

如果为文本登陆返回对应内核的tty路径

返回: 文本登陆时候对应内核的tty路径

◆ type()

SessionType DLoginSession::type ( ) const

当前session类型的编码 TTY, X11, Mir, Wayland, Unspecified其中一种

返回: 当前session 类型的编码

◆ user()

quint32 DLoginSession::user ( ) const

编码此会话所属用户的用户 ID

返回: 返回一个Unix UID

◆ VTNr()

quint32 DLoginSession::VTNr ( ) const

当前session的虚拟终端号

返回: 当前session的虚拟终端号

属性说明

◆ audit

DLoginSession::audit

read

此session ID的内核审计会话

如果会话的审计可用, 返回内核的审计会话id

◆ createdTime

DLoginSession::createdTime

read

返回会话的创建时间

timestamp 返回CLOCK_REALTIME。CLOCK_REALTIME 是对于机器绝对时间的猜测。

◆ createdTimeMonotonic

DLoginSession::createdTimeMonotonic

read

以CLOCK_MONOTONIC的形式获取session创建的时间戳

timestampMonotonic() 返回CLOCK_MONOTONIC,该时间表示来自过去某个任意点经过的绝对时间, 不受系统时钟变化影响

◆ display

DLoginSession::display

read

x11显示名字的编码

如果当前会话是x11图形登陆, display会对x11显示名称进行编码, 如果不是, 返回空字符串

◆ idleSinceHint

DLoginSession::idleSinceHint

read

session空闲状态

描述session的空闲状态,类似于管理器对象上各个属性如何为整个系统执行操作

◆ idleSinceHintMonotonic

DLoginSession::idleSinceHintMonotonic

read

session空闲状态

描述session的空闲状态,类似于管理器对象上各个属性如何为整个系统执行操作

◆ locked

DLoginSession::locked

read

session 的锁定状态

该函数显示这个session的锁定状态, 由setLockedHint 函数进行定义, dbus中为SetLockedHint方法

◆ name

DLoginSession::name

read

用户名称

当前登陆用户名称

◆ remote

DLoginSession::remote

read

是否为远程状态

该函数返回session是远程还是本地的状态

◆ remoteUser

DLoginSession::remoteUser

read

远程用户的User名

如果当前session是远程会话, 返回远程会话的当前的用户名, 否则返回空

◆ seat

DLoginSession::seat

read

编码这个session所处的位置

返回这个session所处的位置, 如果存在的话。返回值是一个seat id

◆ sessionClass

DLoginSession::sessionClass

read

session的class

_class() 函数编码。它是"user"(给普通的用户会话), "greeter"给显示管理器的伪会话或者"lock-screen" (给关闭窗口会话)

◆ state

DLoginSession::state

read

编码session的状态

session有3种状态, "online","active","closing"。当session已经登陆了但是没有active,也就是说没有在前景上显示, 显示为online；当session已经登陆了并且active了, 也就是说在前景上显示, 此时状态显示为"active",当session 正常退出, 但是session的一些进程仍然存在时候, 返回为closing。在未来可能会根据新的需求增加其他状态

◆ TTY

DLoginSession::TTY

read

如果为文本登陆返回对应内核的tty路径

如果当前session是text login,返回tty的路径, 否则返回空字符串

◆ type

DLoginSession::type

readwrite

当前session类型的编码

该函数会返回"unspecified"(未指定, 给PAM sessions或者其他类似的session), TTY(给 text logins), 或者"x11"/"mir"/"wayland"(图形界面登陆)

◆ user

DLoginSession::user

read

编码此会话所属用户的用户 ID

该函数编码此会话所属用户的用户 ID。返回值是一个Unix UID

该类的文档由以下文件生成:

include/login/dloginsession.h
docs/login/dloginsession.zh_CN.dox

Public 槽

信号

Public 成员函数

属性

友元

详细描述

成员函数说明

◆ active()

◆ addAutostart

◆ audit()

◆ autostartAdded

◆ autostartList

◆ autostartRemoved

◆ createdTime()

◆ createdTimeMonotonic()

◆ desktop()

◆ display()

◆ id()

◆ idleHint()

◆ idleSinceHint()

◆ idleSinceHintMonotonic()

◆ isAutostart

◆ leader()

◆ locked()

◆ lockedChanged

◆ name()

◆ remote()

◆ remoteHost()

◆ remoteUser()

◆ removeAutostart

◆ scope()

◆ seat()

◆ service()

◆ sessionClass()

◆ setType

◆ state()

◆ TTY()

◆ type()

◆ user()

◆ VTNr()

属性说明

◆ audit

◆ createdTime

◆ createdTimeMonotonic

◆ display

◆ idleSinceHint

◆ idleSinceHintMonotonic

◆ locked

◆ name

◆ remote

◆ remoteUser

◆ seat

◆ sessionClass

◆ state

◆ TTY

◆ type

◆ user