# pkttyagent(1) - man - phpman

[PKTTYAGENT(1)](https://www.chedong.com/phpMan.php/man/PKTTYAGENT/1/markdown)                                pkttyagent                                [PKTTYAGENT(1)](https://www.chedong.com/phpMan.php/man/PKTTYAGENT/1/markdown)



## NAME
       pkttyagent - Textual authentication helper

## SYNOPSIS
       **pkttyagent** [**--version**] [**--help**]

       **pkttyagent** [**--process** { _pid_ | _pid,pid-start-time_ } | **--system-bus-name** _busname_]
                  [**--notify-fd** _fd_] [**--fallback**]

## DESCRIPTION
       **pkttyagent** is used to start a textual authentication agent for the subject specified by
       either **--process** or **--system-bus-name**. If neither of these options are given, the parent
       process is used.

       To get notified when the authentication agent has been registered either listen to the
       Changed D-Bus signal or use **--notify-fd** to pass the number of a file descriptor that has been
       passed to the program. This file descriptor will then be closed when the authentication agent
       has been successfully registered.

       If **--fallback** is used, the textual authentication agent will not replace an existing
       authentication agent.

## RETURN VALUE
       If the authentication agent could not be registered, **pkttyagent** exits with an exit code of
       127. Diagnostic messages are printed on standard error.

       If one or more of the options passed are malformed, **pkttyagent** exits with an exit code of
       126. If stdin is a tty, then this manual page is also shown.

       If the authentication agent was successfully registered, **pkttyagent** will keep running,
       interacting with the user as needed. When its services are no longer needed, the process can
       be killed.

## NOTES
       Since process identifiers can be recycled, the caller should always use _pid,pid-start-time_
       when using the **--process** option. The value of _pid-start-time_ can be determined by consulting
       e.g. the [**proc**(5)](https://www.chedong.com/phpMan.php/man/proc/5/markdown) file system depending on the operating system. If only _pid_ is passed to the
       **--process** option, then **pkttyagent** will look up the start time itself but note that this may
       be racy.

## AUTHOR
       Written by David Zeuthen <<davidz@redhat.com>> with a lot of help from many others.

## BUGS
       Please send bug reports to either the distribution or the polkit-devel mailing list, see the
       link **<http://lists.freedesktop.org/mailman/listinfo/polkit-devel>** on how to subscribe.

## SEE ALSO
       [**polkit**(8)](https://www.chedong.com/phpMan.php/man/polkit/8/markdown), [**pkaction**(1)](https://www.chedong.com/phpMan.php/man/pkaction/1/markdown), [**pkcheck**(1)](https://www.chedong.com/phpMan.php/man/pkcheck/1/markdown), [**pkexec**(1)](https://www.chedong.com/phpMan.php/man/pkexec/1/markdown)



polkit                                        May 2009                                 [PKTTYAGENT(1)](https://www.chedong.com/phpMan.php/man/PKTTYAGENT/1/markdown)