1
<refentry id="ThunarVfsUser">
3
<refentrytitle role="top_of_page" id="ThunarVfsUser.top_of_page">ThunarVfsUser</refentrytitle>
4
<manvolnum>3</manvolnum>
5
<refmiscinfo>THUNAR-VFS Library</refmiscinfo>
9
<refname>ThunarVfsUser</refname>
10
<refpurpose></refpurpose>
11
<!--[<xref linkend="desc" endterm="desc.title"/>]-->
14
<refsynopsisdiv id="ThunarVfsUser.synopsis" role="synopsis">
15
<title role="synopsis.title">Synopsis</title>
19
#include <thunar-vfs/thunar-vfs.h>
21
<link linkend="ThunarVfsUser-struct">ThunarVfsUser</link>;
22
<link linkend="GList">GList</link>* <link linkend="thunar-vfs-user-get-groups">thunar_vfs_user_get_groups</link> (<link linkend="ThunarVfsUser">ThunarVfsUser</link> *user);
23
<link linkend="ThunarVfsGroup">ThunarVfsGroup</link>* <link linkend="thunar-vfs-user-get-primary-group">thunar_vfs_user_get_primary_group</link> (<link linkend="ThunarVfsUser">ThunarVfsUser</link> *user);
24
<link linkend="ThunarVfsUserId">ThunarVfsUserId</link> <link linkend="thunar-vfs-user-get-id">thunar_vfs_user_get_id</link> (<link linkend="ThunarVfsUser">ThunarVfsUser</link> *user);
25
const <link linkend="gchar">gchar</link>* <link linkend="thunar-vfs-user-get-name">thunar_vfs_user_get_name</link> (<link linkend="ThunarVfsUser">ThunarVfsUser</link> *user);
26
const <link linkend="gchar">gchar</link>* <link linkend="thunar-vfs-user-get-real-name">thunar_vfs_user_get_real_name</link> (<link linkend="ThunarVfsUser">ThunarVfsUser</link> *user);
27
<link linkend="gboolean">gboolean</link> <link linkend="thunar-vfs-user-is-me">thunar_vfs_user_is_me</link> (<link linkend="ThunarVfsUser">ThunarVfsUser</link> *user);
31
<refsect1 id="ThunarVfsUser.object-hierarchy" role="object_hierarchy">
32
<title role="object_hierarchy.title">Object Hierarchy</title>
34
<link linkend="GObject">GObject</link>
47
<refsect1 id="ThunarVfsUser.description" role="desc">
48
<title role="desc.title">Description</title>
54
<refsect1 id="ThunarVfsUser.details" role="details">
55
<title role="details.title">Details</title>
56
<refsect2 id="ThunarVfsUser-struct" role="struct">
57
<title>ThunarVfsUser</title>
58
<indexterm zone="ThunarVfsUser-struct"><primary>ThunarVfsUser</primary></indexterm><programlisting>typedef struct _ThunarVfsUser ThunarVfsUser;</programlisting>
62
<refsect2 id="thunar-vfs-user-get-groups" role="function">
63
<title>thunar_vfs_user_get_groups ()</title>
64
<indexterm zone="thunar-vfs-user-get-groups"><primary>thunar_vfs_user_get_groups</primary></indexterm><programlisting><link linkend="GList">GList</link>* thunar_vfs_user_get_groups (<link linkend="ThunarVfsUser">ThunarVfsUser</link> *user);</programlisting>
66
Returns all <link linkend="ThunarVfsGroup"><type>ThunarVfsGroup</type></link><!---->s that <parameter>user</parameter>
67
belongs to. The returned list and the <link linkend="ThunarVfsGroup"><type>ThunarVfsGroup</type></link><!---->s
68
contained within the list are owned by <parameter>user</parameter> and must not be
69
freed or altered by the caller.
72
Note that if <parameter>user</parameter> has a primary group, this group will
73
also be contained in the returned list.</para>
76
</para><variablelist role="params">
77
<varlistentry><term><parameter>user</parameter> :</term>
78
<listitem><simpara> a <link linkend="ThunarVfsUser"><type>ThunarVfsUser</type></link>.
79
</simpara></listitem></varlistentry>
80
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> the groups that <parameter>user</parameter> belongs to.
81
</simpara></listitem></varlistentry>
82
</variablelist></refsect2>
83
<refsect2 id="thunar-vfs-user-get-primary-group" role="function">
84
<title>thunar_vfs_user_get_primary_group ()</title>
85
<indexterm zone="thunar-vfs-user-get-primary-group"><primary>thunar_vfs_user_get_primary_group</primary></indexterm><programlisting><link linkend="ThunarVfsGroup">ThunarVfsGroup</link>* thunar_vfs_user_get_primary_group (<link linkend="ThunarVfsUser">ThunarVfsUser</link> *user);</programlisting>
87
Returns the primary group of <parameter>user</parameter> or <link linkend="NULL:CAPS"><literal>NULL</literal></link> if <parameter>user</parameter>
91
No reference is taken for the caller, so you must
92
not call <link linkend="g-object-unref"><function>g_object_unref()</function></link> on the returned object.</para>
95
</para><variablelist role="params">
96
<varlistentry><term><parameter>user</parameter> :</term>
97
<listitem><simpara> a <link linkend="ThunarVfsUser"><type>ThunarVfsUser</type></link>.
98
</simpara></listitem></varlistentry>
99
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> the primary group of <parameter>user</parameter> or <link linkend="NULL:CAPS"><literal>NULL</literal></link>.
100
</simpara></listitem></varlistentry>
101
</variablelist></refsect2>
102
<refsect2 id="thunar-vfs-user-get-id" role="function">
103
<title>thunar_vfs_user_get_id ()</title>
104
<indexterm zone="thunar-vfs-user-get-id"><primary>thunar_vfs_user_get_id</primary></indexterm><programlisting><link linkend="ThunarVfsUserId">ThunarVfsUserId</link> thunar_vfs_user_get_id (<link linkend="ThunarVfsUser">ThunarVfsUser</link> *user);</programlisting>
106
Returns the unique id of <parameter>user</parameter>.</para>
109
</para><variablelist role="params">
110
<varlistentry><term><parameter>user</parameter> :</term>
111
<listitem><simpara> a <link linkend="ThunarVfsUser"><type>ThunarVfsUser</type></link>.
112
</simpara></listitem></varlistentry>
113
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> the unique id of <parameter>user</parameter>.
114
</simpara></listitem></varlistentry>
115
</variablelist></refsect2>
116
<refsect2 id="thunar-vfs-user-get-name" role="function">
117
<title>thunar_vfs_user_get_name ()</title>
118
<indexterm zone="thunar-vfs-user-get-name"><primary>thunar_vfs_user_get_name</primary></indexterm><programlisting>const <link linkend="gchar">gchar</link>* thunar_vfs_user_get_name (<link linkend="ThunarVfsUser">ThunarVfsUser</link> *user);</programlisting>
120
Returns the name of <parameter>user</parameter>. If the system is
121
unable to determine the account name of <parameter>user</parameter>,
122
it'll return the user id as string.</para>
125
</para><variablelist role="params">
126
<varlistentry><term><parameter>user</parameter> :</term>
127
<listitem><simpara> a <link linkend="ThunarVfsUser"><type>ThunarVfsUser</type></link>.
128
</simpara></listitem></varlistentry>
129
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> the name of <parameter>user</parameter>.
130
</simpara></listitem></varlistentry>
131
</variablelist></refsect2>
132
<refsect2 id="thunar-vfs-user-get-real-name" role="function">
133
<title>thunar_vfs_user_get_real_name ()</title>
134
<indexterm zone="thunar-vfs-user-get-real-name"><primary>thunar_vfs_user_get_real_name</primary></indexterm><programlisting>const <link linkend="gchar">gchar</link>* thunar_vfs_user_get_real_name (<link linkend="ThunarVfsUser">ThunarVfsUser</link> *user);</programlisting>
136
Returns the real name of <parameter>user</parameter> or <link linkend="NULL:CAPS"><literal>NULL</literal></link> if the
137
real name for <parameter>user</parameter> is not known to the underlying
141
</para><variablelist role="params">
142
<varlistentry><term><parameter>user</parameter> :</term>
143
<listitem><simpara> a <link linkend="ThunarVfsUser"><type>ThunarVfsUser</type></link>.
144
</simpara></listitem></varlistentry>
145
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> the real name for <parameter>user</parameter> or <link linkend="NULL:CAPS"><literal>NULL</literal></link>.
146
</simpara></listitem></varlistentry>
147
</variablelist></refsect2>
148
<refsect2 id="thunar-vfs-user-is-me" role="function">
149
<title>thunar_vfs_user_is_me ()</title>
150
<indexterm zone="thunar-vfs-user-is-me"><primary>thunar_vfs_user_is_me</primary></indexterm><programlisting><link linkend="gboolean">gboolean</link> thunar_vfs_user_is_me (<link linkend="ThunarVfsUser">ThunarVfsUser</link> *user);</programlisting>
152
Checks whether the owner of the current process is
153
described by <parameter>user</parameter>.</para>
156
</para><variablelist role="params">
157
<varlistentry><term><parameter>user</parameter> :</term>
158
<listitem><simpara> a <link linkend="ThunarVfsUser"><type>ThunarVfsUser</type></link>.
159
</simpara></listitem></varlistentry>
160
<varlistentry><term><emphasis>Returns</emphasis> :</term><listitem><simpara> <link linkend="TRUE:CAPS"><literal>TRUE</literal></link> if <parameter>user</parameter> is the owner of the current
161
process, else <link linkend="FALSE:CAPS"><literal>FALSE</literal></link>.
162
</simpara></listitem></varlistentry>
163
</variablelist></refsect2>