Stephdl Repository

esmith::util - Utilities for e-smith server and gateway development

In a root terminal you can do the command below if you want to display the up-to-date content

perldoc esmith::util

This file documents “esmith::util” version 1.4.0

use esmith::util;

This module provides general utilities of use to developers of the e-smith server and gateway.

Sets the real UID to the effective UID and the real GID to the effective GID.

Depreacted interface to esmith::templates::processTemplate().

This routine changes the ownership of a file, automatically converting usernames and groupnames to UIDs and GIDs respectively.

Returns the current release version of the software.

Convert IP address from “xxx.xxx.xxx.xxx” notation to a 32-bit integer.

Convert IP address from a 32-bit integer to “xxx.xxx.xxx.xxx” notation.

Convert IP address from a 32-bit integer to reversed “xxx.xxx.xxx.xxx.in-addr.arpa” notation for BIND files.

Given an IP address and netmask (both in “xxx.xxx.xxx.xxx” format) compute the network and broadcast addresses and output them in the same format.

Given an IP address and netmask, the computeLocalNetworkPrefix function computes the network prefix for local machines.

i.e. for an IP address of 192.168.8.4 and netmask of 255.255.255.0, this function will return “192.168.8.”.

This string is suitable for use in configuration files (such as /etc/proftpd.conf) when the more precise notation xxx.xxx.xxx.xxx/yyy.yyy.yyy.yyy is not supported.

Given an IP address and netmask, the computeAllLocalNetworkPrefixes function computes the network prefix or list of prefixes that fully describe the network to which the IP address belongs.

examples:

* for an IP address of 192.168.8.4 and netmask of 255.255.255.0, will return an array with a first (and only) element of “192.168.8”.

* for an IP address of 192.168.8.4 and netmask of 255.255.254.0, will return the array [ ’192.168.8’, ’192.168.9’ ].

This array is suitable for use in configuration of tools such as djbdns where other network notations are not supported.

Given an IP address and netmask, the computeLocalNetworkShortSpec function computes a valid xxx.xxx.xxx.xxx/yyy specifier where yyy is the number of bits specifying the network.

i.e. for an IP address of 192.168.8.4 and netmask of 255.255.255.0, this function will return “192.168.8.0/24”.

This string is suitable for use in configuration files (such as /etc/proftpd.conf) when the more precise notation xxx.xxx.xxx.xxx/yyy.yyy.yyy.yyy is not supported.

Given an IP address and netmask, the computeLocalNetworkSpec function computes a valid xxx.xxx.xxx.xxx/yyy.yyy.yyy.yyy specifier.

Given a number of bits of network address, calculate the appropriate netmask.

Given an IP address and netmask, the computeLocalNetworkReversed function computes the appropriate DNS domain field.

The return value is aligned to the next available byte boundary, i.e.

          192.168.8.4/255.255.255.0 returns "8.168.192.in-addr.arpa."
          192.168.8.4/255.255.252.0 returns "168.192.in-addr.arpa."
          192.168.8.4/255.255.0.0   returns "168.192.in-addr.arpa."
          192.168.8.4/255.252.0.0   returns "192.in-addr.arpa."
          192.168.8.4/255.0.0.0     returns "192.in-addr.arpa."

This string is suitable for use in BIND configuration files.

Given a network specification (IP address and netmask), compute the total number of hosts in that network, as well as the first and last IP addresses in the range.

Given a domain name such as foo.bar.com, generate the LDAP base name “dc=foo,dc=bar,dc=com”.

Run command in background after a specified delay.

Low-level password-changing utilities. These utilities each change passwords for a single underlying password database, for example /etc/passwd, /etc/samba/smbpasswd, etc.

Validate Unix password.

Set Unix password

Check if the given username/password pair is correct. Return 1 if they are correct, return 0 otherwise.

Set Unix password but require previous password for authentication.

Set Samba password

Cancel Samba password