mirror of
https://github.com/python/cpython.git
synced 2024-11-25 10:54:51 +08:00
b044b2a701
svn+ssh://svn.python.org/python/branches/py3k ................ r74821 | georg.brandl | 2009-09-16 11:42:19 +0200 (Mi, 16 Sep 2009) | 1 line #6885: run python 3 as python3. ................ r74828 | georg.brandl | 2009-09-16 16:23:20 +0200 (Mi, 16 Sep 2009) | 1 line Use true booleans. ................ r74829 | georg.brandl | 2009-09-16 16:24:29 +0200 (Mi, 16 Sep 2009) | 1 line Small PEP8 correction. ................ r74830 | georg.brandl | 2009-09-16 16:36:22 +0200 (Mi, 16 Sep 2009) | 1 line Use true booleans. ................ r74831 | georg.brandl | 2009-09-16 17:54:04 +0200 (Mi, 16 Sep 2009) | 1 line Use true booleans and PEP8 for argdefaults. ................ r74833 | georg.brandl | 2009-09-16 17:58:14 +0200 (Mi, 16 Sep 2009) | 1 line Last round of adapting style of documenting argument default values. ................ r74835 | georg.brandl | 2009-09-16 18:00:31 +0200 (Mi, 16 Sep 2009) | 33 lines Merged revisions 74817-74820,74822-74824 via svnmerge from svn+ssh://pythondev@svn.python.org/python/trunk ........ r74817 | georg.brandl | 2009-09-16 11:05:11 +0200 (Mi, 16 Sep 2009) | 1 line Make deprecation notices as visible as warnings are right now. ........ r74818 | georg.brandl | 2009-09-16 11:23:04 +0200 (Mi, 16 Sep 2009) | 1 line #6880: add reference to classes section in exceptions section, which comes earlier. ........ r74819 | georg.brandl | 2009-09-16 11:24:57 +0200 (Mi, 16 Sep 2009) | 1 line #6876: fix base class constructor invocation in example. ........ r74820 | georg.brandl | 2009-09-16 11:30:48 +0200 (Mi, 16 Sep 2009) | 1 line #6891: comment out dead link to Unicode article. ........ r74822 | georg.brandl | 2009-09-16 12:12:06 +0200 (Mi, 16 Sep 2009) | 1 line #5621: refactor description of how class/instance attributes interact on a.x=a.x+1 or augassign. ........ r74823 | georg.brandl | 2009-09-16 15:06:22 +0200 (Mi, 16 Sep 2009) | 1 line Remove strange trailing commas. ........ r74824 | georg.brandl | 2009-09-16 15:11:06 +0200 (Mi, 16 Sep 2009) | 1 line #6892: fix optparse example involving help option. ........ ................
72 lines
2.7 KiB
ReStructuredText
72 lines
2.7 KiB
ReStructuredText
:mod:`spwd` --- The shadow password database
|
|
============================================
|
|
|
|
.. module:: spwd
|
|
:platform: Unix
|
|
:synopsis: The shadow password database (getspnam() and friends).
|
|
|
|
|
|
This module provides access to the Unix shadow password database. It is
|
|
available on various Unix versions.
|
|
|
|
You must have enough privileges to access the shadow password database (this
|
|
usually means you have to be root).
|
|
|
|
Shadow password database entries are reported as a tuple-like object, whose
|
|
attributes correspond to the members of the ``spwd`` structure (Attribute field
|
|
below, see ``<shadow.h>``):
|
|
|
|
+-------+---------------+---------------------------------+
|
|
| Index | Attribute | Meaning |
|
|
+=======+===============+=================================+
|
|
| 0 | ``sp_nam`` | Login name |
|
|
+-------+---------------+---------------------------------+
|
|
| 1 | ``sp_pwd`` | Encrypted password |
|
|
+-------+---------------+---------------------------------+
|
|
| 2 | ``sp_lstchg`` | Date of last change |
|
|
+-------+---------------+---------------------------------+
|
|
| 3 | ``sp_min`` | Minimal number of days between |
|
|
| | | changes |
|
|
+-------+---------------+---------------------------------+
|
|
| 4 | ``sp_max`` | Maximum number of days between |
|
|
| | | changes |
|
|
+-------+---------------+---------------------------------+
|
|
| 5 | ``sp_warn`` | Number of days before password |
|
|
| | | expires to warn user about it |
|
|
+-------+---------------+---------------------------------+
|
|
| 6 | ``sp_inact`` | Number of days after password |
|
|
| | | expires until account is |
|
|
| | | blocked |
|
|
+-------+---------------+---------------------------------+
|
|
| 7 | ``sp_expire`` | Number of days since 1970-01-01 |
|
|
| | | until account is disabled |
|
|
+-------+---------------+---------------------------------+
|
|
| 8 | ``sp_flag`` | Reserved |
|
|
+-------+---------------+---------------------------------+
|
|
|
|
The sp_nam and sp_pwd items are strings, all others are integers.
|
|
:exc:`KeyError` is raised if the entry asked for cannot be found.
|
|
|
|
The following functions are defined:
|
|
|
|
|
|
.. function:: getspnam(name)
|
|
|
|
Return the shadow password database entry for the given user name.
|
|
|
|
|
|
.. function:: getspall()
|
|
|
|
Return a list of all available shadow password database entries, in arbitrary
|
|
order.
|
|
|
|
|
|
.. seealso::
|
|
|
|
Module :mod:`grp`
|
|
An interface to the group database, similar to this.
|
|
|
|
Module :mod:`pwd`
|
|
An interface to the normal password database, similar to this.
|
|
|