File perl-Net-Hesiod.spec of Package perl-Net-Hesiod

Overview Repositories Revisions Requests Users Attributes Meta

File perl-Net-Hesiod.spec of Package perl-Net-Hesiod (Revision b95339c8b28970208c896351f7f1d27a)

Currently displaying revision b95339c8b28970208c896351f7f1d27a , Show latest

#
# spec file for package perl-Net-Hesiod
#
# Copyright (c) 2015 SUSE LINUX Products GmbH, Nuernberg, Germany.
#
# All modifications and additions to the file contributed by third parties
# remain the property of their copyright owners, unless otherwise agreed
# upon. The license for this file, and modifications and additions to the
# file, is the same license as for the pristine package itself (unless the
# license for the pristine package is not an Open Source License, in which
# case the license is the MIT License). An "Open Source License" is a
# license that conforms to the Open Source Definition (Version 1.9)
# published by the Open Source Initiative.

# Please submit bugfixes or comments via http://bugs.opensuse.org/
#

Name:           perl-Net-Hesiod
Version:        1.11
Release:        0
%define cpan_name Net-Hesiod
Summary:        Perl interface to Hesiod Library API
License:        CHECK(GPL-1.0+ or Artistic-1.0)
Group:          Development/Libraries/Perl
Url:            http://search.cpan.org/dist/Net-Hesiod/
Source:         http://www.cpan.org/authors/id/P/PA/PAYERLE/%{cpan_name}-%{version}.tar.gz
BuildRoot:      %{_tmppath}/%{name}-%{version}-build
BuildRequires:  perl
BuildRequires:  perl-macros
#BuildRequires: perl(Net::Hesiod)
%{perl_requires}

%description
These routines interface to the Hesiod Library API. Hesiod is a distributed
database, with records stored as text records in DNS, that is used to
provide system information in clusters such as MIT's Athena project.
http://web.mit.edu/is/athena/

This module provides both standard and object-orientated interfaces to the
standard Hesiod library API. It requires the hesiod library to already be
installed (and Hesiod configured) on the system.

Before using any of the routines, the hesiod library needs to be
initialized. This can be done in the non-OO interface by calling
'hesiod_init'. The scalar '$context' should be passed to subsequent calls,
and when you are through with the Hesiod library, the resources should be
explicitly freed with the 'hesiod_end' routine.

In the OO interface, the constructor does the hesiod initialization, and
the resources will be automatcially freed by the destructor when the
_Hesiod_ object gets destroyed. (In actuality, the constructor merely calls
'hesiod_init' and blesses the resulting '$context' reference.)

'hesiod_init' returns 0 if successful, -1 if fails (and $! set). The OO
constructor returns a new object reference if successful, and undef
otherwise.

The 'hesiod_to_bind' routine and the 'to_bind' method convert a hesiod
query on a name and type to a DNS type query. No actual lookup is done.

The 'hesiod_resolve' routine and the 'resolve' method perform an actual
query. As with all DNS queries, multiple records can be returned, each of
which is returned as separate items in returned list. Usually, only the
first item is relevant.

The routines 'hesiod_getpwnam', 'hesiod_getpwuid', 'hesiod_getservbyname',
and the related methods ('getpwnam', 'getpwuid', and 'getservbyname'), are
hesiod versions of the Core Perl routines 'getpwnam', 'getpwuid', and
'getservbyname'. The arrays returned have the same structure as the Core
routines. *NOTE*: The service entry returned by 'hesiod_getservbyname' and
the related method has the port number in host-byte order, not network-byte
order as the standard C servent structure does. This is consistent with the
CORE 'getservbyname' and related functions.

'hesiod_getmailhost' and the related method 'getmailhost' return the Hesiod
postoffice structure for the named user. The returned _post office_ array
has three elements, corresponding to the type, host, and name of the
mailbox.

The method 'query' is a convenience wrapper to the 'hesiod_resolve'
function. In scalar context, it _join_'s the list of strings returned by
the resolve routine with the '$delim' argument (which defaults to ', '),
thus returning the entire query as a single scalar. In list context, it
_split_'s each element of the list of strings returned by the raw routine
on '$delim' (which defaults to '\s*,\s*'), and returns an array of all the
values.

The C language version of the API contains a number of routines to free
storage allocated by the library for the results of these queries. The Perl
API copies these results to Perl variables, then immediately frees the
storage allocated by the Hesiod library, and these routines are not needed
in the Perl API.

%prep
%setup -q -n %{cpan_name}-%{version}
find . -type f -print0 | xargs -0 chmod 644

%build
%{__perl} Makefile.PL INSTALLDIRS=vendor OPTIMIZE="%{optflags}"
%{__make} %{?_smp_mflags}

%check
%{__make} test

%install
%perl_make_install
%perl_process_packlist
%perl_gen_filelist

%files -f %{name}.files
%defattr(-,root,root,755)
%doc Artistic.txt Changes GPL.TXT README README.INSTALL

%changelog

Places

File perl-Net-Hesiod.spec of Package perl-Net-Hesiod (Revision b95339c8b28970208c896351f7f1d27a)

Places