/usr/share/psychtoolbox-3/PsychBasic/PsychtoolboxRegistration.m is in psychtoolbox-3-common 3.0.14.20170103+git6-g605ff5c.dfsg1-1build1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 | function PsychtoolboxRegistration(isUpdate, flavor)
% PsychtoolboxRegistration(isUpdate, flavor) - Online registration.
%
% This function is used to register your working copy of Psychtoolbox
% with the official www.psychtoolbox.org website. The routine is
% normally called by PsychtoolboxPostInstallRoutine at the end of
% each successfull update or initial download of a copy of Psychtoolbox.
%
% The routine is fail-safe in the sense that it will not prevent you
% from running PTB if online registration fails for some reason.
%
% The routine transmits a bit of information about your copy of PTB and
% your system environment to the website, together with a world-wide unique
% identifier of your computer+operating system. The unique identifier is
% the MAC address of your computers primary network adapter. We need this
% to disambiguate multiple downloads/updates from the same user so we
% do not count the same system setup multiple times in our statistics.
% We have no way to easily find out who you are based on this information and
% could not care less about that information.
%
% We collect this information exclusively for the following purpose:
%
% 1. Statistics about total number of downloads for the purpose of
% documenting the use of PTB.
%
% 2. Statistics about distribution of user base wrt. operating system,
% and Matlab / Octave version to prioritize development for the most
% common platform+OS combinations.
%
%
% Technical Notes:
% The minimal network server for collecting the transmitted information would be the
% following line of code, executed in the Linux/OS-X command window:
%
% Linux: while true; do nc -l -p 2000 | head -c 500 >> /tmp/testlog ; done
% MacOS-X: while true; do nc -l -p 2000 >> /tmp/testlog ; done
%
% A server script that does this can be found in managementtools/psychregistrationserver.sh
%
% This will receive data from network port 2000 (any number between 1025 and 65535
% is valid), discard everything except the first 500 bytes (to prevent overflows due
% to bugs or hacker attacks) and append it to the logfile /tmp/testlog, one
% line per registered copy of Psychtoolbox.
%
% This M-File makes use of two GPL'ed free software utilities for
% M$-Windows, "nc" and "macid". Credits for the utilities and their source
% code can be found in the PsychContributed subfolder of Psychtoolbox.
%
% History:
% 18.08.2006 Written (MK)
% 5.10.2006 Add queries for Matlabs computer string and for machine
% architecture.
% 31.3.2008 Allow spaces in path to netcat command on Windows (Fix contributed by Tobias Wolf)
% 13.2.2009 Remove need for netcat on Matlab runtimes, esp. Windows, so we
% can get rid of our own nc.exe netcat distribution which made
% trouble for users with misconfigured virus scanners. (MK).
% 08.1.2012 Add extra robust MACID parsing for Linux, so we actually get registrations. (MK)
% Latest distros, e.g., FedoraCore or Ubuntu 11.10 use unusual NIC names, which
% makes Screen()'s parsing of MACID fail and thereby our online registration
% reject the registration.
%
% 28.5.2012 Cleanup for 3.0.10+ series. (MK)
%
% Address and port number of our statistics server:
ptbserveraddress = 'old.psychtoolbox.org';
% Running under OpenGL-PTB? Otherwise we abort.
AssertOpenGL;
try
% All arguments supplied? Otherwise we skip registration.
if nargin < 2
fprintf('PsychtoolboxRegistration: WARNING - Call arguments missing. Skipped...\n');
return;
end
if IsOctave
% No registration for GNU/Octave versions older than 3:
if sscanf(version, '%i') < 3
% Pre Octave-3: Just return -- Noop:
fprintf('PsychtoolboxRegistration: Octave version < 3 detected. Skipping registration...\n');
return;
end
end
compinfo = Screen('Computer');
% Query OS-Type:
if IsOSX
ostype = 'MacOS-X';
osversion = deblank(compinfo.system);
arch = deblank(compinfo.hw.machine);
end
if IsWin
ostype = 'Windows';
osversion = deblank(compinfo.system);
if isempty(osversion)
osversion = 'Unknown';
end
% Define machine architecture to be Intel.
arch = 'Intel';
end
if IsLinux
ostype = 'LinuxOS';
osversion = deblank(compinfo.system);
arch = deblank(compinfo.hw.machine);
end
% Query runtime environment:
if IsOctave
runtimeenv = 'Octave';
runtimeversion = version;
else
runtimeenv = 'Matlab';
runtimeversion = version;
end
% Query what Matlab thinks as well:
runtimearch = computer;
% Query MAC address as unique machine id:
% We try to get the info from the 'Computer' subfunction of Screen:
if isfield(compinfo, 'MACAddress')
% Success. Use it.
mac = compinfo.MACAddress;
% Valid? Some recent Linux distros assign unusual ethernet names,
% e.g., do not call the primary NIC eth0, so our Screen() code
% fails. In this case we fallback to the clumsy but hopefully
% effective method here:
if strcmp(mac, '00:00:00:00:00:00');
% No: Try alternative way, if possible:
if IsLinux
[rc, res] = system('ifconfig | grep Ethernet | grep HWaddr');
if rc == 0
% Find first valid HWaddr:
idx = strfind(res, 'HWaddr ');
for j = idx
mymacid = res(j+7:j+7+16);
if ~strcmp(mymacid, '00:00:00:00:00:00')
% This one seems to be valid. Assign as final mac,
% and we're done:
mac = upper(mymacid);
break;
end
end
end
end
end
else
% Failed: Try harder...
if IsWin
% Use external helper-utility to try to query MAC address:
macidcom = [PsychtoolboxRoot 'PsychContributed\macid '];
[rc mac] = dos(macidcom);
if rc==0 && length(mac)>=12
% Worked on Windows: Reassemble MAC into our standard
% format:
mac = [mac(1) mac(2) ':' mac(3) mac(4) ':' mac(5) mac(6) ':' mac(7) mac(8) ':' mac(9) mac(10) ':' mac(11) mac(12)];
else
% Failed as well. Set to unknown default.
mac = '00:00:00:00:00:00';
end
else
% On Non-Windows system, we are out of luck and use our
% 'unknown' default:
mac = '00:00:00:00:00:00';
end
end
% Build unique id string for this system:
uniqueID = ['<MACID>' mac '</MACID><OS>' ostype '-' osversion '</OS><ENVIRONMENT>' runtimeenv '</ENVIRONMENT><ENVVERSION>' ...
runtimeversion '</ENVVERSION><ENVARCH>' runtimearch '</ENVARCH><CPUARCH>' arch '</CPUARCH><FLAVOR>' ...
flavor '</FLAVOR><ISUPDATE>' num2str(isUpdate) '</ISUPDATE><DATE>' date '</DATE>'];
fprintf('Online Registration: Will try to transmit the following string of data\n');
fprintf('to the www.psychtoolbox.org website for statistical purpose:\n\n');
fprintf('%s\n\n', uniqueID);
fprintf('Type ''help PsychtoolboxRegistration'' at the Matlab/Octave command prompt\n');
fprintf('to learn about the purpose and scope of online registration.\n');
fprintf('Type ''type PsychtoolboxRegistration'' to see the source code of this routine.\n\n');
fprintf('Data transfer can take up to 10 seconds... The system reports:\n');
% Use pnet() for communication:
psychlasterror('reset');
rc = 0;
con=pnet('tcpconnect', ptbserveraddress, 2000);
if con >= 0
% Connection established.
% Write our string, with a timeout of 10 seconds:
pnet(con, 'setwritetimeout', 10);
try
% This try-catch is just to work around a bug in
% pnet('printf'), pretty annoying.
pnet(con, 'printf', '%s\n', uniqueID);
catch
psychlasterror('reset');
end
else
% Failed!
rc = 1;
end
pnet('closeall');
% Did it work?
if rc==0
fprintf('Success! Thanks for online registration of this copy.\n');
else
fprintf('Failed! Anyway, this does not affect your use of PTB in any way,\n');
fprintf('only our statistics about usage will be inaccurate :(\n');
end
catch
% This empty try-catch-end framework is just to make absolutely sure that our
% installation procedure does not fail due to some error in the online registration
% script.
end
% We are done.
return;
|