Print this page
    
    
      
        | Split | 
	Close | 
      
      | Expand all | 
      | Collapse all | 
    
    
          --- old/usr/src/head/libzonecfg.h
          +++ new/usr/src/head/libzonecfg.h
   1    1  /*
   2    2   * CDDL HEADER START
   3    3   *
   4    4   * The contents of this file are subject to the terms of the
   5    5   * Common Development and Distribution License (the "License").
   6    6   * You may not use this file except in compliance with the License.
   7    7   *
   8    8   * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
   9    9   * or http://www.opensolaris.org/os/licensing.
  10   10   * See the License for the specific language governing permissions
  11   11   * and limitations under the License.
  12   12   *
  13   13   * When distributing Covered Code, include this CDDL HEADER in each
  
    | 
      ↓ open down ↓ | 
    13 lines elided | 
    
      ↑ open up ↑ | 
  
  14   14   * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
  15   15   * If applicable, add the following below this CDDL HEADER, with the
  16   16   * fields enclosed by brackets "[]" replaced with your own identifying
  17   17   * information: Portions Copyright [yyyy] [name of copyright owner]
  18   18   *
  19   19   * CDDL HEADER END
  20   20   */
  21   21  
  22   22  /*
  23   23   * Copyright (c) 2003, 2010, Oracle and/or its affiliates. All rights reserved.
  24      - * Copyright 2015, Joyent, Inc.
  25   24   */
  26   25  
  27   26  #ifndef _LIBZONECFG_H
  28   27  #define _LIBZONECFG_H
  29   28  
  30   29  /*
  31   30   * Zone configuration header file.
  32   31   */
  33   32  
  34   33  #ifdef __cplusplus
  35   34  extern "C" {
  36   35  #endif
  37   36  
  38   37  /* sys/socket.h is required by net/if.h, which has a constant needed here */
  39   38  #include <sys/param.h>
  40   39  #include <sys/fstyp.h>
  41   40  #include <sys/mount.h>
  42   41  #include <priv.h>
  43   42  #include <netinet/in.h>
  44   43  #include <sys/socket.h>
  45   44  #include <net/if.h>
  46   45  #include <sys/mac.h>
  47   46  #include <stdio.h>
  48   47  #include <rctl.h>
  49   48  #include <zone.h>
  50   49  #include <libbrand.h>
  51   50  #include <sys/uuid.h>
  52   51  #include <libuutil.h>
  53   52  #include <sys/mnttab.h>
  54   53  #include <limits.h>
  55   54  #include <utmpx.h>
  56   55  
  57   56  #define ZONE_ID_UNDEFINED       -1
  58   57  
  59   58  #define Z_OK                    0
  60   59  #define Z_EMPTY_DOCUMENT        1       /* XML doc root element is null */
  61   60  #define Z_WRONG_DOC_TYPE        2       /* top-level XML doc element != zone */
  62   61  #define Z_BAD_PROPERTY          3       /* libxml-level property problem */
  63   62  #define Z_TEMP_FILE             4       /* problem creating temporary file */
  64   63  #define Z_SAVING_FILE           5       /* libxml error saving or validating */
  65   64  #define Z_NO_ENTRY              6       /* no such entry */
  66   65  #define Z_BOGUS_ZONE_NAME       7       /* illegal zone name */
  67   66  #define Z_REQD_RESOURCE_MISSING 8       /* required resource missing */
  68   67  #define Z_REQD_PROPERTY_MISSING 9       /* required property missing */
  69   68  #define Z_BAD_HANDLE            10      /* bad document handle */
  70   69  #define Z_NOMEM                 11      /* out of memory (like ENOMEM) */
  71   70  #define Z_INVAL                 12      /* invalid argument (like EINVAL) */
  72   71  #define Z_ACCES                 13      /* permission denied (like EACCES) */
  73   72  #define Z_TOO_BIG               14      /* string won't fit in char array */
  74   73  #define Z_MISC_FS               15      /* miscellaneous file-system error */
  75   74  #define Z_NO_ZONE               16      /* no such zone */
  76   75  #define Z_NO_RESOURCE_TYPE      17      /* no/wrong resource type */
  77   76  #define Z_NO_RESOURCE_ID        18      /* no/wrong resource id */
  78   77  #define Z_NO_PROPERTY_TYPE      19      /* no/wrong property type */
  79   78  #define Z_NO_PROPERTY_ID        20      /* no/wrong property id */
  80   79  #define Z_BAD_ZONE_STATE        21      /* zone state invalid for given task */
  81   80  #define Z_INVALID_DOCUMENT      22      /* libxml can't validate against DTD */
  82   81  #define Z_NAME_IN_USE           23      /* zone name already in use (rename) */
  83   82  #define Z_NO_SUCH_ID            24      /* delete_index: no old ID */
  84   83  #define Z_UPDATING_INDEX        25      /* add/modify/delete_index problem */
  85   84  #define Z_LOCKING_FILE          26      /* problem locking index file */
  86   85  #define Z_UNLOCKING_FILE        27      /* problem unlocking index file */
  87   86  #define Z_SYSTEM                28      /* consult errno instead */
  88   87  #define Z_INSUFFICIENT_SPEC     29      /* resource insufficiently specified */
  89   88  #define Z_RESOLVED_PATH         34      /* resolved path mismatch */
  90   89  #define Z_IPV6_ADDR_PREFIX_LEN  35      /* IPv6 address prefix length needed */
  91   90  #define Z_BOGUS_ADDRESS         36      /* not IPv[4|6] address or host name */
  92   91  #define Z_PRIV_PROHIBITED       37      /* specified privilege is prohibited */
  93   92  #define Z_PRIV_REQUIRED         38      /* required privilege is missing */
  94   93  #define Z_PRIV_UNKNOWN          39      /* specified privilege is unknown */
  95   94  #define Z_BRAND_ERROR           40      /* brand-specific error */
  96   95  #define Z_INCOMPATIBLE          41      /* incompatible settings */
  97   96  #define Z_ALIAS_DISALLOW        42      /* rctl alias disallowed */
  98   97  #define Z_CLEAR_DISALLOW        43      /* clear property disallowed */
  99   98  #define Z_POOL                  44      /* generic libpool error */
 100   99  #define Z_POOLS_NOT_ACTIVE      45      /* pool service not enabled */
 101  100  #define Z_POOL_ENABLE           46      /* pools enable failed */
 102  101  #define Z_NO_POOL               47      /* no such pool configured */
 103  102  #define Z_POOL_CREATE           48      /* pool create failed */
 104  103  #define Z_POOL_BIND             49      /* pool bind failed */
 105  104  #define Z_INVALID_PROPERTY      50      /* invalid property value */
 106  105  
 107  106  /*
 108  107   * Warning: these are shared with the admin/install consolidation.
 109  108   * Do not insert states between any of the currently defined states,
 110  109   * and any new states must be evaluated for impact on range comparisons.
 111  110   */
 112  111  #define ZONE_STATE_CONFIGURED           0
  
    | 
      ↓ open down ↓ | 
    78 lines elided | 
    
      ↑ open up ↑ | 
  
 113  112  #define ZONE_STATE_INCOMPLETE           1
 114  113  #define ZONE_STATE_INSTALLED            2
 115  114  #define ZONE_STATE_READY                3
 116  115  #define ZONE_STATE_RUNNING              4
 117  116  #define ZONE_STATE_SHUTTING_DOWN        5
 118  117  #define ZONE_STATE_DOWN                 6
 119  118  #define ZONE_STATE_MOUNTED              7
 120  119  
 121  120  #define ZONE_STATE_MAXSTRLEN    14
 122  121  
 123      -#define ZONE_PROP_MAXSTRLEN     1024
 124      -
 125  122  #define LIBZONECFG_PATH         "libzonecfg.so.1"
 126  123  
 127  124  #define ZONE_CONFIG_ROOT        "/etc/zones"
 128  125  #define ZONE_INDEX_FILE         ZONE_CONFIG_ROOT "/index"
 129  126  
 130  127  #define MAXUSERNAME             (sizeof (((struct utmpx *)0)->ut_name))
 131  128  #define MAXAUTHS                4096
 132  129  #define ZONE_MGMT_PROF          "Zone Management"
 133  130  
 134  131  #define ZONE_INT32SZ            11              /* string to hold 32bit int. */
 135  132  
 136  133  /* Owner, group, and mode (defined by packaging) for the config directory */
 137  134  #define ZONE_CONFIG_UID         0               /* root */
 138  135  #define ZONE_CONFIG_GID         3               /* sys */
 139  136  #define ZONE_CONFIG_MODE        0755
 140  137  
 141  138  /* Owner, group, and mode (defined by packaging) for the index file */
 142  139  #define ZONE_INDEX_UID          0               /* root */
 143  140  #define ZONE_INDEX_GID          3               /* sys */
 144  141  #define ZONE_INDEX_MODE         0644
 145  142  
 146  143  /* The maximum length of the VERSION string in the pkginfo(4) file. */
 147  144  #define ZONE_PKG_VERSMAX        256
 148  145  
 149  146  /*
 150  147   * Shortened alias names for the zones rctls.
 151  148   */
 152  149  #define ALIAS_MAXLWPS           "max-lwps"
 153  150  #define ALIAS_MAXSHMMEM         "max-shm-memory"
 154  151  #define ALIAS_MAXSHMIDS         "max-shm-ids"
 155  152  #define ALIAS_MAXMSGIDS         "max-msg-ids"
 156  153  #define ALIAS_MAXSEMIDS         "max-sem-ids"
 157  154  #define ALIAS_MAXLOCKEDMEM      "locked"
 158  155  #define ALIAS_MAXSWAP           "swap"
 159  156  #define ALIAS_MAXPHYSMEM        "physical"
 160  157  #define ALIAS_SHARES            "cpu-shares"
 161  158  #define ALIAS_CPUCAP            "cpu-cap"
 162  159  #define ALIAS_MAXPROCS          "max-processes"
  
    | 
      ↓ open down ↓ | 
    28 lines elided | 
    
      ↑ open up ↑ | 
  
 163  160  #define ALIAS_ZFSPRI            "zfs-io-priority"
 164  161  
 165  162  /* Default name for zone detached manifest */
 166  163  #define ZONE_DETACHED   "SUNWdetached.xml"
 167  164  
 168  165  /*
 169  166   * Bit flag definitions for passing into libzonecfg functions.
 170  167   */
 171  168  #define ZONE_DRY_RUN            0x01
 172  169  
 173      -typedef enum zone_iptype {
 174      -        ZS_SHARED,
 175      -        ZS_EXCLUSIVE
 176      -} zone_iptype_t;
 177      -
 178  170  /*
 179  171   * The integer field expresses the current values on a get.
 180  172   * On a put, it represents the new values if >= 0 or "don't change" if < 0.
 181  173   */
 182  174  struct zoneent {
 183  175          char    zone_name[ZONENAME_MAX];        /* name of the zone */
 184  176          int     zone_state;     /* configured | incomplete | installed */
 185  177          char    zone_path[MAXPATHLEN];          /* path to zone storage */
 186  178          uuid_t  zone_uuid;                      /* unique ID for zone */
 187  179          char    zone_newname[ZONENAME_MAX];     /* for doing renames */
 188      -        char    zone_brand[MAXNAMELEN];         /* zone's brand */
 189      -        zone_iptype_t zone_iptype;              /* zone's IP type */
 190      -        zoneid_t zone_did;                      /* persistent debug ID */
 191  180  };
 192  181  
 193  182  typedef struct zone_dochandle *zone_dochandle_t;        /* opaque handle */
 194  183  
 195  184  typedef uint_t zone_state_t;
 196  185  
 197  186  typedef struct zone_fsopt {
 198  187          struct zone_fsopt *zone_fsopt_next;
 199  188          char               zone_fsopt_opt[MAX_MNTOPT_STR];
 200  189  } zone_fsopt_t;
 201  190  
 202  191  struct zone_fstab {
 203  192          char            zone_fs_special[MAXPATHLEN];    /* special file */
 204  193          char            zone_fs_dir[MAXPATHLEN];        /* mount point */
 205  194          char            zone_fs_type[FSTYPSZ];          /* e.g. ufs */
  
    | 
      ↓ open down ↓ | 
    5 lines elided | 
    
      ↑ open up ↑ | 
  
 206  195          zone_fsopt_t   *zone_fs_options;                /* mount options */
 207  196          char            zone_fs_raw[MAXPATHLEN];        /* device to fsck */
 208  197  };
 209  198  
 210  199  /*
 211  200   * Generic resource attribute list.
 212  201   * Key/value resource that can be attached to net or device.
 213  202   */
 214  203  struct zone_res_attrtab {
 215  204          char    zone_res_attr_name[MAXNAMELEN];
 216      -        char    zone_res_attr_value[ZONE_PROP_MAXSTRLEN];
      205 +        char    zone_res_attr_value[MAXNAMELEN];
 217  206          struct zone_res_attrtab *zone_res_attr_next;
 218  207  };
 219  208  
 220  209  struct zone_nwiftab {
 221  210          char    zone_nwif_address[INET6_ADDRSTRLEN]; /* shared-ip only */
 222  211          char    zone_nwif_allowed_address[INET6_ADDRSTRLEN]; /* excl-ip only */
 223  212          char    zone_nwif_physical[LIFNAMSIZ];
 224  213          char    zone_nwif_mac[MAXMACADDRLEN];           /* excl-ip only */
 225  214          char    zone_nwif_vlan_id[ZONE_INT32SZ];        /* excl-ip only */
 226  215          char    zone_nwif_gnic[LIFNAMSIZ];              /* excl-ip only */
 227  216          char    zone_nwif_defrouter[INET6_ADDRSTRLEN];
 228  217          struct zone_res_attrtab *zone_nwif_attrp;
 229  218  };
 230  219  
 231  220  struct zone_devtab {
 232  221          char    zone_dev_match[MAXPATHLEN];
 233  222          struct zone_res_attrtab *zone_dev_attrp;
 234  223  };
 235  224  
 236  225  struct zone_rctlvaltab {
 237  226          char    zone_rctlval_priv[MAXNAMELEN];
 238  227          char    zone_rctlval_limit[MAXNAMELEN];
 239  228          char    zone_rctlval_action[MAXNAMELEN];
 240  229          struct zone_rctlvaltab *zone_rctlval_next;
 241  230  };
 242  231  
 243  232  struct zone_rctltab {
 244  233          char    zone_rctl_name[MAXNAMELEN];
 245  234          struct zone_rctlvaltab *zone_rctl_valptr;
 246  235  };
 247  236  
 248  237  struct zone_attrtab {
 249  238          char    zone_attr_name[MAXNAMELEN];
 250  239          char    zone_attr_type[MAXNAMELEN];
 251  240          char    zone_attr_value[2 * BUFSIZ];
 252  241  };
 253  242  
 254  243  struct zone_dstab {
 255  244          char    zone_dataset_name[MAXNAMELEN];
 256  245  };
 257  246  
 258  247  struct zone_psettab {
 259  248          char    zone_ncpu_min[MAXNAMELEN];
 260  249          char    zone_ncpu_max[MAXNAMELEN];
 261  250          char    zone_importance[MAXNAMELEN];
 262  251  };
 263  252  
 264  253  struct zone_pkgtab {
 265  254          char    zone_pkg_name[MAXNAMELEN];
 266  255          char    zone_pkg_version[ZONE_PKG_VERSMAX];
 267  256  };
 268  257  
 269  258  struct zone_devpermtab {
 270  259          char    zone_devperm_name[MAXPATHLEN];
 271  260          uid_t   zone_devperm_uid;
 272  261          gid_t   zone_devperm_gid;
 273  262          mode_t  zone_devperm_mode;
 274  263          char    *zone_devperm_acl;
 275  264  };
 276  265  
 277  266  struct zone_admintab {
 278  267          char    zone_admin_user[MAXUSERNAME];
 279  268          char    zone_admin_auths[MAXAUTHS];
 280  269  };
 281  270  
 282  271  typedef struct zone_userauths {
 283  272          char                    user[MAXUSERNAME];
  
    | 
      ↓ open down ↓ | 
    57 lines elided | 
    
      ↑ open up ↑ | 
  
 284  273          char                    zonename[ZONENAME_MAX];
 285  274          struct zone_userauths   *next;
 286  275  } zone_userauths_t;
 287  276  
 288  277  typedef struct {
 289  278          uu_avl_node_t   zpe_entry;
 290  279          char            *zpe_name;
 291  280          char            *zpe_vers;
 292  281  } zone_pkg_entry_t;
 293  282  
      283 +typedef enum zone_iptype {
      284 +        ZS_SHARED,
      285 +        ZS_EXCLUSIVE
      286 +} zone_iptype_t;
      287 +
 294  288  /*
 295  289   * Basic configuration management routines.
 296  290   */
 297  291  extern  zone_dochandle_t        zonecfg_init_handle(void);
 298  292  extern  int     zonecfg_get_handle(const char *, zone_dochandle_t);
 299  293  extern  int     zonecfg_get_snapshot_handle(const char *, zone_dochandle_t);
 300  294  extern  int     zonecfg_get_template_handle(const char *, const char *,
 301  295      zone_dochandle_t);
 302  296  extern  int     zonecfg_get_xml_handle(const char *, zone_dochandle_t);
 303  297  extern  int     zonecfg_check_handle(zone_dochandle_t);
 304  298  extern  void    zonecfg_fini_handle(zone_dochandle_t);
 305  299  extern  int     zonecfg_destroy(const char *, boolean_t);
 306  300  extern  int     zonecfg_destroy_snapshot(const char *);
 307  301  extern  int     zonecfg_save(zone_dochandle_t);
 308  302  extern  int     zonecfg_create_snapshot(const char *);
 309  303  extern  char    *zonecfg_strerror(int);
 310  304  extern  int     zonecfg_access(const char *, int);
  
    | 
      ↓ open down ↓ | 
    7 lines elided | 
    
      ↑ open up ↑ | 
  
 311  305  extern  void    zonecfg_set_root(const char *);
 312  306  extern  const char *zonecfg_get_root(void);
 313  307  extern  boolean_t zonecfg_in_alt_root(void);
 314  308  extern  int     zonecfg_num_resources(zone_dochandle_t, char *);
 315  309  extern  int     zonecfg_del_all_resources(zone_dochandle_t, char *);
 316  310  extern  boolean_t zonecfg_valid_ncpus(char *, char *);
 317  311  extern  boolean_t zonecfg_valid_importance(char *);
 318  312  extern  int     zonecfg_str_to_bytes(char *, uint64_t *);
 319  313  extern  boolean_t zonecfg_valid_memlimit(char *, uint64_t *);
 320  314  extern  boolean_t zonecfg_valid_alias_limit(char *, char *, uint64_t *);
 321      -extern  void    zonecfg_notify_create(zone_dochandle_t);
 322  315  
 323  316  /*
 324  317   * Zone name, path to zone directory, autoboot setting, pool, boot
 325  318   * arguments, and scheduling-class.
 326  319   */
 327  320  extern  int     zonecfg_validate_zonename(const char *);
 328  321  extern  int     zonecfg_get_name(zone_dochandle_t, char *, size_t);
 329  322  extern  int     zonecfg_set_name(zone_dochandle_t, char *);
 330  323  extern  int     zonecfg_get_zonepath(zone_dochandle_t, char *, size_t);
 331  324  extern  int     zonecfg_set_zonepath(zone_dochandle_t, char *);
 332  325  extern  int     zonecfg_get_autoboot(zone_dochandle_t, boolean_t *);
 333  326  extern  int     zonecfg_set_autoboot(zone_dochandle_t, boolean_t);
 334  327  extern  int     zonecfg_get_iptype(zone_dochandle_t, zone_iptype_t *);
 335  328  extern  int     zonecfg_set_iptype(zone_dochandle_t, zone_iptype_t);
 336  329  extern  int     zonecfg_get_pool(zone_dochandle_t, char *, size_t);
 337  330  extern  int     zonecfg_set_pool(zone_dochandle_t, char *);
 338  331  extern  int     zonecfg_get_bootargs(zone_dochandle_t, char *, size_t);
 339  332  extern  int     zonecfg_set_bootargs(zone_dochandle_t, char *);
 340  333  extern  int     zonecfg_get_sched_class(zone_dochandle_t, char *, size_t);
 341  334  extern  int     zonecfg_set_sched(zone_dochandle_t, char *);
 342  335  extern  int     zonecfg_get_dflt_sched_class(zone_dochandle_t, char *, int);
 343  336  extern  zoneid_t zonecfg_get_did(zone_dochandle_t);
 344  337  extern  void    zonecfg_set_did(zone_dochandle_t);
 345  338  
 346  339  /*
 347  340   * Set/retrieve the brand for the zone
 348  341   */
 349  342  extern  int     zonecfg_get_brand(zone_dochandle_t, char *, size_t);
 350  343  extern  int     zonecfg_set_brand(zone_dochandle_t, char *);
 351  344  
 352  345  /*
 353  346   * Filesystem configuration.
 354  347   */
 355  348  extern  int     zonecfg_add_filesystem(zone_dochandle_t, struct zone_fstab *);
 356  349  extern  int     zonecfg_delete_filesystem(zone_dochandle_t,
 357  350      struct zone_fstab *);
 358  351  extern  int     zonecfg_modify_filesystem(zone_dochandle_t,
 359  352      struct zone_fstab *, struct zone_fstab *);
 360  353  extern  int     zonecfg_lookup_filesystem(zone_dochandle_t,
 361  354      struct zone_fstab *);
 362  355  extern  int     zonecfg_add_fs_option(struct zone_fstab *, char *);
 363  356  extern  int     zonecfg_remove_fs_option(struct zone_fstab *, char *);
 364  357  extern  void    zonecfg_free_fs_option_list(zone_fsopt_t *);
 365  358  extern  int     zonecfg_find_mounts(char *, int(*)(const struct mnttab *,
 366  359      void *), void *);
 367  360  
 368  361  /*
 369  362   * Resource key/value attributes (properties).
 370  363   */
 371  364  extern  int     zonecfg_add_res_attr(struct zone_res_attrtab **,
 372  365      struct zone_res_attrtab *);
 373  366  extern  void    zonecfg_free_res_attr_list(struct zone_res_attrtab *);
 374  367  extern  int     zonecfg_remove_res_attr(struct zone_res_attrtab **,
 375  368      struct zone_res_attrtab *);
 376  369  
 377  370  /*
 378  371   * Network interface configuration.
 379  372   */
 380  373  extern  int     zonecfg_add_nwif(zone_dochandle_t, struct zone_nwiftab *);
 381  374  extern  int     zonecfg_delete_nwif(zone_dochandle_t, struct zone_nwiftab *);
 382  375  extern  int     zonecfg_modify_nwif(zone_dochandle_t, struct zone_nwiftab *,
 383  376      struct zone_nwiftab *);
 384  377  extern  int     zonecfg_lookup_nwif(zone_dochandle_t, struct zone_nwiftab *);
 385  378  
 386  379  /*
 387  380   * Hostid emulation configuration.
 388  381   */
 389  382  extern  int     zonecfg_get_hostid(zone_dochandle_t, char *, size_t);
 390  383  extern  int     zonecfg_set_hostid(zone_dochandle_t, const char *);
 391  384  
 392  385  /*
 393  386   * Allowed FS mounts configuration.
 394  387   */
 395  388  extern int      zonecfg_get_fs_allowed(zone_dochandle_t, char *, size_t);
 396  389  extern int      zonecfg_set_fs_allowed(zone_dochandle_t, const char *);
 397  390  
 398  391  /*
 399  392   * Device configuration and rule matching.
 400  393   */
 401  394  extern  int     zonecfg_add_dev(zone_dochandle_t, struct zone_devtab *);
 402  395  extern  int     zonecfg_delete_dev(zone_dochandle_t, struct zone_devtab *);
 403  396  extern  int     zonecfg_modify_dev(zone_dochandle_t, struct zone_devtab *,
 404  397      struct zone_devtab *);
 405  398  extern  int     zonecfg_lookup_dev(zone_dochandle_t, struct zone_devtab *);
 406  399  
 407  400  /*
 408  401   * Resource control configuration.
 409  402   */
 410  403  extern  int     zonecfg_add_rctl(zone_dochandle_t, struct zone_rctltab *);
 411  404  extern  int     zonecfg_delete_rctl(zone_dochandle_t, struct zone_rctltab *);
 412  405  extern  int     zonecfg_modify_rctl(zone_dochandle_t, struct zone_rctltab *,
 413  406      struct zone_rctltab *);
 414  407  extern  int     zonecfg_lookup_rctl(zone_dochandle_t, struct zone_rctltab *);
 415  408  extern  int     zonecfg_add_rctl_value(struct zone_rctltab *,
 416  409      struct zone_rctlvaltab *);
 417  410  extern  int     zonecfg_remove_rctl_value(struct zone_rctltab *,
 418  411      struct zone_rctlvaltab *);
 419  412  extern  void    zonecfg_free_rctl_value_list(struct zone_rctlvaltab *);
 420  413  extern  boolean_t zonecfg_aliased_rctl_ok(zone_dochandle_t, char *);
 421  414  extern  int     zonecfg_set_aliased_rctl(zone_dochandle_t, char *, uint64_t);
 422  415  extern  int     zonecfg_get_aliased_rctl(zone_dochandle_t, char *, uint64_t *);
 423  416  extern  int     zonecfg_rm_aliased_rctl(zone_dochandle_t, char *);
 424  417  extern  int     zonecfg_apply_rctls(char *, zone_dochandle_t);
 425  418  
 426  419  /*
 427  420   * Generic attribute configuration and type/value extraction.
 428  421   */
 429  422  extern  int     zonecfg_add_attr(zone_dochandle_t, struct zone_attrtab *);
 430  423  extern  int     zonecfg_delete_attr(zone_dochandle_t, struct zone_attrtab *);
 431  424  extern  int     zonecfg_modify_attr(zone_dochandle_t, struct zone_attrtab *,
 432  425      struct zone_attrtab *);
 433  426  extern  int     zonecfg_lookup_attr(zone_dochandle_t, struct zone_attrtab *);
 434  427  extern  int     zonecfg_get_attr_boolean(const struct zone_attrtab *,
 435  428      boolean_t *);
 436  429  extern  int     zonecfg_get_attr_int(const struct zone_attrtab *, int64_t *);
 437  430  extern  int     zonecfg_get_attr_string(const struct zone_attrtab *, char *,
 438  431      size_t);
 439  432  extern  int     zonecfg_get_attr_uint(const struct zone_attrtab *, uint64_t *);
 440  433  
 441  434  /*
 442  435   * ZFS configuration.
 443  436   */
 444  437  extern  int     zonecfg_add_ds(zone_dochandle_t, struct zone_dstab *);
 445  438  extern  int     zonecfg_delete_ds(zone_dochandle_t, struct zone_dstab *);
 446  439  extern  int     zonecfg_modify_ds(zone_dochandle_t, struct zone_dstab *,
 447  440      struct zone_dstab *);
 448  441  extern  int     zonecfg_lookup_ds(zone_dochandle_t, struct zone_dstab *);
 449  442  
 450  443  /*
 451  444   * cpu-set configuration.
 452  445   */
 453  446  extern  int     zonecfg_add_pset(zone_dochandle_t, struct zone_psettab *);
 454  447  extern  int     zonecfg_delete_pset(zone_dochandle_t);
 455  448  extern  int     zonecfg_modify_pset(zone_dochandle_t, struct zone_psettab *);
 456  449  extern  int     zonecfg_lookup_pset(zone_dochandle_t, struct zone_psettab *);
 457  450  
 458  451  /*
 459  452   * Temporary pool support functions.
 460  453   */
 461  454  extern  int     zonecfg_destroy_tmp_pool(char *, char *, int);
 462  455  extern  int     zonecfg_bind_tmp_pool(zone_dochandle_t, zoneid_t, char *, int);
 463  456  extern  int     zonecfg_bind_pool(zone_dochandle_t, zoneid_t, char *, int);
 464  457  extern  boolean_t zonecfg_warn_poold(zone_dochandle_t);
 465  458  extern  int     zonecfg_get_poolname(zone_dochandle_t, char *, char *, size_t);
 466  459  
 467  460  /*
 468  461   * Miscellaneous utility functions.
 469  462   */
 470  463  extern  int     zonecfg_enable_rcapd(char *, int);
 471  464  
 472  465  /*
 473  466   * attach/detach support.
 474  467   */
 475  468  extern  int     zonecfg_get_attach_handle(const char *, const char *,
 476  469      const char *, boolean_t, zone_dochandle_t);
 477  470  extern  int     zonecfg_attach_manifest(int, zone_dochandle_t,
 478  471      zone_dochandle_t);
 479  472  extern  int     zonecfg_detach_save(zone_dochandle_t, uint_t);
 480  473  extern  boolean_t zonecfg_detached(const char *);
 481  474  extern  void    zonecfg_rm_detached(zone_dochandle_t, boolean_t forced);
 482  475  extern  int     zonecfg_dev_manifest(zone_dochandle_t);
 483  476  extern  int     zonecfg_devperms_apply(zone_dochandle_t, const char *,
 484  477      uid_t, gid_t, mode_t, const char *);
 485  478  extern  void    zonecfg_set_swinv(zone_dochandle_t);
 486  479  extern  int     zonecfg_add_pkg(zone_dochandle_t, char *, char *);
 487  480  
 488  481  /*
 489  482   * External zone verification support.
 490  483   */
 491  484  extern  int     zonecfg_verify_save(zone_dochandle_t, char *);
 492  485  
 493  486  /*
 494  487   * '*ent' iterator routines.
 495  488   */
 496  489  extern  int     zonecfg_setfsent(zone_dochandle_t);
 497  490  extern  int     zonecfg_getfsent(zone_dochandle_t, struct zone_fstab *);
 498  491  extern  int     zonecfg_endfsent(zone_dochandle_t);
 499  492  extern  int     zonecfg_setnwifent(zone_dochandle_t);
 500  493  extern  int     zonecfg_getnwifent(zone_dochandle_t, struct zone_nwiftab *);
 501  494  extern  int     zonecfg_endnwifent(zone_dochandle_t);
 502  495  extern  int     zonecfg_setdevent(zone_dochandle_t);
 503  496  extern  int     zonecfg_getdevent(zone_dochandle_t, struct zone_devtab *);
 504  497  extern  int     zonecfg_enddevent(zone_dochandle_t);
 505  498  extern  int     zonecfg_setattrent(zone_dochandle_t);
 506  499  extern  int     zonecfg_getattrent(zone_dochandle_t, struct zone_attrtab *);
 507  500  extern  int     zonecfg_endattrent(zone_dochandle_t);
 508  501  extern  int     zonecfg_setrctlent(zone_dochandle_t);
 509  502  extern  int     zonecfg_getrctlent(zone_dochandle_t, struct zone_rctltab *);
 510  503  extern  int     zonecfg_endrctlent(zone_dochandle_t);
 511  504  extern  int     zonecfg_setdsent(zone_dochandle_t);
 512  505  extern  int     zonecfg_getdsent(zone_dochandle_t, struct zone_dstab *);
 513  506  extern  int     zonecfg_enddsent(zone_dochandle_t);
 514  507  extern  int     zonecfg_getpsetent(zone_dochandle_t, struct zone_psettab *);
 515  508  extern  int     zonecfg_getpkgdata(zone_dochandle_t, uu_avl_pool_t *,
 516  509      uu_avl_t *);
 517  510  extern  int     zonecfg_setdevperment(zone_dochandle_t);
 518  511  extern  int     zonecfg_getdevperment(zone_dochandle_t,
 519  512      struct zone_devpermtab *);
 520  513  extern  int     zonecfg_enddevperment(zone_dochandle_t);
 521  514  extern  int     zonecfg_setadminent(zone_dochandle_t);
 522  515  extern  int     zonecfg_getadminent(zone_dochandle_t, struct zone_admintab *);
 523  516  extern  int     zonecfg_endadminent(zone_dochandle_t);
 524  517  
 525  518  /*
 526  519   * Privilege-related functions.
 527  520   */
 528  521  extern  int     zonecfg_default_privset(priv_set_t *, const char *);
 529  522  extern  int     zonecfg_get_privset(zone_dochandle_t, priv_set_t *,
 530  523      char **);
 531  524  extern  int     zonecfg_get_limitpriv(zone_dochandle_t, char **);
 532  525  extern  int     zonecfg_set_limitpriv(zone_dochandle_t, char *);
 533  526  
 534  527  /*
 535  528   * Higher-level routines.
 536  529   */
  
    | 
      ↓ open down ↓ | 
    205 lines elided | 
    
      ↑ open up ↑ | 
  
 537  530  extern  int     zone_get_brand(char *, char *, size_t);
 538  531  extern  zoneid_t zone_get_did(char *);
 539  532  extern  int     zone_get_rootpath(char *, char *, size_t);
 540  533  extern  int     zone_get_devroot(char *, char *, size_t);
 541  534  extern  int     zone_get_zonepath(char *, char *, size_t);
 542  535  extern  int     zone_get_state(char *, zone_state_t *);
 543  536  extern  int     zone_set_state(char *, zone_state_t);
 544  537  extern  char    *zone_state_str(zone_state_t);
 545  538  extern  int     zonecfg_get_name_by_uuid(const uuid_t, char *, size_t);
 546  539  extern  int     zonecfg_get_uuid(const char *, uuid_t);
 547      -extern  int     zonecfg_set_uuid(const char *, const char *, const char *);
 548  540  extern  int     zonecfg_default_brand(char *, size_t);
 549  541  extern  int     zonecfg_fix_obsolete(zone_dochandle_t);
 550  542  
 551  543  /*
 552  544   * Iterator for configured zones.
 553  545   */
 554  546  extern FILE             *setzoneent(void);
 555  547  extern char             *getzoneent(FILE *);
 556  548  extern struct zoneent   *getzoneent_private(FILE *);
 557  549  extern void             endzoneent(FILE *);
 558  550  
 559  551  /*
 560  552   * File-system-related convenience functions.
 561  553   */
 562  554  extern boolean_t zonecfg_valid_fs_type(const char *);
 563  555  
 564  556  /*
 565  557   * Network-related convenience functions.
 566  558   */
 567  559  extern boolean_t zonecfg_same_net_address(char *, char *);
 568  560  extern int zonecfg_valid_net_address(char *, struct lifreq *);
 569  561  extern boolean_t zonecfg_ifname_exists(sa_family_t, char *);
 570  562  
 571  563  /*
 572  564   * Rctl-related common functions.
 573  565   */
 574  566  extern boolean_t zonecfg_is_rctl(const char *);
 575  567  extern boolean_t zonecfg_valid_rctlname(const char *);
 576  568  extern boolean_t zonecfg_valid_rctlblk(const rctlblk_t *);
 577  569  extern boolean_t zonecfg_valid_rctl(const char *, const rctlblk_t *);
 578  570  extern int zonecfg_construct_rctlblk(const struct zone_rctlvaltab *,
 579  571      rctlblk_t *);
 580  572  
 581  573  /*
 582  574   * Live Upgrade support functions.  Shared between ON and install gate.
 583  575   */
 584  576  extern FILE *zonecfg_open_scratch(const char *, boolean_t);
 585  577  extern int zonecfg_lock_scratch(FILE *);
 586  578  extern void zonecfg_close_scratch(FILE *);
 587  579  extern int zonecfg_get_scratch(FILE *, char *, size_t, char *, size_t, char *,
 588  580      size_t);
 589  581  extern int zonecfg_find_scratch(FILE *, const char *, const char *, char *,
 590  582      size_t);
 591  583  extern int zonecfg_reverse_scratch(FILE *, const char *, char *, size_t,
 592  584      char *, size_t);
 593  585  extern int zonecfg_add_scratch(FILE *, const char *, const char *,
 594  586      const char *);
 595  587  extern int zonecfg_delete_scratch(FILE *, const char *);
 596  588  extern boolean_t zonecfg_is_scratch(const char *);
 597  589  
 598  590  /*
 599  591   * zoneadmd support functions.  Shared between zoneadm and brand hook code.
 600  592   */
 601  593  extern void zonecfg_init_lock_file(const char *, char **);
 602  594  extern void zonecfg_release_lock_file(const char *, int);
 603  595  extern int zonecfg_grab_lock_file(const char *, int *);
 604  596  extern boolean_t zonecfg_lock_file_held(int *);
 605  597  extern int zonecfg_ping_zoneadmd(const char *);
 606  598  extern int zonecfg_call_zoneadmd(const char *, zone_cmd_arg_t *, char *,
 607  599      boolean_t);
 608  600  extern int zonecfg_insert_userauths(zone_dochandle_t, char *, char *);
 609  601  extern int zonecfg_remove_userauths(zone_dochandle_t, char *, char *,
 610  602      boolean_t);
 611  603  extern int zonecfg_add_admin(zone_dochandle_t, struct zone_admintab *,
 612  604      char *);
 613  605  extern int zonecfg_delete_admin(zone_dochandle_t,
 614  606      struct zone_admintab *, char *);
 615  607  extern int zonecfg_modify_admin(zone_dochandle_t, struct zone_admintab *,
 616  608      struct zone_admintab *, char *);
 617  609  extern int zonecfg_delete_admins(zone_dochandle_t, char *);
 618  610  extern int zonecfg_lookup_admin(zone_dochandle_t, struct zone_admintab *);
 619  611  extern int zonecfg_authorize_users(zone_dochandle_t, char *);
 620  612  extern int zonecfg_update_userauths(zone_dochandle_t, char *);
 621  613  extern int zonecfg_deauthorize_user(zone_dochandle_t, char *, char *);
 622  614  extern int zonecfg_deauthorize_users(zone_dochandle_t, char *);
 623  615  extern boolean_t zonecfg_valid_auths(const char *, const char *);
 624  616  
 625  617  #ifdef __cplusplus
 626  618  }
 627  619  #endif
 628  620  
 629  621  #endif  /* _LIBZONECFG_H */
  
    | 
      ↓ open down ↓ | 
    72 lines elided | 
    
      ↑ open up ↑ | 
  
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX