{"issue":{"state":"open","pull_request":{"diff_url":null,"html_url":null,"patch_url":null},"user":{"avatar_url":"https://secure.gravatar.com/avatar/ba25dd7bae959c5e7fedceaf946c7d05?d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-140.png","gravatar_id":"ba25dd7bae959c5e7fedceaf946c7d05","url":"https://api.github.com/users/dajhorn","login":"dajhorn","id":494022},"milestone":null,"assignee":null,"updated_at":"2011-11-07T17:13:22Z","labels":[],"comments":1,"closed_at":null,"url":"https://api.github.com/repos/zfsonlinux/zfs/issues/438","body":"The man page says this about `zpool create`:\r\n\r\n\tCreates  a  new  storage  pool containing the virtual devices specified on the command\r\n\tline. The pool name must begin with a letter, and can only contain alphanumeric  char‐\r\n\tacters as well as underscore (\"_\"), dash (\"-\"), and period (\".\"). The pool names \"mir‐\r\n\tror\", \"raidz\", \"spare\" and \"log\" are reserved, as are names beginning with the pattern\r\n\t\"c[0-9]\". The vdev specification is described in the \"Virtual Devices\" section.\r\n\r\nHowever, a zpool can have a literal colon in its name like this:\r\n\r\n\t# zpool create zfs:foobar /dev/sdb\r\n\t# zpool list zfs:foobar\r\n\tNAME         SIZE  ALLOC   FREE    CAP  DEDUP  HEALTH  ALTROOT\r\n\tzfs:foobar  9.94G   108K  9.94G     0%  1.00x  ONLINE  -\r\n\t# zpool status zfs:foobar\r\n\t  pool: zfs:foobar\r\n\t state: ONLINE\r\n\t scan: none requested\r\n\tconfig:\r\n\t\r\n\t        NAME        STATE    READ WRITE CKSUM\r\n\t        zfs:foobar  ONLINE      0     0     0\r\n\t          sdb       ONLINE      0     0     0\r\n\r\nIs the man page incorrect?\r\n\r\nThis is somewhat problematic because the dracut scripts assume that `zfs:` is a safe prefix to use for overloading the `root=` kernel parameter.","html_url":"https://github.com/zfsonlinux/zfs/issues/438","title":"a literal colon in a zpool name is allowed, which contradicts the man page","number":438,"id":2159674,"created_at":"2011-11-07T04:35:03Z"},"action":"created","comment":{"user":{"avatar_url":"https://secure.gravatar.com/avatar/ea1f5fb7eefd51c5d308e2b78dbdf921?d=https://a248.e.akamai.net/assets.github.com%2Fimages%2Fgravatars%2Fgravatar-140.png","gravatar_id":"ea1f5fb7eefd51c5d308e2b78dbdf921","url":"https://api.github.com/users/behlendorf","login":"behlendorf","id":148917},"updated_at":"2011-11-07T17:13:22Z","url":"https://api.github.com/repos/zfsonlinux/zfs/issues/comments/2656292","body":"Yes, the man page is incorrect and should be fixed.  See zpool\\_name\\_valid()->pool\\_namecheck()->valid\\_char() in the source.  Allowed characters are `a-z`, `A-Z`, `0-9`, `-`, `_`, `.`, and `:`.  We can't really change this either since I'm sure there currently exist pool names which use the colon and removing it would break compatibility.  Perhaps we can update the dracut scripts.\r\n","id":2656292,"created_at":"2011-11-07T17:13:22Z"}}