d060701 TROST devNote getpwd Platform Isolation getpwd00.h (0.4-alpha) Description

TROSTing>dev> 2006>07> d060701f> 0.41 2017-07-01 07:36 -0700

• The latest getpwd.h Description:   <http://TROSTing.org/2006/07/d060701e.htm>.  Consult that page for the latest header-file version and its download.
• This getpwd00.h (0.4-alpha) Description: <http://TROSTing.org/2006/07/d060701f.htm>.  This version is now obsolete.  It is preserved for historical purposes and for comparison with improved versions.
• Next getpwd00.h (0.50-alpha) version: <http://TROSTing.org/2006/07/d060701j.htm>.  This version incorporates precise information about the interface contract as it is now conceived.

This version of getpwd00.h header file was produced simply to confirm compilation of the function prototype. Its packaging here is to initiate revision tracking and packaging practice.  The current artifacts are heavy on procedure and short on content.  That will shift as development and testing proceeds.

1. Initial-Trial Header
2. Package Download

1. Initial-Trial Header

The header file has been defined to use a provisional name and function prototype while still at an alpha stage of development.  The current text is as follows:

/* getpwd00.h 0.4 alpha        ISO 8859-1 encoding            dh:2006-07-29
 *
 *  Obtain Password Entry Directly from Console (version 0.4 alpha)
 *  - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
 *
 * This is an alpha-test C/C++ Language header version for a custom user
 * function.  For the latest status of the development of this header
 * and the interface that is specified herein, consult the web page at
 * http://TROSTing.org/dev/2006/07/d060701f.htm
 *
 *          Copyright © 2006, NuovoDoc <http://NuovoDoc.com>
 *
 *     Attribution: 
 *       Hamilton, Dennis E.  getpwd00.h version 0.04 alpha header
 *       for declaring getpwd00.h implementations.  Latest version 
 *       available at http://TROSTing.org/dev/2006/07/d060701f.htm
 *       as part of package d060701f.zip.  
 *
 *    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);
 
#ifdef  __cplusplus
}
#endif

/* TO DO AND EXPLAIN FURTHER:
   1. This header file specifies a function prototype for the syntax
      and type agreement of function getpwd00().
   2. This header file will also evolve to carry the contract for the
      specific behavior of platform-isolating function definitions 
      that implement getpwd10().
   3. The use of the versioned name getpwd00() is to emphasize that 
      all use is at the provisional alpha level and is not at the
      desired level of portable usage until getpwd10() is attained.
   4. Consult the web pages that describe this header file for details
      on how implementations are isolated for portable usage. 
*/   
 
#endif /* GETPWD_H */
/*
 * $Header: /MyProjects/getpwd/getpwd00.h 3     06-07-30 0:08 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.

Revision History:

0.41 2006-08-06-10:44 Indicate Obsolescence

The revision-progression information is updated to report the obsolescence of this version and the next-available version having tighter interface-contract information.

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: 17-07-01 7:36 $ $$Revision: 33 $