Merge 464467e into 60973ef

Author: cstes

build.sunos64x64/HowToBuild

@@ -6,10 +6,12 @@ Contents:
         - Overview
 	- Audio Headers
 	- OpenSSL
-	- Real-Time
+	- Squeak Profile
+	- Real-Time Class
 	- Swapspace
 	- C Compiler
 	- GNU make
+	- pkg-config
 	- IPS package
 
 Overview
@@ -45,16 +47,26 @@ Audio Headers
 The configure script will look for header files (#include) and enable
 the build of some sound plugins, depending on what it finds.
 
-Personally I like the "pulse" server supported by the "vm-sound-pulse" plugin.
+For example it will check for /usr/include/sys/soundcard.h,
+and /usr/include/sys/audio/audio_oss.h.
 
-Make sure that you *uninstall* the audio headers:
+You can find out which package installs that header file as follows:
 
-# pkg list -a system/header/header-audio
-# pkg list -a library/audio/pulseaudio
+# pkg search  /usr/include/sys/audio/audio_oss.h
+
+Personally I like the "pulse" server supported by the "vm-sound-pulse" plugin.
+
+In some cases, the audio header files are in a separate package header-audio,
+which is not strictly needed because the PulseAudio server is sufficient.
 
 Make sure (before you configure and build) that header-audio is uninstalled,
 and that pulseaudio is installed.
 
+You can see whether the audio headers are installed as follows :
+
+# pkg list -a system/header/header-audio
+# pkg list -a library/audio/pulseaudio
+
 The header files for pulseaudio are in the pulseaudio package.
 
 OpenSSL
@@ -75,27 +87,86 @@ In order to avoid this problem, we build the VM with the option:
 
 	--without-libtls
 
-Real-Time
----------
+Squeak Profile
+--------------
 
 When running the squeak vm, after copying a Squeak .image and .change file,
 and after copying the Squeak Smalltalk source file (SqueakV50.sources).
 
-bash-4.4$ bin/squeak Squeak6.0alpha-19547-32bit.image 
+$ bin/squeak Squeak6.0alpha-19547-32bit.image 
 pthread_setschedparam failed: Not owner
+...
+
+This indicates that the process does not have the necessary "privilege".
+
+It is possible to get rid of this warning and run squeak as follows:
+
+$     pfexec squeak Squeak6.0alpha-19547-32bit.image 
+
+without warning.  This is a Solaris pfexec "execute squeak in a profile".
+
+To do this, add profile "Squeak":
+
+# profiles -p Squeak
+profiles:Squeak> set desc="Allow Squeak VM to Set Priority"
+profiles:Squeak> add cmd=/usr/bin/squeak
+profiles:Squeak:squeak> set privs=proc_priocntl
+profiles:Squeak:squeak> end
+profiles:Squeak> commit
+profiles:Squeak> info
+        name=Squeak
+        desc=Allow Squeak VM to Set Priority
+        cmd=/usr/bin/squeak
+profiles:Squeak> exit
+
+The above commands adds the following entries to /etc/security :
+
+# tail /etc/security/exec_attr
+Squeak:solaris:cmd:::/usr/bin/squeak:privs=proc_priocntl
+
+# tail /etc/security/prof_attr
+Squeak:::Allow Squeak VM to Set Priority:
 
-Note that it is possible to suppress the "pthread_setschedparam" warning,
+Once the profile is created, you can assign the profile to a user:
+
+$ cp /etc/user_attr /etc/user_attr.backup
+$ usermod -P Squeak someuser
+
+This changes the file /etc/user_attr; you can also edit /etc/user_attr.
+
+The user can verify that the profile is available:
+
+$ userattr profiles
+Squeak,System Administrator
+
+Finally the following two pfexec usages both (!) require the Squeak profile to exist.  So the second form with -P proc_priocntl as argument to pfexec only works if proc_priocntl is in the "intersection of the available profiles and proc_prioctnl".  So it's not enough to simply pfexec -P proc_prioctnl the squeak vm, it is necessary that the root user assigns the Squeak profile to the user.
+
+$ pfexec squeak Cuis5.0-4112.image
+
+$ pfexec -P proc_priocntl squeak Cuis5.0-4112.image
+
+Verify as follows the squeak threads (LWP light-weight processes)
+
+$ ps -eLo pid,pri,lwp,class,comm | grep squeak
+ 3849  44      1   IA /usr/lib/squeak/5.0-202004221445-sunos/squeak
+ 3849  49      2   IA /usr/lib/squeak/5.0-202004221445-sunos/squeak
+ 3849  49      3   IA /usr/lib/squeak/5.0-202004221445-sunos/squeak
+ 3849  50      4   IA /usr/lib/squeak/5.0-202004221445-sunos/squeak
+
+Note that there are 4 threads (LWP) and they are in the schedule class IA;
+the last thread is running at priority 50 (the others at 49).
+
+Real-Time Class
+---------------
+
+Note that it is also possible to suppress the "pthread_setschedparam" warning,
 by running the squeak vm in the RT (real-time) class.
 
 One way would be to use priocntl -e and execute the squeak in the -c RT class.
 
-Or perhaps at the "authorization" (auths) level it could perhaps
-be possible to have an entry in /etc/security/exec_attr.d for
-an authorization that gives "proc_priocntl" to squeak.
-
 You must do this as "root".
 
-Another way is to change a "bash" shell to RT class,
+You can change a "bash" shell to RT class,
 
 bash-4.4$ priocntl -d $$
 INTERACTIVE CLASS PROCESSES:
@@ -171,6 +242,15 @@ GNU Make
 
 For the Makefiles, pkg:/developer/build/gnu-make  must be installed.
 
+pkg-config
+----------
+
+The configure script uses the pkg-config tool for some plugins.
+
+Be sure to install it:
+
+   pkg install developer/build/pkg-config
+
 IPS Package
 -----------
 

platforms/unix/plugins/SqueakSSL/openssl_overlay.h

@@ -164,7 +164,7 @@
 #define sqo_SSL_library_init SSL_library_init
 #define sqo_SSL_load_error_strings SSL_load_error_strings
 
-#define sk_GENERAL_NAME_freefunc void(*)(void*)
+#define sk_GENERAL_NAME_freefunc void(*)(GENERAL_NAME*)
 
 #endif