d060701j: getpwd00.h (0.45-alpha) Description

The header file is tied to the corresponding API Reference specification. The current text is as follows:

/* getpwd00.h 0.50 alpha      ISO 8859-1 encoding            dh:2006-08-31
 *
 *  Obtain Password Entry Directly from Console (version 0.50 alpha)
 *  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
 *
 * This is an alpha-test version of a C/C++ Language header of a custom
 * user function.  The interface contract that this header represents is
 * available at http://TROSTing.org/dev/2006/07/d060701i.htm
 *
 *          Copyright © 2006, NuovoDoc <http://NuovoDoc.com>
 *
 *     Attribution: 
 *       Hamilton, Dennis E.  getpwd00.h 0.50 alpha.  C Language header
 *       for trial getpwd00-version implementations, 2006-08-31.
 *       Latest version available in package d060701j.zip at
 *       http://TROSTing.org/dev/2006/07/d060701j.htm 
 *
 *    This work is licensed under the Creative Commons Attribution 
 *    License.  To view a copy of this license, visit web site
 *    http://creativecommons.org/licenses/by/2.5/ or send a letter 
 *    to Creative Commons, 559 Nathan Abbott Way, Stanford, 
 *    California 94305, USA.
 */
 
#ifndef GETPWD_H
#define GETPWD_H

#ifdef  __cplusplus
extern "C" {
#endif

#include <stddef.h>
    /* for implementation of size_t. */
 
int getpwd00(char buffer[ ], size_t maxpwd, size_t maxfield);

#define getpwdMAX_MAXPWD (63)
    /* Limit buffers to a reasonable ceiling above manual entries */

#define getpwdMAX_MAXFIELD (getpwdMAX_MAXPWD+8)
    /* Limit fields to a slight increase over the maximum buffer */
    
#ifdef  __cplusplus
}
#endif

#endif /* GETPWD_H */
/*
 * $Header: /MyProjects/getpwd/getpwd00.h 4     06-08-31 17:04 Orcmid $
 *
 *                        *** end of getpwd00.h ***
 */

2. Package Download

A Zip archive with the header and a simple test program is available:

The Manifest for the Zip Archive: 5,013 byte file d060701f.txt version 0.06 dated 2006-07-30-00:40. Read this file first to determine whether it is useful to download the Zip file.
The Zip Archive: 4,301 byte file d060701f.zip version 0.06 dated 2006-07-30-00:41.

4. Design Notes

Revision History:

0.50 2006-08-07-13:14 Upgrade to 0.50 alpha

Go immediately to the 0.50 alpha level so that the defined constants can be employed in the statement of invariants and in the little test program that is constructed next.

0.45 2006-08-06-10:45 Upgrade to 0.45 alpha

Tie to the 0.45 alpha API Reference and demonstrate use in application of getpwd as well as implementations of getpwd.

0.40 2006-07-30-00:44 Update to 0.4 alpha with Cleaned-Up Files

The header file is renamed to getpwd00.h for all alpha-beta versions, and the Zip package is cleaned up.

0.30 2006-07-29-21:50 Introduce Initial Header File and Confirmation

The text of the first, provisional header file is produced. There is an on-line manifest and a Zip file that can be downloaded that contains the manifest, the file, and a tiny program that tests compilation using the header file and its Standard C Library dependency.

0.00 2006-07-29-16:08 Create Initial Placeholder

Introduce an initial placeholder that serve as a target of links and include-page components until more content is developed.

You are navigating TROSTing.org.
This work is licensed under a
Creative Commons License.

created 2006-07-29-16:08 -0700 (pdt) by orcmid
$$Author: Orcmid $
$$Date: 06-08-31 17:29 $
$$Revision: 6 $

1. Improved Trial Header
2. Package Download
3. Package Usage
4. Design Notes

1. Improved Trial Header

2. Package Download

3. Package Usage

4. Design Notes