This commit is contained in:
eknauel 2003-12-04 15:45:16 +00:00
parent 7089a25b08
commit 5161e4d5ca
2 changed files with 19 additions and 14 deletions

4
NEWS
View File

@ -0,0 +1,4 @@
-*- outline -*-
* December 3, 2003: Intial release

29
README
View File

@ -31,7 +31,7 @@
definitions for scsh-yp. definitions for scsh-yp.
If the installation directory of scsh-yp is in scsh's library path If the installation directory of scsh-yp is in scsh's library path
scsh-yp load scsh-yp at start-up by you can load scsh-yp at start-up by
scsh -lel scsh-yp-0.1/scheme/load-yp.scm scsh -lel scsh-yp-0.1/scheme/load-yp.scm
@ -85,10 +85,10 @@
This sections gives an brief overview on the functions provided by This sections gives an brief overview on the functions provided by
the scsh-yp package. The man pages of the underlying yp_*() the scsh-yp package. The man pages of the underlying yp_*()
function calls explain these functions in greater detail. Almost function calls explain these functions in greater detail. Almost
all of the functions listed here have an optional parameter all of the functions listed here have an optional parameter DOMAIN
DOMAIN that tells YP/NIS which YP/NIS domain you are referring to. that tells YP/NIS which YP/NIS domain you are referring to. If
If this parameter is left out, the default domain will be used, this parameter is omitted, the default domain will be used, that
that is, the domain name that can be obtained with is, the domain name that can be obtained with
YP-GET-DEFAULT-DOMAIN. YP-GET-DEFAULT-DOMAIN.
(yp-get-default-domain) -> string (yp-get-default-domain) -> string
@ -103,9 +103,9 @@
yp-error condition. yp-error condition.
(yp-match map key [domain]) -> list-of-strings (yp-match map key [domain]) -> list-of-strings
Returns the entries in map (a string) that match key (a string). Returns the entries in MAP (a string) that match KEY (a string).
Make sure to use a full NIS/YP map name, e.g. "passwd.byname" Make sure to use a full NIS/YP map name, e.g. "passwd.byname"
instead "passwd". May raise an yp-error condition. instead of "passwd". May raise an yp-error condition.
(yp-order map [domain]) -> integer (yp-order map [domain]) -> integer
Returns the order number of a MAP (a string). May raise an yp-error. Returns the order number of a MAP (a string). May raise an yp-error.
@ -162,16 +162,15 @@
| |
| Error: yp-unknown-key | Error: yp-unknown-key
| 5 | 5
| (yp-match map "passwd.byname" key "knauel3" domain ---) | (yp-match map "passwd.byname" key "klabautermann" domain ---)
| 1> | 1>
`---- `----
* Caveats * Caveats
There is only a synchronous high-level interface to YP/NIS, so, There is only a synchronous high-level interface to YP/NIS, so
call a yp_*() function causes to whole scsh and all scsh threads to calling a yp_*() function causes scsh and all scsh threads to block.
block. I hope to solve that problem in a future version of I hope to solve that problem in a future version of scsh-yp.
scsh-yp.
* Bug reporting * Bug reporting
@ -187,8 +186,10 @@
engage in a battle with automake and wrote the automake build engage in a battle with automake and wrote the automake build
files. files.
Eric Knauel
Tübingen, December 2003 Eric Knauel
<knauel@informatik.uni-tuebingen.de>
Tübingen, December 2003
Footnotes: Footnotes:
[1] <http://www.scsh.net/> [1] <http://www.scsh.net/>