php_library/general/suid.inc

<?php
if (!isset($GENERAL_PUTS_INCLUDED))
   {
   include("general/puts.inc");
   $GENERAL_PUTS_INCLUDED=1;
   }
?>
<?php
//********************************************************************************
//Copyright (C) 2006 David T. Ashley
//********************************************************************************
//This program or source file is free software; you can redistribute it and/or 
//modify it under the terms of the GNU General Public License as published by
//the Free Software Foundation; either version 2 of the License, or (at your 
//option) any later version.
//
//This program or source file is distributed in the hope that it will 
//be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of
//MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
//GNU General Public License for more details.
//
//You may have received a copy of the GNU General Public License
//along with this program; if not, write to the Free Software
//Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
//********************************************************************************
//Dave Ashley, 01/06
//
//This source file provides the code to create globally-unique identifiers.
//The rationale is that since no process can have the same PID at the same
//time as another process, using the PID concatenated with a guaranteed
//unique time should provide an identifier that can never recur in the lifetime
//of the server.
//
//A SUID is 104 bits of information (26 hexadecimal
//digits).  The breakdown is:
//
//   a)First 32 bits (8 hexadecimal digits) is the PID.  At present, PIDs
//     are only 16 bits, but in the future (faster systems, etc.) they may be
//     expanded to 32 bits.
//
//   b)Second 40 bits (10 hexadecimal digits).  The integer time, in seconds
//     since the Unix epoch.  The extra 8 bits are reserved due to the impending
//     Unix 2037 AD issue.
//
//   c)Third 32 bits (8 hexadecimal digits).  The nanoseconds representing the 
//     fractional part of the integer seconds.
//
//Note that both of the data sizes above are designed to allow future
//expansion.  The integer part is designed for the Unix 2037 issue.  The
//fractional part is designed for faster hardware in the future.
//
//
function SUID_suid()
   {
   return(sprintf("%08X", getmypid()) . PUTS_timestamp());
   }
//
//
//Returns the size of a SUID (in bytes).
//
function SUID_suid_size()
   {
   return(8 + PUTS_timestamp_size());
   }
?>
1	<?php
2	if (!isset($GENERAL_PUTS_INCLUDED))
3	{
4	include("general/puts.inc");
5	$GENERAL_PUTS_INCLUDED=1;
6	}
7	?>
8	<?php
9	//********************************************************************************
10	//Copyright (C) 2006 David T. Ashley
11	//********************************************************************************
12	//This program or source file is free software; you can redistribute it and/or
13	//modify it under the terms of the GNU General Public License as published by
14	//the Free Software Foundation; either version 2 of the License, or (at your
15	//option) any later version.
16	//
17	//This program or source file is distributed in the hope that it will
18	//be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of
19	//MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
20	//GNU General Public License for more details.
21	//
22	//You may have received a copy of the GNU General Public License
23	//along with this program; if not, write to the Free Software
24	//Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
25	//********************************************************************************
26	//Dave Ashley, 01/06
27	//
28	//This source file provides the code to create globally-unique identifiers.
29	//The rationale is that since no process can have the same PID at the same
30	//time as another process, using the PID concatenated with a guaranteed
31	//unique time should provide an identifier that can never recur in the lifetime
32	//of the server.
33	//
34	//A SUID is 104 bits of information (26 hexadecimal
35	//digits). The breakdown is:
36	//
37	// a)First 32 bits (8 hexadecimal digits) is the PID. At present, PIDs
38	// are only 16 bits, but in the future (faster systems, etc.) they may be
39	// expanded to 32 bits.
40	//
41	// b)Second 40 bits (10 hexadecimal digits). The integer time, in seconds
42	// since the Unix epoch. The extra 8 bits are reserved due to the impending
43	// Unix 2037 AD issue.
44	//
45	// c)Third 32 bits (8 hexadecimal digits). The nanoseconds representing the
46	// fractional part of the integer seconds.
47	//
48	//Note that both of the data sizes above are designed to allow future
49	//expansion. The integer part is designed for the Unix 2037 issue. The
50	//fractional part is designed for faster hardware in the future.
51	//
52	//
53	function SUID_suid()
54	{
55	return(sprintf("%08X", getmypid()) . PUTS_timestamp());
56	}
57	//
58	//
59	//Returns the size of a SUID (in bytes).
60	//
61	function SUID_suid_size()
62	{
63	return(8 + PUTS_timestamp_size());
64	}
65	?>