Mandalika's scratchpad | [ Work blog @Oracle | My Music Compositions ] |
Old Posts: 09.04 10.04 11.04 12.04 01.05 02.05 03.05 04.05 05.05 06.05 07.05 08.05 09.05 10.05 11.05 12.05 01.06 02.06 03.06 04.06 05.06 06.06 07.06 08.06 09.06 10.06 11.06 12.06 01.07 02.07 03.07 04.07 05.07 06.07 08.07 09.07 10.07 11.07 12.07 01.08 02.08 03.08 04.08 05.08 06.08 07.08 08.08 09.08 10.08 11.08 12.08 01.09 02.09 03.09 04.09 05.09 06.09 07.09 08.09 09.09 10.09 11.09 12.09 01.10 02.10 03.10 04.10 05.10 06.10 07.10 08.10 09.10 10.10 11.10 12.10 01.11 02.11 03.11 04.11 05.11 07.11 08.11 09.11 10.11 11.11 12.11 01.12 02.12 03.12 04.12 05.12 06.12 07.12 08.12 09.12 10.12 11.12 12.12 01.13 02.13 03.13 04.13 05.13 06.13 07.13 08.13 09.13 10.13 11.13 12.13 01.14 02.14 03.14 04.14 05.14 06.14 07.14 09.14 10.14 11.14 12.14 01.15 02.15 03.15 04.15 06.15 09.15 12.15 01.16 03.16 04.16 05.16 06.16 07.16 08.16 09.16 12.16 01.17 02.17 03.17 04.17 06.17 07.17 08.17 09.17 10.17 12.17 01.18 02.18 03.18 04.18 05.18 06.18 07.18 08.18 09.18 11.18 12.18 01.19 02.19 05.19 06.19 08.19 10.19 11.19 05.20 10.20 11.20 12.20 09.21 11.21 12.22
[ Related: 1st part @ Locality Group Observability on Solaris ]
As of this writing, Solaris has limited support for lgroup observability using programmatic interfaces. Applications can use the lgroup API to traverse the locality group hierarchy, discover the contents of each locality group and even affect thread and memory placement on desired lgroups.
The man page for liblgrp(3LIB)
lists out the currently supported public interfaces, and a brief description for most of those interfaces can be obtained by running man -k lgroup
in
a shell. In order to use this API, applications must link with locality group library, liblgrp(3LIB)
.
The following sample code demonstrates lgroup API usage by making several lgrp_*()
calls including lgrp_device_lgrps()
to find the locality groups that are closest to the specified
I/O device.
# cat -n iodevlgrp.c 1 #include <stdio.h> 2 #include <stdlib.h> 3 #include <assert.h> 4 #include <sys/lgrp_user.h> 5 #include <sys/types.h> 6 7 int main(int argc, char **argv) { 8 9 if (argc != 2) { 10 fprintf(stderr, "Usage: %s\n", argv[0]); 11 exit(1); 12 } 13 14 /* lgroup interface version check */ 15 if (lgrp_version(LGRP_VER_CURRENT) != LGRP_VER_CURRENT) { 16 fprintf(stderr, "\nBuilt with unsupported lgroup interface %d", 17 LGRP_VER_CURRENT); 18 exit(1); 19 } 20 21 lgrp_cookie_t cookie =lgrp_init(LGRP_VIEW_OS); 22 lgrp_id_t node = lgrp_root(cookie); 23 24 /* refresh the cookie if stale */ 25 if ( lgrp_cookie_stale(cookie) ) { 26 lgrp_fini(cookie); 27 cookie =lgrp_init(LGRP_VIEW_OS); 28 } 29 30 int nlgrps = lgrp_nlgrps(cookie); 31 if ( nlgrps == -1 ) { 32 perror("\n lgrp_nlgrps"); 33 lgrp_fini(cookie); 34 exit(1); 35 } 36 printf("Number of locality groups on the system: %d\n", (nlgrps-1)); 37 38 /* lgroups closest to the target device */ 39 int numlgrps = lgrp_device_lgrps(argv[1], NULL, 0); 40 if (numlgrps == -1 ){ 41 fprintf(stderr, "I/O device: %s. ", argv[1]); 42 perror("lgrp_device_lgrps"); 43 } else { 44 printf("lgroups closest to the I/O device %s: ", argv[1]); 45 lgrp_id_t *lgrpids = (lgrp_id_t *)calloc(numlgrps, sizeof(lgrp_id_t)); 46 assert(lgrpids != NULL); 47 lgrp_device_lgrps(argv[1], lgrpids, numlgrps); 48 for (int i = 0; i < numlgrps; ++i) { 49 printf(" %d ", lgrpids[i]); 50 } 51 free(lgrpids); 52 } 53 lgrp_fini(cookie); 54 printf("\n"); 55 return 0; 56 57 } % cc -o iodevlgrp -llgrp iodevlgrp.c % ./iodevlgrp /dev/ixgbe0 Number of locality groups on the system: 2 lgroups closest to the I/O device /dev/ixgbe0: 1 % lgrpinfo -d /dev/ixgbe0 lgroup ID : 1 % ./iodevlgrp /dev/ixgbe1 Number of locality groups on the system: 2 lgroups closest to the I/O device /dev/ixgbe1: 2 % lgrpinfo -d /dev/ixgbe1 lgroup ID : 2
Source: Oracle Solaris 11.3 Programming Interfaces Guide
Labels: oracle solaris C API locality+group lgroup observability
2004-2019 |