docs/htmldocs/smbgroupedit.8.html

   1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
   2 <HTML
   3 ><HEAD
   4 ><TITLE
   5 >smbgroupedit</TITLE
   6 ><META
   7 NAME="GENERATOR"
   8 CONTENT="Modular DocBook HTML Stylesheet Version 1.77"></HEAD
   9 ><BODY
  10 CLASS="REFENTRY"
  11 BGCOLOR="#FFFFFF"
  12 TEXT="#000000"
  13 LINK="#0000FF"
  14 VLINK="#840084"
  15 ALINK="#0000FF"
  16 ><H1
  17 ><A
  18 NAME="SMBGROUPEDIT"
  19 ></A
  20 >smbgroupedit</H1
  21 ><DIV
  22 CLASS="REFNAMEDIV"
  23 ><A
  24 NAME="AEN5"
  25 ></A
  26 ><H2
  27 >Name</H2
  28 >smbgroupedit&nbsp;--&nbsp;Query/set/change UNIX - Windows NT group mapping</DIV
  29 ><DIV
  30 CLASS="REFSYNOPSISDIV"
  31 ><A
  32 NAME="AEN8"
  33 ></A
  34 ><H2
  35 >Synopsis</H2
  36 ><P
  37 ><B
  38 CLASS="COMMAND"
  39 >smbroupedit</B
  40 >  [-v [l|s]] [-a UNIX-groupname [-d NT-groupname|-p privilege|]]</P
  41 ></DIV
  42 ><DIV
  43 CLASS="REFSECT1"
  44 ><A
  45 NAME="AEN13"
  46 ></A
  47 ><H2
  48 >DESCRIPTION</H2
  49 ><P
  50 >This program is part of the <A
  51 HREF="samba.7.html"
  52 TARGET="_top"
  53 >Samba</A
  54 >
  55 suite.</P
  56 ><P
  57 >The  smbgroupedit  command  allows for mapping unix groups
  58 to NT Builtin, Domain, or Local groups.  Also
  59 allows setting privileges for that group, such as saAddUser,
  60 etc.</P
  61 ></DIV
  62 ><DIV
  63 CLASS="REFSECT1"
  64 ><A
  65 NAME="AEN18"
  66 ></A
  67 ><H2
  68 >OPTIONS</H2
  69 ><P
  70 ></P
  71 ><DIV
  72 CLASS="VARIABLELIST"
  73 ><DL
  74 ><DT
  75 >-v[l|s]</DT
  76 ><DD
  77 ><P
  78 >This option will list all groups available
  79                 in the Windows NT domain in which samba is operating.
  80                 </P
  81 ><P
  82 ></P
  83 ><DIV
  84 CLASS="VARIABLELIST"
  85 ><DL
  86 ><DT
  87 >-l</DT
  88 ><DD
  89 ><P
  90 >give a long listing, of the format:</P
  91 ><P
  92 ><PRE
  93 CLASS="PROGRAMLISTING"
  94 >"NT Group Name"
  95     SID            :
  96     Unix group     :
  97     Group type     :
  98     Comment        :
  99     Privilege      :</PRE
 100 ></P
 101 ><P
 102 >For examples,</P
 103 ><P
 104 ><PRE
 105 CLASS="PROGRAMLISTING"
 106 >Users
 107     SID       : S-1-5-32-545
 108     Unix group: -1
 109     Group type: Local group
 110     Comment   :
 111     Privilege : No privilege</PRE
 112 ></P
 113 ></DD
 114 ><DT
 115 >-s</DT
 116 ><DD
 117 ><P
 118 >display a short listing of the format:</P
 119 ><P
 120 ><PRE
 121 CLASS="PROGRAMLISTING"
 122 >NTGroupName(SID) -&#62; UnixGroupName</PRE
 123 ></P
 124 ><P
 125 >For example,</P
 126 ><P
 127 ><PRE
 128 CLASS="PROGRAMLISTING"
 129 >Users (S-1-5-32-545) -&#62; -1</PRE
 130 ></P
 131 ></DD
 132 ></DL
 133 ></DIV
 134 ></DD
 135 ></DL
 136 ></DIV
 137 ></DIV
 138 ><DIV
 139 CLASS="REFSECT1"
 140 ><A
 141 NAME="AEN44"
 142 ></A
 143 ><H2
 144 >FILES</H2
 145 ><P
 146 ></P
 147 ></DIV
 148 ><DIV
 149 CLASS="REFSECT1"
 150 ><A
 151 NAME="AEN47"
 152 ></A
 153 ><H2
 154 >EXIT STATUS</H2
 155 ><P
 156 ><B
 157 CLASS="COMMAND"
 158 >smbgroupedit</B
 159 > returns a status of 0 if the
 160 operation completed successfully, and a value of 1 in the event
 161 of a failure.</P
 162 ></DIV
 163 ><DIV
 164 CLASS="REFSECT1"
 165 ><A
 166 NAME="AEN51"
 167 ></A
 168 ><H2
 169 >EXAMPLES</H2
 170 ><P
 171 >To make a subset of your samba PDC users members of
 172 the 'Domain Admins'  Global group:</P
 173 ><P
 174 ></P
 175 ><OL
 176 TYPE="1"
 177 ><LI
 178 ><P
 179 >create a unix group (usually in
 180         <TT
 181 CLASS="FILENAME"
 182 >/etc/group</TT
 183 >), let's call it <TT
 184 CLASS="CONSTANT"
 185 >domadm</TT
 186 >.
 187         </P
 188 ></LI
 189 ><LI
 190 ><P
 191 >add to this group the users that you want to be
 192         domain administrators. For example if you want joe, john and mary,
 193         your entry in <TT
 194 CLASS="FILENAME"
 195 >/etc/group</TT
 196 > will look like:
 197         </P
 198 ><P
 199 >domadm:x:502:joe,john,mary</P
 200 ></LI
 201 ><LI
 202 ><P
 203 >map this domadm group to the 'domain admins' group:
 204         </P
 205 ><P
 206 ></P
 207 ><OL
 208 TYPE="a"
 209 ><LI
 210 ><P
 211 >Get the SID for the Windows NT "Domain Admins"
 212                 group:</P
 213 ><P
 214 ><PRE
 215 CLASS="PROGRAMLISTING"
 216 ><TT
 217 CLASS="PROMPT"
 218 >root# </TT
 219 ><B
 220 CLASS="COMMAND"
 221 >smbgroupedit -vs | grep "Domain Admins"</B
 222 >
 223 Domain Admins (S-1-5-21-1108995562-3116817432-1375597819-512) -&#62; -1</PRE
 224 ></P
 225 ></LI
 226 ><LI
 227 ><P
 228 >map the unix domadm group to the Windows NT
 229                 "Domain Admins" group, by running the command:
 230                 </P
 231 ><P
 232 ><PRE
 233 CLASS="PROGRAMLISTING"
 234 ><TT
 235 CLASS="PROMPT"
 236 >root# </TT
 237 ><B
 238 CLASS="COMMAND"
 239 >smbgroupedit \
 240 -c S-1-5-21-1108995562-3116817432-1375597819-512 \
 241 -u domadm</B
 242 ></PRE
 243 ></P
 244 ><P
 245 >               <SPAN
 246 CLASS="emphasis"
 247 ><I
 248 CLASS="EMPHASIS"
 249 >warning:</I
 250 ></SPAN
 251 > don't copy and paste this sample, the
 252                 Domain Admins SID (the S-1-5-21-...-512) is different for every PDC.
 253                 </P
 254 ></LI
 255 ></OL
 256 ></LI
 257 ></OL
 258 ><P
 259 >To verify that your mapping has taken effect:</P
 260 ><P
 261 ><PRE
 262 CLASS="PROGRAMLISTING"
 263 ><TT
 264 CLASS="PROMPT"
 265 >root# </TT
 266 ><B
 267 CLASS="COMMAND"
 268 >smbgroupedit -vs|grep "Domain Admins"</B
 269 >
 270 Domain Admins (S-1-5-21-1108995562-3116817432-1375597819-512) -&#62; domadm</PRE
 271 ></P
 272 ><P
 273 >To give access to a certain directory on a domain member machine (an
 274 NT/W2K or a samba server running winbind) to some users who are member
 275 of a group on your samba PDC, flag that group as a domain group:</P
 276 ><P
 277 ><PRE
 278 CLASS="PROGRAMLISTING"
 279 ><TT
 280 CLASS="PROMPT"
 281 >root# </TT
 282 ><B
 283 CLASS="COMMAND"
 284 >smbgroupedit -a unixgroup -td</B
 285 ></PRE
 286 ></P
 287 ></DIV
 288 ><DIV
 289 CLASS="REFSECT1"
 290 ><A
 291 NAME="AEN90"
 292 ></A
 293 ><H2
 294 >VERSION</H2
 295 ><P
 296 >This man page is correct for the 3.0alpha releases of
 297 the Samba suite.</P
 298 ></DIV
 299 ><DIV
 300 CLASS="REFSECT1"
 301 ><A
 302 NAME="AEN93"
 303 ></A
 304 ><H2
 305 >SEE ALSO</H2
 306 ><P
 307 ><A
 308 HREF="smb.conf.5.html"
 309 TARGET="_top"
 310 >smb.conf(5)</A
 311 ></P
 312 ></DIV
 313 ><DIV
 314 CLASS="REFSECT1"
 315 ><A
 316 NAME="AEN97"
 317 ></A
 318 ><H2
 319 >AUTHOR</H2
 320 ><P
 321 >The original Samba software and related utilities
 322 were created by Andrew Tridgell. Samba is now developed
 323 by the Samba Team as an Open Source project similar
 324 to the way the Linux kernel is developed.</P
 325 ><P
 326 ><B
 327 CLASS="COMMAND"
 328 >smbgroupedit</B
 329 > was written by Jean Francois Micouleau.
 330 The current set of manpages and documentation is maintained
 331 by the Samba Team in the same fashion as the Samba source code.</P
 332 ></DIV
 333 ></BODY
 334 ></HTML
 335 >