File size: 364,081 Bytes
18a519f | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 435 436 437 438 439 440 441 442 443 444 445 446 447 448 449 450 451 452 453 454 455 456 457 458 459 460 461 462 463 464 465 466 467 468 469 470 471 472 473 474 475 476 477 478 479 480 481 482 483 484 485 486 487 488 489 490 491 492 493 494 495 496 497 498 499 500 501 502 503 504 505 506 507 508 509 510 511 512 513 514 515 516 517 518 519 520 521 522 523 524 525 526 527 528 529 530 531 532 533 534 535 536 537 538 539 540 541 542 543 544 545 546 547 548 549 550 551 552 553 554 555 556 557 558 559 560 561 562 563 564 565 566 567 568 569 570 571 572 573 574 575 576 577 578 579 580 581 582 583 584 585 586 587 588 589 590 591 592 593 594 595 596 597 598 599 600 601 602 603 604 605 606 607 608 609 610 611 612 613 614 615 616 617 618 619 620 621 622 623 624 625 626 627 628 629 630 631 632 633 634 635 636 637 638 639 640 641 642 643 644 645 646 647 648 649 650 651 652 653 654 655 656 657 658 659 660 661 662 663 664 665 666 667 668 669 670 671 672 673 674 675 676 677 678 679 680 681 682 683 684 685 686 687 688 689 690 691 692 693 694 695 696 697 698 699 700 701 702 703 704 705 706 707 708 709 710 711 712 713 714 715 716 717 718 719 720 721 722 723 724 725 726 727 728 729 730 731 732 733 734 735 736 737 738 739 740 741 742 743 744 745 746 747 748 749 750 751 752 753 754 755 756 757 758 759 760 761 762 763 764 765 766 767 768 769 770 771 772 773 774 775 776 777 778 779 780 781 782 783 784 785 786 787 788 789 790 791 792 793 794 795 796 797 798 799 800 801 802 803 804 805 806 807 808 809 810 811 812 813 814 815 816 817 818 819 820 821 822 823 824 825 826 827 828 829 830 831 832 833 834 835 836 837 838 839 840 841 842 843 844 845 846 847 848 849 850 851 852 853 854 855 856 857 858 859 860 861 862 863 864 865 866 867 868 869 870 871 872 873 874 875 876 877 878 879 880 881 882 883 884 885 886 887 888 889 890 891 892 893 894 895 896 897 898 899 900 901 902 903 904 905 906 907 908 909 910 911 912 913 914 915 916 917 918 919 920 921 922 923 924 925 926 927 928 929 930 931 932 933 934 935 936 937 938 939 940 941 942 943 944 945 946 947 948 949 950 951 952 953 954 955 956 957 958 959 960 961 962 963 964 965 966 967 968 969 970 971 972 973 974 975 976 977 978 979 980 981 982 983 984 985 986 987 988 989 990 991 992 993 994 995 996 997 998 999 1000 1001 1002 1003 1004 1005 1006 1007 1008 1009 1010 1011 1012 1013 1014 1015 1016 1017 1018 1019 1020 1021 1022 1023 1024 1025 1026 1027 1028 1029 1030 1031 1032 1033 1034 1035 1036 1037 1038 1039 1040 1041 1042 1043 1044 1045 1046 1047 1048 1049 1050 1051 1052 1053 1054 1055 1056 1057 1058 1059 1060 1061 1062 1063 1064 1065 1066 1067 1068 1069 1070 1071 1072 1073 1074 1075 1076 1077 1078 1079 1080 1081 1082 1083 1084 1085 1086 1087 1088 1089 1090 1091 1092 1093 1094 1095 1096 1097 1098 1099 1100 1101 1102 1103 1104 1105 1106 1107 1108 1109 1110 1111 1112 1113 1114 1115 1116 1117 1118 1119 1120 1121 1122 1123 1124 1125 1126 1127 1128 1129 1130 1131 1132 1133 1134 1135 1136 1137 1138 1139 1140 1141 1142 1143 1144 1145 1146 1147 1148 1149 1150 1151 1152 1153 1154 1155 1156 1157 1158 1159 1160 1161 1162 1163 1164 1165 1166 1167 1168 1169 1170 1171 1172 1173 1174 1175 1176 1177 1178 1179 1180 1181 1182 1183 1184 1185 1186 1187 1188 1189 1190 1191 1192 1193 1194 1195 1196 1197 1198 1199 1200 1201 1202 1203 1204 1205 1206 1207 1208 1209 1210 1211 1212 1213 1214 1215 1216 1217 1218 1219 1220 1221 1222 1223 1224 1225 1226 1227 1228 1229 1230 1231 1232 1233 1234 1235 1236 1237 1238 1239 1240 1241 1242 1243 1244 1245 1246 1247 1248 1249 1250 1251 1252 1253 1254 1255 1256 1257 1258 1259 1260 1261 1262 1263 1264 1265 1266 1267 1268 1269 1270 1271 1272 1273 1274 1275 1276 1277 1278 1279 1280 1281 1282 1283 1284 1285 1286 1287 1288 1289 1290 1291 1292 1293 1294 1295 1296 1297 1298 1299 1300 1301 1302 1303 1304 1305 1306 1307 1308 1309 1310 1311 1312 1313 1314 1315 1316 1317 1318 1319 1320 1321 1322 1323 1324 1325 1326 1327 1328 1329 1330 1331 1332 1333 1334 1335 1336 1337 1338 1339 1340 1341 1342 1343 1344 1345 1346 1347 1348 1349 1350 1351 1352 1353 1354 1355 1356 1357 1358 1359 1360 1361 1362 1363 1364 1365 1366 1367 1368 1369 1370 1371 1372 1373 1374 1375 1376 1377 1378 1379 1380 1381 1382 1383 1384 1385 1386 1387 1388 1389 1390 1391 1392 1393 1394 1395 1396 1397 1398 1399 1400 1401 1402 1403 1404 1405 1406 1407 1408 1409 1410 1411 1412 1413 1414 1415 1416 1417 1418 1419 1420 1421 1422 1423 1424 1425 1426 1427 1428 1429 1430 1431 1432 1433 1434 1435 1436 1437 1438 1439 1440 1441 1442 1443 1444 1445 1446 1447 1448 1449 1450 1451 1452 1453 1454 1455 1456 1457 1458 1459 1460 1461 1462 1463 1464 1465 1466 1467 1468 1469 1470 1471 1472 1473 1474 1475 1476 1477 1478 1479 1480 1481 1482 1483 1484 1485 1486 1487 1488 1489 1490 1491 1492 1493 1494 1495 1496 1497 1498 1499 1500 1501 1502 1503 1504 1505 1506 1507 1508 1509 1510 1511 1512 1513 1514 1515 1516 1517 1518 1519 1520 1521 1522 1523 1524 1525 1526 1527 1528 1529 1530 1531 1532 1533 1534 1535 1536 1537 1538 1539 1540 1541 1542 1543 1544 1545 1546 1547 1548 1549 1550 1551 1552 1553 1554 1555 1556 1557 1558 1559 1560 1561 1562 1563 1564 1565 1566 1567 1568 1569 1570 1571 1572 1573 1574 1575 1576 1577 1578 1579 1580 1581 1582 1583 1584 1585 1586 1587 1588 1589 1590 1591 1592 1593 1594 1595 1596 1597 1598 1599 1600 1601 1602 1603 1604 1605 1606 1607 1608 1609 1610 1611 1612 1613 1614 1615 1616 1617 1618 1619 1620 1621 1622 1623 1624 1625 1626 1627 1628 1629 1630 1631 1632 1633 1634 1635 1636 1637 1638 1639 1640 1641 1642 1643 1644 1645 1646 1647 1648 1649 1650 1651 1652 1653 1654 1655 1656 1657 1658 1659 1660 1661 1662 1663 1664 1665 1666 1667 1668 1669 1670 1671 1672 1673 1674 1675 1676 1677 1678 1679 1680 1681 1682 1683 1684 1685 1686 1687 1688 1689 1690 1691 1692 1693 1694 1695 1696 1697 1698 1699 1700 1701 1702 1703 1704 1705 1706 1707 1708 1709 1710 1711 1712 1713 1714 1715 1716 1717 1718 1719 1720 1721 1722 1723 1724 1725 1726 1727 1728 1729 1730 1731 1732 1733 1734 1735 1736 1737 1738 1739 1740 1741 1742 1743 1744 1745 1746 1747 1748 1749 1750 1751 1752 1753 1754 1755 1756 1757 1758 1759 1760 1761 1762 1763 1764 1765 1766 1767 1768 1769 1770 1771 1772 1773 1774 1775 1776 1777 1778 1779 1780 1781 1782 1783 1784 1785 1786 1787 1788 1789 1790 1791 1792 1793 1794 1795 1796 1797 1798 1799 1800 1801 1802 1803 1804 1805 1806 1807 1808 1809 1810 1811 1812 1813 1814 1815 1816 1817 1818 1819 1820 1821 1822 1823 1824 1825 1826 1827 1828 1829 1830 1831 1832 1833 1834 1835 1836 1837 1838 1839 1840 1841 1842 1843 1844 1845 1846 1847 1848 1849 1850 1851 1852 1853 1854 1855 1856 1857 1858 1859 1860 1861 1862 1863 1864 1865 1866 1867 1868 1869 1870 1871 1872 1873 1874 1875 1876 1877 1878 1879 1880 1881 1882 1883 1884 1885 1886 1887 1888 1889 1890 1891 1892 1893 1894 1895 1896 1897 1898 1899 1900 1901 1902 1903 1904 1905 1906 1907 1908 1909 1910 1911 1912 1913 1914 1915 1916 1917 1918 1919 1920 1921 1922 1923 1924 1925 1926 1927 1928 1929 1930 1931 1932 1933 1934 1935 1936 1937 1938 1939 1940 1941 1942 1943 1944 1945 1946 1947 1948 1949 1950 1951 1952 1953 1954 1955 1956 1957 1958 1959 1960 1961 1962 1963 1964 1965 1966 1967 1968 1969 1970 1971 1972 1973 1974 1975 1976 1977 1978 1979 1980 1981 1982 1983 1984 1985 1986 1987 1988 1989 1990 1991 1992 1993 1994 1995 1996 1997 1998 1999 2000 2001 2002 2003 2004 2005 2006 2007 2008 2009 2010 2011 2012 2013 2014 2015 2016 2017 2018 2019 2020 2021 2022 2023 2024 2025 2026 2027 2028 2029 2030 2031 2032 2033 2034 2035 2036 2037 2038 2039 2040 2041 2042 2043 2044 2045 2046 2047 2048 2049 2050 2051 2052 2053 2054 2055 2056 2057 2058 2059 2060 2061 2062 2063 2064 2065 2066 2067 2068 2069 2070 2071 2072 2073 2074 2075 2076 2077 2078 2079 2080 2081 2082 2083 2084 2085 2086 2087 2088 2089 2090 2091 2092 2093 2094 2095 2096 2097 2098 2099 2100 2101 2102 2103 2104 2105 2106 2107 2108 2109 2110 2111 2112 2113 2114 2115 2116 2117 2118 2119 2120 2121 2122 2123 2124 2125 2126 2127 2128 2129 2130 2131 2132 2133 2134 2135 2136 2137 2138 2139 2140 2141 2142 2143 2144 2145 2146 2147 2148 2149 2150 2151 2152 2153 2154 2155 2156 2157 2158 2159 2160 2161 2162 2163 2164 2165 2166 2167 2168 2169 2170 2171 2172 2173 2174 2175 2176 2177 2178 2179 2180 2181 2182 2183 2184 2185 2186 2187 2188 2189 2190 2191 2192 2193 2194 2195 2196 2197 2198 2199 2200 2201 2202 2203 2204 2205 2206 2207 2208 2209 2210 2211 2212 2213 2214 2215 2216 2217 2218 2219 2220 2221 2222 2223 2224 2225 2226 2227 2228 2229 2230 2231 2232 2233 2234 2235 2236 2237 2238 2239 2240 2241 2242 2243 2244 2245 2246 2247 2248 2249 2250 2251 2252 2253 2254 2255 2256 2257 2258 2259 2260 2261 2262 2263 2264 2265 2266 2267 2268 2269 2270 2271 2272 2273 2274 2275 2276 2277 2278 2279 2280 2281 2282 2283 2284 2285 2286 2287 2288 2289 2290 2291 2292 2293 2294 2295 2296 2297 2298 2299 2300 2301 2302 2303 2304 2305 2306 2307 2308 2309 2310 2311 2312 2313 2314 2315 2316 2317 2318 2319 2320 2321 2322 2323 2324 2325 2326 2327 2328 2329 2330 2331 2332 2333 2334 2335 2336 2337 2338 2339 2340 2341 2342 2343 2344 2345 2346 2347 2348 2349 2350 2351 2352 2353 2354 2355 2356 2357 2358 2359 2360 2361 2362 2363 2364 2365 2366 2367 2368 2369 2370 2371 2372 2373 2374 2375 2376 2377 2378 2379 2380 2381 2382 2383 2384 2385 2386 2387 2388 2389 2390 2391 2392 2393 2394 2395 2396 2397 2398 2399 2400 2401 2402 2403 2404 2405 2406 2407 2408 2409 2410 2411 2412 2413 2414 2415 2416 2417 2418 2419 2420 2421 2422 2423 2424 2425 2426 2427 2428 2429 2430 2431 2432 2433 2434 2435 2436 2437 2438 2439 2440 2441 2442 2443 2444 2445 2446 2447 2448 2449 2450 2451 2452 2453 2454 2455 2456 2457 2458 2459 2460 2461 2462 2463 2464 2465 2466 2467 2468 2469 2470 2471 2472 2473 2474 2475 2476 2477 2478 2479 2480 2481 2482 2483 2484 2485 2486 2487 2488 2489 2490 2491 2492 2493 2494 2495 2496 2497 2498 2499 2500 2501 2502 2503 2504 2505 2506 2507 2508 2509 2510 2511 2512 2513 2514 2515 2516 2517 2518 2519 2520 2521 2522 2523 2524 2525 2526 2527 2528 2529 2530 2531 2532 2533 2534 2535 2536 2537 2538 2539 2540 2541 2542 2543 2544 2545 2546 2547 2548 2549 2550 2551 2552 2553 2554 2555 2556 2557 2558 2559 2560 2561 2562 2563 2564 2565 2566 2567 2568 2569 2570 2571 2572 2573 2574 2575 2576 2577 2578 2579 2580 2581 2582 2583 2584 2585 2586 2587 2588 2589 2590 2591 2592 2593 2594 2595 2596 2597 2598 2599 2600 2601 2602 2603 2604 2605 2606 2607 2608 2609 2610 2611 2612 2613 2614 2615 2616 2617 2618 2619 2620 2621 2622 2623 2624 2625 2626 2627 2628 2629 2630 2631 2632 2633 2634 2635 2636 2637 2638 2639 2640 2641 2642 2643 2644 2645 2646 2647 2648 2649 2650 2651 2652 2653 2654 2655 2656 2657 2658 2659 2660 2661 2662 2663 2664 2665 2666 2667 2668 2669 2670 2671 2672 2673 2674 2675 2676 2677 2678 2679 2680 2681 2682 2683 2684 2685 2686 2687 2688 2689 2690 2691 2692 2693 2694 2695 2696 2697 2698 2699 2700 2701 2702 2703 2704 2705 2706 2707 2708 2709 2710 2711 2712 2713 2714 2715 2716 2717 2718 2719 2720 2721 2722 2723 2724 2725 2726 2727 2728 2729 2730 2731 2732 2733 2734 2735 2736 2737 2738 2739 2740 2741 2742 2743 2744 2745 2746 2747 2748 2749 2750 2751 2752 2753 2754 2755 2756 2757 2758 2759 2760 2761 2762 2763 2764 2765 2766 2767 2768 2769 2770 2771 2772 2773 2774 2775 2776 2777 2778 2779 2780 2781 2782 2783 2784 2785 2786 2787 2788 2789 2790 2791 2792 2793 2794 2795 2796 2797 2798 2799 2800 2801 2802 2803 2804 2805 2806 2807 2808 2809 2810 2811 2812 2813 2814 2815 2816 2817 2818 2819 2820 2821 2822 2823 2824 2825 2826 2827 2828 2829 2830 2831 2832 2833 2834 2835 2836 2837 2838 2839 2840 2841 2842 2843 2844 2845 2846 2847 2848 2849 2850 2851 2852 2853 2854 2855 2856 2857 2858 2859 2860 2861 2862 2863 2864 2865 2866 2867 2868 2869 2870 2871 2872 2873 2874 2875 2876 2877 2878 2879 2880 2881 2882 2883 2884 2885 2886 2887 2888 2889 2890 2891 2892 2893 2894 2895 2896 2897 2898 2899 2900 2901 2902 2903 2904 2905 2906 2907 2908 2909 2910 2911 2912 2913 2914 2915 2916 2917 2918 2919 2920 2921 2922 2923 2924 2925 2926 2927 2928 2929 2930 2931 2932 2933 2934 2935 2936 2937 2938 2939 2940 2941 2942 2943 2944 2945 2946 2947 2948 2949 2950 2951 2952 2953 2954 2955 2956 2957 2958 2959 2960 2961 2962 2963 2964 2965 2966 2967 2968 2969 2970 2971 2972 2973 2974 2975 2976 2977 2978 2979 2980 2981 2982 2983 2984 2985 2986 2987 2988 2989 2990 2991 2992 2993 2994 2995 2996 2997 2998 2999 3000 3001 3002 3003 3004 3005 3006 3007 3008 3009 3010 3011 3012 3013 3014 3015 3016 3017 3018 3019 3020 3021 3022 3023 3024 3025 3026 3027 3028 3029 3030 3031 3032 3033 3034 3035 3036 3037 3038 3039 3040 3041 3042 3043 3044 3045 3046 3047 3048 3049 3050 3051 3052 3053 3054 3055 3056 3057 3058 3059 3060 3061 3062 3063 3064 3065 3066 3067 3068 3069 3070 3071 3072 3073 3074 3075 3076 3077 3078 3079 3080 3081 3082 3083 3084 3085 3086 3087 3088 3089 3090 3091 3092 3093 3094 3095 3096 3097 3098 3099 3100 3101 3102 3103 3104 3105 3106 3107 3108 3109 3110 3111 3112 3113 3114 3115 3116 3117 3118 3119 3120 3121 3122 3123 3124 3125 3126 3127 3128 3129 3130 3131 3132 3133 3134 3135 3136 3137 3138 3139 3140 3141 3142 3143 3144 3145 3146 3147 3148 3149 3150 3151 3152 3153 3154 3155 3156 3157 3158 3159 3160 3161 3162 3163 3164 3165 3166 3167 3168 3169 3170 3171 3172 3173 3174 3175 3176 3177 3178 3179 3180 3181 3182 3183 3184 3185 3186 3187 3188 3189 3190 3191 3192 3193 3194 3195 3196 3197 3198 3199 3200 3201 3202 3203 3204 3205 3206 3207 3208 3209 3210 3211 3212 3213 3214 3215 3216 3217 3218 3219 3220 3221 3222 3223 3224 3225 3226 3227 3228 3229 3230 3231 3232 3233 3234 3235 3236 3237 3238 3239 3240 3241 3242 3243 3244 3245 3246 3247 3248 3249 3250 3251 3252 3253 3254 3255 3256 3257 3258 3259 3260 3261 3262 3263 3264 3265 3266 3267 3268 3269 3270 3271 3272 3273 3274 3275 3276 3277 3278 3279 3280 3281 3282 3283 3284 3285 3286 3287 3288 3289 3290 3291 3292 3293 3294 3295 3296 3297 3298 3299 3300 3301 3302 3303 3304 3305 3306 3307 3308 3309 3310 3311 3312 3313 3314 3315 3316 3317 3318 3319 3320 3321 3322 3323 3324 3325 3326 3327 3328 3329 3330 3331 3332 3333 3334 3335 3336 3337 3338 3339 3340 3341 3342 3343 3344 3345 3346 3347 3348 3349 3350 3351 3352 3353 3354 3355 3356 3357 3358 3359 3360 3361 3362 3363 3364 3365 3366 3367 3368 3369 3370 3371 3372 3373 3374 3375 3376 3377 3378 3379 3380 3381 3382 3383 3384 3385 3386 3387 3388 3389 3390 3391 3392 3393 3394 3395 3396 3397 3398 3399 3400 3401 3402 3403 3404 3405 3406 3407 3408 3409 3410 3411 3412 3413 3414 3415 3416 3417 3418 3419 3420 3421 3422 3423 3424 3425 3426 3427 3428 3429 3430 3431 3432 3433 3434 3435 3436 3437 3438 3439 3440 3441 3442 3443 3444 3445 3446 3447 3448 3449 3450 3451 3452 3453 3454 3455 3456 3457 3458 3459 3460 3461 3462 3463 3464 3465 3466 3467 3468 3469 3470 3471 3472 3473 3474 3475 3476 3477 3478 3479 3480 3481 3482 3483 3484 3485 3486 3487 3488 3489 3490 3491 3492 3493 3494 3495 3496 3497 3498 3499 3500 3501 3502 3503 3504 3505 3506 3507 3508 3509 3510 3511 3512 3513 3514 3515 3516 3517 3518 3519 3520 3521 3522 3523 3524 3525 3526 3527 3528 3529 3530 3531 3532 3533 3534 3535 3536 3537 3538 3539 3540 3541 3542 3543 3544 3545 3546 3547 3548 3549 3550 3551 3552 3553 3554 3555 3556 3557 3558 3559 3560 3561 3562 3563 3564 3565 3566 3567 3568 3569 3570 3571 3572 3573 3574 3575 3576 3577 3578 3579 3580 3581 3582 3583 3584 3585 3586 3587 3588 3589 3590 3591 3592 3593 3594 3595 3596 3597 3598 3599 3600 3601 3602 3603 3604 3605 3606 3607 3608 3609 3610 3611 3612 3613 3614 3615 3616 3617 3618 3619 3620 3621 3622 3623 3624 3625 3626 3627 3628 3629 3630 3631 3632 3633 3634 3635 3636 3637 3638 3639 3640 3641 3642 3643 3644 3645 3646 3647 3648 3649 3650 3651 3652 3653 3654 3655 3656 3657 3658 3659 3660 3661 3662 3663 3664 3665 3666 3667 3668 3669 3670 3671 3672 3673 3674 3675 3676 3677 3678 3679 3680 3681 3682 3683 3684 3685 3686 3687 3688 3689 3690 3691 3692 3693 3694 3695 3696 3697 3698 3699 3700 3701 3702 3703 3704 3705 3706 3707 3708 3709 3710 3711 3712 3713 3714 3715 3716 3717 3718 3719 3720 3721 3722 3723 3724 3725 3726 3727 3728 3729 3730 3731 3732 3733 3734 3735 3736 3737 3738 3739 3740 3741 3742 3743 3744 3745 3746 3747 3748 3749 3750 3751 3752 3753 3754 3755 3756 3757 3758 3759 3760 3761 3762 3763 3764 3765 3766 3767 3768 3769 3770 3771 3772 3773 3774 3775 3776 3777 3778 3779 3780 3781 3782 3783 3784 3785 3786 3787 3788 3789 3790 3791 3792 3793 3794 3795 3796 3797 3798 3799 3800 3801 3802 3803 3804 3805 3806 3807 3808 3809 3810 3811 3812 3813 3814 3815 3816 3817 3818 3819 3820 3821 3822 3823 3824 3825 3826 3827 3828 3829 3830 3831 3832 3833 3834 3835 3836 3837 3838 3839 3840 3841 3842 3843 3844 3845 3846 3847 3848 3849 3850 3851 3852 3853 3854 3855 3856 3857 3858 3859 3860 3861 3862 3863 3864 3865 3866 3867 3868 3869 3870 3871 3872 3873 3874 3875 3876 3877 3878 3879 3880 3881 3882 3883 3884 3885 3886 3887 3888 3889 3890 3891 3892 3893 3894 3895 3896 3897 3898 3899 3900 3901 3902 3903 3904 3905 3906 3907 3908 3909 3910 3911 3912 3913 3914 3915 3916 3917 3918 3919 3920 3921 3922 3923 3924 3925 3926 3927 3928 3929 3930 3931 3932 3933 3934 3935 3936 3937 3938 3939 3940 3941 3942 3943 3944 3945 3946 3947 3948 3949 3950 3951 3952 3953 3954 3955 3956 3957 3958 3959 3960 3961 3962 3963 3964 3965 3966 3967 3968 3969 3970 3971 3972 3973 3974 3975 3976 3977 3978 3979 3980 3981 3982 3983 3984 3985 3986 3987 3988 3989 3990 3991 3992 3993 3994 3995 3996 3997 3998 3999 4000 4001 4002 4003 4004 4005 4006 4007 4008 4009 4010 4011 4012 4013 4014 4015 4016 4017 4018 4019 4020 4021 4022 4023 4024 4025 4026 4027 4028 4029 4030 4031 4032 4033 4034 4035 4036 4037 4038 4039 4040 4041 4042 4043 4044 4045 4046 4047 4048 4049 4050 4051 4052 4053 4054 4055 4056 4057 4058 4059 4060 4061 4062 4063 4064 4065 4066 4067 4068 4069 4070 4071 4072 4073 4074 4075 4076 4077 4078 4079 4080 4081 4082 4083 4084 4085 4086 4087 4088 4089 4090 4091 4092 4093 4094 4095 4096 4097 4098 4099 4100 4101 4102 4103 4104 4105 4106 4107 4108 4109 4110 4111 4112 4113 4114 4115 4116 4117 4118 4119 4120 4121 4122 4123 4124 4125 4126 4127 4128 4129 4130 4131 4132 4133 4134 4135 4136 4137 4138 4139 4140 4141 4142 4143 4144 4145 4146 4147 4148 4149 4150 4151 4152 4153 4154 4155 4156 4157 4158 4159 4160 4161 4162 4163 4164 4165 4166 4167 4168 4169 4170 4171 4172 4173 4174 4175 4176 4177 4178 4179 4180 4181 4182 4183 4184 4185 4186 4187 4188 4189 4190 4191 4192 4193 4194 4195 4196 4197 4198 4199 4200 4201 4202 4203 4204 4205 4206 4207 4208 4209 4210 4211 4212 4213 4214 4215 4216 4217 4218 4219 4220 4221 4222 4223 4224 4225 4226 4227 4228 4229 4230 4231 4232 4233 4234 4235 4236 4237 4238 4239 4240 4241 4242 4243 4244 4245 4246 4247 4248 4249 4250 4251 4252 4253 4254 4255 4256 4257 4258 4259 4260 4261 4262 4263 4264 4265 4266 4267 4268 4269 4270 4271 4272 4273 4274 4275 4276 4277 4278 4279 4280 4281 4282 4283 4284 4285 4286 4287 4288 4289 4290 4291 4292 4293 4294 4295 4296 4297 4298 4299 4300 4301 4302 4303 4304 4305 4306 4307 4308 4309 4310 4311 4312 4313 4314 4315 4316 4317 4318 4319 4320 4321 4322 4323 4324 4325 4326 4327 4328 4329 4330 4331 4332 4333 4334 4335 4336 4337 4338 4339 4340 4341 4342 4343 4344 4345 4346 4347 4348 4349 4350 4351 4352 4353 4354 4355 4356 4357 4358 4359 4360 4361 4362 4363 4364 4365 4366 4367 4368 4369 4370 4371 4372 4373 4374 4375 4376 4377 4378 4379 4380 4381 4382 4383 4384 4385 4386 4387 4388 4389 4390 4391 4392 4393 4394 4395 4396 4397 4398 4399 4400 4401 4402 4403 4404 4405 4406 4407 4408 4409 4410 4411 4412 4413 4414 4415 4416 4417 4418 4419 4420 4421 4422 4423 4424 4425 4426 4427 4428 4429 4430 4431 4432 4433 4434 4435 4436 4437 4438 4439 4440 4441 4442 4443 4444 4445 4446 4447 4448 4449 4450 4451 4452 4453 4454 4455 4456 4457 4458 4459 4460 4461 4462 4463 4464 4465 4466 4467 4468 4469 4470 4471 4472 4473 4474 4475 4476 4477 4478 4479 4480 4481 4482 4483 4484 4485 4486 4487 4488 4489 4490 4491 4492 4493 4494 4495 4496 4497 4498 4499 4500 4501 4502 4503 4504 4505 4506 4507 4508 4509 4510 4511 4512 4513 4514 4515 4516 4517 4518 4519 4520 4521 4522 4523 4524 4525 4526 4527 4528 4529 4530 4531 4532 4533 4534 4535 4536 4537 4538 4539 4540 4541 4542 4543 4544 4545 4546 4547 4548 4549 4550 4551 4552 4553 4554 4555 4556 4557 4558 4559 4560 4561 4562 4563 4564 4565 4566 4567 4568 4569 4570 4571 4572 4573 4574 4575 4576 4577 4578 4579 4580 4581 4582 4583 4584 4585 4586 4587 4588 4589 4590 4591 4592 4593 4594 4595 4596 4597 4598 4599 4600 4601 4602 4603 4604 4605 4606 4607 4608 4609 4610 4611 4612 4613 4614 4615 4616 4617 4618 4619 4620 4621 4622 4623 4624 4625 4626 4627 4628 4629 4630 4631 4632 4633 4634 4635 4636 4637 4638 4639 4640 4641 4642 4643 4644 4645 4646 4647 4648 4649 4650 4651 4652 4653 4654 4655 4656 4657 4658 4659 4660 4661 4662 4663 4664 4665 4666 4667 4668 4669 4670 4671 4672 4673 4674 4675 4676 4677 4678 4679 4680 4681 4682 4683 4684 4685 4686 4687 4688 4689 4690 4691 4692 4693 4694 4695 4696 4697 4698 4699 4700 4701 4702 4703 4704 4705 4706 4707 4708 4709 4710 4711 4712 4713 4714 4715 4716 4717 4718 4719 4720 4721 4722 4723 4724 4725 4726 4727 4728 4729 4730 4731 4732 4733 4734 4735 4736 4737 4738 4739 4740 4741 4742 4743 4744 4745 4746 4747 4748 4749 4750 4751 4752 4753 4754 4755 4756 4757 4758 4759 4760 4761 4762 4763 4764 4765 4766 4767 4768 4769 4770 4771 4772 4773 4774 4775 4776 4777 4778 4779 4780 4781 4782 4783 4784 4785 4786 4787 4788 4789 4790 4791 4792 4793 4794 4795 4796 4797 4798 4799 4800 4801 4802 4803 4804 4805 4806 4807 4808 4809 4810 4811 4812 4813 4814 4815 4816 4817 4818 4819 4820 4821 4822 4823 4824 4825 4826 4827 4828 4829 4830 4831 4832 4833 4834 4835 4836 4837 4838 4839 4840 4841 4842 4843 4844 4845 4846 4847 4848 4849 4850 4851 4852 4853 4854 4855 4856 4857 4858 4859 4860 4861 4862 4863 4864 4865 4866 4867 4868 4869 4870 4871 4872 4873 4874 4875 4876 4877 4878 4879 4880 4881 4882 4883 4884 4885 4886 4887 4888 4889 4890 4891 4892 4893 4894 4895 4896 4897 4898 4899 4900 4901 4902 4903 4904 4905 4906 4907 4908 4909 4910 4911 4912 4913 4914 4915 4916 4917 4918 4919 4920 4921 4922 4923 4924 4925 4926 4927 4928 4929 4930 4931 4932 4933 4934 4935 4936 4937 4938 4939 4940 4941 4942 4943 4944 4945 4946 4947 4948 4949 4950 4951 4952 4953 4954 4955 4956 4957 4958 4959 4960 4961 4962 4963 4964 4965 4966 4967 4968 4969 4970 4971 4972 4973 4974 4975 4976 4977 4978 4979 4980 4981 4982 4983 4984 4985 4986 4987 4988 4989 4990 4991 4992 4993 4994 4995 4996 4997 4998 4999 5000 5001 5002 5003 5004 5005 5006 5007 5008 5009 5010 5011 5012 5013 5014 5015 5016 5017 5018 5019 5020 5021 5022 5023 5024 5025 5026 5027 5028 5029 5030 5031 5032 5033 5034 5035 5036 5037 5038 5039 5040 5041 5042 5043 5044 5045 5046 5047 5048 5049 5050 5051 5052 5053 5054 5055 5056 5057 5058 5059 5060 5061 5062 5063 5064 5065 5066 5067 5068 5069 5070 5071 5072 5073 5074 5075 5076 5077 5078 5079 5080 5081 5082 5083 5084 5085 5086 5087 5088 5089 5090 5091 5092 5093 5094 5095 5096 5097 5098 5099 5100 5101 5102 5103 5104 5105 5106 5107 5108 5109 5110 5111 5112 5113 5114 5115 5116 5117 5118 5119 5120 5121 5122 5123 5124 5125 5126 5127 5128 5129 5130 5131 5132 5133 5134 5135 5136 5137 5138 5139 5140 5141 5142 5143 5144 5145 5146 5147 5148 5149 5150 5151 5152 5153 5154 5155 5156 5157 5158 5159 5160 5161 5162 5163 5164 5165 5166 5167 5168 5169 5170 5171 5172 5173 5174 5175 5176 5177 5178 5179 5180 5181 5182 5183 5184 5185 5186 5187 5188 5189 5190 5191 5192 5193 5194 5195 5196 5197 5198 5199 5200 5201 5202 5203 5204 5205 5206 5207 5208 5209 5210 5211 5212 5213 5214 5215 5216 5217 5218 5219 5220 5221 5222 5223 5224 5225 5226 5227 5228 5229 5230 5231 5232 5233 5234 5235 5236 5237 5238 5239 5240 5241 5242 5243 5244 5245 5246 5247 5248 5249 5250 5251 5252 5253 5254 5255 5256 5257 5258 5259 5260 5261 5262 5263 5264 5265 5266 5267 5268 5269 5270 5271 5272 5273 5274 5275 5276 5277 5278 5279 5280 5281 5282 5283 5284 5285 5286 5287 5288 5289 5290 5291 5292 5293 5294 5295 5296 5297 5298 5299 5300 5301 5302 5303 5304 5305 5306 5307 5308 5309 5310 5311 5312 5313 5314 5315 5316 5317 5318 5319 5320 5321 5322 5323 5324 5325 5326 5327 5328 5329 5330 5331 5332 5333 5334 5335 5336 5337 5338 5339 5340 5341 5342 5343 5344 5345 5346 5347 5348 5349 5350 5351 5352 5353 5354 5355 5356 5357 5358 5359 5360 5361 5362 5363 5364 5365 5366 5367 5368 5369 5370 5371 5372 5373 5374 5375 5376 5377 5378 5379 5380 5381 5382 5383 5384 5385 5386 5387 5388 5389 5390 5391 5392 5393 5394 5395 5396 5397 5398 5399 5400 5401 5402 5403 5404 5405 5406 5407 5408 5409 5410 5411 5412 5413 5414 5415 5416 5417 5418 5419 5420 5421 5422 5423 5424 5425 5426 5427 5428 5429 5430 5431 5432 5433 5434 5435 5436 5437 5438 5439 5440 5441 5442 5443 5444 5445 5446 5447 5448 5449 5450 5451 5452 5453 5454 5455 5456 5457 5458 5459 5460 5461 5462 5463 5464 5465 5466 5467 5468 5469 5470 5471 5472 5473 5474 5475 5476 5477 5478 5479 5480 5481 5482 5483 5484 5485 5486 5487 5488 5489 5490 5491 5492 5493 5494 5495 5496 5497 5498 5499 5500 5501 5502 5503 5504 5505 5506 5507 5508 5509 5510 5511 5512 5513 5514 5515 5516 5517 5518 5519 5520 5521 5522 5523 5524 5525 5526 5527 5528 5529 5530 5531 5532 5533 5534 5535 5536 5537 5538 5539 5540 5541 5542 5543 5544 5545 5546 5547 5548 5549 5550 5551 5552 5553 5554 5555 5556 5557 5558 5559 5560 5561 5562 5563 5564 5565 5566 5567 5568 5569 5570 5571 5572 5573 5574 5575 5576 5577 5578 5579 5580 5581 5582 5583 5584 5585 5586 5587 5588 5589 5590 5591 5592 5593 5594 5595 5596 5597 5598 5599 5600 5601 5602 5603 5604 5605 5606 5607 5608 5609 5610 5611 5612 5613 5614 5615 5616 5617 5618 5619 5620 5621 5622 5623 5624 5625 5626 5627 5628 5629 5630 5631 5632 5633 5634 5635 5636 5637 5638 5639 5640 5641 5642 5643 5644 5645 5646 5647 5648 5649 5650 5651 5652 5653 5654 5655 5656 5657 5658 5659 5660 5661 5662 5663 5664 5665 5666 5667 5668 5669 5670 5671 5672 5673 5674 5675 5676 5677 5678 5679 5680 5681 5682 5683 5684 5685 5686 5687 5688 5689 5690 5691 5692 5693 5694 5695 5696 5697 5698 5699 5700 5701 5702 5703 5704 5705 5706 5707 5708 5709 5710 5711 5712 5713 5714 5715 5716 5717 5718 5719 5720 5721 5722 5723 5724 5725 5726 5727 5728 5729 5730 5731 5732 5733 5734 5735 5736 5737 5738 5739 5740 5741 5742 5743 5744 5745 5746 5747 5748 5749 5750 5751 5752 5753 5754 5755 5756 5757 5758 5759 5760 5761 5762 5763 5764 5765 5766 5767 5768 5769 5770 5771 5772 5773 5774 5775 5776 5777 5778 5779 5780 5781 5782 5783 5784 5785 5786 5787 5788 5789 5790 5791 5792 5793 5794 5795 5796 5797 5798 5799 5800 5801 5802 5803 5804 5805 5806 5807 5808 5809 5810 5811 5812 5813 5814 5815 5816 5817 5818 5819 5820 5821 5822 5823 5824 5825 5826 5827 5828 5829 5830 5831 5832 5833 5834 5835 5836 5837 5838 5839 5840 5841 5842 5843 5844 5845 5846 5847 5848 5849 5850 5851 5852 5853 5854 5855 5856 5857 5858 5859 5860 5861 5862 5863 5864 5865 5866 5867 5868 5869 5870 5871 5872 5873 5874 5875 5876 5877 5878 5879 5880 5881 5882 5883 5884 5885 5886 5887 5888 5889 5890 5891 5892 5893 5894 5895 5896 5897 5898 5899 5900 5901 5902 5903 5904 5905 5906 5907 5908 5909 5910 5911 5912 5913 5914 5915 5916 5917 5918 5919 5920 5921 5922 5923 5924 5925 5926 5927 5928 5929 5930 5931 5932 5933 5934 5935 5936 5937 5938 5939 5940 5941 5942 5943 5944 5945 5946 5947 5948 5949 5950 5951 5952 5953 5954 5955 5956 5957 5958 5959 5960 5961 5962 5963 5964 5965 5966 5967 5968 5969 5970 5971 5972 5973 5974 5975 5976 5977 5978 5979 5980 5981 5982 5983 5984 5985 5986 5987 5988 5989 5990 5991 5992 5993 5994 5995 5996 5997 5998 5999 6000 6001 6002 6003 6004 6005 6006 6007 6008 6009 6010 6011 6012 6013 6014 6015 6016 6017 6018 6019 6020 6021 6022 6023 6024 6025 6026 6027 6028 6029 6030 6031 6032 6033 6034 6035 6036 6037 6038 6039 6040 6041 6042 6043 6044 6045 6046 6047 6048 6049 6050 6051 6052 6053 6054 6055 6056 6057 6058 6059 6060 6061 6062 6063 6064 6065 6066 6067 6068 6069 6070 6071 6072 6073 6074 6075 6076 6077 6078 6079 6080 6081 6082 6083 6084 6085 6086 6087 6088 6089 6090 6091 6092 6093 6094 6095 6096 6097 6098 6099 6100 6101 6102 6103 6104 6105 6106 6107 6108 6109 6110 6111 6112 6113 6114 6115 6116 6117 6118 6119 6120 6121 6122 6123 6124 6125 6126 6127 6128 6129 6130 6131 6132 6133 6134 6135 6136 6137 6138 6139 6140 6141 6142 6143 6144 6145 6146 6147 6148 6149 6150 6151 6152 6153 6154 6155 6156 6157 6158 6159 6160 6161 6162 6163 6164 6165 6166 6167 6168 6169 6170 6171 6172 6173 6174 6175 6176 6177 6178 6179 6180 6181 6182 6183 6184 6185 6186 6187 6188 6189 6190 6191 6192 6193 6194 6195 6196 6197 6198 6199 6200 6201 6202 6203 6204 6205 6206 6207 6208 6209 6210 6211 6212 6213 6214 6215 6216 6217 6218 6219 6220 6221 6222 6223 6224 6225 6226 6227 6228 6229 6230 6231 6232 6233 6234 6235 6236 6237 6238 6239 6240 6241 6242 6243 6244 6245 6246 6247 6248 6249 6250 6251 6252 6253 6254 6255 6256 6257 6258 6259 6260 6261 6262 6263 6264 6265 6266 6267 6268 6269 6270 6271 6272 6273 6274 6275 6276 6277 6278 6279 6280 6281 6282 6283 6284 6285 6286 6287 6288 6289 6290 6291 6292 6293 6294 6295 6296 6297 6298 6299 6300 6301 6302 6303 6304 6305 6306 6307 6308 6309 6310 6311 6312 6313 6314 6315 6316 6317 6318 6319 6320 6321 6322 6323 6324 6325 6326 6327 6328 6329 6330 6331 6332 6333 6334 6335 6336 6337 6338 6339 6340 6341 6342 6343 6344 6345 6346 6347 6348 6349 6350 6351 6352 6353 6354 6355 6356 6357 6358 6359 6360 6361 6362 6363 6364 6365 6366 6367 6368 6369 6370 6371 6372 6373 6374 6375 6376 6377 6378 6379 6380 6381 6382 6383 6384 6385 6386 6387 6388 6389 6390 6391 6392 6393 6394 6395 6396 6397 6398 6399 6400 6401 6402 6403 6404 6405 6406 6407 6408 6409 6410 6411 6412 6413 6414 6415 6416 6417 6418 6419 6420 6421 6422 6423 6424 6425 6426 6427 6428 6429 6430 6431 6432 6433 6434 6435 6436 6437 6438 6439 6440 6441 6442 6443 6444 6445 6446 6447 6448 6449 6450 6451 6452 6453 6454 6455 6456 6457 6458 6459 6460 6461 6462 6463 6464 6465 6466 6467 6468 6469 6470 6471 6472 6473 6474 6475 6476 6477 6478 6479 6480 6481 6482 6483 6484 6485 6486 6487 6488 6489 6490 6491 6492 6493 6494 6495 6496 6497 6498 6499 6500 6501 6502 6503 6504 6505 6506 6507 6508 6509 6510 6511 6512 6513 6514 6515 6516 6517 6518 6519 6520 6521 6522 6523 6524 6525 6526 6527 6528 6529 6530 6531 6532 6533 6534 6535 6536 6537 6538 6539 6540 6541 6542 6543 6544 6545 6546 6547 6548 6549 6550 6551 6552 6553 6554 6555 6556 6557 6558 6559 6560 6561 6562 6563 6564 6565 6566 6567 6568 6569 6570 6571 6572 6573 6574 6575 6576 6577 6578 6579 6580 6581 6582 6583 6584 6585 6586 6587 6588 6589 6590 6591 6592 6593 6594 6595 6596 6597 6598 6599 6600 6601 6602 6603 6604 6605 6606 6607 6608 6609 6610 6611 6612 6613 6614 6615 6616 6617 6618 6619 6620 6621 6622 6623 6624 6625 6626 6627 6628 6629 6630 6631 6632 6633 6634 6635 6636 6637 6638 6639 6640 6641 6642 6643 6644 6645 6646 6647 6648 6649 6650 6651 6652 6653 6654 6655 6656 6657 6658 6659 6660 6661 6662 6663 6664 6665 6666 6667 6668 6669 6670 6671 6672 6673 6674 6675 6676 6677 6678 6679 6680 6681 6682 6683 6684 6685 6686 6687 6688 6689 6690 6691 6692 6693 6694 6695 6696 6697 6698 6699 6700 6701 6702 6703 6704 6705 6706 6707 6708 6709 6710 6711 6712 6713 6714 6715 6716 6717 6718 6719 6720 6721 6722 6723 6724 6725 6726 6727 6728 6729 6730 6731 6732 6733 6734 6735 6736 6737 6738 6739 6740 6741 6742 6743 6744 6745 6746 6747 6748 6749 6750 6751 6752 6753 6754 6755 6756 6757 6758 6759 6760 6761 6762 6763 6764 6765 6766 6767 6768 6769 6770 6771 6772 6773 6774 6775 6776 6777 6778 6779 6780 6781 6782 6783 6784 6785 6786 6787 6788 6789 6790 6791 6792 6793 6794 6795 6796 6797 6798 6799 6800 6801 6802 6803 6804 6805 6806 6807 6808 6809 6810 6811 6812 6813 6814 6815 6816 6817 6818 6819 6820 6821 6822 6823 6824 6825 6826 6827 6828 6829 6830 6831 6832 6833 6834 6835 6836 6837 6838 6839 6840 6841 6842 6843 6844 6845 6846 6847 6848 6849 6850 6851 6852 6853 6854 6855 6856 6857 6858 6859 6860 6861 6862 6863 6864 6865 6866 6867 6868 6869 6870 6871 6872 6873 6874 6875 6876 6877 6878 6879 6880 6881 6882 6883 6884 6885 6886 6887 6888 6889 6890 6891 6892 6893 6894 6895 6896 6897 6898 6899 6900 6901 6902 6903 6904 6905 6906 6907 6908 6909 6910 6911 6912 6913 6914 6915 6916 6917 6918 6919 6920 6921 6922 6923 6924 6925 6926 6927 6928 6929 6930 6931 6932 6933 6934 6935 6936 6937 6938 6939 6940 6941 6942 6943 6944 6945 6946 6947 6948 6949 6950 6951 6952 6953 6954 6955 6956 6957 6958 6959 6960 6961 6962 6963 6964 6965 6966 6967 6968 6969 6970 6971 6972 6973 6974 6975 6976 6977 6978 6979 6980 6981 6982 6983 6984 6985 6986 6987 6988 6989 6990 6991 6992 6993 6994 6995 6996 6997 6998 6999 7000 7001 7002 7003 7004 7005 7006 7007 7008 7009 7010 7011 7012 7013 7014 7015 7016 7017 7018 7019 7020 7021 7022 7023 7024 7025 7026 7027 7028 7029 7030 7031 7032 7033 7034 7035 7036 7037 7038 7039 7040 7041 7042 7043 7044 7045 7046 7047 7048 7049 7050 7051 7052 7053 7054 7055 7056 7057 7058 7059 7060 7061 7062 7063 7064 7065 7066 7067 7068 7069 7070 7071 7072 7073 7074 7075 7076 7077 7078 7079 7080 7081 7082 7083 7084 7085 7086 7087 7088 7089 7090 7091 7092 7093 7094 7095 7096 7097 7098 7099 7100 7101 7102 7103 7104 7105 7106 7107 7108 7109 7110 7111 7112 7113 7114 7115 7116 7117 7118 7119 7120 7121 7122 7123 7124 7125 7126 7127 7128 7129 7130 7131 7132 7133 7134 7135 7136 7137 7138 7139 7140 7141 7142 7143 7144 7145 7146 7147 7148 7149 7150 7151 7152 7153 7154 7155 7156 7157 7158 7159 7160 7161 7162 7163 7164 7165 7166 7167 7168 7169 7170 7171 7172 7173 7174 7175 7176 7177 7178 7179 7180 7181 7182 7183 7184 7185 7186 7187 7188 7189 7190 7191 7192 7193 7194 7195 7196 7197 7198 7199 7200 7201 7202 7203 7204 7205 7206 7207 7208 7209 7210 7211 7212 7213 7214 7215 7216 7217 7218 7219 7220 7221 7222 7223 7224 7225 7226 7227 7228 7229 7230 7231 7232 7233 7234 7235 7236 7237 7238 7239 7240 7241 7242 7243 7244 7245 7246 7247 7248 7249 7250 7251 7252 7253 7254 7255 7256 7257 7258 7259 7260 7261 7262 7263 7264 7265 7266 7267 7268 7269 7270 7271 7272 7273 7274 7275 7276 7277 7278 7279 7280 7281 7282 7283 7284 7285 7286 7287 7288 7289 7290 7291 7292 7293 7294 7295 7296 7297 7298 7299 7300 7301 7302 7303 7304 7305 7306 7307 7308 7309 7310 7311 7312 7313 7314 7315 7316 7317 7318 7319 7320 7321 7322 7323 7324 7325 7326 7327 7328 7329 7330 7331 7332 7333 7334 7335 7336 7337 7338 7339 7340 7341 7342 7343 7344 7345 7346 7347 7348 7349 7350 7351 7352 7353 7354 7355 7356 7357 7358 7359 7360 7361 7362 7363 7364 7365 7366 7367 7368 7369 7370 7371 7372 7373 7374 7375 7376 7377 7378 7379 7380 7381 7382 7383 7384 7385 7386 7387 7388 7389 7390 7391 7392 7393 7394 7395 7396 7397 7398 7399 7400 7401 7402 7403 7404 7405 7406 7407 7408 7409 7410 7411 7412 7413 7414 7415 7416 7417 7418 7419 7420 7421 7422 7423 7424 7425 7426 7427 7428 7429 7430 7431 7432 7433 7434 7435 7436 7437 7438 7439 7440 7441 7442 7443 7444 7445 7446 7447 7448 7449 7450 7451 7452 7453 7454 7455 7456 7457 7458 7459 7460 7461 7462 7463 7464 7465 7466 7467 7468 7469 7470 7471 7472 7473 7474 7475 7476 7477 7478 7479 7480 7481 7482 7483 7484 7485 7486 7487 7488 7489 7490 7491 7492 7493 7494 7495 7496 7497 7498 7499 7500 7501 7502 7503 7504 7505 7506 7507 7508 7509 7510 7511 7512 7513 7514 7515 7516 7517 7518 7519 7520 7521 7522 7523 7524 7525 7526 7527 7528 7529 7530 7531 7532 7533 7534 7535 7536 7537 7538 7539 7540 7541 7542 7543 7544 7545 7546 7547 7548 7549 7550 7551 7552 7553 7554 7555 7556 7557 7558 7559 7560 7561 7562 7563 7564 7565 7566 7567 7568 7569 7570 7571 7572 7573 7574 7575 7576 7577 7578 7579 7580 7581 7582 7583 7584 7585 7586 7587 7588 7589 7590 7591 7592 7593 7594 7595 7596 7597 7598 7599 7600 7601 7602 7603 7604 7605 7606 7607 7608 7609 7610 7611 7612 7613 7614 7615 7616 7617 7618 7619 7620 7621 7622 7623 7624 7625 7626 7627 7628 7629 7630 7631 7632 7633 7634 7635 7636 7637 7638 7639 7640 7641 7642 7643 7644 7645 7646 7647 7648 7649 7650 7651 7652 7653 7654 7655 7656 7657 7658 7659 7660 7661 7662 7663 7664 7665 7666 7667 7668 7669 7670 7671 7672 7673 7674 7675 7676 7677 7678 7679 7680 7681 7682 7683 7684 7685 7686 7687 7688 7689 7690 7691 7692 7693 7694 7695 7696 7697 7698 7699 7700 7701 7702 7703 7704 7705 7706 7707 7708 7709 7710 7711 7712 7713 7714 7715 7716 7717 7718 7719 7720 7721 7722 7723 7724 7725 7726 7727 7728 7729 7730 7731 7732 7733 7734 7735 7736 7737 7738 7739 7740 7741 7742 7743 7744 7745 7746 7747 7748 7749 7750 7751 7752 7753 7754 7755 7756 7757 7758 7759 7760 7761 7762 7763 7764 7765 7766 7767 7768 7769 7770 7771 7772 7773 7774 7775 7776 7777 7778 7779 7780 7781 7782 7783 7784 7785 7786 7787 7788 7789 7790 7791 7792 7793 7794 7795 7796 7797 7798 7799 7800 7801 7802 7803 7804 7805 7806 7807 7808 7809 7810 7811 7812 7813 7814 7815 7816 7817 7818 7819 7820 7821 7822 7823 7824 7825 7826 7827 7828 7829 7830 7831 7832 7833 7834 7835 7836 7837 7838 7839 7840 7841 7842 7843 7844 7845 7846 7847 7848 7849 7850 7851 7852 7853 7854 7855 7856 7857 7858 7859 7860 7861 7862 7863 7864 7865 7866 7867 7868 7869 7870 7871 7872 7873 7874 7875 7876 7877 7878 7879 7880 7881 7882 7883 7884 7885 7886 7887 7888 7889 7890 7891 7892 7893 7894 7895 7896 7897 7898 7899 7900 7901 7902 7903 7904 7905 7906 7907 7908 7909 7910 7911 7912 7913 7914 7915 7916 7917 7918 7919 7920 7921 7922 7923 7924 7925 7926 7927 7928 7929 7930 7931 7932 7933 7934 7935 7936 7937 7938 7939 7940 7941 7942 7943 7944 7945 7946 7947 7948 7949 7950 7951 7952 7953 7954 7955 7956 7957 7958 7959 7960 7961 7962 7963 7964 7965 7966 7967 7968 7969 7970 7971 7972 7973 7974 7975 7976 7977 7978 7979 7980 7981 7982 7983 7984 7985 7986 7987 7988 7989 7990 7991 7992 7993 7994 7995 7996 7997 7998 7999 8000 8001 8002 8003 8004 8005 8006 8007 8008 8009 8010 8011 8012 8013 8014 8015 8016 8017 8018 8019 8020 8021 8022 8023 8024 8025 8026 8027 8028 8029 8030 8031 8032 8033 8034 8035 8036 8037 8038 8039 8040 8041 8042 8043 8044 8045 8046 8047 8048 8049 8050 8051 8052 8053 8054 8055 8056 8057 8058 8059 8060 8061 8062 8063 8064 8065 8066 8067 8068 8069 8070 8071 8072 8073 8074 8075 8076 8077 8078 8079 8080 8081 8082 8083 8084 8085 8086 8087 8088 8089 8090 8091 8092 8093 8094 8095 8096 8097 8098 8099 8100 8101 8102 8103 8104 8105 8106 8107 8108 8109 8110 8111 8112 8113 8114 8115 8116 8117 8118 8119 8120 8121 8122 8123 8124 8125 8126 8127 8128 8129 8130 8131 8132 8133 8134 8135 8136 8137 8138 8139 8140 8141 8142 8143 8144 8145 8146 8147 8148 8149 8150 8151 8152 8153 8154 8155 8156 8157 8158 8159 8160 8161 8162 8163 8164 8165 8166 8167 8168 8169 8170 8171 8172 8173 8174 8175 8176 8177 8178 8179 8180 8181 8182 8183 8184 8185 8186 8187 8188 8189 8190 8191 8192 8193 8194 8195 8196 8197 8198 8199 8200 8201 8202 8203 8204 8205 8206 8207 8208 8209 8210 8211 8212 8213 8214 8215 8216 8217 8218 8219 8220 8221 8222 8223 8224 8225 8226 8227 8228 8229 8230 8231 8232 8233 8234 8235 8236 8237 8238 8239 8240 8241 8242 8243 8244 8245 8246 8247 8248 8249 8250 8251 8252 8253 8254 8255 8256 8257 8258 8259 8260 8261 8262 8263 8264 8265 8266 8267 8268 8269 8270 8271 8272 8273 8274 8275 8276 8277 8278 8279 8280 8281 8282 8283 8284 8285 8286 8287 8288 8289 8290 8291 8292 8293 8294 8295 8296 8297 8298 8299 8300 8301 8302 8303 8304 8305 8306 8307 8308 8309 8310 8311 8312 8313 8314 8315 8316 8317 8318 8319 8320 8321 8322 8323 8324 8325 8326 8327 8328 8329 8330 8331 8332 8333 8334 8335 8336 8337 8338 8339 8340 8341 8342 8343 8344 8345 8346 8347 8348 8349 8350 8351 8352 8353 8354 8355 8356 8357 8358 8359 8360 8361 8362 8363 8364 8365 8366 8367 8368 8369 8370 8371 8372 8373 8374 8375 8376 8377 8378 8379 8380 8381 8382 8383 8384 8385 8386 8387 8388 8389 8390 8391 8392 8393 8394 8395 8396 8397 8398 8399 8400 8401 8402 8403 8404 8405 8406 8407 8408 8409 8410 8411 8412 8413 8414 8415 8416 8417 8418 8419 8420 8421 8422 8423 8424 8425 8426 8427 8428 8429 8430 8431 8432 8433 8434 8435 8436 8437 8438 8439 8440 8441 8442 8443 8444 8445 8446 8447 8448 8449 8450 8451 8452 8453 8454 8455 8456 8457 8458 8459 8460 8461 8462 8463 8464 8465 8466 8467 8468 8469 8470 8471 8472 8473 8474 8475 8476 8477 8478 8479 8480 8481 8482 8483 8484 8485 8486 8487 8488 8489 8490 8491 8492 8493 8494 8495 8496 8497 8498 8499 8500 8501 8502 8503 8504 8505 8506 8507 8508 8509 8510 8511 8512 8513 8514 8515 8516 8517 8518 8519 8520 8521 8522 8523 8524 8525 8526 8527 8528 8529 8530 8531 8532 8533 8534 8535 8536 8537 8538 8539 8540 8541 8542 8543 8544 8545 8546 8547 8548 8549 8550 8551 8552 8553 8554 8555 8556 8557 8558 8559 8560 8561 8562 8563 8564 8565 8566 8567 8568 8569 8570 8571 8572 8573 8574 8575 8576 8577 8578 8579 8580 8581 8582 8583 8584 8585 8586 8587 8588 8589 8590 8591 8592 8593 8594 8595 8596 8597 8598 8599 8600 8601 8602 8603 8604 8605 8606 8607 8608 8609 8610 8611 8612 8613 8614 8615 8616 8617 8618 8619 8620 8621 8622 8623 8624 8625 8626 8627 8628 8629 8630 8631 8632 8633 8634 8635 8636 8637 8638 8639 8640 8641 8642 8643 8644 8645 8646 8647 8648 8649 8650 8651 8652 8653 8654 8655 8656 8657 8658 8659 8660 8661 8662 8663 8664 8665 8666 8667 8668 8669 8670 8671 8672 8673 8674 8675 8676 8677 8678 8679 8680 8681 8682 8683 8684 8685 8686 8687 8688 8689 8690 8691 8692 8693 8694 8695 8696 8697 8698 8699 8700 8701 8702 8703 8704 8705 8706 8707 8708 8709 8710 8711 8712 8713 8714 8715 8716 8717 8718 8719 8720 8721 8722 8723 8724 8725 8726 8727 8728 8729 8730 8731 8732 8733 8734 8735 8736 8737 8738 8739 8740 8741 8742 8743 8744 8745 8746 8747 8748 8749 8750 8751 8752 8753 8754 8755 8756 8757 8758 8759 8760 8761 8762 8763 8764 8765 8766 8767 8768 8769 8770 8771 8772 8773 8774 8775 8776 8777 8778 8779 8780 8781 8782 8783 8784 8785 8786 8787 8788 8789 8790 8791 8792 8793 8794 8795 8796 8797 8798 8799 8800 8801 8802 8803 8804 8805 8806 8807 8808 8809 8810 8811 8812 8813 8814 8815 8816 8817 8818 8819 8820 8821 8822 8823 8824 8825 8826 8827 8828 8829 8830 8831 8832 8833 8834 8835 8836 8837 8838 8839 8840 8841 8842 8843 8844 8845 8846 8847 8848 8849 8850 8851 8852 8853 8854 8855 8856 8857 8858 8859 8860 8861 8862 8863 8864 8865 8866 8867 8868 8869 8870 8871 8872 8873 8874 8875 8876 8877 8878 8879 8880 8881 8882 8883 8884 8885 8886 8887 8888 8889 8890 8891 8892 8893 8894 8895 8896 | == CMD_DESCRIPTION_ACL ==
Configura permisos para un objeto.
== CMD_USAGE_ACL ==
Sintaxis:
cm acl (--user=<usr_name> | --group=<group_name>)
(-allowed|-denied|-overrideallowed|-overridedenied=+|-<permission>[,...])[,...]
<objectspec>
--user Nombre de usuario.
--group Nombre de grupo.
-allowed Habilita los permisos indicados. Use una coma para
separar permisos. (Use 'cm showpermissions' para mostrar
los permisos disponibles.)
-denied Deniega los permisos indicados. Use una coma para
separar permisos. (Use 'cm showpermissions' para mostrar
los permisos disponibles.)
-overrideallowed Anula los permisos habilitados. Use una coma para separar
permisos. (Use 'cm showpermissions' para mostrar
los permisos disponibles.)
-overridedenied Anula los permisos denegados. Use una coma para separar
permisos. (Use 'cm showpermissions' para mostrar
los permisos disponibles.)
objectspec Objeto sobre el que configurar los permisos.
Este objeto puede ser uno de los siguientes:
servidor de repositorios, repositorio, rama, etiqueta
o atributo.
(Use 'cm help objectspec' para más información sobre
las especificaciones de objetos.)
Uso especial para rutas seguras:
cm acl [(--user=<usr_name> | --group=<group_name>)
(-allowed|-denied|-overrideallowed|-overridedenied=+|-<permission>[,...])[,...]]
[--delete] [--branches=[+ | -]<branch>[,...]]
<spec>
--delete Elimina una ruta segura.
Consulte las Notas para más información.
--branches Configura los permisos de una ruta segura a un grupo de
ramas. Use una coma para separar las ramas.
Opcionalmente, cada rama puede ir precedida de un signo
+ o - para especificar si la rama debe añadirse o
eliminarse de la lista cuando se está editando.
Consulte las Notas para más información.
spec La ruta segura donde configurar los permisos.
== CMD_HELP_ACL ==
La configuración de permisos requiere entender cómo funciona la seguridad en
Unity VCS. Lea la Guía de Seguridad para aprender cómo funcionan estos
permisos:
https://www.plasticscm.com/download/help/securityguide
Notas:
Este comando configura permisos para un usuario o un grupo en los objetos,
repositorios, ramas, etiquetas o rutas de servidor especificados.
Especificaciones de objeto:
(Use 'cm help objectspec' para más información sobre las especificaciones
de objetos.)
El comando acl usa un tipo especial de especificación: rutas seguras.
- Especificación de rutas seguras:
path:server_path[#tag]
Ejemplos: path:/src/foo.c
path:/doc/pdf
path:/doc/pdf#documents
Acciones de permisos:
Use -allowed y -denied para especificar qué permisos aplicar.
Use los argumentos -overrideallowed y -overridedenied para especificar
qué permisos se anulan.
Cada acción requiere una lista de permisos separados por comas.
Nombres de permisos:
Cada nombre de permiso debe ir precedido del símbolo + o -.
El símbolo + aplica el permiso y el símbolo - lo elimina.
Para ver los permisos de un objeto use el comando 'cm showacl'.
Permisos anulados:
Anular un permiso usando --overrideallowed y --overridedenied permite
evitar la herencia de permisos.
Esto es útil para evitar los permisos aplicados a nivel de repositorio o
de servidor.
Por ejemplo:
cm acl --user=vio -allowed=+ci -overrideallowed=+ci br:qa@test
(Permite a la usuaria 'vio' hacer checkin en la rama 'qa' del
repositorio 'test' incluso si ella tiene los permisos denegados a
nivel de repositorio.)
Permisos de rutas de servidor (rutas seguras):
- Se pueden especificar permisos para una ruta de servidor dada.
- Estos permisos se comprueban durante la operación de checkin.
- Estos permisos también se pueden comprobar durante la operación de
update y se pueden usar para evitar que ciertos directorios y ficheros
se descarguen al espacio de trabajo.
- Por cada ítem que se proteja (checkin), el servidor intenta concordar
la ruta del ítem con una ruta segura. Si se encuentra, entonces la
operación de checkin comprueba si el ítem tiene permisos para ser
protegido (checked in).
Los permisos que se pueden definir para una ruta segura son:
ci, change, add, move, rm, read
Si la comprobación de permisos no es satisfactoria para ninguno de los
ítems involucrados, entonces la operación de checkin se revierte.
Para aplicar permisos de rutas seguras a un grupo de ramas, use la
opción --branches.
Por ejemplo:
cm acl --user=jo -denied=+ci path:/src#rule0 --branches=main,main/rel0
Para editar el ACL asociado a una ruta segura, use el símbolo "#".
Por ejemplo:
cm acl --user=jo -denied=+rm path:/src#rule0
(Sin "#", la lista de ramas tendría que especificarse de nuevo).
La lista de ramas de una ruta segura se puede editar.
Por ejemplo:
cm acl path:/src#rule0 --branches=-main,+main/rel1
(Elimina 'main' de la lista y añade 'main/rel1'.)
Para eliminar una ruta segura, use el argumento --delete.
Por ejemplo:
cm acl --user=jo --delete path:/src#rule0
Herencia:
Herencia es una opción que proviene de los inicios de Plastic SCM 3.0.
Es una opción avanzada pero también obsoleta.
Permite a un objeto heredar los permisos de otro objeto anulando las
relaciones de herencia por defecto.
Use la opción -cut para cortar la cadena de herencia.
Usd la opción -cutncpy para cortar y copiar los permisos heredados.
(Esto está inspirado en los permisos de sistema de Windows donde se
puede cortar herencia pero mantener los permisos actuales.)
La opción -inherit permiter heredar de una especificación de objeto.
Por ejemplo: '-inherit=object_spec'
Ejemplos:
cm acl --user=danipen -denied=+ci rep:core
(Deniega el permiso de checkin al usuario 'danipen' en el repositorio 'core'.)
cm acl --group=developers -allowed=+view,-read -denied=+chgperm br:main
(Otorga el permiso 'view', elimina el permiso 'read' y deniega el permiso
'chgperm' al grupo 'developers' en la rama 'main'.)
Ejemplos con rutas de servidor:
cm acl --group=devs -denied=+ci path:/server#rel --branches=main,main/2.0
(Deniega el permiso de checkin al grupo 'devs' para cualquier ruta que
concuerde con '/server' en las ramas 'main' y 'main/2.0'. La etiqueta '#rel'
se crea para poder referirse a ella más adelante.)
cm acl path:/server#rel --branches=-/main,+/main/Rel2.1
(Actualiza la ruta segura '/server' cuya etiqueta es 'rel', borrando la
rama 'main' y añadiendo la rama 'main/Rel2.1' al grupo de ramas al que la
ruta segura aplica. Teniendo en cuenta el ejemplo anterior, ahora la lista
de ramas contendrá 'main/Rel2.1' y 'main/2.0'.)
cm acl --user=vsanchezm -allowed=-read -overrideallowed=+read path:/doc
(Eliminar el permiso de lectura 'read' a 'vsanchezm' anulándolo en la ruta
'/doc'.)
== CMD_DESCRIPTION_ACTIVATEUSER ==
Activa un usuario con licencia.
== CMD_USAGE_ACTIVATEUSER ==
Sintaxis:
cm activateuser | au <user-name>[ ...] [--server=<rep-server-spec>]
user-name Nombre o nombres de usuario a activar. Use comillas dobles (" ")
para especificar nombres de usuario que contengan espacios. Use
un espacio en blanco para separar nombres de usuarios.
Opciones:
--server=<rep-server-spec> Activa al usuario en el servidor indicado.
Si no se especifica ningún servidor, el comando
se ejecuta en el servidor por defecto indicado
en el fichero client.conf.
(Use 'cm help objectspec' para más información
sobre las especificaciones de servidores de
repositorios.)
== CMD_HELP_ACTIVATEUSER ==
Notas:
Para activar un usuario debe haber sido desactivado previamente.
Por defecto, un usuario se activa por primera vez cuando lleva a cabo una
operación de escritura en Unity VCS. El usuario se activa automáticamente
si no se ha excedido el número máximo de usuarios.
(Use 'cm help deactivateuser' para más información sobre desactivar usuarios
en Unity VCS.)
Examples:
cm activateuser john
cm activateuser david "mary collins"
cm au peter --server=localhost:8087
== CMD_DESCRIPTION_ADD ==
Añade un ítem al control de versiones.
== CMD_USAGE_ADD ==
Sintaxis:
cm add [-R | -r | --recursive] [--silent] [--ignorefailed]
[--skipcontentcheck] [--coparent] [--filetypes=<file>] [--noinfo]
[--format=<str-format>] [--errorformat=<str-format>]
<item-path>[ ...]
item-path Ítem o ítems a añadir. Use comillas dobles (" ") para especificar
rutas que contengan espacios. Use un espacio en blanco para
separar rutas de ítems.
Use * para añadir todo el contenido del directorio actual.
Opciones:
-R|-r|--recursive Añade los ítems recursivamente.
--silent No muestra ninguna salida.
--ignorefailed Si un ítem no se puede añadir, la operación de add
continuará sin él. Importante: si un directorio no se
puede añadir, su contenido tampoco se añadirá.
--skipcontentcheck Cuando la extensión no es suficiente para determinar si
el fichero es de texto o binario, se asumirá que es
binario en lugar de usar el contenido para detectar el
tipo. Este funcionamiento se asume para aumentar el
rendimiento en grandes operaciones de checkin.
--coparent Hace checkout al padre del ítem que se va a añadir.
--filetypes Fichero con los tipos de ficheros a usar. Consulte el
siguiente enlace para más información:
http://blog.plasticscm.com/2008/03/custom-file-types.html
--noinfo No muestra información de progreso.
--format Muestra el mensaje de salida con el formato indicado.
Consulte los ejemplos para más información.
--errorformat Muestra el mensaje de error (si existe) con el formato
indicado. Consulte los ejemplos para más información.
== CMD_HELP_ADD ==
Notas:
Requisitos para añadir ítems:
- El directorio padre del ítem a añadir debe haber sido añadido previamente.
Lectura desde stdin:
El comando 'add' puede leer rutas desde stdin. Para ello, pase como
argumento un guión "-".
Por ejemplo: cm add -
Las rutas se leerán hasta que se introduzca una línea en blanco.
Este tipo de lectura permite usar una tubería (pipe) para especificar qué
ficheros se van a añadir.
Por ejemplo:
dir /S /B *.c | cm add -
(En Windows, añade todos los ficheros del workspace con extensión .c.)
Ejemplos:
cm add file1.txt file2.txt
(Añade los ítems file1.txt y file2.txt.)
cm add c:\workspace\file.txt
(Añade el ítem file.txt en la ruta c:\workspace.)
cm add -R c:\workspace\src
(Añade recursivamente el contenido de la ruta src.)
cm add -R *
(Añade recursivamente todo el contenido del directorio actual.)
cm add -R * --filetypes=filetypes.conf
(Añade recursivamente todo el contenido del directorio actual usando el
fichero 'filetypes.conf' para asignar un tipo a cada fichero basándose en su
extensión en lugar de en el contenido.)
cm add --coparent c:\workspace\dir\file.txt
(Añade el fichero 'file.txt' y hace checkout a 'dir'.)
cm add -R * --format="ADD {0}" --errorformat="ERR {0}"
(Añade recursivamente todo el contenido del directorio actual y muestra por
pantalla 'ADD <item>' para cada archivo añadido y 'ERR <item>' para cada
archivo que no se pudo añadir.)
== CMD_USAGE_ADDIGNOREPATTERN ==
Uso:
cm addignorepattern <pattern>[ ...]
[--workspace=<wkpath> | --allworkspaces] [--remove]
== CMD_DESCRIPTION_ADMIN ==
Ejecuta comandos de administración en el servidor.
== CMD_USAGE_ADMIN ==
Sintaxis:
cm admin <command> [options]
Comandos:
readonly
Para obtener más información de cada uno de los comandos use lo siguiente:
cm admin <command> --usage
cm admin <command> --help
== CMD_HELP_ADMIN ==
Notas:
Sólo el administrador del servidor puede ejecutar comandos de administración.
Ejemplos:
cm admin readonly enter
cm admin readonly status
== CMD_DESCRIPTION_ADMIN_READONLY ==
Habilita/deshabilita el modo solo lectura del servidor.
== CMD_USAGE_ADMIN_READONLY ==
Sintaxis:
cm admin readonly (enter | leave | status) [<server>]
Acciones:
enter Habilita el modo solo lectura en el servidor. Las operaciones de
escritura se rechazan.
leave Deshabilita el modo solo lectura en el servidor.
status Muestra el estado del modo solo lectura en el servidor.
Opciones:
server Ejecuta el comando en el servidor indicado (servidor:puerto). (Use
'cm help objectspec' para más información sobre las especificaciones
de servidor.)
Si no se especifica ningún servidor, el comando actúa en el servidor
del espacio de trabajo actual.
Si la ruta actual no corresponde a un espacio de trabajo, el comando
actúa sobre el servidor por defecto indicado en el fichero client.conf.
== CMD_HELP_ADMIN_READONLY ==
Notas:
Solo el administrador del servidor puede configurarlo como solo lectura.
Ejemplos:
cm admin readonly enter diana:8086
cm admin readonly leave
== CMD_DESCRIPTION_ANNOTATE ==
Muestra el changeset donde se modificó por última vez y por quién cada línea de
un fichero.
== CMD_USAGE_ANNOTATE ==
Sintaxis:
cm annotate | blame <spec>[ ...]
[--format=<str_format>]
[--comparisonmethod=(ignoreeol | ignorewhitespaces
| ignoreeolandwhitespaces | recognizeall)]
[--dateformat=<str_date_format>]
[--encoding=<name>]
[--stats]
[--repository=<repspec>]
spec Especificación del fichero que se va a anotar.
(Use 'cm help objectspec' para obtener más información sobre
especificaciones.)
Use comillas dobles (" ") para especificar rutas que contengan
espacios.
Opciones:
--format Muestra el mensaje de salida en el formato indicado.
Consulte las Notas para más información.
--comparisonmethod Configura el método de comparación indicado.
Consulte las Notas para más información.
--dateformat Configura el formato de salida para la impresión de fechas.
--encoding Especifica el encoding que se usará en la salida, por
ejemplo, utf-8. Consulte la documentación de MSDN en
http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
para obtener la tabla de codificaciones soportadas y su
formato (al final de la página en la columna "Name").
--stats Muestra estadísticas.
--repository Especifica el repositorio a usar para calcular las
anotaciones. Por defecto, se usa el repositorio del
workspace cuya revisión está cargada. (Use
'cm help objectspec' para más información sobre las
especificaciones de repositorio.)
== CMD_HELP_ANNOTATE ==
Notas:
Los ítems de tipo binario no pueden ser anotados.
Métodos de comparación (opción --comparisonmethod):
ignoreeol Ignora diferencias en final de línea.
ignorewhitespaces Ignora diferencias en espacios.
ignoreeolandwhitespaces Ignora diferencias en final de línea y espacios.
recognizeall Detecta diferencias en final de línea y espacios.
Parámetros de formato de salida (opción --format):
Este comando acepta una cadena de formato para mostrar la salida.
Los parámetros de salida de este comando son los siguientes:
{owner} Usuario que hizo el último cambió en la línea.
{rev} Especificación de la revisión de la línea.
{content} Contenido de la línea.
{date} Fecha de checkin de la línea.
{comment} Comentario de la revisión de la línea.
{changeset} Changeset de la revisión de la línea.
{line} Número de línea del fichero.
{id} Identificador del ítem.
{parentid} Identificador del padre del ítem.
{rep} Repositorio del ítem.
{branch} Rama de la revisión de la línea.
{ismergerev} Si la revisión de la línea se creó en un merge.
--dateformat:
Para especificar el formato en el que se escribirán las fechas en pantalla.
Consulte los formatos soportados:
https://docs.microsoft.com/en-us/dotnet/standard/base-types/custom-date-and-time-format-strings
--repository:
Para devolver los datos de un repositorio remoto. Esto es útil cuando se
trabaja con escenarios distribuidos.
Ejemplos:
cm blame c:\workspace\src --comparisonmethod=ignoreeolandwhitespaces --encoding=utf-8
cm annotate c:\workspace\file.txt --comparisonmethod=ignoreeol
cm annotate c:\workspace\file.txt --format="{owner} {date, 10} {content}"
(Muestra el usuario que hizo el último cambio, un espacio, la fecha alineada
a la derecha, un espacio y el contenido de la línea.)
cm blame c:\workspace\file.txt --format="{owner, -7} {comment} {date}" \
--dateformat=yyyyMMdd
(Muestra en 7 espacios (y alineado a la izquierda) el usuario que hizo el
último cambio, un espacio, el comentario seguido de otro espacio y la fecha
formateada (por ejemplo, 20170329).)
cm annotate c:\workspace\file.txt --repository=centralRep@myserver:8084
cm blame serverpath:/src/client/checkin/Checkin.cs#cs:73666
(Muestra las anotaciones del fichero (usando una especificacion de ruta de
servidor) comenzando por el changeset 73666.)
== CMD_DESCRIPTION_APPLY_LOCAL ==
Busca cambios locales (movidos localmente, borrados localmente y modificados
localmente) y los aplica para que Unity VCS pueda monitorizarlos.
== CMD_USAGE_APPLY_LOCAL ==
Sintaxis:
cm applylocal | al [--dependencies] [<item_path>[ ...]]
[--machinereadable [--startlineseparator=<sep>]
[--endlineseparator=<sep>] [--fieldseparator=<sep>]]
Opciones:
--dependencies Añade las dependencias de cambios locales a los ítems
a aplicar.
item_path Ítems a aplicar. Use comillas dobles (" ")
para especificar rutas que contengan espacios. Use un
espacio en blanco para separar rutas de ítems.
--machinereadable Muestra el resultado en un formato fácil de parsear.
--startlineseparator Usado con '--machinereadable', indica cómo deben
empezar las líneas del resultado.
--endlineseparator Usado con '--machinereadable', indica cómo deben
terminar las líneas del resultado.
--fieldseparator Usado con '--machinereadable', indica cómo deben
separarse los campos de cada línea resultante.
== CMD_HELP_APPLY_LOCAL ==
Notas:
- Si no se especifican las opciones --dependencies y <item_path>, la operación
involucra a todos los cambios locales en el espacio de trabajo.
- Siempre se aplican recursivamente desde la ruta indicada.
Ejemplos:
cm applylocal foo.c bar.c
cm applylocal .
(Aplica todos los cambios locales del directorio actual.)
cm applylocal
(Aplica todos los cambios locales del espacio de trabajo.)
cm applylocal --machinereadable
(Aplica todos los cambios locales del espacio de trabajo y muestra por
pantalla el resultado en un formato simple y fácil de parsear.)
cm applylocal --machinereadable --startlineseparator=">" \
--endlineseparator="<" --fieldseparator=","
(Aplica todos los cambios locales del espacio de trabajo y muestra por
pantalla el resultado en un formato simple y fácil de parsear, comenzando y
terminando cada línea con los separadores indicados y separando los campos
de cada línea con el separador también indicado.)
== CMD_DESCRIPTION_ARCHIVE ==
Almacena datos en almacenamiento externo.
== CMD_USAGE_ARCHIVE ==
Sintaxis:
cm archive | arch <revspec>[ ...] [-c=<str_comment>]
[--file=<base_file>]
(Extrae datos del repositorio y los almacena en un almacenamiento externo.)
cm archive | arch <revspec>[ ...] --restore
(Restaura al repositorio datos previamente almacenados.)
revspec Una o más especificaciones de revisión.(Use 'cm help objectspec'
para más información sobre especificaciones de revisiones.)
--restore Restaura desde los ficheros generados durante el almacenamiento
los datos previamente almacenados. El almacenamiento externo y
el fichero externaldata.conf tienen que estar disponibles en el
momento de la restauración de la revisión. Consulte las Notas
para más información.
Opciones:
-c Aplica un comentario en los ficheros de almacenamiento que
se van a crear.
--file Prefijo y ruta (opcional) de los nuevos ficheros de
almacenamiento de datos.
== CMD_HELP_ARCHIVE ==
Notas:
Este comando extrae datos del repositorio y los almacena en un almacenamiento
externo, ahorrando así espacio en la base de datos.
El comando también restaura (--restore) las revisiones que previamente
fueron archivadas para volverlas a introducir en el repositorio.
Use 'cm help objectspec' para saber más sobre especificaciones de revisiones.
El usuario que ejecute este comando debe ser administrador del servidor
de Unity VCS (propietario del servidor de repositorios) para que se le
permita completar la operación.
Cada segmento de datos de las revisiones especificadas se almacenará en
un fichero diferente cuyo nombre comenzará por el texto definido en el
argumento --file. Este argumento puede ser un path completo incluyendo un
prefijo o únicamente el prefijo.
Una vez archivados los datos de las revisiones, se podrá acceder a ellos
de dos maneras:
1. Desde el cliente: El cliente de Unity VCS detectará si los datos fueron
fueron archivados y pedirá al usuario que indique la ubicación de los
ficheros.
El usuario configurará las ubicaciones de almacenamiento externo en un
fichero llamado externaldata.conf. El fichero se creará en las ubicaciones
estándar donde se encuentran los ficheros de configuración y siguiendo las
mismas reglas que se aplican para el fichero client.conf. El fichero
externaldata.conf contendrá las rutas en los que se encuentren los datos
archivados.
2. Desde el servidor: Con este método, los usuarios no tienen que saber si
los datos han sido archivados o no ya que las peticiones se resuelven de
forma transparente por el servidor. Para ello, el administrador creará un
fichero llamado externaldata.conf en el directorio del servidor e
introducirá las rutas donde se archivaron los datos.
Para restaurar (restore) los datos de una revisión (o conjunto de
revisiones), el cliente tiene que poder acceder a los ficheros donde los
datos se almacenaron. Por tanto, no es posible restaurar datos que estén
siendo resueltos por el servidor (método 2) porque el cliente no podrá
identificarlos como archivados.
Para restaurar usando el método 2, el administrador tiene que editar el
fichero externaldata.conf en el servidor para eliminar el acceso a los
ficheros archivados para que puedan ser restaurados.
Ejemplo para archivar:
1) Archivar una revisión:
cm archive Assets/RoofTextures/Textures/Wooden_Roof_05.png --file=/Users/ruben/archive/battle
2) Es posible comprobar la revisión archivada en la ruta especificada:
ls -al /Users/ruben/archive/battle*
-rw-r--r-- 1 ruben staff 2220039 Nov 9 10:52 /Users/ruben/archive/battle-100280-167
Ejemplo para restaurar:
1) Añadir la ruta de almacenamiento al fichero externaldata.conf:
vi /Users/ruben/.plastic4/externaldata.conf
/Users/ruben/archive
2) Restaurar la revisión:
cm archive Assets/RoofTextures/Textures/Wooden_Roof_05.png --restore
Configure la variable de entorno PLASTICEDITOR para especificar un editor
para escribir el comentario. Si la variable de entorno PLASTICEDITOR está
configurada pero no se indica ningún comentario, el editor se abrirá para
que pueda escribir el comentario.
Lectura desde stdin:
El comando 'archive' puede leer rutas desde stdin. Para ello, pase como
argumento un guión "-".
Por ejemplo: cm archive -
Las rutas se leerán hasta que se introduzca una línea en blanco.
Este tipo de lectura permite usar una tubería (pipe) para especificar qué
ficheros se van a almacenar (archive).
Por ejemplo:
dir /S /B *.c | cm archive --all -
(En Windows, almacena (archive) todos los ficheros del workspace con
extensión .c.)
Ejemplos:
cm archive bigfile.zip#br:/main
(Almacena la última revisión de 'bigfile.zip' en la rama 'main'.)
cm archive bigfile.zip#br:/main --restore
(Restaura la revisión almacenada.)
cm archive rev:myfile.pdf#cs:2 -c="big pdf file" --file=c:\arch_files\arch
(Archiva la revisión del changeset 2 de myfile.pdf en la carpeta
'c:\archived_files'. El nombre del fichero de almacenamiento comenzará con
'arch' (por ejemplo, arch_11_56).)
cm find "revs where size > 26214400" --format="{item}#{branch}" \
--nototal | cm archive -c="volume00" --file="volume00" -
(Archiva todos los ficheros de tamaño mayor de 25Mb en ficheros de
almacenamiento cuyo nombre empiece por 'volume00'.)
== CMD_DESCRIPTION_ATTRIBUTE ==
Permite al usuario administrar atributos.
== CMD_USAGE_ATTRIBUTE ==
Sintaxis:
cm attribute | att <command> [options]
Comandos:
create | mk
delete | rm
set
unset
rename
edit
Para obtener más información de cada uno de los comandos use lo siguiente:
cm attribute <command> --usage
cm attribute <command> --help
== CMD_HELP_ATTRIBUTE ==
Ejemplos:
cm attribute create status
cm attribute set att:status br:/main/SCM105 open
cm attribute unset att:status br:/main/SCM105
cm attribute delete att:status
cm attribute rename att:status "buildStatus"
cm attribute edit att:status "Status of the task in the CI pipeline"
== CMD_DESCRIPTION_CHANGELIST ==
Agrupa los cambios pendientes en listas de cambios (changelists).
== CMD_USAGE_CHANGELIST ==
Sintaxis:
a) Manejo de los objetos 'changelist':
cm changelist | clist [--symlink]
(Muestra todas las listas de cambios.)
cm changelist | clist create <clist_name>
[<clist_desc>] [--persistent | --notpersistent] [--symlink]
(Crea una lista de cambios.)
cm changelist | clist delete <clist_name> [--symlink]
(Borra la lista de cambios indicada. Si dicha lista contiene cambios
pendientes, estos se moverán a lista de cambios 'default'.)
cm changelist | clist edit <clist_name> [<action_name> <action_value>]
[--persistent | --notpersistent] [--symlink]
(Edita la lista de cambios indicada.)
b) Manejo del contenido de un 'changelist':
cm changelist | clist <clist_name> (add | rm) <path_name>[ ...]
[--symlink]
(Edita la lista de cambios indicada y añade (add) o quita (rm) los cambios
que concuerden con la ruta especificada. Use un espacio en blanco para
separar rutas. Use comillas dobles (" ") para especificar rutas que
contengan espacios. El estado de las rutas debe ser 'Added' o
'Checked-out'.)
Opciones:
clist_name El nombre de la lista de cambios (changelist). Se puede
usar la ruta a un archivo que contenga el nombre en su
lugar. Más información en --namefile.
clist_desc La descripción de la lista de cambios. Se puede usar la
ruta a un archivo que contenga el nombre en su lugar.
Más información en --descriptionfile.
action_name Seleccione 'rename' o 'description' para modificar un
changelist.
action_value Aplica el nuevo cambio o la nueva descripción al editar
la lista de cambios.
--persistent La lista de cambios permanecerá en el espacio de trabajo
aun cuando los cambios en ella se hayan protegido
(checked-in) o deshecho.
--notpersistent (Por defecto.) La lista de cambios no permanecerá en el
espacio de trabajo cuando los cambios en ella se protejan
(checked-in) o se deshagan.
--symlink Aplica la operación al symlink pero no al destino
(target).
--namefile Una ruta válida al archivo que contiene el nombre de la
lista de cambios. El archivo debe existir en esa ruta, debe
contener algo de texto y no puede contener saltos de línea.
--newnamefile Una ruta válida al archivo que contiene el nuevo nombre de
la lista de cambios cuando se edita para renombrar. El
archivo debe existir en esa ruta, debe de contener algo de
texto y no puede contener saltos de línea.
--descriptionfile Una ruta válida al archivo que contiene la descripción deseada
para la lista de cambios. El archivo debe existir en esa ruta.
== CMD_HELP_CHANGELIST ==
Notas:
El comando 'changelist' gestiona tanto las listas de cambios pendientes del
espacio de trabajo como los cambios dentro de la lista.
Ejemplos:
cm changelist
(Muestra las listas de cambios del espacio de trabajo actual.)
cm changelist create config_changes "dotConf files" --persistent
(Crea una nueva lista de cambios llamada 'config_changes' con descripción
'dotConf files' que permanecerá en el espacio de trabajo después de que sus
cambios se hayan protegido (checked-in) o deshecho.)
cm changelist create --namefile="name.txt" --descriptionfile="desc.txt"
(Crea una nueva lista de cambios cuyo nombre y descripción son tomados de
archivos.)
cm changelist edit config_changes rename config_files --notpersistent
(Edita la lista de cambios 'config_changes' renombrándola a 'config_files'
y haciéndola no persistente.)
cm changelist edit config_changes --notpersistent
(Edita la lista de cambios 'config_changes' haciéndola no persistente.)
cm changelist delete config_files
(Elimina la lista de cambios 'config_files' del espacio de trabajo actual.)
cm changelist delete --namefile="name.txt"
(Elimina la lista de cambios identificada por el nombre contenido en 'name.txt'
del espacio de trabajo actual.)
cm changelist config_files add foo.conf
(Añade el fichero 'foo.conf' a la lista de cambios 'config_files'.)
cm changelist config_files rm foo.conf readme.txt
(Elimina los ficheros 'foo.conf' y 'readme.txt' de la lista de cambios
'config_files' y los mueve la lista de cambios por defecto del sistema.)
cm changelist edit --namefile="name.txt" description --descriptionfile="desc.txt"
(Edita la lista de cambios identificada por el nombre contenido en 'name.txt', cambiando
su descripción por el contenido del archivo 'desc.txt'.)
cm changelist edit --namefile="name.txt" rename --newnamefile="newname.txt"
(Edita la lista de cambios identificada por el nombre contenido en 'name.txt' file,
renombrándola por el contenido del archivo 'newname.txt'.)
== CMD_DESCRIPTION_CHANGESET ==
Ejecuta operaciones avanzadas sobre changesets.
== CMD_USAGE_CHANGESET ==
Sintaxis:
cm changeset <command> [options]
Comandos:
move | mv
delete | rm
editcomment | edit
Para obtener más información de cada uno de los comandos use lo siguiente:
cm changeset <command> --usage
cm changeset <command> --help
== CMD_HELP_CHANGESET ==
Ejemplos:
cm changeset move cs:15@myrepo br:/main/scm005@myrepo
cm changeset delete cs:2b55f8aa-0b29-410f-b99c-60e573a309ca@devData
== CMD_DESCRIPTION_CHANGESET_EDIT_COMMENT ==
Modifica el comentario de un changeset.
== CMD_USAGE_CHANGESET_EDIT_COMMENT ==
Sintaxis:
cm changeset editcomment | edit <csetspec> <new_comment>
Opciones:
csetspec El changeset cuyo comentario se va a editar. (Use
'cm help objectspec' para más información sobre
especificaciones de changesets.)
new_comment El nuevo comentario que se aplicará al changeset indicado.
== CMD_HELP_CHANGESET_EDIT_COMMENT ==
Notas:
- La especificación del changeset debe ser válida.
Ejemplos:
cm changeset editcomment cs:15@myrepo "I forgot to add the checkin details"
cm changeset edit cs:cb11ecdb-1aa9-4f11-8698-dcab14e5885a \
"This comment text will replace the previous one."
cm changeset edit "89095131-895d-4173-9440-ff9ef9b2538d@project@cloud" \
"Changing my comment"
== CMD_DESCRIPTION_CHANGESET_MOVE ==
Mueve un changeset y todos sus descendientes a otra rama.
== CMD_USAGE_CHANGESET_MOVE ==
Sintaxis:
cm changeset move | mv <csetspec> <branchspec>
Opciones:
csetspec El primer changeset que debe moverse a una rama
diferente. Todos los changeset descendientes en la
misma rama se moverán también.
(Use 'cm help objectspec' para más información sobre
especificaciones de changesets.)
branchspec La rama destino a la que mover los changesets
seleccionados. Debe estar vacía o no existir. En caso
de no existir, el comando la creará.
(Use 'cm help objectspec' para más información sobre
especificaciones de ramas.)
== CMD_HELP_CHANGESET_MOVE ==
Notas:
- La especificación del changeset debe ser válida.
- La rama de destino debe estar vacía o no existir.
- Si la rama de destino no existe, el comando la creará.
- Los enlaces de merge no se verán afectados dado que las ramas no están
involucradas en ellos.
Ejemplos:
cm changeset move cs:15@myrepo br:/main/scm005@myrepo
cm changeset move cs:cb11ecdb-1aa9-4f11-8698-dcab14e5885a br:/hotfix/TL-352
== CMD_DESCRIPTION_CHANGESET_DELETE ==
Elimina un changeset del repositorio.
== CMD_USAGE_CHANGESET_DELETE ==
Sintaxis:
cm changeset delete | rm <csetspec>
Opciones:
csetspec El changeset a eliminar. Debe cumplir con una serie de
condiciones. Consulte las Notas para más información.
(Use 'cm help objectspec' para más información sobre
especificaciones de changesets.)
== CMD_HELP_CHANGESET_DELETE ==
Notas:
- El changeset debe ser el último en su rama.
- El changeset no puede ser el padre de otro changeset.
- El changeset no debe ser origen de un merge ni formar parte de un intervalo
de merge.
- El changeset no tiene que tener ninguna etiqueta.
- El changeset no puede ser el changeset raíz (cs:0).
Ejemplos:
cm changeset rm cs:4525@myrepo@myserver
cm changeset delete cs:cb11ecdb-1aa9-4f11-8698-dcab14e5885a
== CMD_DESCRIPTION_CHANGEUSERPASSWORD ==
Cambia el password del usuario (UP).
== CMD_USAGE_CHANGEUSERPASSWORD ==
Sintaxis:
cm changepassword | passwd
== CMD_HELP_CHANGEUSERPASSWORD ==
Notas:
Este comando está disponible solo si la configuración de seguridad es UP
(user/password).
Lea la Guía del Administrador para más información:
https://www.plasticscm.com/download/help/adminguide
Las contraseñas antigua y nueva son obligatorias.
Ejemplo:
cm passwd
== CMD_DESCRIPTION_CHECKCONNECTION ==
Comprueba la conexión con el servidor.
== CMD_USAGE_CHECKCONNECTION ==
Sintaxis:
cm checkconnection | cc
== CMD_HELP_CHECKCONNECTION ==
Notas:
- Este comando devuelve un mensaje indicando si existe una conexión válida
con el servidor de Unity VCS configurado.
- El comando comprueba la compatibilidad de versiones con el servidor.
- El comando también comprueba si el usuario configurado es válido o no.
== CMD_DESCRIPTION_CHECKDB ==
Comprueba la integridad de los repositorios.
== CMD_USAGE_CHECKDB ==
Sintaxis:
cm checkdatabase | chkdb [<repserverspec> | <repspec>]
Options:
repserverspec Servidor de repositorios.
repspec Repositorio.
(Use 'cm help objectspec' para más información sobre especificaciones de
servidor de repositorios y repositorio..)
== CMD_HELP_CHECKDB ==
Notas:
- Si no se indica ninguna especificación (de servidor de repositorios o de
repositorio), la comprobación se hará sobre el servidor indicado en el
fichero client.conf.
Ejemplos:
cm checkdatabase repserver:localhost:8084
cm chkdb rep:default@localhost:8084
== CMD_DESCRIPTION_CHECKIN ==
Guarda (protege) los cambios en el repositorio.
== CMD_USAGE_CHECKIN ==
Sintaxis:
cm checkin | ci [<item_path>[ ...]]
[-c=<comentario> | -commentsfile=<fichero_comentario>]
[--all|-a] [--applychanged] [--private] [--update] [--symlink]
[--noshowchangeset]
[--machinereadable [--startlineseparator=<sep>]
[--endlineseparator=<sep>] [--fieldseparator=<sep>]]
Opciones:
item_path Ítems a guardar (checkin). Use comillas dobles (" ")
para especificar rutas que contengan espacios. Use un
espacio en blanco para separar rutas de ítems.
Use . para hacer checkin al directorio actual.
-c Asigna el comentario indicado al changeset que se crea
en el checkin.
-commentsfile Asigna el comentario especificado en el fichero al
changeset que se crea en el checkin.
--all | -a Incluye en el checkin los ítems de las rutas indicadas
que han sido cambiados, movidos y borrados localmente.
--applychanged Incluye en el checkin los ítems cambiados y los
desprotegidos (checked-out).
--private Incluye en el checkin los ítems privados.
--update Procesa automáticamente un update-merge si fuera
necesario.
--symlink Incluye en el checkin al symlink pero no al destino
(target).
--noshowchangeset No muestra el changeset resultante.
--machinereadable Muestra el resultado en un formato fácil de parsear.
--startlineseparator Usado con '--machinereadable', indica cómo deben
empezar las líneas del resultado.
--endlineseparator Usado con '--machinereadable', indica cómo deben
terminar las líneas del resultado.
--fieldseparator Usado con '--machinereadable', indica cómo deben
separarse los campos de cada línea resultante.
== CMD_HELP_CHECKIN ==
Notas:
- Si no se especifica ningún <item_path>, el checkin afecta a todos los
cambios pendientes en el workspace.
- El checkin siempre se aplica recursivamente desde la ruta especificada.
- Para proteger (checkin) un ítem:
- El ítem tiene que estar controlado (checked-in).
- Si el ítem es privado (no está controlado), es necesario indicar el
argumento --private para poder protegerlo (checkin).
- El ítem tiene que estar desprotegido (checked-out).
- Si el ítem ha cambiado pero no está desprotegido (no checked-out), no es
necesario indicar el argumento --applychanged a no ser que <item_path>
sea un directorio o contenga wildcards ('*').
El contenido de la revisión a proteger (checkin) debería ser diferente de la
revisión anterior.
Configure la variable de entorno PLASTICEDITOR para especificar un editor
para escribir el comentario. Si la variable de entorno PLASTICEDITOR está
configurada pero no se indica ningún comentario, el editor se abrirá para
que pueda escribir el comentario.
Lectura desde stdin:
El comando 'checkin' puede leer rutas desde stdin. Para ello, pase como
argumento un guión "-".
Por ejemplo: cm checkin -
Las rutas se leerán hasta que se introduzca una línea en blanco.
Este tipo de lectura permite usar una tubería (pipe) para especificar qué
ficheros se van a proteger (checkin).
Por ejemplo:
dir /S /B *.c | cm checkin --all -
(En Windows, protege (checkin) todos los ficheros del workspace con
extensión .c.)
Ejemplos:
cm checkin file1.txt file2.txt
(Protege (checkin) los ficheros desprotegidos (checked-out) 'file1.txt' y
'file2.txt'.)
cm checkin . -commentsfile=micomentario.txt
(Protege (checkin) el directorio actual y aplica el comentario incluido en
el fichero 'mycomment.txt'.)
cm checkin link --symlink
(Protege (checkin) el fichero symlink y no el destino (target).)
cm ci file1.txt -c="my comment"
(Protege (checkin) el fichero 'file1.txt' y aplica el comentario.)
cm status --short --compact --changelist=pending_to_review | cm checkin -
(Obtiene los ítems de la lista de cambios (changelist) 'pending_to_review' y
las redirecciona como entrada al comando checkin para protegerlos.)
cm ci . --machinereadable
(Protege (checkin) el directorio actual y muestra por pantalla el resultado
en un formato simple y fácil de parsear.)
cm ci . --machinereadable --startlineseparator=">" --endlineseparator="<" --fieldseparator=","
(Protege (checkin) el directorio actual y muestra por pantalla el resultado
en un formato simple y fácil de parsear, comenzando y terminando cada línea
con los separadores indicados y separando los campos de cada línea con el
separador también indicado.)
== CMD_DESCRIPTION_CHECKOUT ==
Marca los ficheros para ser modificados (desprotege).
== CMD_USAGE_CHECKOUT ==
Sintaxis:
cm checkout | co [<item_path>[ ...]] [-R | -r | --recursive]
[--format=<str_format>]
[--errorformat=<str_format>] [--resultformat=<str_format>]
[--silent] [--symlink] [--ignorefailed]
[--machinereadable [--startlineseparator=<sep>]
[--endlineseparator=<sep>] [--fieldseparator=<sep>]]
Opciones:
item_path Ítems a desproteger (checkout). Use comillas dobles (" ")
para especificar rutas que contengan espacios. Use un
espacio en blanco para separar rutas de ítems.
Use . para hacer checkout al directorio actual.
-R Desprotege (checkout) los ficheros recursivamente.
--format Muestra el progreso en la salida con el formato
indicado. Consulte los ejemplos para más información.
--resultformat Muestra el resultado en la salida con el formato
indicado. Consulte los ejemplos para más información.
--silent No muestra nada en la salida.
--symlink Incluye en el checkout al symlink pero no al destino
(target).
--ignorefailed Si no se puede hacer un checkout exclusivo (bloqueo)
de un ítem, el checkout continuará sin él.
--machinereadable Muestra el resultado en un formato fácil de parsear.
--startlineseparator Usado con '--machinereadable', indica cómo deben
empezar las líneas del resultado.
--endlineseparator Usado con '--machinereadable', indica cómo deben
terminar las líneas del resultado.
--fieldseparator Usado con '--machinereadable', indica cómo deben
separarse los campos de cada línea resultante.
== CMD_HELP_CHECKOUT ==
Notas:
Para desproteger (checkout) un ítem:
- El ítem tiene que estar controlado (bajo control de versiones)
- El ítem debe estar protegido (checked-in).
Si los bloqueos están configurados en el servidor (existe el fichero
lock.conf), cada vez que se produza un checkout en un ítem, Unity VCS
comprueba si se cumple alguna de las reglas de bloqueo. Si se cumple, el
ítem se bloqueará (checkout exclusivo) y nadie podrá hacer otro checkout.
Para conocer los bloqueos que existen en cualquier momento en el servidor
usa el comando 'cm lock list'.
Lea la Guía del Administrador para más información:
https://www.plasticscm.com/download/help/adminguide
El texto en el argumento --format reemplaza a la variable '{0}' del ítem que
se va a desproteger (checkout). Consulte los ejemplos para más información.
Lectura desde stdin:
El comando 'checkout' puede leer rutas desde stdin. Para ello, pase como
argumento un guión "-".
Por ejemplo: cm checkout -
Las rutas se leerán hasta que se introduzca una línea en blanco.
Este tipo de lectura permite usar una tubería (pipe) para especificar qué
ficheros se van a desproteger (checkout).
Por ejemplo:
dir /S /B *.c | cm checkout --all -
(En Windows, desprotege (checkout) todos los ficheros del workspace con
extensión .c.)
Ejemplos:
cm checkout file1.txt file2.txt
(Desprotege (checkout) los ficheros 'file1.txt' y 'file2.txt'.)
cm co *.txt
(Desprotege (checkout) todos los ficheros con extensión .txt.)
cm checkout .
(Desprotege (checkout) el directorio actual.)
cm checkout -R c:\workspace\src
(Desprotege (checkout) recursivamente el contenido de la carpte 'src'.)
cm co file.txt --format="Checking out item {0}"
--resultformat="Item {0} checked out"
(Desprotege (checkout) el fichero 'file.txt' y usa un formato determinado
para mostrar el progreso de la operación y el resultado.)
cm checkout link --symlink
(Desprotege (checkout) el fichero symlink y no el destino (target).)
cm checkout . -R --ignorefailed
(Desprotege (checkou) recursivamente el directorio actual ignorando aquellos
ficheros que no se pueden desproteger.)
cm co . --machinereadable --startlineseparator=">"
(Desprotege (checkout) el directorio actual y muestra por pantalla el
resultado en un formato simple y fácil de parsear, comenzando cada línea con
el separador indicado.)
== CMD_DESCRIPTION_CHECKSELECTORSYNTAX ==
Comprueba la sintaxis de un selector.
== CMD_USAGE_CHECKSELECTORSYNTAX ==
Sintaxis:
cm checkselectorsyntax | css --file=<selector_file>
(Comprueba la sintaxis del fichero del selector.)
cat <selector_file> | cm checkselectorsyntax | css -
(Unix. Comprueba el fichero del selector desde la entrada estándar.)
type <selector_file> | cm checkselectorsyntax | css -
(Windows. Comprueba el fichero del selector desde la entrada estándar.)
--file Fichero desde el que leer el selector.
== CMD_HELP_CHECKSELECTORSYNTAX ==
Notas:
Este comando lee el selector tanto de un fichero o de la entrada estándar, y
comprueba su sintaxis. Si esta comprobación falla, los motivos de este fallo
se mostrarán por la salida estándar.
Ejemplos:
cm checkselectorsyntax --file=myselector.txt
(Comprueba la sintaxis del fichero 'myselector.txt'.)
cat myselector.txt | cm checkselectorsyntax
(Comprueba la sintaxis del fichero 'myselector.txt' desde la entrada estándar.)
== CMD_DESCRIPTION_CHGREVTYPE ==
Cambia el tipo de revisión (binario o texto) de un ítem.
== CMD_USAGE_CHGREVTYPE ==
Sintaxis:
cm changerevisiontype | chgrevtype | crt <item_path>[ ...] --type=(bin | txt)
item_path Ítems a los que cambiar el tipo de revisión. Use comillas
dobles (" ") para especificar rutas que contengan
espacios. Use un espacio en blanco para separar rutas de
ítems.
--type Tipo de revisión: 'bin' (binario) o 'txt' (texto).
== CMD_HELP_CHGREVTYPE ==
Notas:
Este comando solo se puede aplicar a ficheros y no a directorios.
El tipo especificado debe ser uno de los soportados por el sistema: 'bin'
(binario) o 'txt' (texto).
Ejemplos:
cm changerevisiontype c:\workspace\file.txt --type=txt
(Cambia el tipo de revisión del fichero 'file.txt' a texto.)
cm chgrevtype comp.zip "image file.jpg" --type=bin
(Cambia el tipo de revisión de los ficheros 'comp.zip' e 'image file.jpg' a
binario.)
cm crt *.* --type=txt
(Cambia el tipo de revisión de todos los ficheros a texto.)
== CMD_DESCRIPTION_TRIGGER_EDIT ==
Edita un trigger.
== CMD_USAGE_TRIGGER_EDIT ==
Sintaxis:
cm trigger | tr edit <subtype_type> <position_number>
[--position=<new_position>]
[--name=<new_name>] [--script=<script_path>]
[--filter=<str_filter>] [--server=<repserverspec>]
subtype_type Ejecución y operación del trigger.
(Use 'cm showtriggertypes' para ver la lista de tipos de
triggers.)
position_number Posición que ocupa el trigger que se va a modificar.
Opciones:
--position Nueva posición del trigger a modificar.
Esta posición no debe estar en uso por otro trigger del
mismo tipo.
--name Nuevo nombre del trigger a modificar.
--script Nueva ruta de ejecución del script del trigger a modificar.
Si el script comienza con "webtrigger ", el trigger se
considerará como trigger de tipo web. Consulte las Notas
para más información.
--filter Comprueba solo los ítems que cumplen con el filtro
indicado.
--server Modifica el trigger del servidor indicado.
Si no se especifica ningún trigger, entonces el comando
se ejecuta en el servidor configurado en el cliente.
(Use 'cm help objectspec' para más información sobre
especificaciones de servidor.)
== CMD_HELP_TRIGGER_EDIT ==
Notas:
Web triggers: Un trigger web se crea escribiendo "webtrigger <target-uri>"
como comando del trigger. En este caso, el trigger ejecutará una consulta
POST contra el URI especificado en la que el cuerpo de la petición
contiene un diccionario JSON con las variables de entorno del trigger y una
clave INPUT apuntando a un vector de cadenas de texto .
Ejemplos:
cm trigger edit after-setselector 6 --name="Backup2 manager" --script="/new/path/al/script"
cm tr edit before-mklabel 7 --position=4 --server=myserver:8084
cm trigger edit after-add 2 --script="webtrigger http://myserver.org/api"
== CMD_DESCRIPTION_CODEREVIEW ==
Crea, edita o elimina revisiones de código.
== CMD_USAGE_CODEREVIEW ==
Sintaxis:
cm codereview <spec> <title> [--status=<status_name>]
[--assignee=<user_name>] [--format=<str_format>]
[--repository=<rep_spec>]
(Crea una revisión de código.)
cm codereview -e <id> [--status=<status_name>] [--assignee=<user_name>]
[--repository=<rep_spec>]
(Edita una revisión de código.)
cm codereview -d <id> [ ...] [--repository=<rep_spec>]
(Borra una o más revisiones de código.)
spec Puede ser una especificación de changeset, una especificación de
shelve o una especificación de rama. Creará la nueva revisión de
código de dicha especificación. (Use 'cm help objectspec' para más
información sobre especificaciones de changeset o rama.)
title Cadena de texto que se usará como título de la revisión de
código.
id Número de identificación de la revisión de código. También se
puede usar un GUID.
Opciones:
-e Edita los parámetros de una revisión de código.
-d Elimina una o más revisiones de código. Use un espacio en
blanco para separar los identificadores de las revisiones de
código.
--status Aplica el nuevo estado a la revisión de código. Consulte las
Notas para más información.
--assignee Aplica el nuevo usuario asignado a la revisión de código.
--format Muestra el mensaje de salida con el formato indicado.
Consulte las Notas para más información.
--repository Indica el repositorio que se utilizará por defecto. (Use
'cm help objectspec' para más información sobre
especificaciones de repositorio.)
== CMD_HELP_CODEREVIEW ==
Notas:
Este comando permite a los usuarios gestionar revisiones de código: crear,
editar y eliminar revisiones de código de changesets o ramas.
Para crear una nueva revisión de código se requiere una especificación de
changeset o rama además de un título. También se puede indicar el estado
inicial y el usuario asignado como revisor de los cambios.
Como resultado se devolverá el identificador ID (o GUID).
Para editar o eliminar una revisión de código existente debe indicar el ID
(o GUID) de la misma. No se mostrarán mensajes si no ha habido errores.
El parámetro 'status' debe tener uno de los siguientes valores:
'Under review' (valor por defecto), 'Reviewed' o 'Rework required'.
El parámetro 'repository' sirve para especificar el repositorio por defecto.
Esto es útil cuando el usuario quiere gestionar revisiones de código de un
servidor diferente del asociado al espacio de trabajo actual o cuando no
existe un espacio de trabajo.
Parámetros de formato de salida (opción --format):
Este comando acepta una cadena de formato para mostrar la salida.
Los parámetros de salida de este comando son los siguientes:
{0} id
{1} guid
Tenga en cuenta que el parámetro --format solo tiene efecto al crear una
nueva revisión de código.
Ejemplos:
cm codereview cs:1856@myrepo@myserver:8084 "My code review" --assignee=dummy
cm codereview br:/main/task001@myrepo@myserver:8084 "My code review" \
--status="Rework required" --assignee=newbie --format="{id} -> {guid}"
cm codereview 1367 -e --assignee=new_assignee
cm codereview -e 27658884-5dcc-49b7-b0ef-a5760ae740a3 --status=Reviewed
cm codereview -d 1367 --repository=myremoterepo@myremoteserver:18084
cm codereview 27658884-5dcc-49b7-b0ef-a5760ae740a3 -d
== CMD_DESCRIPTION_CRYPT ==
Encripta una contraseña.
== CMD_USAGE_CRYPT ==
Sintaxis:
cm crypt <mypassword>
mypassword Contraseña que se va a encriptar.
== CMD_HELP_CRYPT ==
Notas:
Este comando encripta la contraseña que se pasa como argumento.
Está diseñado para encriptar las contraseñas de los ficheros de
configuración y aumentar así su seguridad.
Ejemplos:
cm crypt dbconfpassword -> ENCRYPTED: encrypteddbconfpassword
(Encripta la contraseña en el fichero de configuración de la base de datos:
'db.conf'.)
== CMD_DESCRIPTION_DEACTIVATEUSER ==
Desactiva un usuario con licencia.
== CMD_USAGE_DEACTIVATEUSER ==
Sintaxis:
cm deactivateuser | du <usr_name>[ ...] [--server=<name:port>]
[--nosolveuser]
usr_name Nombre del usuario a desactivar. Use un espacio en
blanco para separar nombres de usuario.
Si SID, entonces debe incluir el argumento '--nosolveuser'.
Options:
--server Desactiva el usuario en el servidor indicado. Si no se
indica ningún servidor, el comando se ejecuta en el
servidor configurado en el cliente.
--nosolveuser Si se indica esta opción, el comando no comprobará si el
nombre de usuario existe en el sistema de autentificación.
El nombre de usuario debe ser un usuario SID.
== CMD_HELP_DEACTIVATEUSER ==
Notas:
Este comando desactiva a un usuario. De este modo no podrá usar Unity VCS.
(Use 'cm activateuser' para más información sobre cómo activar usuarios de
Unity VCS.)
Este comando comprueba si el usuario existe en el sistema de autentificación
(por ejemplo, ActiveDirectory, LDAP, User/Password...).
Para forzar la desactivación de un usuario que ya no existe en el sistema de
autentificación, use la opción '--nosolveuser' option.
Ejemplos:
cm deactivateuser john
cm du peter "mary collins"
cm deactivateuser john --server=myserver:8084
cm deactivateuser S-1-5-21-3631250224-3045023395-1892523819-1107 --nosolveuser
== CMD_DESCRIPTION_DIFF ==
Muestra las diferencias entre ficheros, changesets o ramas.
== CMD_USAGE_DIFF ==
Sintaxis:
cm diff <csetspec> | <lbspec> | <shspec> [<csetspec> | <lbspec> | <shspec>]
[<path>]
[--added] [--changed] [--moved] [--deleted]
[--repositorypaths] [--download=<download_path>]
[--encoding=<name>]
[--comparisonmethod=(ignoreeol | ignorewhitespaces |
ignoreeolandwhitespaces | recognizeall)]
[--clean]
[--integration]
[--format=<str_format>] [--dateformat=<str_format>]
Muestra las diferencias entre un changeset o un shelveset 'origen' y un
changeset o un shelveset 'destino'. Los changesets se pueden especificar
usando una especificación de changeset o de etiqueta.
Si se indican dos especificaciones, la primera será el 'origen' del diff
y la segunda será el 'destino'.
Si se indica solo una especificación, el 'origen' será el changeset
padre del 'destino' indicado.
Si se especifica una ruta, la ventana de Diff se abrirá para mostrar las
diferencias entre las dos revisiones del fichero indicado.
cm diff <revspec1> <revspec2>
Muestra las diferencias entre un par de revisiones. Las diferencias se
muestran en la ventana de Diff. La primera revisión indicada aparecerá
a la izquierda.
cm diff <brspec> [--added] [--changed] [--moved] [--deleted]
[--repositorypaths] [--download=<download_path>]
[--encoding=<name>]
[--comparisonmethod=(ignoreeol | ignorewhitespaces |
ignoreeolandwhitespaces | recognizeall)]
[--clean]
[--integration]
[--format=<str_format>] [--dateformat=<str_format>]
[--fullpaths | --fp]
Muestra las diferencias de rama.
(Use 'cm help objectspec' para más información sobre especificaciones.)
Opciones:
--added Imprime las diferencias de ítems añadidos al repositorio.
--changed Imprime las diferencias de ítems que han cambiado.
--moved Imprime las diferencias de ítems movidos o renombrados.
--deleted Imprime las diferencias de ítems borrados.
Si no se indica ni '--added' ni '--changed' ni '--moved'
ni '--deleted', se imprimen todas las diferencias.
'A' significa ítems añadidos ('added'.)'
'C' significa ítems cambiados ('changed'.)
'D' significa ítems borrados ('deleted'.)
'M' significa ítems movidos ('moved'). El ítem a la
izquierda es el original, y el de la derecha es el
destino.
--repositorypaths Imprime rutas de repositorio en lugar de rutas de
workspace. (Esta opción anula la opción '--fullpaths'.)
--download Guarda el contenido de las diferencias en la ruta de
salida indicada.
--encoding Especifica el encoding que se usará en la salida, por
ejemplo, utf-8. Consulte la documentación de MSDN en
http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
para obtener la tabla de codificaciones soportadas y
su formato (al final de la página en la columna "Name").
--comparisonmethod Configura el método de comparación indicado.
Consulte las Notas para más información.
--clean Omite las diferencias que provienen de un merge mostrando
solo las diferencias creadas en los checkins.
--integration Muestra los cambios de la rama que están pendientes de
integrar en su rama padre. Tiene en cuenta los rebases
y los merges a la rama padre ya realizados.
--format Muestra el mensaje de salida en el formato indicado.
Consulte las Notas para más información.
--dateformat Configura el formato de salida para la impresión de fechas.
--fullpaths, --fp Fuerza la impresión de rutas de workspaces absolutas para
ficheros y directorios siempre que sea posible.
== CMD_HELP_DIFF ==
Notas:
Métodos de comparación (opción --comparisonmethod):
ignoreeol Ignora diferencias en final de línea.
ignorewhitespaces Ignora diferencias en espacios.
ignoreeolandwhitespaces Ignora diferencias en final de línea y espacios.
recognizeall Detecta diferencias en final de línea y espacios.
Parámetros de formato de salida (opción --format):
Este comando acepta una cadena de formato para mostrar la salida.
Los parámetros de salida de este comando son los siguientes:
{path} Ruta del ítem.
{date} Fecha/hora del cambio.
{owner} Autor del cambio.
{revid} Identificador de la revisión considerada como
destino en las diferencias.
{parentrevid} Identificador del padre de la revisión considerada
como destino en las diferencias.
{baserevid} Identificador de la revisión considerada como origen
en las diferencias.
{srccmpath} Ruta de servidor antes de mover un ítem (para la
operación de movido).
{dstcmpath} Ruta de servidor después de mover un ítem (para la
operación de movido).
{type} Tipo de ítem:
D directorio,
B fichero binario,
F fichero de texto,
S symlink,
X Xlink.
{repository} Repositorio del ítem.
{status} Estado del ítem:
A añadido,
D borrado,
M movido,
C cambiado.
{fsprotection} Muestra los permisos del ítem (Linux/Mac chmod).
{srcfsprotection} Muestra los permisos de la revisión padre del ítem.
{newline} Inserta una nueva línea.
Notas sobre 'revid':
Para ítems añadidos, 'baserevid' y 'parentrevid' es -1 puesto que no existe
revisión previa en estos casos.
Para ítems borrados, 'revid' es el identificador de la revisión origen, y
'baserevid' es -1 puesto que no existe revisión destino.
Para Xlinks, 'baserevid' y 'parentrevid' son siempre -1.
Ejemplos:
Comparar ramas:
cm diff br:/main/task001
cm diff br:/main/task001 \doc\readme.txt
cm diff br:/main/task001 --integration
Comparar changesets:
cm diff 19
cm diff 19 25
cm diff cs:19 cs:25 --format="{path} {parentrevid}"
cm diff cs:19 cs:23 --format="{date} {path}" --dateformat="yy/dd/MM HH:mm:ss"
cm diff cs:19 cs:23 --changed
cm diff cs:19 cs:23 --repositorypaths
cm diff cs:19 cs:23 --download="D:\temp"
cm diff cs:19 cs:23 --clean
cm diff cs:19 cs:23 \doc\readme.txt
Comparar etiquetas:
cm diff lb:EtiquetaPrimeraRelease lb:EtiquetaSegundaRelease
cm diff lb:tag_193.2 cs:34214
cm diff cs:31492 lb:tag_193.2
Comparar shelves:
cm diff sh:2
cm diff sh:2 sh:4
Comparar revisiones:
cm diff rev:readme.txt#cs:19 rev:readme.txt#cs:20
cm diff serverpath:/doc/readme.txt#cs:19@myrepo \
serverpath:/doc/readme.txt#br:/main@myrepo@localhost:8084
cm diff rev:foo.c#cs:1 rev:foo.c#cs:2 --comparisonmethod=ignoreeol
== CMD_DESCRIPTION_DIFFMETRICS ==
Muestra métricas de diferencias entre dos revisiones.
== CMD_USAGE_DIFFMETRICS ==
Sintaxis:
cm diffmetrics | dm <revspec1> <revspec2> [--format=<str_format>]
[--encoding=<name>]
[--comparisonmethod=(ignoreeol | ignorewhitespaces |
ignoreeolandwhitespaces | recognizeall)]
revspec Revisiones a comparar.
(Use 'cm help objectspec' para más información sobre
especificaciones de revisiones.)
Options:
--format Muestra el mensaje de salida en el formato indicado.
Consulte las Notas para más información.
--encoding Especifica el encoding que se usará en la salida, por
ejemplo, utf-8. Consulte la documentación de MSDN en
http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
para obtener la tabla de codificaciones soportadas y
su formato (al final de la página en la columna "Name").
--comparisonmethod Configura el método de comparación indicado.
Consulte las Notas para más información.
== CMD_HELP_DIFFMETRICS ==
Notas:
Las métricas que se obtienen son: número de líneas cambiadas, añadidas y
borradas.
Parámetros de formato de salida (opción --format):
Este comando acepta una cadena de formato para mostrar la salida.
Los parámetros de salida de este comando son los siguientes:
{0} Número de líneas cambiadas.
{1} Número de líneas añadidas.
{2} Número de líneas borradas.
Métodos de comparación (opción --comparisonmethod):
ignoreeol Ignora diferencias en final de línea.
ignorewhitespaces Ignora diferencias en espacios.
ignoreeolandwhitespaces Ignora diferencias en final de línea y espacios.
recognizeall Detecta diferencias en final de línea y espacios.
Ejemplos:
cm diffmetrics file.txt#cs:2 file.txt#br:/main/scm0211 \
--format="There are {0} changed, {1} added and {2} deleted lines."
(Muestra las métricas de diferencias en el formato indicado.)
cm dm file.txt#cs:2 file.txt#cs:3 --encoding=utf-8 --comparisonmethod=ignorewhitespaces
== CMD_DESCRIPTION_FASTEXPORT ==
Exporta los datos de un repositorio de Unity VCS a un formato fast-export.
== CMD_USAGE_FASTEXPORT ==
Sintaxis:
cm fast-export | fe <repspec> <fast-export-file>
[--import-marks=<marks_file>]
[--export-marks=<marks_file>]
[--branchseparator=<chr_separator>]
[--nodata] [--from=<changesetid>] [--to=<changesetid>]
Opciones:
repspec Repositorio cuyos datos serán exportados.
(Use 'cm help objectspec' para más información sobre
especificaciones de repositorio.)
fast-export-file Fichero con los datos del repositorio en formato
fast-export de Git.
--import-marks Fichero de marcas usado para la importación incremental.
Este fichero ha sido previamente exportado con el
comando --export-marks. Los changesets descritos en este
fichero no se importarán porque ya lo fueron en una
importación previa.
--export-marks Fichero donde se guardan los changesets importados.
Este fichero se usará en una operación fast-import para
indicar los changesets que han sido importados.
--branchseparator Unity VCS usa "/" como separador por defecto en la
jerarquía de ramas. Esta opción permite usar un carácter
como separador de jerarquía. Por ejemplo, la rama
main-task-sub será mapeada en Unity VCS como
/main/task/sub.
--nodata Exporta el repositorio pero sin incluir los datos. Esta
opción es útil para comprobar que la exportación se
llevará a cabo sin problemas.
--from Exporta desde el changeset especificado.
--to Exporta hasta el changeset especificado.
== CMD_HELP_FASTEXPORT ==
Notas:
- Para importar un repositorio de Unity VCS a Git, use un comando como el siguiente:
cat repo.fe.00 | git fast-import --export-marks=marks.git --import-marks=marks.git
- La exportación incremental se realiza usando un fichero de marcas que
contenga los changesets previamente importados (ficheros --import-marks y
--export-marks).
Esto significa que solamente se exportarán los changesets que no fueron
exportados con un fast-export previamente.
Ejemplos:
cm fast-export repo@localhost:8087 repo.fe.00 --import-marks=marks.cm --export-marks=marks.cm
(Exporta el repositorio 'repo' en el servidor local al fichero 'repo.fe.00'
en formato fast-export de Git y crea el fichero de marcas para poder
realizar una futura exportación incremental.)
cm fast-export repo@localhost:8087 repo.fe.00 --from=20
(Exporta el repositorio 'repo' en el servidor local al fichero 'repo.fe.00'
en formato Git fast-export desde el changeset '20'.)
== CMD_DESCRIPTION_FASTIMPORT ==
Importa datos de fast-export de Git a un repositorio.
== CMD_USAGE_FASTIMPORT ==
Sintaxis:
cm fast-import | fi <repspec> <fast-export-file>
[--import-marks=<marks_file>]
[--export-marks=<marks_file>]
[--stats] [--branchseparator=<chr_separator>]
[--nodata] [--ignoremissingchangesets] [--mastertomain]
Opciones:
repspec Repositorio en el cual se importarán los datos.
Si no existe en el momento de la operación, se
crea automáticamente. (Use 'cm help objectspec'
para más información sobre especificaciones de
repositorio.)
fast-export-file Fichero con los datos en formato Git
fast-export.
--import-marks El fichero de marcas utilizado para
importaciones incrementales. Dicho fichero se
ha exportado previamente con --export-marks.
Los changesets descritos en este fichero no se
importarán porque ya existían de una importación
previa.
--export-marks El fichero en el cual se guardarán los changesets
importados. Dicho fichero se utilizará en una
operación posterior de fast-import para indicar
los changesets que ya han sido importados.
--stats Muestra estadísticas del proceso de importación.
--branchseparator Unity VCS usa "/" como separador por defecto
en la jerarquía de ramas. Esta opción permite
usar un carácter como separador en esa
jerarquía. Por ejemplo, la rama main-task-sub
será mapeada en Unity VCS como /main/task/sub.
--nodata Importa Git fast-export pero sin incluir datos.
Esta opción es útil para comprobar que la
importación exportación se llevará a cabo sin
problemas.
--ignoremissingchangesets Los changesets que no pueden ser importados se
descartan y la operación de fast-import continúa
sin ellos.
--mastertomain Realiza la importación usando "main" en lugar
de "master".
== CMD_HELP_FASTIMPORT ==
Notas:
- Para exportar un repositorio de Git, use un comando como el siguiente:
git fast-export --all -M --signed-tags=strip --tag-of-filtered-object=drop> ..\git-fast-export.dat
La opción -M es importante para detectar ítems movidos.
- El repositorio indicado se crea en caso de que no exista.
- La importación incremental se realiza usando los ficheros de marcas que
contengan los changesets previamente importados (ficheros --import-marks y
--export-marks).
Esto significa que solamente se importarán los changesets que no fueron
importados con un fast-import previamente.
Ejemplos:
cm fast-import mynewrepo@atenea:8084 repo.fast-export
(Importa el contenido exportado en el fichero 'repo.fast-export' al
repositorio 'mynewrepo' del servidor 'atenea:8084'.)
cm fast-import repo@server:8084 repo.fast-export --export-marks=rep.marks
(Importa el contenido exportado en el fichero 'repo.fast-export' al
repositorio 'repo' del servidor 'atenea:8084' y crea un archivo de
marcas para importaciones incrementales posteriores.)
cm fast-import repo@server:8084 repo.fast-export --importmarks=repo.marks \
--export-marks=repo.marks
(Importa el contenido del fichero 'repo.fast-export'. Solamente se importarán
los changesets que no están en el fichero de marcas. Se utiliza el mismo
fichero de marcas para guardar la lista de changesets de nuevo para la
siguiente importación incremental.)
== CMD_DESCRIPTION_FILEINFO ==
Obtiene información detallada de ítems del espacio de trabajo.
== CMD_USAGE_FILEINFO ==
Sintaxis:
cm fileinfo <item_path>[ ...] [--fields=<field_value>[,...]]
[[--xml | -x [=<output_file>]] | [--format=<str_format>]]
[--symlink] [--encoding=<name>]
item_path Ítems a mostrar. Use comillas dobles (" ") para especificar
rutas que contengan espacios. Use un espacio en blanco para
separar rutas de ítems.
Opciones:
--fields Cadena de valores separados por coma. Indica qué campos Se
mostrarán por cada ítem. Consulte las Notas para más
información.
--xml | -x Imprime el resultado en formato XML a la salida estándar.
También es posible especificar un fichero de salida.
Esta opción no puede combinarse con --format.
--format Muestra el mensaje de salida en un formato específico.
Consulte las Notas para más información. No puede
combinarse con --xml.
--symlink Aplica la operación al symlink pero no al destino.
--encoding Especifica el encoding que se usará en la salida, por
ejemplo, utf-8. Consulte la documentación de MSDN en
http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
para obtener la tabla de codificaciones soportadas y
su formato (al final de la página en la columna "Name").
== CMD_HELP_FILEINFO ==
Notas:
Este comando muestra una lista detallada de atributos para cada ítem
indicado. Cada atributo se muestra en una nueva línea.
Se puede modificar la lista de atributos para mostrar únicamente los
atributos que el usuario necesite. Para ello, utilice el argumento
--fields=<field_list> que acepta una cadena de nombres de atributo
separados por comas. De este modo, solo se mostrarán aquellos argumentos
cuyo nombre esté presente en la lista.
Revision head changeset:
Esta opción está desactivada por defecto. Tenga en cuenta que la
recuperación de este atributo es notablemente más lenta que la del resto de
atributos, por lo que recomendamos agrupar tantos ficheros por ejecución como
sea posible. Esto mejora los tiempos de ejecución al evitar numerosas
ejecuciones de 'cm fileinfo' separadas.
Además, esta característica no se encuentra disponible actualmente para
directorios controlados.
A continuación se encuentra la lista completa de nombres de atributo. Los
nombres marcados con asterisco ('*') no se mostrarán:
ClientPath Ruta local del ítem en disco.
RelativePath Ruta relativa del ítem en el espacio de trabajo.
ServerPath Ruta del repositorio para el ítem.
(Nota: Los espacios de trabajo transformado no
están actualmente soportados para esta opción.)
Size Tamaño del ítem.
Hash Suma 'hash' del ítem.
Owner Nombre del usuario propietario del ítem.
RevisionHeadChangeset (*) Changeset de la revisión cargada en el
changeset head de la rama.
(Ver nota más arriba.)
RevisionChangeset Changeset de la revisión cargada en el espacio
de trabajo.
RepSpec Especificación del repositorio para el ítem.
(Use 'cm help objectspec' para más información
sobre especificaciones de repositorio.)
Status Estado del ítem en el espacio de trabajo:
añadido, desprotegido (checked-out), eliminado...
Type Tipo de la revisión (texto, binario, directorio,
symlink o desconocido).
Changelist Lista de cambios (si existe) a la que pertenece
el ítem.
IsLocked (*) Si el ítem está bloqueado por un checkout
exclusivo o no.
LockedBy (*) Usuario que bloqueó el ítem mediante
checkout exclusivo.
LockedWhere (*) Localización del ítem bloqueado mediante
checkout exclusivo.
IsUnderXlink Si el ítem está localizado en un Xlink o no.
UnderXlinkTarget Destino del Xlink (si existe) donde el ítem se
encuentra.
UnderXlinkPath Ruta de servidor del ítem en el repositorio del
Xlink (si existe).
UnderXlinkWritable Si el Xlink al que pertenece el ítem es de
escritura o no.
UnderXlinkRelative Si el Xlink al que pertenece el ítem es
relativo o no.
IsXlink Si el ítem es un Xlink o no.
XlinkTarget Repositorio destino al que el ítem apunta, si es
un Xlink.
XlinkName Nombre del ítem Xlink.
XlinkWritable Si el ítem Xlink es un Xlink de escritura o no.
XlinkRelative Si el ítem Xlink es un Xlink relativo o no.
Parámetros de formato de salida (opción --format):
Este comando acepta una cadena de formato para mostrar su salida.
Los parámetros de salida de este comando son los siguientes:
{ClientPath}
{RelativePath}
{ServerPath}
{Size}
{Hash}
{Owner}
{RevisionHeadChangeset}
{RevisionChangeset}
{Status}
{Type}
{Changelist}
{IsLocked}
{LockedBy}
{LockedWhere}
{IsUnderXlink}
{UnderXlinkTarget}
{UnderXlinkPath}
{UnderXlinkWritable}
{UnderXlinkRelative}
{IsXlink}
{XlinkTarget}
{XlinkName}
{XlinkWritable}
{XlinkRelative}
{RepSpec}
Tenga en cuenta que las opciones --format y --xml son mutuamente excluyentes,
por lo que no se pueden utilizar simultáneamente.
Ejemplos:
cm fileinfo file1.txt file2.txt dir/
cm fileinfo "New Project.csproj" --xml
cm fileinfo assets.art --fields=ServerPath,Size,IsLocked,LockedBy
cm fileinfo proj_specs.docx --fields=ServerPath,RevisionChangeset --xml
cm fileinfo samples.ogg --format="{ServerPath}[{Owner}] -> {Size}"
== CMD_DESCRIPTION_FIND_QUERY ==
Obtiene una serie de objetos en base a unos criterios de búsqueda.
== CMD_USAGE_FIND_QUERY ==
Sintaxis:
cm find <object_type>
[where <str_conditions>]
[on repository '<repspec>' | on repositories '<repspec1>','<repspec2>'[,...]]
[order by <sort_field> ['asc' | 'desc']]
[[limit <maxresults>] [offset <offset>]]
[--format=<str_format>] [--dateformat=<date_format>]
[--nototal] [--file=<dump_file>] [--xml]
[--encoding=<name>]
object_type Objecto a buscar.
Algunos de estos objetos permiten la cláusula 'order by'.
Use 'cm help showfindobjects' para más información sobre
estos objetos, aquellos que permiten ordenación y por qué campos.
Lea la Guía de 'cm find' para más información:
https://www.plasticscm.com/download/help/cmfind
Opciones:
str_conditions Condiciones de búsqueda sobre los atributos del objeto.
repspec Nombre o especificación del repositorio (o repositorios)
donde buscar.
Para 'on repositories', use una coma para separar las
especificaciones de repositorio.
(Use 'cm help objectspec' para más información sobre
especificaciones de repositorio.)
sort_field Nombre del campo elegido para la ordenación. Tenga en cuenta
que esos campos son limitados. Use 'cm help showfindobjects' para
consultar qué objetos se permiten ordenar y por qué campos.
maxresults Número máximo de resultados devueltos por la búsqueda.
offset Número de resultados que se omiten antes de empezar a devolver
los resultados de la búsqueda.
--format Muestra el mensaje de salida en el formato indicado.
Lea la Guía de 'cm find' para ver todos los atributos
de objeto que se pueden usar para el formato de salida:
https://www.plasticscm.com/download/help/cmfind
--dateformat Configura el formato de salida para la impresión de fechas.
--nototal No muestra el número total de registros.
--file Fichero al que volcar los resultados.
--xml Imprime el resultado en formato XML a la salida estándar.
--encoding Especifica el encoding que se usará en la salida, por
ejemplo, utf-8. Consulte la documentación de MSDN en
http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
para obtener la tabla de codificaciones soportadas y
su formato (al final de la página en la columna "Name").
== CMD_HELP_FIND_QUERY ==
Notas:
Si no se especifica ningún repositorio, la búsqueda se realiza sobre el
repositorio configurado en el espacio de trabajo.
Cuando se ejecutan búsquedas desde la línea de comandos usando operadores de
comparación (>, <, >=, <=), el intérprete de comandos (o shell) considera a
estos operadores como redirecciones de E/S. Por lo que es necesario escribir
la búsqueda entre comillas dobles.
El comando 'cm find' acepta una cadena de formato para mostrar la salida.
Cada parámetro de salida se identifica con un nombre, y el usuario se
puede referir a él escribiéndolo entre llaves '{' y '}'.
Los parámetros de salida se corresponden normalmente con atributos del objeto.
Estas son cadenas de formato válidas:
--format={id}{date}{name}
--format="{item}#{branch} con fecha {date}"
Consideraciones sobre XML y encoding:
Cuando se especifica la opción --xml, se muestra el resultado como texto XML
en la salida estándar. Por defecto se utiliza la codificación estándar del
sistema operativo, por lo que es posible que los caracteres no ANSI no se
visualicen correctamente en la consola. Pero si se redirige la salida a un
fichero, el contenido se visualizará correctamente.
Cuando se especifican simultáneamente las opciones --xml y --file, se
utiliza por defecto la codificación UTF-8.
Ejemplos:
cm find revision
cm find revision "where changeset = 23 and owner = 'user'"
cm find branch "on repository 'rep1'"
cm find label "on repositories 'rep1', 'rep:default@localhost:8084'"
cm find branch "where parent = 'br:/main' on repository 'rep1'"
cm find revision "where item = 'item:.'" --format="{item}#{branch}"
cm find revision "where item = 'item:.'" --xml --file=c:\queryresults\revs.xml
cm find label "where owner='me' limit 10 offset 20"
cm find branches "where owner='me' order by branchname desc limit 10"
== CMD_DESCRIPTION_FINDCHANGED ==
Obtiene una lista de los ficheros cambiados. Este comando está obsoleto y solo
se mantiene por retrocompatibilidad. Use 'cm status'.
== CMD_USAGE_FINDCHANGED ==
Sintaxis:
cm findchanged | fc [-R | -r | --recursive] [--checkcontent]
[--onlychanged] [<path>]
Opciones:
-R Busca recursivamente en los directorios.
--checkcontent Compara los ficheros por contenido.
--onlychanged Encuentra solo los ficheros cambiados; los ficheros
desprotegidos no se devolverán en la búsqueda.
path (Por defecto, el directorio actual.)
Ruta inicial de búsqueda de los ficheros cambiados.
== CMD_HELP_FINDCHANGED ==
Notas:
Si no se especifica la opción '--checkcontent', Unity VCS busca cambiados
basándose en el registro de tiempo (timestamp) de los ficheros.
Si se especifica la opción '--checkcontent', entonces lo que se compara es
el contenido de los ficheros o las carpetas y no el timestamp.
Este comando es útil para detectar ficheros que han cambiado durante una
desconexión del servidor de Unity VCS. La salida de este comando permite
usar una tubería (pipe) con el comando 'checkout' y así poder comprobar
los cambios más tarde (ver ejemplos).
Ejemplos:
cm findchanged .
(Busca ficheros cambiados en el directorio actual.)
cm findchanged -R . | cm checkout -
(Desprotege los elementos cambiados.)
== CMD_DESCRIPTION_FINDCHECKEDOUT ==
Obtiene una lista de ficheros desprotegidos. Este comando está obsoleto y se
mantiene por retrocompatibilidad. Use 'cm status'.
== CMD_USAGE_FINDCHECKEDOUT ==
Sintaxis:
cm findcheckouts | fco [--format=<str_format>] [--basepath]
Opciones:
--format Muestra el mensaje de salida con el formato indicado.
Consulte las Notas para más información.
--basepath Ruta por la que comenzar a buscar desprotegidos. Si no
se especifica ninguna ruta, se usará la ruta actual.
== CMD_HELP_FINDCHECKEDOUT ==
Notas:
Este comando es útil para, en un único paso, proteger o deshacer las
desprotecciones de todos los ficheros desprotegidos, y redirigir la salida
estándar a otro comando. Vea los ejemplos.
Parámetros de formato de salida (opción --format):
Este comando acepta una cadena de formato para mostrar la salida.
Los parámetros de salida de este comando son los siguientes:
{0} Fecha.
{1} Propietario.
{2} Espacio de trabajo.
{3} Nombre de la máquina cliente.
{4} Ruta del fichero.
{5} Información de rama y repositorio.
Ejemplos:
cm findcheckouts --format="File {4} changed on branch {5}"
(Busca los ficheros desprotegidos y formatea la salida con la ruta del
fichero y la información de la rama y repositorio.)
cm findcheckouts --format={4} | cm checkin -
(Protege todos los ficheros desprotegidos.)
cm findcheckouts --format={4} | cm undocheckout -
(Deshace la desprotección de todos los ficheros desprotegidos.)
== CMD_DESCRIPTION_FINDPRIVATE ==
Obtiene una lista de ítems privados. Este comando está obsoleto y se mantiene
por retrocompatibilidad. Use 'cm status'.
== CMD_USAGE_FINDPRIVATE ==
Sintaxis:
cm findprivate | fp [-R | -r | --recursive] [--exclusions] [<path>]
Opciones:
-R Busca recursivamente en los directorios.
--exclusions Permite interrumpir la búsqueda dentro de las rutas
ignoradas (definidas en el fichero ignore.conf).
path (Por defecto, directorio actual.)
Ruta por la que comenzar a buscar los ficheros privados.
== CMD_HELP_FINDPRIVATE ==
Notas:
Si no se especifica ninguna ruta, Unity VCS comenzará a buscar por el
directorio actual.
Este comando es útil para añadir los elementos privados de la ruta
redireccionando la salida estándar al comando 'add'.
Vea los ejemplos.
Ejemplos:
cm findprivate .
cm findprivate -R | cm add -
(Busca recursivamente items privados y los añade al repositorio.)
== CMD_DESCRIPTION_GETCONFIG ==
Obtiene información de configuración.
== CMD_USAGE_GETCONFIG ==
Sintaxis:
cm getconfig [setfileasreadonly] [location] [extensionworkingmode]
[extensionprefix] [defaultrepserver]
setfileasreadonly Muestra si los ficheros protegidos se dejan en modo
solo lectura o no.
location Muestra la ruta del fichero de configuración del
cliente.
extensionworkingmode Muestra el modo de trabajo de la extensión.
extensionprefix Muestra el prefijo de la extensión configurada.
defaultrepserver Muestra el servidor de repositorios configurado por
defecto.
== CMD_HELP_GETCONFIG ==
Ejemplos:
cm getconfig setfileasreadonly
== CMD_DESCRIPTION_GETFILE ==
Descarga el contenido de una revisión especificada.
== CMD_USAGE_GETFILE ==
Sintaxis:
cm getfile | cat <revspec> [--file=<output_file>] [--debug]
[--symlink] [--raw]
revspec Especificación de la revisión. (Use 'cm help objectspec' para
más información sobre las especificaciones de revisiones.)
Opciones:
--file Fichero donde guardar la salida. Por defecto, se imprime en
la salida estándar.
--debug Cuando se especifica la revisión de un directorio, el
comando muestra el id de la revisión y la protección del
sistema del fichero.
--symlink Aplica la operación al symlink pero no al destino (target).
--raw Muestra los datos del fichero sin procesar (raw data).
== CMD_HELP_GETFILE ==
Ejemplos:
cm cat myfile.txt#br:/main
(Obtiene la última revisión del fichero 'myfile.txt' en la rama 'br:/main'.)
cm getfile myfile.txt#cs:3 --file=tmp.txt
(Obtiene el changeset 3 del fichero 'myfile.txt' y escribe su contenido en
el fichero 'tmp.txt'.)
cm cat serverpath:/src/foo.c#br:/main/task003@myrepo
(Obtiene el contenido del fichero '/src/foo.c' del último changeset de la
rama '/main/task003' en el repositorio 'myrepo'.)
cm cat revid:1230@rep:myrep@repserver:myserver:8084
(Obtiene la revisión con id igual a 1230.)
cm getfile rev:info\ --debug
(Obtiene todas las revisiones del directorio 'info'.)
== CMD_DESCRIPTION_GETREVISION ==
Carga una revisión en el espacio de trabajo.
== CMD_USAGE_GETREVISION ==
Este comando modifica la revisión cargada en el espacio de trabajo, con lo que
puede afectar a futuros merges.
Este es un comando avanzado heredado de antiguas versiones; úselo con precaución.
Sintaxis:
cm getrevision <revspec>
revspec Especificación de la revisión. (Use 'cm help objectspec' para
más información sobre las especificaciones de revisiones.)
== CMD_HELP_GETREVISION ==
Ejemplos:
cm getrevision file.txt#cs:3
(Carga la revisión del changeset 3 del fichero 'file.txt'.)
== CMD_DESCRIPTION_GETSTATUS ==
Obtiene el estado de un ítem.
== CMD_USAGE_GETSTATUS ==
Este comando está pensado para la automatización de otros comandos. Con lo que,
es posible, que no resulte muy intuitivo.
Sintaxis:
cm getstatus | gs <item_path>[ ...] [--format=<str_format>] [--stats]
[-R | -r | --recursive]
item_path Ítem o ítems de los que obtener el estado. Use comillas
dobles (" ") para especificar rutas que contengan espacios.
Use un espacio en blanco para separar rutas de ítems.
Opciones:
--format Muestra el mensaje de salida en el formato indicado.
Consulte las Notas para más información.
--stats Muestra estadísticas sobre el proceso de obtención del estado.
-R Muestra recursivamente el estado en las rutas indicadas.
== CMD_HELP_GETSTATUS ==
Notas:
Parámetros de formato de salida (opción --format):
Este comando acepta una cadena de formato para mostrar la salida.
Los parámetros de salida de este comando son los siguientes:
{0} Ruta del ítem.
{1} Estado del ítem:
0 privado,
1 protegido,
2 desprotegido.
Lectura desde stdin:
El comando 'getstatus' puede leer rutas desde stdin. Para ello, pase como
argumento un guión "-".
Por ejemplo: cm getstatus -
Las rutas se leerán hasta que se introduzca una línea en blanco.
Este tipo de lectura permite usar una tubería (pipe) para especificar de qué
ficheros se van a obtener su estado.
Por ejemplo:
dir /S /B *.c | cm getstatus --format="Path {0} Status {1}" -
(En Windows, obtiene el estado de todos los ficheros del workspace con
extensión .c.)
Ejemplos:
cm getstatus file1.txt file2.txt
(Obtiene el estado de los ficheros.)
cm gs info\ -R --format="The item {0} has the status {1}"
(Obtiene el estado del directorio y de todos sus ficheros y muestra la
salida formateada.)
== CMD_DESCRIPTION_GETTASKBRANCHES ==
Obtiene las ramas asociadas con una tarea.
== CMD_USAGE_GETTASKBRANCHES ==
Este comando está pensado para la automatización de otros comandos. Con lo que,
es posible, que no resulte muy intuitivo.
Sintaxis:
cm gettaskbranches | gtb <task_name> [--format=<str_format>]
[--dateformat=<date_format>]
task_name Identificador de la tarea.
Opciones:
--format Muestra el mensaje de salida en el formato indicado.
Consulte las Notas para más información.
--dateformat Configura el formato de salida para la impresión de fechas.
== CMD_HELP_GETTASKBRANCHES ==
Notas:
Parámetros de formato de salida (opción --format):
Este comando acepta una cadena de formato para mostrar la salida.
Los parámetros de salida de este comando son los siguientes:
{tab} Inserta un tabulador.
{newline} Inserta una nueva línea.
{name} Nombre de la rama.
{owner} Propietario de la rama.
{date} Fecha de creación de la rama.
{parent} Rama padre.
{comment} Comentario de la rama.
{repname} Repositorio donde se encuentra la rama.
{repserver} Nombre del servidor.
Ejemplos:
cm gettaskbranches 4311
cm gtb 4311 --format="br:{name}"
cm gtb 4311 --format="br:{name} {date}" --dateformat="yyyy/MM/dd HH:mm:ss"
== CMD_DESCRIPTION_GETWWI ==
Muestra información del selector del espacio de trabajo.
== CMD_USAGE_GETWWI ==
Sintaxis:
cm wi [<wk_path>]
wk_path Ruta en disco del workspace a consultar.
== CMD_HELP_GETWWI ==
Notas:
El comando 'wi' muestra la configuración actual del espacio de trabajo
(repositorio, rama o etiqueta.)
Ejemplos:
cm wi c:\mywk
== CMD_DESCRIPTION_GWP ==
Obtiene información del espacio de trabajo a partir de una ruta.
== CMD_USAGE_GWP ==
Este comando está pensado para la automatización de otros comandos. Con lo que,
es posible, que no resulte muy intuitivo.
Sintaxis:
cm getworkspacefrompath | gwp <item_path> [--format=<str_format>] [--extended]
item_path Fichero o directorio en disco.
Opciones:
--format Muestra el mensaje de salida en el formato indicado.
Consulte las Notas para más información.
--extended Muestra más información sobre el espacio de trabajo: type y
dynamic además del resto de campos. Consulte las Notas para
más información.
== CMD_HELP_GWP ==
Notas:
Este comando muestra información del espacio de trabajo de la ruta indicada.
Parámetros de formato de salida (opción --format):
Este comando acepta una cadena de formato para mostrar la salida.
Los parámetros de salida de este comando son los siguientes:
{0} | {wkname} Nombre del espacio de trabajo.
{1} | {wkpath} Ruta del espacio de trabajo.
{2} | {machine} Nombre de la máquina del cliente.
{3} | {owner} Propietario del espacio de trabajo.
{4} | {guid} GUID del espacio de trabajo.
{5} | {type} Tipo de espacio de trabajo: partial (gluon) o regular.
{6} | {dynamic} Un espacio de trabajo puede ser dynamic (plasticfs)
o static.
{tab} Inserta un tabulador.
{newline} Inserta una nueva línea.
Ejemplos:
cm gwp c:\myworkspace\code\file1.cpp --format="Espacio de trabajo: {wkname}"
cm gwp . --format="Nombre: {wkname} | Tipo: {type}, {dynamic}"
== CMD_DESCRIPTION_HELP ==
Muestra la ayuda de un comando de Unity VCS.
== CMD_USAGE_HELP ==
Sintaxis:
cm help <command>
== CMD_HELP_HELP ==
== CMD_DESCRIPTION_IOSTATS ==
Muestra estadísticas relativas al hardware.
== CMD_USAGE_IOSTATS ==
Sintaxis:
cm iostats [<repserverspec>] [<list_of_tests>[ ...]]
[--nettotalmb=<value_mb>] [--networkiterations=<value_iter>]
[--diskdatasize=<value_size>] [--disktestpath=<value_path>]
[--systemdisplaytime=<value_time>]
[--systemdisplaytimeinterval=<value_interval>]
Opciones:
repserverspec Servidor de Unity VCS disponible para poder
realizar pruebas de red como, por ejemplo,
"serverUploadTest" o "serverDownloadTest".
Si no se indica ningún servidor, el comando
intentará comunicarse con el servidor
configurado por defecto.
(Use 'cm help objectspec' para más información
sobre las especificaciones de servidores.)
list_of_tests Tests disponibles. Use un espacio en blanco
para separar los diferentes tests.
Consulte las Notas para más información.
--nettotalmb Cantidad de datos de usuario (en MegaBytes)
transmitidos en un test de red, por ejemplo,
"serverDownloadTest" y "serverUploadTest".
Debe ser un valor comprendido entre "4" y "512"
(por defecto, 16).
--networkiterations Número de iteraciones de los tests de red
"serverDownloadTest" y "serverUploadTest".
Debe ser un valor comprendido entre "1" y "100"
(por defecto, 1).
--diskdatasize Cantidad de datos (en MegaBytes) que se
escribirán y leerán en el test de disco
"diskTest".
Debe ser un valor comprendido entre "100" y
"4096" (por defecto, 512).
--disktestpath Ruta donde el test de disco "diskTest" escribe
los ficheros de tests. Si no se indica ninguna
ruta, se intentará usar el directorio temporal
del sistema.
--systemdisplaytime Intervalo de tiempo (en segundos) en el que se
muestra el uso de los recursos del sistema.
Esta opción está disponible para los tests
"systemNetworkUsage" y "systemDiskUsage".
Debe ser un valor comprendido entre "1" y
"3600" (por defecto, 5 segundos).
--systemdisplaytimeinterval Intervalo de tiempo (en segundos) entre las
muestras de rendimiento del sistema. Esta
opcion está disponible para los tests
"systemNetworkUsage" y "systemDiskUsage".
Debe ser un valor comprendido entre "1" and "60"
(por defecto, 1 segundo).
== CMD_HELP_IOSTATS ==
Notas:
Este comando requiere de un servidor disponible para usarse durante los tests
de velocidad de red ("serverUploadTest" y "serverDownloadTest").
La ruta de la opción '--diskTestPath' debe ser una ruta dentro de la unidad
física de disco que se va a probar. Si no se especifica ninguna ruta, el
comando intentará usar la ruta temporal por defecto del sistema.
La unidad de disco de la ruta especificada debe tener suficiente espacio
libre para ejecutar la prueba.
Durante la ejecución del comando, el sistema puede sufrir una caída de
rendimiento a causa de las pruebas realizadas.
Test disponibles:
--serveruploadtest (Defecto). Mide la velocidad de subida de datos
desde el cliente de Unity VCS al servidor.
--serverdownloadtest (Defecto). Mide la velocidad de bajada de datos
desde el servidor de Unity VCS al cliente.
--disktest (Defecto). Mide la velocidad de lectura y
escritura de disco.
--systemnetworkusage Muestra el uso actual de los recursos de red del
sistema. Se muestran contadores de rendimiento
de interfaz de red (Network Interface)
proporcionados por Microsoft Windows.
Test disponible solo en Microsoft Windows.
--systemdiskusage Muestra el uso actual de los discos físicos del
sistema. Se muestran contadores de rendimiento
de interfaz de red (Network Interface)
proporcionados por Microsoft Windows.
Test disponible solo en Microsoft Windows.
Ejemplos:
cm iostats MYSERVER:8087 --serveruploadtest --serverdownloadtest --nettotalmb=32
== CMD_DESCRIPTION_ISSUETRACKER ==
Obtiene, actualiza o busca el estado de una tarea en el sistema de incidencias
(issue tracker) especificado.
== CMD_USAGE_ISSUETRACKER ==
Sintaxis:
cm issuetracker <name> status get <task_id> <parameter>[ ...]
cm issuetracker <name> status update <task_id> <status> <parameter>[ ...]
cm issuetracker <name> status find <status> <parameter>[ ...]
cm issuetracker <name> connection check <parameter>[ ...]
name Nombre del sistema de incidencias.
Solo Jira está soportado por el momento.
task_id Número de la tarea que se quiere consultar o actualizar.
status Estado de tarea válido en el sistema especificado.
Parámetros de Jira (todos son obligatorios):
--user=<user> El usuario a autenticar.
--password=<pwd> La contraseña a autenticar.
--host=<url> La url del sistema de seguimiento de incidencias.
--projectkey=<key> La clave del proyecto de Jira.
== CMD_HELP_ISSUETRACKER ==
Ejemplos:
cm issuetracker jira status get 11 --user=user@mail.es --password=pwd \
--host=https://user.atlassian.net --projectkey=PRJ
(Obtiene el estado de la tarea 11 para el proyecto 'PRJ'.)
cm issuetracker jira status update 11 "Done" --user=user@mail.es \
--password=pwd --host=https://user.atlassian.net --projectkey=PRJ
(Actualiza el estado a 'Done' de la tarea 11 para el proyecto 'PRJ'.)
cm issuetracker jira status find "Done" --user=user@mail.es --password=pwd \
--host=https://user.atlassian.net --projectkey=PRJ
(Obtiene los ids de las tareas cuyo estado es "Done" en el proyecto 'PRJ'.)
cm issuetracker jira connection check --user=user@mail.es --password=pwd \
--host=https://user.atlassian.net --projectkey=PRJ
(Comprueba si los parámetros de configuración son válidos o no.)
== CMD_DESCRIPTION_LICENSEINFO ==
Muestra información de la licencia y de su uso.
== CMD_USAGE_LICENSEINFO ==
Sintaxis:
cm licenseinfo | li [--server=<repserverspec>] [--inactive] [--active]
[--sort=(name|status)]
Opciones:
--server: Obtiene la información de la licencia del servidor
especificado. Si no se especifica ningún servidor, el
comando se ejecutará contra el servidor configurado en
el cliente.
(Use 'cm help objectspec' para más información sobre
las especificaciones de servidores.)
--inactive Muestra únicamente usuarios inactivos en la sección
"Uso de licencia".
--active Muestra únicamente usuarios activos en la sección de
"Uso de licencia".
--sort Ordena usuarios usando el campo especificado:
'name' o 'status'.
== CMD_HELP_LICENSEINFO ==
Notas:
Se muestra información acerca de la fecha de expiración, usuarios activos y
no activos, etc.
Ejemplos:
cm licenseinfo
cm licenseinfo --server=myserver:8084
cm licenseinfo --sort=name
== CMD_DESCRIPTION_LINKTASK ==
Enlaza un changeset a una tarea de un sistema de control de tareas.
== CMD_USAGE_LINKTASK ==
Este comando está pensado para la automatización de otros comandos. Con lo que,
es posible, que no resulte muy intuitivo.
Sintaxis:
cm linktask | lt <csetspec> <ext_prefix> <task_name>
csetspec Especificación del changeset para enlazarlo a una tarea.
(Use 'cm help objectspec' para más información sobre las
especificaciones de changesets.)
ext_prefix Prefijo del sistema de control de tareas configurado.
task_name Identificador de la tarea en el sistema de control de tareas.
== CMD_HELP_LINKTASK ==
Ejemplos:
cm lt cs:8@rep:default@repserver:localhost:8084 jira PRJ-1
== CMD_DESCRIPTION_LOCK_LIST ==
Muestra los bloqueos de un servidor.
== CMD_USAGE_LOCK_LIST ==
Sintaxis:
cm lock list | ls [<revspec> [ ...]] [--server=<server>]
[--onlycurrentuser] [--onlycurrentworkspace]
[--ignorecase]
[--machinereadable [--startlineseparator=<sep>]
[--endlineseparator=<sep>] [--fieldseparator=<sep>]]
revspec Si se especifican una o más revisiones, el comando
mostrará una línea de bloqueo por cada revisión solo si
el ítem asociado está bloqueado en el servidor.
Si no se especifica ninguna revisión, el comando mostrará
todos los ítems bloqueados en el servidor por defecto (o
en el indicado en la opción '--server').
Use un espacio en blanco para separar revisiones en caso
de especificar más de una.
(Use 'cm help objectspec' para más información sobre las
especificaciones de revisiones.)
Opciones:
--server Especificación del servidor de repositorios.
Esta opción anula el servidor por defecto que se
obtiene del espacio de trabajo actual o del fichero
client.conf.
(Use 'cm help objectspec' para más información sobre
las especificaciones de servidores.)
--onlycurrentuser Filtra el resultado mostrando solo los bloqueos
llevados a cabo por el usuario actual.
--onlycurrentworkspace Filtra el resultado mostrando solo los bloqueos
del espacio de trabajo actual (comparándolos por
nombre).
--ignorecase Ignora mayúsculas y minúsculas en las rutas donde
se usa una especificación de ruta de servidor. Por
ejemplo, con esta opción, el comando funcionará tanto
con "/src/foo.c" como con "/sRc/fOO.c".
--machinereadable Muestra el resultado en un formato fácil de parsear.
--startlineseparator Usado con '--machinereadable', indica cómo deben
empezar las líneas del resultado.
--endlineseparator Usado con '--machinereadable', indica cómo deben
terminar las líneas del resultado.
--fieldseparator Usado con '--machinereadable', indica cómo deben
separarse los campos de cada línea resultante.
== CMD_HELP_LOCK_LIST ==
Notas:
El comando muestra una lista de los elementos actualmente bloqueados en el
servidor por defecto. También acepta una lista de especificaciones de
revisión; en este caso, solo se mostrarán los bloqueos asociados a los
elementos especificados.
Es posible usar también la opción '--server=<server>' para consultar los
bloqueos en ese servidor en concreto.
El comando muestra una línea por cada bloqueo en el servidor especificado:
- GUID del elemento bloqueado.
- Nombre del usuario que realizó el bloqueo.
- Nombre del espacio de trabajo donde se realizó el bloqueo.
- Ruta del elemento bloqueado (formato de ruta de servidor).
Ejemplos:
cm lock list
cm lock ls --server=myserver:8084
cm lock ls serverpath:/src/foo.c#cs:99@default@localhost:8084
cm lock ls revid:3521@default itemid:2381@secondary --onlycurrentuser
cm lock ls --onlycurrentuser
cm lock ls --onlycurrentuser --onlycurrentworkspace
cm lock list --machinereadable --startlineseparator=">" \
--endlineseparator="<" --fieldseparator=","
== CMD_DESCRIPTION_LISTUSERS ==
Lista usuarios y grupos.
== CMD_USAGE_LISTUSERS ==
Sintaxis:
cm listusers | lu <repserverspec> [--onlyusers] [--onlygroups]
[--filter= <str_filter>]
cm listusers | lu <repserverspec> --group=<group_name>
repserverspec Especificación del servidor de repositorios.
(Use 'cm help objectspec' para más información sobre
especificaciones de servidores de repositorio.)
Opciones:
--onlyusers Muestra únicamente los usuarios.
--onlygroups Muestra únicamente los grupos.
--filter Muestra únicamente los usuarios o grupos que coinciden con
el filtro especificado.
--group Muestra únicamente los usuarios que pertenecen a un grupo
determinado. Esta opción no es compatible con onlyusers,
onlygroups, ni filter.
== CMD_HELP_LISTUSERS ==
Ejemplos:
cm lu localhost:8084
(Muestra todos los usuarios del servidor.)
cm listusers localhost:8084 --onlyusers --filter=m
(Muestra los usuarios del servidor cuyo nombre contiene 'm'.)
cm listusers codice@cloud --group=Administrators
(Muestra los usuarios del grupo Administrators de la organización 'codice@cloud'.)
== CMD_DESCRIPTION_LOCATION ==
Muestra la ruta del cliente 'cm'.
== CMD_USAGE_LOCATION ==
Sintaxis:
cm location
== CMD_HELP_LOCATION ==
== CMD_DESCRIPTION_LOCK ==
Este comando permite al usuario gestionar bloqueos.
== CMD_USAGE_LOCK ==
Sintaxis:
cm lock <command> [options]
Comandos:
list | ls
unlock
Para obtener más información de cada uno de los comandos use lo siguiente:
cm lock <command> --usage
cm lock <command> --help
== CMD_HELP_LOCK ==
Ejemplos:
cm lock list
cm lock
(La opción 'list' es opcional si no hay argumentos.)
cm lock ls serverpath:/src/foo.c#cs:99@default@localhost:8084
cm lock unlock 91961b14-3dfe-4062-8c4c-f33a81d201f5
== CMD_DESCRIPTION_LOG ==
Obtiene información sobre revisiones en changesets.
== CMD_USAGE_LOG ==
Sintaxis:
cm log [<csetspec> | <repspec>] [--from=<csetspec_from>] [--allbranches]
[--ancestors] [--csformat=<str_format>] [--itemformat=<str_format>]
[--xml[=<output_file>]] [--encoding=<name>]
[--repositorypaths | --fullpaths | --fp]
Opciones:
csetspec Obtiene todos los cambios hechos en el changeset
especificado.
(Use 'cm help objectspec' para más información sobre las
especificaciones de changesets.)
repspec Obtiene todos los cambios hechos en el repositorio
especificado.
(Use 'cm help objectspec' para más información sobre las
especificaciones de repositorios.)
--from Lista todos los cambios hechos en cada changeset desde
el changeset especificado en [csetspec_from] hasta el
changeset especificado en [csetspec].
El changeset [csetspec_from] no se incluye en la salida.
Esta opción se ignorará si lo que se proporciona es una
especificación de repositorio.
--allbranches Muestra información sobre los changesets creados en un
intervalo especificado para todas las ramas donde dichos
changesets se crearon.
--ancestors Muestra información sobre los changesets accesibles
a través del padre y de los enlaces de mezcla (enlaces
de merge) para el changeset especificado en [csetspec].
Si también se especifica el changeset [csetspec_from],
este se usará como límite inferior para todas las rutas.
Nota: Los cambios del changeset no se mostrarán cuando
se use esta opción.
--csformat Muestra información del changeset en el formato
especificado. Consulte las Notas para más información.
No puede combinarse con --xml.
--itemformat Muestra información del ítem en el formato especificado.
Consulte las Notas para más información..
No puede combinarse con --xml.
--xml Imprime el resultado en formato XML a la salida estándar.
También es posible especificar un fichero de salida. No
puede combinarse con --csformat o --itemformat.
--encoding Usado con la opción --xml, especifica el encoding que se
usará en la salida XML, por ejemplo, utf-8.
Consulte la documentación de MSDN en
http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
para obtener la tabla de codificaciones soportadas y su
formato (al final de la página en la columna "Name").
--fullpaths, --fp Imprime las rutas completas de espacio de trabajo para
ficheros y directorios cuando sea posible.
--repositorypaths Imprime las rutas de repositorio (rutas de servidor) en
lugar de las rutas de espacio de trabajo. (Esta opción
anula la opción '--fullpaths'.)
== CMD_HELP_LOG ==
Notas:
- Si no se especifica ningún changeset [csetspec] ni ninguna otra opción,
el comando muestra información de cada changeset creado en el último mes
en cada rama.
- Si solo se especifica la opción '--from', el comando muestra información
de cada changeset desde el especificado en '--from' hasta el último
changeset de la rama donde el especificado fue creado.
- Si la opción '--allbranches' se indica sin ningún intervalo, el comando
muestra la misma información que aparecería si solo se hubiera especificado
'csetspec'.
- Si se usa la opción '--from', el comando muestra información desde el
changeset 'csetspec_from'+1 en adelante.
- El repositorio qe se utiliza para mostrar la información de los changesets
es el repositorio cargado en la ruta desde donde se ejecuta el comando.
Este comando acepta una cadena de formato para los ítems ('--itemformat') y
una cadena de formato para los changesets ('--csformat').
Los parámetros de salida de '--csformat' son los siguientes:
{tab} Inserta un tabulador.
{newline} Inserta una línea nueva.
{changesetid} Número de changeset.
{branch} Rama donde se creó el changeset.
{date} Fecha de creación del changeset.
{owner} Propietario del changeset.
{comment} Comentario del changeset.
{items} Ítems involucrados en el changeset.
{repository} Repositorio donde existe el changeset.
{repserver} Nombre del servidor.
Los parámetros de salida de '--itemformat' son los siguientes:
{tab} Inserta un tabulador.
{newline} Inserta una línea nueva.
{path} Ruta del ítem.
{branch} Rama donde se creó el changeset.
{date} Fecha de creación del changeset.
{owner} Propietario del changeset.
{shortstatus} Imprime el estado en el formato corto. Vea abajo.
{fullstatus} Imprime el estado en el formato largo. Vea abajo.
Formato corto para el estado y su correspondiente formato largo:
'A' Added
'D' Deleted
'M' Moved
'C' Changed
Estas son cadenas válidas de formateo de salida:
--csformat="{newline}Changeset {changesetid} creado en {date};{tab} ítems cambiados: {items}."
--itemformat="{newline}El ítem {path} se creó en la rama {branch}."
Ejemplos:
cm log
(Muestra información de todos los changesets creados en el último mes en
cualquier rama.)
cm log cs:16
(Muestra la información de los cambios realizados en el changeset 16 en la
rama en que se creó dicho changeset.)
cm log cs:16 --csformat="{newline}Changeset {changesetid} creado el día {date}; \
{tab} ítems cambiados: {items}."
(Muestra la información en el formato especificado.)
cm log --from=cs:20 cs:50
(Muestra información de todas las revisiones de todos los changesets
comprendidos entre el 21 y el 50.)
cm log --from=cs:20 cs:50 --allbranches
(Muestra información de todas las revisiones de todos los changesets
comprendidos entre el 21 y el 50 en todas las ramas del repositorio.)
cm log rep:myrep@localhost:8084
(Muestra información de todos los changesets creados en el repositorio
especificado. No hay que especificar ningún espacio de trabajo para ejecutar
el comando.)
cm log --from=cs:20@rep:mainRep@localhost:8084
(Muestra información de todas las revisiones de todos los changesets desde
el changeset 21. No hay que especificar ningún espacio de trabajo para
ejecutar el comando porque se está indicando una especificación completa de
changeset.)
== CMD_DESCRIPTION_LS ==
Lista el contenido de árbol.
== CMD_USAGE_LS ==
Sintaxis:
cm ls | dir [<paths>[ ...]] [--format=<str_format>] [--symlink]
[--selector[=<selector_format>]] [--tree=<obj_spec>]
[-R | -r | --recursive]
[--xml[=<output_file>]] [--encoding=<name>]
Opciones:
paths Lista de rutas a mostrar. Use un espacio en blanco para
separar rutas.
Use comillas dobles (" ") para especificar rutas que
contengan espacios.
--format Muestra el mensaje de salida en el formato indicado.
Consulte las Notas para más información. No puede
combinarse con --xml.
--symlink Incluye en el checkin al symlink pero no al destino
(target).
--selector Obtiene el contenido del selector del espacio de trabajo
activo.
Si se especifica un valor para 'selector_format', entonces
muestra el selector especificado.
Esta opción está prácticamente obsoleta ya que los
selectores no son una parte central de Unity VCS desde la
versión 4.x.
--tree Lista el árbol en el changeset o rama especificados.
(Use 'cm help objectspec' para más información sobre
especificaciones.)
-R Lista recursivamente.
--xml Imprime el resultado en formato XML a la salida estándar.
También es posible especificar un fichero de salida. No
puede combinarse con --format.
--encoding Usado con la opción --xml, especifica el encoding que se
usará en la salida XML, por ejemplo, utf-8.
Consulte la documentación de MSDN en
http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
para obtener la tabla de codificaciones soportadas y su
formato (al final de la página en la columna "Name").
== CMD_HELP_LS ==
Notas:
- Es posible especificar rutas con metacaracteres (*, ?, ...).
- La lista resultante depende del selector del espacio de trabajo.
- La salida del comando se puede formatear especificando una cadena de formato.
- Si no se especifica alguna de estas opciones '--tree' o '--selector',
entonces la ruta indicada tiene que ser una ruta de servidor ('cm path'),
por ejemplo, /dir/file.txt, y no una ruta de espacio de trabajo, por
ejemplo, C:\Users\myuser\mywk\dir\file.txt.
- Si no se indica ninguna ruta, se asumirá que la ruta de espacio de trabajo
es el directorio actual. Si se especifica alguna de estas opciones '--tree'
o '--selector', entonces se asumirá como ruta la raíz ("/").
La cadena de formato por defecto que se mostrará es:
"{size,10} {date:dd/MM/yyyy} {date:HH:mm} \
{type,-6} {location,-12} {checkout,-5} {name} \
{symlinktarget}"
Parámetros de formato de salida (opción --format):
Este comando acepta una cadena de formato para mostrar la salida.
Los parámetros de salida de este comando son los siguientes:
{size}
{formattedsize}
{date}
{type}
dir directorio,
txt fichero de texto,
File fichero.
{location} Por ejemplo: br:branch#cset
{checkout}
{name}
{changeset}
{path}
{repspec}
{owner}
{revid}
{parentrevid}
{itemid}
{brid}
{repid}
{server}
{symlinktarget}
{hash}
{chmod}
{wkpath} Ruta relativa a la raíz del espacio de trabajo
{branch}
{newlocation} cset@branch
{guid} (El comando tardará más tiempo en resolverse)
{itemguid}
{transformed} Muestra la regla aplicada para ítems transformados.
Lea la Guía del Administrador para más información sobre
Transformable workspaces:
https://www.plasticscm.com/download/help/adminguide
You can customize the 'ls' format setting the PLASTIC_LS_FORMAT environment
variable.
Configure la variable de entorno PLASTIC_LS_FORMAT para especificar la
salida del comando y evitar así tener que especificar un valor para la
opción '--format' cada vez que ejecute el comando 'cm ls'.
Ejemplos:
cm ls
cm ls c:\workspace\src
cm ls --format={name}
(Muestra solo nombres de ficheros.)
cm ls --symlink
(Muestra información de los symlinks y no del fichero o directorio al que
apuntan.)
cm ls code --selector
(Muestra el contenido del subdirectorio 'code' del selector del espacio de
trabajo actual.)
cm ls /code --selector="rep 'myrep' path '/' branch '/main'"
(Muestra el contenido del subdirectorio '/code' del selector especificado.
La ruta se ha especificado en formato servidor.)
cm ls /code --tree=44@myrep@denver:7070
(Lista el subdirectorio '/code' en el changeset 44 del repositorio 'myrep'
en el servidor 'denver:7070'.)
cm ls /code --tree=br:/main/scm13596@myrep@denver:7070
(Lista el subdirectorio '/code' en el último changeset de la rama
'/main/scm13596' del repositorio 'myrep' en el servidor 'denver:7070'.)
cm ls /code --tree=ae1390ed-7ce9-4ec3-a155-e5a61de0dc77@myrep@denver:7070
(Lista el subdirectorio '/code' en el changeset
ae1390ed-7ce9-4ec3-a155-e5a61de0dc77 del repositorio 'myrep' en el servidor
'denver:7070'.)
== CMD_DESCRIPTION_TRIGGER_LIST ==
Lista los triggers de un determinado tipo en un servidor.
== CMD_USAGE_TRIGGER_LIST ==
Sintaxis:
cm trigger | tr list | ls [<subtype-type>] [--server=<repserverspec>]
[--format=<str_format>]
Opciones:
subtype-type Ejecución y operación del trigger.
(Use 'cm showtriggertypes' para ver la lista de tipos de
triggers.)
--server Lista los triggers del servidor especificado.
Si no se especifica ningún servidor, el comando se
ejecuta en el servidor configurado en el cliente.
(Use 'cm help objectspec' para más información sobre
las especificaciones de servidor.)
--format Muestra el mensaje de salida en el formato indicado.
Consulte las Notas para más información.
== CMD_HELP_TRIGGER_LIST ==
Notas:
Si no se especifica el tipo, muestra todos los triggers del servidor.
Parámetros de formato de salida (opción --format):
Este comando acepta una cadena de formato para mostrar la salida.
Los parámetros de salida de este comando son los siguientes:
{0} Posición del trigger.
{1} Nombre del trigger.
{2} Ruta del trigger.
{3} Propietario del trigger.
{4} Tipo del trigger.
{5} Filtro del trigger.
Ejemplos:
cm trigger list after-mklabel
(Lista todos los triggers del tipo 'after-mklabel' en el servidor configurado
en el cliente.)
cm tr ls before-mkbranch --server=myserver:8084
(Lista todos los triggers del tipo 'before-mkbranch' en el servidor
'myserver:8084'.)
== CMD_DESCRIPTION_MANIPULATESELECTOR ==
Cambia el selector a una fecha.
== CMD_USAGE_MANIPULATESELECTOR ==
Este comando está pensado para la automatización de otros comandos. Con lo que,
es posible, que no resulte muy intuitivo.
Sintaxis:
cm manipulateselector | ms [<wk_path> | <wk_spec>] --atdate=<sel_date>
wk_path Ruta del espacio de trabajo.
wk_spec Especificación del espacio de trabajo.
(Use 'cm help objectspec' para más información sobre
especificaciones de espacios de trabajo.)
Opciones:
--atdate Devuelve un selector que recreará el espacio de trabajo con
los contenidos que se cargarían en la fecha especificada.
== CMD_HELP_MANIPULATESELECTOR ==
Notas:
Si no se indica ni la ruta o la especificación del espacio de trabajo, el
comando tomará el directorio actual como ruta del espacio de trabajo.
Ejemplos:
cm manipulateselector c:\workspace --atdate=yyyy-MM-ddTHH:mm:ss
cm manipulateselector --atdate=yyyy-MM-ddTHH:mm:ss
cm manipulateselector > mySelector.txt --atdate=yyyy-MM-ddTHH:mm:ss
cm manipulateselector wk:build_wk@BUILDER --atdate=yyyy-MM-ddTHH:mm:ss
== CMD_DESCRIPTION_MERGE ==
Mezcla una rama con otra.
== CMD_USAGE_MERGE ==
Sintaxis:
cm merge <source_spec> [--merge] [--cherrypicking] [--forced]
[--mergetype=(onlyone|onlysrc|onlydst|try|forced)]
[--interval-origin=<csetspec> | --ancestor=<csetspec>]
[--keepsource | --ks] [--keepdestination | --kd]
[--automaticresolution=<conflict-types>[;...]]
[--subtractive] [--mount] [--printcontributors]
[--noprintoperations] [--silent]
[(--to=<brspec> | --destination=<brspec>)[--shelve]]
[--no-dst-changes]
[-c=<str_comment> | --commentsfile=<comments_file>]
[--resolveconflict --conflict=<index>
--resolutionoption=(src|dst|(rename --resolutioninfo=<strname>))
--mergeresultfile=<path> --solvedconflictsfile=<path>]
[--nointeractiveresolution]
[--machinereadable [--startlineseparator=<sep>]
[--xml] [--encoding]
[--endlineseparator=<sep>] [--fieldseparator=<sep>]]
source_spec Especificación del objeto origen de la mezcla (merge).
Este puede ser:
- especificación de una rama: '[br:/]br_name'
- especificación de una etiqueta: 'lb:lb_name'
- especificación de un changeset: 'cs:cs_number'
- especificación de un almacenamiento (shelve): 'sh:shelve_number'
(Use 'cm help objectspec' para más información sobre
especificaciones.)
Opciones:
--merge Realiza el merge. Si no se especifica esta opción,
se muestran los conflictos encontrados.
--cherrypicking Realiza el merge de los cambios incluidos en los
changesets origen. Esta opción se omitirá si el
origen del merge es una etiqueta.
--forced No comprueba si el origen y el destino ya están
conectados.
Esta opción solo es válida para el merge de intervalo
y para el cherry picking.
--mergetype Especifica el tipo de merge. Consulte las Notas
para más información.
--interval-origin Especifica el changeset inicio del intervalo. El
merge solo tendrá en cuenta las diferencias entre
el changeset origen y el inicio del intervalo
especificado.
--ancestor Alias para '--interval-origin'.
--keepsource Acepta todos los cambios del contribuidor origen
para los elementos con conflictos.
--keepdestination Preserva los cambios del contribuidor destino
para elementos con conflictos.
--automaticresolution Opción para resolver conflictos de directorio. Esta
opción permite elegir automáticamente entre el
contribuidor origen (source) o el contribuidor
destino (destination) para resolver el conflicto.
Use punto y coma (;) para separar los tipos de
conflicto. Consulte las Notas para más información.
--subtractive Elimina los cambios introducidos por un merge.
El parámetro (source_spec) que se pasa al comando
especifica el origen a partir del cual eliminar los
cambios. Debe ser un changeset. En el caso de un
intervalo de changesets, debe utilizar la opción
'--interval-origin' para definir el inicio del
intervalo. Para eliminar un cambio, el sistema
crea una nueva revisión desprotegida con todo el
contenido anterior excepto los cambios eliminados.
--mount El punto de montaje del repositorio especificado.
--printcontributors Muestra los contribuidores (base, origen y destino).
--noprintoperations Resuelve las mezclas (merges) sin mostrar
información sobre la resolución.
--silent Solo se imprimen mensajes en caso de error.
--to | --destination Realiza una operación de merge-to a la rama de
especificada con resolución completa de conflictos.
(Use 'cm help objectspec' para más información sobre
las especificaciones de ramas.)
Una mezcla "merge-to" (o mezcla sin espacio de
trabajo) es una mezcla que se hace en el lado del
servidor. Mientras que las mezclas normales
ocurren en un espacio de trabajo mezclando desde
("from") una rama, etiqueta o changeset, una mezcla
"merge-to" tiene lugar en el servidor. Mientras que
en mezclas normales el destino es el espacio de
trabajo, en una mezcla "merge-to" se debe
especificar el destino (por eso se llama "to",
'hacia' en inglés).
Lea la siguiente guía para más información:
https://www.plasticscm.com/download/help/mergeto
--shelve Crea un almacenamiento (shelve) con los cambios del
resultado del merge (además de información de
trazabilidad de la mezcla) en lugar de crear
un nuevo changeset. Esta opción no es válida cuando
el origen del merge es un shelve. Esta opción sólo
está disponible para el merge del lado del servidor
(merge-to). Por ello, hay que especificar las
opciones '--to' y '--merge'.
--no-dst-changes Asegura que el contribuidor destino no tiene cambios
(el changeset destino es también el antecesor
común). Cuando hay cambios en el destino, no se
permite hacer el merge.
-c Añade un comentario al changeset que se crea al
hacer la mezcla.
--commentsfile Asigna el comentario especificado en el fichero al
changeset que se crea al hacer la mezcla.
--resolveconflict (Usado principalmente por plugins. Consulte las
Notas para más información.)
Usado para resolver un conflicto de directorio.
--conflict Usado con '--resolveconflict', especifica el
índice del conflicto a resolver empezando por 1.
--resolutionoption Usado con '--resolveconflict', indica el tipo de
resolución de conflicto. Puede ser una de las
siguientes opciones: 'src', 'dst', 'rename'.
Consulte las Notas para más información.
--resolutioninfo Usado con '--resolveconflict', proporciona el
nombre que se usará cuando la opción
'--resolutionoption' es 'rename'.
--mergeresultfile Usado con '--resolveconflict', guarda en un fichero
la información del resultado de la mezcla entre
diferentes llamadas. El fichero especificado se
crea en la primera llamada y se actualiza en las
las siguientes llamadas.
--solvedconflictsfile Usado con '--resolveconflict', guarda en un fichero
la información de los conflictos solucionados
entre diferentes llamadas. El fichero especificado
se crea en la primera llamada y se actualiza en
las siguientes llamadas.
--nointeractiveresolution (Usado principalmente por plugins. Consulte las
Notas para más información.)
Evita preguntar al usuario cuando hay un conflicto
manual. Así, por ejemplo, un conflicto de directorio
no podrá ser resuelto.
--machinereadable (Usado principalmente por plugins. Consulte las
Notas para más información.)
Muestra el resultado en un formato fácil de parsear.
--xml Imprime el resultado en formato XML a la salida estándar.
También es posible especificar un fichero de salida. No
puede combinarse con --format ni --resolveconflict.
--encoding Usado con la opción --xml, especifica el encoding que se
usará en la salida XML, por ejemplo, utf-8.
Consulte la documentación de MSDN en
http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
para obtener la tabla de codificaciones soportadas y su
formato (al final de la página en la columna "Name").
--startlineseparator Usado con '--machinereadable', indica cómo deben
empezar las líneas del resultado. (Por defecto,
una cadena de texto vacía.)
--endlineseparator Usado con '--machinereadable', indica cómo deben
terminar las líneas del resultado. (Por defecto,
una cadena de texto vacía.)
--fieldseparator Usado con '--machinereadable', indica cómo deben
separarse los campos de cada línea resultante.
(Por defecto, un espacio en blanco.)
== CMD_HELP_MERGE ==
Notas:
Este comando se utiliza para meclar cambios entre dos ramas, o entre una
etiqueta y una rama. El destino del merge siempre debe ser una rama.
El origen del merge se especifica como argumento.
El destino es el contenido actual del espacio de trabajo.
Por ejemplo, para mostrar los elementos que se mezclarán desde la rama
task001 a la rama principal, el selector debe apuntar a la rama principal,
el espacio de trabajo debe estar actualizado, y entonces ejecutar:
cm merge br:/task001
Para que el merge se realice, hay que añadir la opción '--merge':
cm merge br:/task001 --merge
Para definir el origen de la mezcla, puede usar las siguientes especificaciones:
- Especificación de rama (brspec):
[br:/]br_name
Por ejemplo: br:/main/task001
(Mezcla desde el último changeset de la rama especificada.)
- Especificación de etiqueta (lbspec):
lb:lb_name
Por ejemplo: lb:BL001
(Mezcla desde el último changeset etiquetado.)
- Especificación de changeset (csetspec):
cs:cs_number
Por ejemplo: cs:25
(Mezcla desde el contenido del changeset especificado.)
- Especificación de almancenamiento o shelve (shspec):
sh:shelve_number
Por ejemplo: sh:2
(Mezcla desde el contenido del shelve.)
Para resolver automáticamente conflictos de directorio use la opción
"--automaticresolution" y especifique el tipo de conflicto seguido por el
contribuidor (origen o destino) que se seleccionará durante el merge.
(Separe cada par "tipo de conflicto"-"contribuidor" con punto y coma (;).)
Por ejemplo:
cm merge cs:2634 --merge --automaticresolution=eviltwin-src;changedelete-src
(La operación de merge desde el changeset 2634 resuelve los conflictos
"eviltwin" y "changedelete" manteniendo al contribuidor origen ("-src")
en ambos conflictos.)
- El sufijo "-src" añadido después del tipo de conflicto indica al comando
merge que debe mantener los cambios del contribuidor origen (source).
- El sufijo "-dst" mantendrá los cambios del contribuidor destino
(destination).
Esta es la lista de tipos de conflictos que soporta el comando merge:
"movedeviltwin", "eviltwin", "changedelete", "deletechange", "movedelete",
"deletemove", "loadedtwice", "addmove", "moveadd", "divergentmove",
"cyclemove", "all".
El valor "all" anula el resto de opciones. En el siguiente ejemplo, el
conflicto "eviltwin-dst" será ignorado:
cm merge br:/main/task062 --merge --automaticresolution=all-src;eviltwin-dst
Consulte el siguiente enlace para más información sobre conflictos de merge:
https://www.plasticscm.com/download/help/directorymerges
Estas son los valores para la opción --mergetype:
onlyone Merge automático si solo uno de los contribuidores modificó
el elemento.
onlysrc Merge automático si solo el contribuidor origen modificó el
elemento.
onlydst Merge automático si solo el contribuidor destino modificó el
elemento.
try Merge automático si solo un contribuidor ha modificado la
parte del fichero en conflicto (para cada conflicto).
forced Intenta resolver siempre los conflictos no automáticos.
Estas son las opciones que se usan principalmente por plugins e integraciones:
- "--resolveconflict" para resolver un conflicto de directorio. Se
deben usar las siguientes opciones:
- "--conflict" es el índice del conflicto que se quiere resolver
(empezando por 1).
- "--resolutionoption" indica el tipo de resolución de conflicto.
Puede ser:
- "src" para mantener el cambio del origen y descartar el
cambio del destino
- "dst" para mantener el cambio del destino y descartar el
cambio del origen
- "rename" (solo si el tipo de conflicto soporta esta
resolución) para renombar el destino al nombre
proporcionado en la opción "--resolutioninfo".
- "--resolutioninfo" para proporcionar el nombre a usar
con el tipo de resolución "rename"
- "--mergeresultfile" y "--solvedconflictsfile", ambos se usan
para guardar informacación de la mezcla entre las diferentes
llamadas.
- "nointeractiveresolution" indica a la mezcla que no pregunte al usuario
en caso de necesitarse una resolución manual de un conflicto.
- "--machinereadable" y "--startlineseparator", "--endlineseparator",
"fieldseparator" se usan para imprimir la salida a un formato fácil
de leer, tratar o parsear.
Por ejemplo:
cm merge --machinereadable --startlineseparator=start@_@line \
--endlineseparator=new@_@line --fieldseparator=def#_#sep \
--mergeresultfile=C:\Users\Borja\AppData\Local\Temp\2tmp4D6C.tmp \
--solvedconflictsfile=C:\Users\Borja\AppData\Local\Temp\2tmp4D6D.tmp \
--resolveconflict --conflict=1 --resolutionoption=rename \
--resolutioninfo=bin_dst br:/main/task --merge
Configure la variable de entorno PLASTICEDITOR para especificar un editor
para escribir el comentario. Si la variable de entorno PLASTICEDITOR está
configurada pero no se indica ningún comentario, el editor se abrirá para
que pueda escribir el comentario.
Ejemplos:
cm merge br:/task001
(No realiza la mezcla, simplemente muestra los elementos que se van a
mezclar.)
cm merge br:/task001 --merge
(Realiza el merge desde la rama task001.)
cm merge cs:5 --merge --cherrypicking --interval-origin=cs:2
(Cherry pick del intervalo de changesets (2,5].)
cm merge cs:8 --merge --subtractive --keepdestination
(Merge sustractivo del changeset 8, preservando los cambios del destino
para aquellos elementos con conflictos.)
cm merge br:/main/task001 --to=br:/main --merge -c="Integrated new UI"
(Realiza el merge en el lado del servidor -a.k.a. "merge-to"-, desde la
rama 'task001' hasta la rama 'main' y añade un comentario.)
cm merge br:/main/task001 --to=br:/main --merge --shelve
(Realiza el merge en el lado del servidor desde la rama 'task001' a la rama
'main' y deja el resultado en un shelve.)
cm merge sh:2 --to=br:/main --merge --no-dst-changes
(Aplica el shelve 2 en la rama 'main' solo si fue creado desde la cabeza
actual de 'main'.)
== CMD_DESCRIPTION_ATTRIBUTE_CREATE ==
Crea un atributo nuevo.
== CMD_USAGE_ATTRIBUTE_CREATE ==
Sintaxis:
cm attribute | att create | mk <att_name>
att_name Nombre del atributo.
== CMD_HELP_ATTRIBUTE_CREATE ==
Notas:
Configure la variable de entorno PLASTICEDITOR para especificar un editor
para escribir el comentario. Si la variable de entorno PLASTICEDITOR está
configurada pero no se indica ningún comentario, el editor se abrirá para
que pueda escribir el comentario.
Ejemplos:
cm attribute create status
(Crea el atributo 'status'.)
cm att mk integrated
(Crea el atributo 'integrated'.)
== CMD_DESCRIPTION_BRANCH ==
Permite al usuario gestionar ramas.
== CMD_USAGE_BRANCH ==
Sintaxis:
cm branch | br <command> [options]
Comandos:
create | mk
delete | rm
rename
history
showmain
showmerges
Para obtener más información sobre cada comando:
cm branch command --usage
cm branch command --help
== CMD_HELP_BRANCH ==
Ejemplos:
cm branch /main/scm21345
cm branch create /main/scm21345
cm branch delete /main/scm21345
cm branch rename /main/scm21345 scm21346
cm branch history /main/scm21345
cm branch showmain
cm branch showmerges file.txt
== CMD_DESCRIPTION_BRANCH_CREATE ==
Crea una rama.
== CMD_USAGE_BRANCH_CREATE ==
Sintaxis:
cm branch | br [create | mk] <brspec>
[--changeset=<csetspec> | --label=<lbspec>]
[-c=<str_comment> | -commentsfile=<comments_file>]
brspec Nombre o especificación de la nueva rama.
(Use 'cm help objectspec' para más información sobre
especificaciones de ramas.)
Opciones:
--changeset Changeset usado como punto de partida de la nueva rama.
(Use 'cm help objectspec' para más información sobre
especificaciones de changesets.)
--label Etiqueta usada como punto de partida de la nueva rama.
(Use 'cm help objectspec' para más información sobre
especificaciones de ramas.)
-c Asigna el comentario especificado a la nueva rama.
--commentsfile Asigna el comentario especificado en el fichero a la
nueva rama.
== CMD_HELP_BRANCH_CREATE ==
Notas:
Para crear una rama de primer nivel, especifique el nombre sin jerarquía.
Por ejemplo:
cm br /dev
Si no se especifica el parámetro '--changeset', la base de la nueva rama
será el último changeset de la rama madre. En caso de que la rama sea de
primer nivel, se utilizará como base el changeset 0.
Para especificar comentarios use la opción "-c" o "-m" del siguiente modo:
cm branch main/task001 -c="Este es el comentario"
cm branch main/task001 -m "Este es el comentario"
Configure la variable de entorno PLASTICEDITOR para especificar un editor
para escribir el comentario. Si la variable de entorno PLASTICEDITOR está
configurada pero no se indica ningún comentario, el editor se abrirá para
que pueda escribir el comentario.
Ejemplos:
cm branch task001
cm branch create task001
cm branch mk task001
cm br mk task001
(Todos los ejemplos anteriores, crean una rama de primer nivel llamada
'task001' en el repositorio del espacio de trabajo actual.)
cm branch br:/task001/task002
(Crea la rama 'task002' como hija de 'task001'.)
cm br /main/task001@myrep@myserver:8084 -c="my comment"
(Crea la rama 'task001' como hija de 'main' en el repositorio
'myrepo@myserver:8084' y asigna como comentario el texto 'my comment'.)
cm br mk br:/main/task001 --changeset=2837 -commentsfile=commenttask001.txt
(Crea la rama 'task001' como hija de 'main' con base el changeset '2837'
y asigna como comentario el texto del fichero 'commenttask001.txt'.)
== CMD_DESCRIPTION_BRANCH_DELETE ==
Borra una o más ramas.
== CMD_USAGE_BRANCH_DELETE ==
Sintaxis:
cm branch | br delete | rm <brspec>[ ...]
brspec Rama a borrar. Use un espacio en blanco para separar ramas.
(Use 'cm help objectspec' para más información sobre
especificaciones de ramas.)
== CMD_HELP_BRANCH_DELETE ==
Notas:
Este comando borra una o más ramas.
Ejemplos:
cm branch delete /main/task001
(Borra la rama con nombre 'task001' que es hija de 'main' en el repositorio
del espacio de trabajo actual.)
cm br rm main/task002 /main/task012@reptest@myserver:8084
(Borra la rama '/main/task002' del repositorio del espacio de trabajo actual
y la rama '/main/task012' del repositorio 'reptest@myserver:8084'.)
== CMD_DESCRIPTION_BRANCH_RENAME ==
Renombra una rama.
== CMD_USAGE_BRANCH_RENAME ==
Sintaxis:
cm branch | br rename <brspec> <new_name>
brspec Rama a renombrar.
(Use 'cm help objectspec' para más información sobre
especificaciones de ramas.)
new_name Nuevo nombre para la rama.
== CMD_HELP_BRANCH_RENAME ==
Notas:
Este comando renombra una rama.
Ejemplos:
cm branch rename /main/task0 task1
(Renombra la rama '/main/task0' a '/main/task1'.)
cm br rename br:/main@reptest@server2:8084 secondary
(Renombra la rama 'main' del repositorio 'reptest' a 'secondary'.)
== CMD_DESCRIPTION_BRANCH_HISTORY ==
Muestra la historia de una rama.
== CMD_USAGE_BRANCH_HISTORY ==
Sintaxis:
cm branch | br history <brspec> [--dateformat=<date_format>]
[--machinereadable]
brspec Especificación de la rama de la que obtener la historia.
(Use 'cm help objectspec' para más información sobre
especificaciones de ramas.)
Opciones:
--dateformat Configura el formato de salida para la impresión de
fechas.
--machinereadable Muestra el resultado en un formato fácil de parsear.
== CMD_HELP_BRANCH_HISTORY ==
Ejemplos:
cm branch history br:/main/scm001@myrepository@myserver:8084
(Muestra la historia de la rama '/main/scm001' del repositorio 'myrepository'
en el servidor 'myserver'.)
cm br history main --dateformat="yyyy, dd MMMM" --machinereadable
(Muestra la historia de la rama 'main' del repositorio actual con un formato
de fecha determinado y con un formato sencillo de parsear.)
== CMD_DESCRIPTION_BRANCH_SHOWMAIN ==
Muestra la rama principal de un repositorio.
Con toda probabilidad, la rama principal de sus repositorios se denominará '/main'.
Este comando está pensado para la automatización de otros comandos.
== CMD_USAGE_BRANCH_SHOWMAIN ==
Sintaxis:
cm branch | br showmain [<repspec>] [--encoding=<name>]
[--format=<format_str>] [--dateformat=<date_format>]
repspec Especificación del repositorio de donde mostrar la rama principal.
Si no se especifica ningún repositorio, se mostrará la rama
principal del repositorio del espacio de trabajo actual.
(Use 'cm help objectspec' para más información sobre
especificaciones de repositorio.)
Opciones:
--encoding Especifica el encoding que se usará en la salida, por
ejemplo, utf-8. Consulte la documentación de MSDN en
http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
para obtener la tabla de codificaciones soportadas y
su formato (al final de la página en la columna "Name").
--format Muestra el mensaje de salida en el formato indicado.
Consulte las Notas para más información.
--dateformat Configura el formato de salida para la impresión de fechas.
== CMD_HELP_BRANCH_SHOWMAIN ==
Notas:
Este comando muestra la rama principal de un repositorio.
Parámetros de formato de salida (opción --format):
Este comando acepta una cadena de formato para mostrar la salida.
Los parámetros de salida de este comando son los siguientes:
{id} Id de la rama.
{comment} Comentario.
{date} Fecha.
{name} Nombre.
{owner} Propietario.
{parent} Nombre de la rama madre.
{repository} Repositorio.
{repname} Nombre del repositorio.
{repserver} Servidor.
{changeset} Último changeset de la rama (head).
Ejemplos:
cm branch showmain
(Muestra la rama principal del repositorio del espacio de trabajo actual.)
cm branch showmain repo@server:8084
(Muestra la rama principal del repositorio 'repo' en el servidor
'server:8084'.)
cm br showmain --dateformat="yyyy, dd MMMM" --encoding=utf-8
(Muestra la rama principal del repositorio con las fechas en un determinado
formato y la salida codificada en utf-8.)
cm br showmain --format="{id} - {name}"
(Muestra la rama principal del repositorio mostrando únicamente su id y
nombre.)
== CMD_DESCRIPTION_BRANCH_SHOWMERGES ==
Muestra las ramas que están pendientes de mezclar (merge).
== CMD_USAGE_BRANCH_SHOWMERGES ==
Este comando está pensado para la automatización de otros comandos. Con lo que,
es posible, que no resulte muy intuitivo.
Sintaxis:
cm branch | br showmerges <item_path>[ ...]
[--format=<format_str>]
[--dateformat=<date_format>]
Opciones:
--format Muestra el mensaje de salida en el formato indicado.
Consulte las Notas para más información.
--dateformat Configura el formato de salida para la impresión de fechas.
== CMD_HELP_BRANCH_SHOWMERGES ==
Notas:
Parámetros de formato de salida (opción --format):
Este comando acepta una cadena de formato para mostrar la salida.
Los parámetros de salida de este comando son los siguientes:
{id} Id de la rama.
{comment} Comentario.
{date} Fecha.
{name} Nombre.
{owner} Propietario.
{parent} Nombre de la rama madre.
{parentid} Id de la rama madre.
{repid} Id del repositorio.
{repository} Repositorio.
{repname} Nombre del repositorio.
{repserver} Servidor del repositorio.
Ejemplos:
cm branch showmerges file.txt
(Muestra las ramas involucradas en el merge pendiente del fichero file.txt.)
cm branch showmerges file.txt --format="{date} {name}" --dateformat="ddMMyy"
(Muestra las ramas involucradas en el merge mostrando solo la fecha y el
nombre y con las fechas en un determinado formato.)
== CMD_DESCRIPTION_REPOSITORY ==
Permite al usuario administrar repositorios.
== CMD_USAGE_REPOSITORY ==
Sintaxis:
cm repository | repo <command> [options]
Comandos:
create | mk
delete | rm
list | ls
rename
add
Para obtener más información sobre cada comando:
cm repository <command> --usage
cm repository <command> --help
== CMD_HELP_REPOSITORY ==
Ejemplos:
cm repository
cm repository list
cm repository newrepo
cm repository create newrepo
cm repository rename oldname newname
cm repository add C:\repo\
== CMD_DESCRIPTION_REPOSITORY_CREATE ==
Crea un repositorio en un servidor.
== CMD_USAGE_REPOSITORY_CREATE ==
Sintaxis:
cm repository | repo <rep_name>
cm repository | repo <repserverspec> <rep_name>[ ...]
cm repository | repo [create | mk] <rep_name>
repserverspec Especificación del servidor de repositorios.
(Use 'cm help objectspec' para más información sobre
especificaciones de repositorios de servidor.)
rep_name Nombre del nuevo repositorio. Use un espacio en
blanco para separar nombres de repositorio.
== CMD_HELP_REPOSITORY_CREATE ==
Ejemplos:
cm repository MyRep
cm repo 192.168.1.140:8087 Rep01 Rep01/ModuleA Rep01/ModuleB
cm repo create Rep01
cm repo mk list
== CMD_DESCRIPTION_REPOSITORY_DELETE ==
Borra un repositorio de un servidor.
== CMD_USAGE_REPOSITORY_DELETE ==
Sintaxis:
cm repository | repo delete | rm <repspec>
repspec Especificación del repositorio.
(Use 'cm help objectspec' para más información sobre
especificaciones de repositorios.)
== CMD_HELP_REPOSITORY_DELETE ==
Nota:
Borra un repositorio del servidor de repositorios.
No borra los datos de la base de datos; simplemente "desconecta" el
repositorio de la base de datos para que no sean accesibles. (Los datos
se pueden "reconectar" de nuevo con el comando 'cm repository add'.)
Ejemplos:
cm repository delete myrepository@repserver:myserver:8084
cm repository rm myrepository@myserver:8084
cm repo rm myrepository
== CMD_DESCRIPTION_REPOSITORY_LIST ==
Lista los repositorios de un servidor.
== CMD_USAGE_REPOSITORY_LIST ==
Sintaxis:
cm repository | repo [list | ls] [<repserverspec>] [--format=<str_format>]
repserverspec Especificación del servidor de repositorios.
(Use 'cm help objectspec' para más información sobre
especificaciones de servidor de repositorios.)
--format Muestra el mensaje de salida en el formato indicado.
Consulte las Notas para más información.
== CMD_HELP_REPOSITORY_LIST ==
Notas:
Parámetros de formato de salida (opción --format):
Este comando acepta una cadena de formato para mostrar la salida.
Los parámetros de salida de este comando son los siguientes:
{repid} | {0} Identificador del repositorio.
{repname} | {1} Nombre del repositorio.
{repserver} | {2} Nombre del servidor del repositorio.
{repowner} | {3} Propietario del repositorio.
{repguid} | {4} Identificador único del repositorio.
{tab} Inserta un tabulador.
{newline} Inserta una nueva línea.
Si el valor de opción '--format' es 'TABLE', la salida se imprimirá en formato
tabla con los siguientes campos: {repid}, {repname} y {repserver}.
Ejemplos:
cm repository
(Lista todos los repositorios.)
cm repository list localhost:8084 --format="{1, -20} {3}"
(Muestra el nombre del repositorio utilizando 20 espacios y alineado a la
izquierda, un espacio y el propietario del repositorio.)
cm repository ls localhost:8084 --format="{repname, -20} {repowner}"
(Muestra el mismo resultado que el ejemplo anterior.)
cm repo ls localhost:8084 --format=TABLE
(Muestra la lista de repositorios en formato tabla con los siguientes
campos: id del repositorio, nombre del repositorio, y el nombre del servidor
de repositorios.)
== CMD_DESCRIPTION_REPOSITORY_RENAME ==
Renombra un repositorio.
== CMD_USAGE_REPOSITORY_RENAME ==
Sintaxis:
cm repository | repo rename [<repspec>] <new_name>
repspec Repositorio a renombrar.
(Use 'cm help objectspec' para más información sobre
especificaciones de repositorio.)
new_name Nuevo nombre para el repositorio.
== CMD_HELP_REPOSITORY_RENAME ==
Notas:
Este comando renombre un repositorio.
Si no se proporciona ninguna especificación de repositorio, el comando tomará
por defecto el repositorio actual.
Ejemplos:
cm repository rename development
(El repositorio actual se renombra a 'development'.)
cm repo rename rep:default@SERVER:8084 development
(El repositorio 'default' del servidor 'SERVER' se renombra a 'development'.)
== CMD_DESCRIPTION_REPOSITORY_ADD ==
Conecta un repositorio existente añadiendo su base de datos.
== CMD_USAGE_REPOSITORY_ADD ==
Sintaxis:
cm repository | repo add <db_file> <rep_name> <repserverspec>
db_file Nombre del fichero de la base de datos.
rep_name Nombre del repositorio.
repserverspec Especificación del servidor de repositorios.
(Use 'cm help objectspec' para más información sobre
especificaciones de servidor de repositorios.)
== CMD_HELP_REPOSITORY_ADD ==
Nota:
Reconecta una base de datos de repositorio ya existente al servidor. Este
comando es útil para mover un repositorio de un servidor a otro, o para
restaurar o reconectar un repositorio después de haber usado el comando
'cm repository delete'.
Ejemplos:
cm repository add rep_27 myrepository myserver:8084
== CMD_DESCRIPTION_TRIGGER_CREATE ==
Crea un nuevo trigger en un servidor.
== CMD_USAGE_TRIGGER_CREATE ==
Sintaxis:
cm trigger | tr create | mk <subtype-type> <new_name> <script_path>
[--position=<new_position>]
[--filter=<str_filter>]
[--server=<repserverspec>]
subtype-type Ejecución y operación del trigger.
(Use 'cm showtriggertypes' para ver la lista de tipos de
triggers.)
new_name Nombre del nuevo trigger.
script_path Ruta en disco del servidor donde se encuentra el script
a ejecutar. Si la línea comienza con "webtrigger ", el
trigger entenderá que se trata de un trigger web.
Consulte las Notas para más información.
Opciones:
--position Posición para el trigger especificado. Esta posición no
tiene que estar en uso por ningún otro trigger del mismo
tipo.
--filter Comprueba solo los ítems que concuerdan con el filtro
especificado.
--server Crea el trigger en el servidor especificado.
Si no se especifica ningún servidor, el comando se
ejecuta en el servidor configurado en el cliente.
(Use 'cm help objectspec' para más información sobre
las especificaciones de servidor.)
== CMD_HELP_TRIGGER_CREATE ==
Notas:
Web triggers: Para crear triggers web escriba "webtrigger <target-uri>"
como comando de trigger. En este caso, el trigger ejecutará una consulta
POST contra el URI especificado (donde el cuerpo de la petición contiene un
diccionario JSON con las variables de entorno del trigger) y una clave INPUT
apuntando a un array de cadenas de texto.
Ejemplos:
cm trigger create after-setselector "BackupMgr" "/path/to/script" --position=4
cm tr mk before-mklabel new "/path/to/script" --server=myserver:8084
cm tr mk after-mklabel Log "/path/to/script" --filter="rep:myRep,LB*"
(Este trigger se ejecutará solo si la etiqueta ha sido creada en el
repositorio 'myRep' y si el nombre de la etiqueta comienza por 'LB'.)
cm tr mk after-checkin NotifyTeam "webtrigger http://myserver.org/api"
== CMD_DESCRIPTION_MOVE ==
Mueve o renombra un ítem.
== CMD_USAGE_MOVE ==
Sintaxis:
cm move ruta_origen ruta_destino
ruta_origen: Ruta origen del ítem.
ruta_destino: Ruta destino del ítem.
== CMD_HELP_MOVE ==
Notas:
Este comando mueve o renombra un ítem en el repositorio.
Los cambios también se realizan en el sistema de ficheros local.
Si la ruta de origen es un fichero, el destino puede ser un fichero o un
directorio. En el primer caso, el fichero se renombra, si no, el ítem se
mueve al directorio destino.
Si la ruta de origen es un directorio, la ruta destino ha de serlo también.
Requisitos para mover o renombrar un ítem:
El ítem ha de estar controlado por Unity VCS.
El directorio padre del ítem origen y del ítem destino han de estar desprotegidos.
Ejemplos:
cm move fichero.txt fichero.old (renombra el ítem)
cm move .\fichero.old .\antiguos (mueve fichero.old al directorio antiguos)
cm move .\src .\src2 (renombra el directorio)
== CMD_DESCRIPTION_LABEL ==
Este comando permite al usuario efectuar operaciones con etiquetas.
== CMD_USAGE_LABEL ==
Sintaxis:
cm label | lb command [options]
Comandos:
create | mk
delete | rm
rename
Para obtener más información sobre cada uno de los comandos ejecute:
cm label command --usage
cm label command --help
== CMD_HELP_LABEL ==
Ejemplos
cm label myNewLabel cs:42
(el comando 'create' es opcional)
cm label rename myNewLabel newLabelName
cm label delete newLabelName
== CMD_DESCRIPTION_LABEL_CREATE ==
Crea una etiqueta nueva o etiqueta una changeset dado.
== CMD_USAGE_LABEL_CREATE ==
Sintaxis:
cm label [create] spec_etiqueta [spec_changeset | ruta]
[--allxlinkedrepositories]
[-c=str_comment | -commentsfile=<comments_file>]
spec_etiqueta: Especificación de la etiqueta. Usa 'cm help objectspec' para
obtener más información sobre especificaciones.
spec_changeset: Nombre o especificación del changeset a etiquetar. Usa
'cm help objectspec' para obtener más información sobre especificaciones.
ruta: Ruta del workspace a etiquetar
Si no se especifica spec_changeset ni ruta se asumirá el directorio actual
como workspace a etiquetar.
Opciones:
--allxlinkedrepositories (-s): Crea la etiqueta en todos los repositorios
enlazados.
-c: Añade un comentario a la etiqueta creada.
--commentsfile=comment.txt: Carga el comentario del fichero especificado.
== CMD_HELP_LABEL_CREATE ==
Notas:
Configure la variable de entorno PLASTICEDITOR para especificar un editor
para escribir el comentario. Si la variable de entorno PLASTICEDITOR está
configurada pero no se indica ningún comentario, el editor se abrirá para
que pueda escribir el comentario.
Ejemplos:
cm label create lb:BL001 cs:1203 -commentsfile=commentlb001.txt
cm label BL002 cs:=1203 -c="first release"
== CMD_DESCRIPTION_LABEL_DELETE ==
Borra una o más etiquetas.
== CMD_USAGE_LABEL_DELETE ==
Sintaxis:
cm label delete spec_etiqueta1 spec_etiqueta2 ...
spec_etiqueta: Etiquetas a borrar, separadas por espacios.
Usa 'cm help objectspec' para obtener más información
sobre la especificación de etiquetas.
== CMD_HELP_LABEL_DELETE ==
Notas:
Este comando borra una o más etiquetas creadas previamente.
Ejemplos:
cm label delete lb:BL001 (Se borra la etiqueta 'BL001')
cm label delete lb:BL001 lb:BL002
== CMD_DESCRIPTION_LABEL_RENAME ==
Renombra una etiqueta.
== CMD_USAGE_LABEL_RENAME ==
Sintaxis:
cm label rename spec_etiqueta nuevo_nombre
sepec_etiqueta: Especificación de la etiqueta que se va a renombrar.
Usa 'cm help objectspec' para obtener más información sobre
la especificación de etiquetas.
nuevo_nombre: Nuevo nombre para la etiqueta.
== CMD_HELP_LABEL_RENAME ==
Notas:
Este comando renombra una etiqueta.
Ejemplos:
cm label rename lb:BL001 BL002
(La etiqueta 'BL001' se renombra a 'BL002')
== CMD_DESCRIPTION_OBLITERATE ==
DEPRECATED
== CMD_USAGE_OBLITERATE ==
== CMD_HELP_OBLITERATE ==
== CMD_DESCRIPTION_OBJECTSPEC ==
Explica cómo escribir object specs (especificaciones de objetos).
== CMD_USAGE_OBJECTSPEC ==
Sintaxis:
cm objectspec
Para obtener toda la información sobre cómo construir specs de objetos.
== CMD_HELP_OBJECTSPEC ==
Muchos comandos de Unity VCS esperan 'object specs' como entrada para
referirse a un objeto concreto (normalmente una rama, un changeset, un
repositorio, etc.).
Esta documentación describe los diferentes tipos de "specs" disponibles y
cómo construirlas.
Cada tipo de especificación comienza con un tag único, por ejemplo "rep:" o "cs:".
El tag se debe indicar para comandos que reciban especificaciones generales
de objetos, como por ejemplo "cm setowner object_spec", pero a menudo se pueden
omitir en comandos que solo acepten un tipo de especificación, como por ejemplo
"cm getfile revision_spec".
== Repository server spec (repserverspec) ==
repserver:name:port
Ejemplos:
cm lrep repserver:skull:8084
cm lrep skull:8084
Nota:
Lo llamamos "rep" server spec (con el 'rep' delante) en lugar de
simplemente 'server spec' por motivos históricos. Hace mucho tiempo
Unity VCS tenía servidores de workspaces y repositorios separados, y
el nombre ha sobrevivido.
== Repository spec (repspec) ==
rep:rep_name@[repserverspec]
Ejemplos:
cm showowner rep:codice@localhost:6060
(Aquí la "rep:" es necesaria porque el comando showowner admite
todo tipo de objetos).
== Branch spec (brspec) ==
br:[/]br_name[@repspec]
Ejemplos:
cm switch br:/main@rep:plastic@repserver:skull:9095
(En este caso "br:", "rep:" y "repserver:" no son necesarios así
que el comando se puede escribir de forma mucho más compacta:
"cm switch main@plastic@skull:9095" .)
cm find revisions "where branch='br:/main/task001'"
Nota:
La barra inicial '/' en las ramas no es obligatoria. Solíamos escribir
todas las ramas como /main, /main/task001, etc. Pero ahora preferimos
user formatos más cortos tipo main, main/task001.
== Changeset spec (csetspec) ==
cs:cs_number|cs_guid[@repspec]
Se puede especificar el número o el GUID del changeset.
Ejemplos:
cm ls /code --tree=ae1390ed-7ce9-4ec3-a155-e5a61de0dc77@code@skull:7070
== Label spec (labelspec) ==
lb:lb_name[@repspec]
Ejemplos:
cm switch lb:RELEASE2.0
cm switch lb:RELEASE1.4@myrep@MYSERVER:8084
== Revision spec ==
Hay distintos tipos de specs de revisiones:
rev:item_path[#(brspec|csetspec|labelspec)]
rev:serverpath:item_path#(brspec|cset_spec|lb_spec)
rev:revid:rev_id[@rep_spec]
rev:itemid:item_id#(br_spec|cset_spec|lb_spec)
Ejemplos:
cm diff rev:readme.txt#cs:19 rev:readme.txt#cs:20
cm diff serverpath:/doc/readme.txt#cs:19@myrepo \
serverpath:/doc/readme.txt#br:/main@myrepo@localhost:8084
cm cat revid:1230@rep:myrep@repserver:myserver:8084
== Item spec ==
Se usa muy raras veces.
item:path
Ejemplo:
cm find revision "where item='item:.'"
== Attribute spec ==
att:att_name[@repspec]
Ejemplo:
cm rmattributereal att:merged@code@doe:8084 cs:25@code@doe:8084
== Workspace specs ==
wk:name@clientmachine
Se usa muy poco porque solamente aplica a los comandos relacionados con los
workspaces. Es útil para indicar el nombre del workspace en lugar del path.
Ejemplo:
cm showselector wk:codebase@modok
Nota:
Estas specs vienen de los viejos tiempos de Plastic SCM 2.x en los que
los 'workspace servers' eran una forma de almacenar metadatos de forma
centralizada. Se eliminaron por cuestiones de rendimiento.
== CMD_DESCRIPTION_PARTIAL ==
Ejecuta comandos en un espacio de trabajo parcial.
== CMD_USAGE_PARTIAL ==
Sintaxis:
cm partial comando [opciones]
Comandos:
configure
add
undo
co | checkout
unco | undocheckout
ci | checkin
mv | move
rm | remove
stb | switch
upd | update
shelve | shelveset
Para obtener más información de cada uno de los comandos ejecute:
cm partial comando --usage
cm partial comando --help
== CMD_HELP_PARTIAL ==
Ejemplos:
cm partial configure +/fondo-azul.png
cm partial update paisaje-1024.png
cm partial checkin ojos-verde.png ojos-negro.png
== CMD_DESCRIPTION_PARTIAL_ADD ==
Añade un ítem al repositorio.
== CMD_USAGE_PARTIAL_ADD ==
Sintaxis:
cm partial add [-R | -r | --recursive] [--silent] [--parents] [--ignorefailed]
[--skipcontentcheck]
[--format=<str-format>] [--errorformat=<str-format>]
<rutas>+
rutas Rutas de los ítems a añadir separados por espacios.
Usa comillas (") para especificar rutas con espacios.
Usa * para añadir todo el contenido del directorio
actual.
Opciones:
-R Añade los ítems recursivamente.
--silent No muestra ninguna salida.
--parents Incluye los directorios padre de los ítems indicados en
la operación.
--ignorefailed Si un ítem no se puede añadir, la operación de add
continuará sin él. Importante: si un directorio no se
puede añadir, su contenido tampoco se añadirá.
--skipcontentcheck Cuando la extensión no es suficiente para determinar si
el fichero es de tipo texto o binario, se asumirá que es
binario en lugar de usar el contenido para detectar el
tipo.
--format Devuelve la salida en el formato especificado. Consulta
los ejemplos para más información.
--errorformat En caso de error, devuelve el mensaje en el formato
especificado. Consulta los ejemplos para más información.
== CMD_HELP_PARTIAL_ADD ==
Notas:
Requisitos para añadir ítems:
- El directorio padre del ítem a añadir debe existir en el repositorio.
Ejemplos:
cm partial add pic1.png pic2.png
(Añade los ítems pic1.png y pic2.png.)
cm partial add c:\workspace\imagen.png
(Añade el ítem imagen.png en el directorio c:\workspace.)
cm partial add -R c:\workspace\src
(Añade recursivamente todos los ítems del directorio especificado.)
cm partial add --parents ejemplos\diseño01.png
(Añade el ítem diseño01.png y su directorio padre ejemplos.)
cm partial add -R *
(Añade recursivamente todo el contenido del directorio actual.)
cm partial add -R * --format="ADD {0}" --errorformat="ERR {0}"
(Añade recursivamente todo el contenido del directorio actual imprimiendo
por pantalla 'ADD <item>' para los archivos añadidos correctamente y
'ERR <item>' para los archivos que no se pudieron añadir.)
== CMD_DESCRIPTION_PARTIAL_CHECKIN ==
Crea una nueva revisión de un ítem.
== CMD_USAGE_PARTIAL_CHECKIN ==
Sintaxis:
cm partial checkin | ci [opciones] [<ruta>+]
[-c=<str_comment> | -commentsfile=<comments_file>]
[--all | -a] [--applychanged] [--keeplock]
[--symlink] [--ignorefailed]
[--machinereadable [--startlineseparator=<sep>]
[--endlineseparator=<sep>] [--fieldseparator=<sep>]]
ruta Rutas de los ítems a proteger, separados por espacios.
Usa comillas (") para especificar rutas con espacios.
Usa . para aplicar la operación de checkin al directorio
actual.
Opciones:
-c Añade un comentario al changeset creado en la operación
de protección.
-commentsfile Añade el comentario existente en el fichero especificado
al changeset creado en la operación de protección.
--all | -a Los ítems cambiados, movidos y borrados localmente en
las rutas especificadas también son protegidos.
--applychanged Protege los ítems cambiados localmente junto con los
ítems desprotegidos.
--private Incluye en el checkin los ítems privados.
--keeplock Mantiene el bloqueo de aquellos elementos que estaban
bloqueados después de la operación de protección.
--symlink Realizar la operación de checkin sobre el fichero de
link y no al que apunta.
--ignorefailed Los cambios locales que no se pueden aplicar (porque el
bloqueo (checkout exclusivo) no se puede obtener o
porque están en conflicto con los cambios del servidor)
son descartados y el checkin continúa sin ellos.
--machinereadable Muestra el resultado en un formato fácil de parsear.
--startlineseparator Usado con '--machinereadable', indica cómo deben
empezar las líneas del resultado.
--endlineseparator Usado con '--machinereadable', indica cómo deben
terminar las líneas del resultado.
--fieldseparator Usado con '--machinereadable', indica cómo deben
separarse los campos de cada línea resultante.
== CMD_HELP_PARTIAL_CHECKIN ==
Notas:
- Si no se especifican [opciones] ni [rutas], la operación involucrará a
todos los cambios pendientes en el espacio de trabajo.
- La operación de protección se aplica siempre recursivamente desde la
ruta indicada.
- Requisitos para proteger un ítem:
- El ítem debe estar controlado por Unity VCS.
- El ítem ha de estar desprotegido.
- Si un ítem ha sido cambiado pero no desprotegido, no es necesario
especificar la opción --applychanged, salvo que en las rutas a ser
protegidas se incluyan directorios o rutas con wildcards ('*').
La revisión ha de tener cambios. Es decir, no se pueden proteger los
mismos datos.
Configure la variable de entorno PLASTICEDITOR para especificar un editor
para escribir el comentario. Si la variable de entorno PLASTICEDITOR está
configurada pero no se indica ningún comentario, el editor se abrirá para
que pueda escribir el comentario.
Ejemplos:
cm partial checkin figura.png paisaje.png
(Protege los ítems figura.png and paisaje.png.)
cm partial checkin . -commentsfile=micomentario.txt
(Protege los ítems de la ruta actual y aplica el comentario existente en el
fichero micomentario.txt.)
cm partial ci fondo.png -c="Nuevo fondo añadido" --keeplock
(Protege el ítem fondo.png, incluye el comentario especificado y mantiene el
bloqueo.)
cm partial checkin --applychanged
(Protege todos los cambios pendientes en el espacio de trabajo.)
cm partial checkin link --symlink
(Proteger el fichero de symlink y no al que apunta.)
== CMD_DESCRIPTION_PARTIAL_CHECKOUT ==
Desprotege los ítems dejándolos preparados para ser modificados.
== CMD_USAGE_PARTIAL_CHECKOUT ==
Síntaxis:
cm partial checkout | co [<ruta>+] [--resultformat=str_format]
[--silent] [--ignorefailed]
Opciones:
ruta Rutas de los ítems a desproteger, separados por
espacios.
Usa comillas (") para especificar rutas con espacios.
Usa . para aplicar la operación de checkout al
directorio actual.
--resultformat Devuelve la salida en el formato especificado.
--silent No muestra ninguna salida.
--ignorefailed Si un ítem no se puede desproteger/bloquear (no se puede
hacer un checkout exclusivo), la operación de checkout
continuará sin él.
== CMD_HELP_PARTIAL_CHECKOUT ==
Notas:
Para desproteger un ítem:
- El ítem debe estar controlado por Unity VCS.
- El ítem debe estar protegido.
Si se han configurado bloqueos en el servidor (existe el fichero lock.conf),
entonces cada vez que se produzca una desprotección, Unity VCS comprobará si
se aplica alguna de las reglas. Si es así, la ruta permanecerá en checkout
exclusivo (bloqueada), con lo que nadie podrá desprotegerlo simultáneamente.
Puedes obtener todos los bloqueos del servidor usando 'cm listlocks'.
Lee la documentación Administrator Guide para más información.
Examples:
cm partial checkout imagen1.png imagen2.png
(Desprotege los ítems imagen1.png and imagen2.png.)
cm partial co *.png
(Desprotege todos los ítems png.)
cm partial checkout .
(Desprotege el directorio actual.)
cm partial checkout -R c:\workspace\paisaje
(Desprotege recursivamente el directorio paisaje.)
cm partial co diseño01.png --exclusive
(Desprotege el ítem exclusivamente.)
== CMD_DESCRIPTION_PARTIAL_CONFIGURE ==
Permite configurar tu espacio de trabajo, cargando o descargando elementos.
== CMD_USAGE_PARTIAL_CONFIGURE ==
Sintaxis:
cm partial configure <+|-ruta>+ [--silent] [--ignorefailed] [--ignorecase]
[--restorefulldirs]
[--machinereadable [--startlineseparator=<sep>]
[--endlineseparator=<sep>] [--fieldseparator=<sep>]]
ruta Rutas a cargar o descargar, separadas por espacios.
Usa comillas (") para especificar rutas con espacios.
Todas las rutas deben comenzar con "/".
Opciones:
--silent No muestra ninguna salida.
--ignorefailed Ignora cualquier error durante la operación.
--ignorecase Ignora mayúsculas y minúsculas. Con esta opción el
comando funcionará para "/Data/Textures" incluso si el
usuario indica "/data/teXtures".
--restorefulldirs Resetea una configuración de directorio incorrecta
(ocurre cuando una operación no parcial es ejecutada en
un espacio de trabajo parcial).
Los directorios de esta lista se configuran por
completo (full check), lo que significa que bajarán
automáticamente el nuevo contenido durante el update.
Esta operación no descarga ningún fichero, simplemente
restaura la configuración de directorio en un espacio
de trabajo parcial.
--machinereadable Muestra el resultado en un formato fácil de parsear.
--startlineseparator Usado con '--machinereadable', indica cómo deben
empezar las líneas del resultado.
--endlineseparator Usado con '--machinereadable', indica cómo deben
terminar las líneas del resultado.
--fieldseparator Usado con '--machinereadable', indica cómo deben
separarse los campos de cada línea resultante.
== CMD_HELP_PARTIAL_CONFIGURE ==
Notas:
El comando siempre asume recursividad.
Ejemplos:
cm partial configure +/paisaje-gris.png
(Carga paisaje-gris.png.)
cm partial configure -/paisaje-negro.png
(Descarga paisaje-negro.)
cm partial configure +/textura -/textura/textura01.png
(Carga todo el contenido del directorio textura excepto textura01.png.)
cm partial configure -/
(Descarga todo el directorio de trabajo.)
cm partial configure -/ +/
(Carga todo el directorio de trabajo.)
cm partial configure +/figura-64.png --ignorefailed
(Carga figura-64.png, estuviera o no ya cargado previamente.)
cm partial configure +/ --restorefulldirs
(Fija todos los directorios para que descarguen el nuevo contenido automáticamente.)
cm partial configure +/src/lib --restorefulldirs
(Fija sólo /src/lib y sus subdirectorios para que descarguen el nuevo contenido automáticamente.)
== CMD_DESCRIPTION_PARTIAL_MOVE ==
Mueve o renombra un archivo o directorio.
== CMD_USAGE_PARTIAL_MOVE ==
Sintaxis:
cm partial move | mv src_path dst_path [--format=str_format]
src_path Ruta origen del ítem.
dst_path Ruta destino del ítem.
Options:
--format Devuelve la salida en el formato especificado.
== CMD_HELP_PARTIAL_MOVE ==
Notas:
Este comando mueve o renombra un ítem en el repositorio.
Los cambios también se aplican localmente.
Si la ruta de origen es un fichero, el destino puede ser un fichero o un
directorio. En el primer caso, el fichero se renombra. En el segundo, el
fichero se renombra.
Si la ruta de origen en un directorio, el destino ha de serlo también.
El ítem a mover o renombrar debe existir.
Formato:
{0} Ruta de origen.
{1} Ruta de destino.
Examples:
cm partial move fichero.png fichero-azul.png
(Renombra el ítem.)
cm partial mv .\fichero-azul.png .\azulFicheros
(Mueve fichero-azul.png a azulFicheros.)
cm partial move .\diseño .\marketing
(Renombra un directorio.)
== CMD_DESCRIPTION_PARTIAL_RM ==
Borra un ítem del control de versiones.
== CMD_USAGE_PARTIAL_RM ==
Sintaxis:
cm partial remove | rm <ruta>+ [--nodisk]
ruta Ítems a borrar, separados por espacios.
Usa comillas (") para especificar rutas con espacios.
Opciones:
--nodisk Borra del control de versiones, pero mantiene el ítem en
disco.
== CMD_HELP_PARTIAL_RM ==
Notas:
Los ítems se borran de disco. Los ítems borrados son borrados del directorio
padre en el control de versiones.
Requisitos:
- El ítem debe estar controlado.
Ejemplos:
cm partial remove src
(Borra src. Si src es un directorio, equivale a ejecutar:
cm partial remove -R src.)
cm partial remove c:\workspace\pic01.png --nodisk
(Borra pic01.png del control de versiones, pero lo mantiene en el disco.)
== CMD_DESCRIPTION_PARTIAL_SHELVESET ==
Use este comando para administrar shelvesets parciales.
== CMD_USAGE_PARTIAL_SHELVESET ==
Sintaxis:
cm partial shelveset | shelve <command> [options]
Comandos:
create | mk
apply
delete | rm
Para obtener más información sobre cada comando:
cm partial shelveset <command> --usage
cm partial shelveset <command> --help
== CMD_HELP_PARTIAL_SHELVESET ==
Ejemplos:
cm partial shelveset create -c="my comment"
cm partial shelveset apply sh:3
cm partial shelveset delete sh:5
== CMD_DESCRIPTION_PARTIAL_SHELVESET_CREATE ==
Almacena los cambios pendientes escogidos.
== CMD_USAGE_PARTIAL_SHELVESET_CREATE ==
Sintaxis:
cm partial shelveset | shelve create | mk [<item_path>[ ...]]
[-c=<str_comment> | -commentsfile=<comments_file>]
[--applychanged] [--symlink] [--ignorefailed]
[--machinereadable [--startlineseparator=<sep>]
[--endlineseparator=<sep>] [--fieldseparator=<sep>]]
Opciones:
-c Añade un comentario al shelveset creado en la operación
de protección.
-commentsfile Añade el comentario existente en el fichero especificado
al shelveset creado en la operación de protección.
--applychanged Protege los ítems cambiados localmente junto con los
ítems desprotegidos.
--symlink Realizar la operación de shelve sobre el fichero de
link y no al que apunta.
--ignorefailed Los cambios locales que no se pueden aplicar (porque el
bloqueo (checkout exclusivo) no se puede obtener o
porque están en conflicto con los cambios del servidor)
son descartados y el shelve continúa sin ellos.
--machinereadable Muestra el resultado en un formato fácil de parsear.
--startlineseparator Usado con '--machinereadable', indica cómo deben
empezar las líneas del resultado.
--endlineseparator Usado con '--machinereadable', indica cómo deben
terminar las líneas del resultado.
--fieldseparator Usado con '--machinereadable', indica cómo deben
separarse los campos de cada línea resultante.
== CMD_HELP_PARTIAL_SHELVESET_CREATE ==
El comando partial shelveset create almacena los ítems en checkout especificados
dentro del repositorio. De este modo el contenido queda almacenado en el
servidor sin necesidad de hacer checkin.
Notas:
- Si no se especifican [opciones] ni [rutas], la operación involucrará a
todos los cambios pendientes en el espacio de trabajo.
- La operación de protección se aplica siempre recursivamente desde la
ruta indicada.
- La operacion de creación de protección es la operación por defecto,
lo que significa que si no se especifica ninguna otra, el comando tratará
de ejecutar una nueva creación de protección.
- Requisitos para proteger un ítem:
- El ítem debe estar controlado por Unity VCS.
- El ítem ha de estar desprotegido.
- Si un ítem ha sido cambiado pero no desprotegido, no es necesario
especificar la opción --applychanged, salvo que en las rutas a ser
protegidas se incluyan directorios o rutas con wildcards ('*').
La revisión ha de tener cambios. Es decir, no se pueden proteger los
mismos datos.
Configure la variable de entorno PLASTICEDITOR para especificar un editor
para escribir el comentario. Si la variable de entorno PLASTICEDITOR está
configurada pero no se indica ningún comentario, el editor se abrirá para
que pueda escribir el comentario.
Ejemplos:
cm partial shelveset figura.png paisaje.png
(Crea un nuevo shelveset con los ítems figura.png and paisaje.png.)
cm partial shelveset . -commentsfile=micomentario.txt
(Crea un nuevo shelveset con los ítems de la ruta actual y aplica el
comentario existente en el fichero micomentario.txt.)
cm partial shelve fondo.png -c="Nuevo fondo añadido"
(Crea un nuevo shelveset el ítem fondo.png, incluye el comentario
especificado.)
cm partial shelveset --applychanged
(Crea un nuevo shelveset con todos los cambios locales junto con los
cambios controlados pendientes en el espacio de trabajo.)
cm partial shelveset link --symlink
(Crea un nuevo shelveset con fichero de symlink, en lugar del fichero al
que apunta.)
== CMD_DESCRIPTION_PARTIAL_SHELVESET_APPLY ==
El comando partial shelveset apply restaura los contenidos almancenados en el
repositorio.
== CMD_USAGE_PARTIAL_SHELVESET_APPLY ==
Sintaxis:
cm partial shelveset apply shelve_spec [opciones]
shelve_spec: Restaura los contenidos almancenados en el repositorio
identificados por "shelve_spec"
Opciones:
--encoding=codificación: Especifica la codificación de los ficheros de
origen (por ejemplo, UTF-8 o Unicode)
--comparisonmethod=tipo: cualquiera de las siguientes opciones:
ignoreeol: Ignora diferencias de final de línea.
ignorewhitespaces: Ignora diferencias de espacios en blanco.
ignoreeolandwhitespaces: Ignora diferencias de final de línea y espacios en
blanco.
recognizeall: Detecta diferencias de final de línea y espacios en
blanco.
== CMD_HELP_PARTIAL_SHELVESET_APPLY ==
El comando partial shelveset apply restaura los contenidos almancenados en el
repositorio.
Ejemplo: Aplicar un shelve almacenado en el repositorio:
cm partial shelveset apply sh:3
== CMD_DESCRIPTION_PARTIAL_SHELVESET_DELETE ==
Borra un shelveset.
== CMD_USAGE_PARTIAL_SHELVESET_DELETE ==
Sintaxis:
cm partial shelveset delete shelve_spec
shelve_spec: Elimina los contenidos almancenados en el repositorio
identificados por "shelve_spec"
== CMD_HELP_PARTIAL_SHELVESET_DELETE ==
El comando partial shelveset delete borra un shelveset creado anteriormente.
Ejemplo:
cm partial shelveset delete sh:3
(Elimina un shelveset almacenado en el repositorio.)
== CMD_DESCRIPTION_PARTIAL_SWITCH ==
Establece la rama especificada como rama de trabajo.
== CMD_USAGE_PARTIAL_SWITCH ==
Sintaxis:
cm switch branch_spec [--report | --silent] [--workspace=path] [--noinput]
(Establece la rama de trabajo y actualiza el workspace.)
cm switch branch_spec --configure <+|-ruta>+ [--silent]
[--ignorefailed] [--ignorecase] [--workspace=path]
(Establece la rama de trabajo y configura el workspace como haría el
comando 'cm partial configure'.)
branch_spec Especificación de rama.
ruta Rutas a cargar o descargar, separadas por espacios.
Usa comillas (") para especificar rutas con espacios.
Todas las rutas deben comenzar con "/".
Opciones:
--silent No muestra salida.
--report Imprime una lista de los cambios efectuados una vez
termina la operación. Pierde efecto si se utiliza
la opción --silent conjuntamente.
--configure Configura (carga / descarga rutas) el espacio de
trabajo después de haber actualizado la rama de trabajo.
Usa 'cm partial configure --help' para aprender más
sobre como especificar las rutas a configurar.
--ignorefailed Ignora cualquier error durante la operación
de configuración.
--ignorecase Ignora mayúsculas y minúsculas en las rutas a
configurar. Con esta opción el comando funcionará
para "/Data/Textures" incluso si el usuario indica
"/data/teXtures".
--noinput Ignora las pregunta interactiva para continuar la
operación haciendolos shelve a los cambios pendientes.
--workspace=path Ruta del espacio de trabajo a cambiar.
--forcedetailedprogress Fuerza mostrar progreso detallado incluso cuando se
redirige la salida estándar.
Usa 'cm help objectspec' para aprender más sobre cómo indicar especificaciones
de ramas.
== CMD_HELP_PARTIAL_SWITCH ==
Notas:
Este comando permite a los usuarios especificar una rama, como rama de
trabajo. Después de actualizar la rama, actualiza el espacio de trabajo
a la nueva rama como haría un 'cm partial update'. Sin embargo, si se
especifica la opción --configure, permite configurar el espacio de trabajo
teniendo en cuenta los elementos cargados en la nueva rama como haría un
'cm partial configure'.
Ejemplos:
cm switch br:/main/task
(Establece /main/task como rama de trabajo y actualiza el espacio de
trabajo.)
cm switch br:/main/task --configure +/art/images
(Establece /main/task como rama de trabajo y configura el directorio
/art/images.)
== CMD_DESCRIPTION_PARTIAL_UNCO ==
Deshace la desprotección de un ítem.
== CMD_USAGE_PARTIAL_UNCO ==
Sintaxis:
cm partial undocheckout | unco <ruta>+ [--silent] [--keepchanges | -k]
ruta Ítems sobre los que aplicar la operación, separados por
espacios.
Usa comillas (") para especificar rutas con espacios.
Usa . para aplicar la operación al directorio actual.
Opciones:
--silent No muestra ninguna salida.
--keepchanges (-k) Deshace la desprotección dejando los cambios locales.
Ejemplo: un checkout lo deja como changed con el
contenido en disco que tenia antes de hacer el unco.
Esta opción no puede utilizarse con workspaces dinámicos.
== CMD_HELP_PARTIAL_UNCO ==
Notas:
Si un ítem está desprotegido y no quieres protegerlo, puede deshacer la
desprotección usando este comando.
Se puede deshacer la desprotección tanto a ficheros como a carpetas.
El ítem se actualizará al estado anterior previo a ser desprotegido.
Requisitos:
- El ítem debe estar controlado.
- El ítem debe estar desprotegido.
Ejemplos:
cm partial undocheckout .
(Deshace las desprotecciones del directorio actual.)
cm partial undocheckout pic1.png pic2.png
cm unco c:\workspace\diseño01.png
(Deshace las desprotecciones de los ítems especificados.)
== CMD_DESCRIPTION_PARTIAL_UNDO ==
Deshace cambios en un workspace.
== CMD_USAGE_PARTIAL_UNDO ==
Syntaxis:
cm partial undo [path]+ [--symlink] [-r | --recursive] [Filtros]+
[Opciones de salida]
path Rutas de los ficheros o carpetas a los que aplicar
la operación, separados por espacios. Se pueden
utilizar comillas (") para especificar rutas con
espacios. Si no se especifica ninguna ruta, por
defecto la operación se ejecutará sobre los ficheros
en el directorio actual.
Opciones:
--symlink Aplica la operación de undo al enlace simbólico y
no a su destino.
-r Ejecuta el undo de manera recursiva.
Filtros:
Si ninguna de estas opciones está presente, por defecto se deshacen todos
los tipos de cambio, pero los ficheros pueden filtrarse utilizando estas
opciones.
Si un fichero o directorio tiene uno o más de los tipos de cambio
especificados, todos los cambios en ese fichero o directorio serán
deshechos.
Por ejemplo, si se especifica tanto --checkedout como --moved, si un fichero
está tanto movido como checkedout, ambos cambios se desharán.
--checkedout Selecciona ficheros y directorios marcados para
cambios.
--unchanged Selecciona ficheros sin modificaciones en su
contenido.
--changed Selecciona ficheros y directorios cambiados o
marcados para cambios.
--deleted Selecciona ficheros y directorios eliminados.
--moved Selecciona ficheros y directorios movidos.
--added Selecciona ficheros y directorios añadidos.
Opciones de salida:
--silent | --machinereadable [--startlineseparator=sep]
[--endlineseparator=sep] [--fieldseparator=sep]
--silent No muestra ninguna salida.
--machinereadable Muestra la salida en un formato fácil de tratar.
--startlineseparator Usado en conjunto con la opción '--machinereadable',
especifica cómo deberían comenzar las líneas.
--endlineseparator Usado en conjunto con la opción '--machinereadable',
especifica cómo deberían terminar las líneas.
--fieldseparator Usado en conjunto con la opción '--machinereadable',
especifica cómo deberían separarse las líneas.
== CMD_HELP_PARTIAL_UNDO ==
Notas:
El comand undo es peligroso - deshace trabajo de una manera irreversible.
Una vez que el undo termina, no hay manera posible de recuperar el estado
anterior de los ficheros y directorios afectados. Si no se especifica
ninguna ruta en los argumentos, por defecto se desharán los cambios en todos
los elementos del directorio actual, pero NO de manera recursiva.
Estos comandos son equivalentes ejecutados desde el directorio /src:
/src
|- file.txt
|- code.cs
\- /test
|- test_a.py
\- test_b.py
$ cm partial undo
$ cm partial undo *
$ cm partial undo file.txt code.cs /test
$ cm partial undo .
$ cm partial undo /src file.txt code.cs
Si se quiere que la operación sea recursiva, se necesita especificar la
opción -r.
Para deshacer todos los cambios debajo de un directorio (incluyendo los
cambios sobre el propio directorio):
$ cm partial undo dirpath -r
Si dirpath es la ruta de un workspace, todos los cambios dentro del
workspace serán deshechos.
Examples:
$ cm partial undo . -r
(Deshace todos los cambios en el directorio actual de manera recursiva. Si
se ejecuta desde la raíz del workspace, deshace todos los cambios en el
workspace completo.)
$ cm partial co file.txt
$ cm partial undo file.txt
(Deshace el checkout en file.txt.)
$ echo content >> file.txt
$ cm partial undo file.txt
(Deshace el cambio local en file.txt.)
$ cm partial undo src
(Deshace los cambios en el directorio src y en todos los ficheros
controlados que contenga)
$ cm partial undo src/*
(Deshace los cambios en todos los elementos contenidos en src, sin afectar
al propio directorio. Por la expansión del wildcard, es equivalente a
'cm partial undo src/file1.txt src/file2.txt').
$ cm partial undo *.cs
(Deshace cambios en cada elemento que encaje con el patrón *.cs en el
directorio actual.)
$ cm partial undo *.cs -r
(Deshace cambios en cada elemento que encaje con el patrón *.cs en el
directorio actual, y en cada directorio por debajo de una manera recursiva.)
$ cm partial co file1.txt file2.txt
$ echo content >> file1.txt
$ cm partial undo --unchanged
(Deshace el checkout en file2.txt por no estar modificado, ignorando
file1.txt ya que tiene cambios locales.)
$ echo content >> file1.txt
$ echo content >> file2.txt
$ cm partial co file1.txt
$ cm partial undo --checkedout
(Deshace el cambio en el fichero en checkout file1.txt, ignorando file2.txt
ya que no está en checkout.)
$ cm partial add file.txt
$ cm partial undo file.txt
(Deshace el añadido de file.txt, dejándolo de nuevo como privado.)
$ rm file1.txt
$ echo content >> file2.txt
$ cm partial add file3.txt
$ cm partial undo --deleted --added *
(Deshace el borrado de file1.txt y el añadido de file3.txt, ignorando
el cambio en file2.txt.)
== CMD_DESCRIPTION_PARTIAL_UPDATE ==
Actualiza el espacio de trabajo parcial.
== CMD_USAGE_PARTIAL_UPDATE ==
Sintaxis:
cm partial update [<ruta>+]
[--changeset=número]
[--silent | --report] [--dontmerge]
[--xml[=<output_file>]]
[--machinereadable [--startlineseparator=<sep>]
[--endlineseparator=<sep>] [--fieldseparator=<sep>]]
ruta Rutas a actualizar, separadas por espacios. Las dobles
comillas (") deben usarse para especificar rutas que
contienen espacios.
Si se usa . entonces se actualiza el directorio actual.
Si no se especifica ninguna ruta, entonces se actualiza todo
el espacio de trabajo parcial.
Opciones:
--changeset Actualiza el espacio de trabajo parcial al changeset
especificado.
--silent No muestra salida a no ser que ocurra un error.
--xml Imprime por defecto a la salida estándar en formato
XML. Se permite especificar un fichero de salida.
--report Imprime una lista de los cambios efectuados una vez que
termina la operación. Esta opción no tiene efecto si se
utiliza la opción --silent.
--dontmerge No procesa los conflictos de fichero. El resto de cambios
se procesan con normalidad. Esta opción puede ser útil en
automatización para evitar interacción con el usuario.
--machinereadable Muestra el resultado en un formato fácil de parsear.
--startlineseparator Usado con '--machinereadable', indica cómo deben
empezar las líneas del resultado.
--endlineseparator Usado con '--machinereadable', indica cómo deben
terminar las líneas del resultado.
--fieldseparator Usado con '--machinereadable', indica cómo deben
separarse los campos de cada línea resultante.
== CMD_HELP_PARTIAL_UPDATE ==
Notas:
El comando update actualiza los ficheros desactualizados.
El comando update siempre asume recursividad.
Si todas las rutas especificadas son ficheros dentro del mismo xlink y
se usa la opción --changeset, entonces las versiones a actualizar se buscan
dentro del changeset del repositorio del xlink.
Ejemplos:
cm partial update
(Actualiza todo el espacio de trabajo parcial.)
cm partial update .
(Actualiza todos los hijos del directorio actual.)
cm partial update fichero1.txt
(Actualiza el fichero fichero1.txt.)
cm partial update fichero1.txt fichero2.txt
(Actualiza los ficheros fichero1.txt y fichero2.txt.)
cm partial update src --report
(Actualiza todos los hijos del directorio src, mostrando una lista de los
cambios aplicados al finalizar.)
cm partial update src --changeset=4
(Actualiza todos los hijos del directorio src, al contenido
que cargaban en el changeset 4.)
cm partial update xlink/first.png --changeset=4
(Actualiza el fichero xlink/first.png al contenido que cargaba en el
changeset 4 del repositorio del xlink.)
cm partial update . --changeset=2 --xml=output.xml 2>errors.txt
(Actualiza todos los hijos del directorio actual al contenido que cargaba en el
changeset 2 del repositorio e informa del resultado en formato XML. La salida
la almacena en un archivo output.xml y los potenciales errores los redirige
al archivo errors.txt.
NOTA: la redirección puede variar dependiendo de la consola empleada.)
== CMD_DESCRIPTION_PATCH ==
Genera un parche a partir de una spec o aplica un parche generado en el workspace actual.
== CMD_USAGE_PATCH ==
Sintaxis:
cm patch [source_spec] source_spec
[--output=output_file] [--tool=/path/to/diff]
cm patch --apply patch_file [--tool=/path/to/patch]
source_spec Especificación de rama o changeset
output_file Fichero que contendrá la salida del comando. Se
mostrará en pantalla si no se especifica.
Opciones:
--output Indica el fichero de destino para almacenar los
contenidos del parche.
--tool Especifica la ruta hacia la herramienta necesaria para
ejecutar la operación (diff o patch).
== CMD_HELP_PATCH ==
Notas:
Este comando genera un fichero patch que contiene las diferencias de una
rama o un changeset, así como las diferencias entre changesets. Encuentra
diferencias para ficheros tanto de texto como binarios.
El parámetro --apply permite aplicar los contenidos de un fichero patch
en el workspace actual.
Limitaciones:
Si el fichero de salida de patch ya existe, el comando no lo
sobreescribirá.
Si el fichero con modificaciones en el patch no existe, el comando no
creará uno nuevo para aplicar los cambios.
Importante:
Este comando requiere las utilidades Diff y Patch, disponibles
en http://gnuwin32.sourceforge.net/packages/patch.htm y
http://gnuwin32.sourceforge.net/packages/diffutils.htm
Tras su instalación se recomienda agregar su ubicación a la variable
de entorno PATH.
Ejemplos:
cm patch cs:4@default@localhost:8084
(Muestra en pantalla las diferencias del changeset 4 en formato patch.)
cm patch br:/main --output=file.patch
(Obtiene un fichero file.patch con las diferencias de la rama "main".)
cm patch br:/main --output=file.patch --tool=C:\gnu\diff.exe
(Misma operación con un ejecutable indicado explícitamente.)
cm patch cs:2@default cs:4@default
(Muestra en pantalla las diferencias entre los changeset 2 y 4.)
cm patch --apply file.patch --tool=C:\gnu\patch.exe
(Aplica el parche contenido en file.patch al workspace actual con un
ejecutable indicado explícitamente.)
== CMD_DESCRIPTION_PROFILE ==
Permite al usuario administrar perfiles de conexión configurados en el cliente.
== CMD_USAGE_PROFILE ==
Sintaxis:
cm profile | profile <command> [options]
Comandos:
list | ls
create | mk
delete | rm
Para obtener más información sobre cada comando:
cm profile <command> --usage
cm profile <command> --help
== CMD_HELP_PROFILE ==
Ejemplos:
cm profile
cm profile list
cm profile create
cm profile delete 1
== CMD_DESCRIPTION_PROFILE_LIST ==
Lista los perfiles de conexión configurados en el cliente.
== CMD_USAGE_PROFILE_LIST ==
Sintaxis:
cm profile [list | ls] [--format=<str_format>]
Opciones:
--format Muestra el mensaje de salida en el formato indicado.
Consulte las notas para más información.
== CMD_HELP_PROFILE_LIST ==
Notas:
Parámetros de formato de salida (opción --format):
Este comando acepta una cadena de formato para mostrar la salida.
Los parámetros de salida de este comando son los siguientes:
{index} | {0} Índice del perfil dentro de la lista
{name} | {1} Nombre del perfil
{server} | {2} Servidor del perfil
{user} | {3} Usuario del perfil
{workingmode} | {4} Modo de trabajo del perfil
{securityconfig} | {5} Configuración de seguridad del perfil
{tab} Inserta un tabulador
{newline} Inserta una nueva línea
Ejemplos:
cm profile
(Lista todos los perfiles usando el formato por defecto.)
cm profile --format="{index,2} {server,-20}"
(Muestra el índice del perfil utilizando 2 espacios y alineado a la derecha,
dos espacios, y el servidor de repositorios utilizando veinte espacios,
alineado a la izquierda.)
cm profile --format="{0,2} {2,-20}"
(Muestra el mismo resultado que el ejemplo anterior.)
== CMD_DESCRIPTION_PROFILE_CREATE ==
Crea un nuevo perfil de conexión.
== CMD_USAGE_PROFILE_CREATE ==
Sintaxis:
cm profile [create | mk]
(Crea un nuevo perfil de conexión de manera interactiva.)
cm profile [create | mk] --server=<server_addr> --username=<username>
--password=<password> --workingmode=<workingmode>
(Crea un nuevo perfil de conexión usando un modo de autenticación basado
en usuario y contraseña.)
cm profile [create | mk] --server=<server_addr> --username=<username>
--token=<token> --workingmode=SSOWorkingMode
(Crea un nuevo perfil de conexión usando un modo de autenticación basado
en Single Sign On.)
Opciones:
--server Crea el perfil de conexión para el servidor especificado.
--username El nombre de usuario que va a ser utilizado en el perfil de
conexión.
--password La contraseña, en texto plano, que será usada en el perfil
de conexión. Esta opción solo es válida para los modos de
autenticación basados en usuario y contraseña.
--token El token, en texto plano, que será usado en el perfil de
conexión. Esta opción solo es válida para los modos de
autenticación basados en token (por ahora solo SSOWorkingMode).
--workingmode El modo de autenticación del servidor.
Modos de autenticación disponibles:
LDAPWorkingMode (LDAP)
UPWorkingMode (User and password)
SSOWorkingMode (Single Sign On)
== CMD_HELP_PROFILE_CREATE ==
Notas:
Cuando se utiliza este comando en modo interactivo (sin opciones) el cliente
trata de conectarse con el servidor para obtener el modo de autenticación y
comprobar las credenciales. Esto garantiza que el perfil de conexión
resultante sea correcto.
Cuando se utiliza este comando con opciones, el cliente genera el perfil de
conexión sin conectar con el servidor. Esto es útil para crear perfiles de
conexión para su uso en automatización.
Ejemplos:
cm profile create
(Crea un perfil de conexión de manera interactiva.)
cm profile create --server=plastic.domain.com:8087 --username=sergio
--password=thisissupersecret --workingmode=LDAPWorkingMode
(Crea un perfil de conexión contra 'plastic.domain.com:8087' con el usuario
'sergio' y la contraseña 'thisissupersecret' usando el modo de autenticación
LDAP.)
cm profile mk --server=plastic.domain.com:8087 --username=sergio
--token="TOKENAMoKJ9iAA(...)12fssoprov:unityid"
(Crea un perfil de conexión contra 'plastic.domain.com:8087' con el usuario
'sergio' y el token especificado usando el modo de autenticación Single Sign
On.)
== CMD_DESCRIPTION_PROFILE_DELETE ==
Borra un perfil de conexión de la configuración del cliente.
== CMD_USAGE_PROFILE_DELETE ==
Sintaxis:
cm profile delete | rm <index | name>
cm profile delete | rm --index=<index>
cm profile delete | rm --name=<name>
index Índice del perfil en la lista de perfiles de conexión.
name Nombre del perfil.
Opciones:
--index Utilizado para desambiguación en caso de que un perfil tenga un
número por nombre.
--name Utilizado para desambiguación en caso de que un perfil tenga un
número por nombre.
== CMD_HELP_PROFILE_DELETE ==
Notas:
Borra un perfil de conexión de la configuración del cliente.
Funciona especificando tanto el índice del perfil como su nombre.
El comando 'cm profile list' no muestra el nombre del perfil por defecto,
use 'cm profile list --help' para saber cómo mostrar el nombre del perfil.
Ejemplos:
cm profile delete 1
(Borra el perfil con índice 1)
cm profile delete 192.168.0.2:8087_UPWorkingMode
(Borra el perfil con nombre '192.168.0.2:8087_UPWorkingMode'.)
cm profile delete --name=12
(Borra el perfil con nombre '12'.)
== CMD_DESCRIPTION_QUERY ==
Ejecuta una consulta SQL contra la base de datos del servidor.
== CMD_USAGE_QUERY ==
Uso:
cm query comandosql [--outputfile=ruta]
[--solveuser=nombre_columna1,nombre_columna2,...]
[--solvepath=nombre_columna1,nombre_columna2,...]
[--columnwidth=valor]
--outputfile: Escribe en un fichero el resultado de la consulta.
--solveuser: Indica al intérprete de consultas que la(s) columna(s)
especificada(s) contiene(n) usuarios. Se tratarán de resolver
identificadores de usuario a nombres de usuario.
--solvepath: Indica al intérprete de consultas que la(s) columna(s)
especificadas(s) contiene(n) identificadores de ítem. Se tratarán de
resolver los identificadores a rutas de disco.
--columnwidth: Especifica la anchura de cada columna del resultado de la
consulta.
== CMD_HELP_QUERY ==
Notas:
Este comando permite a los usuarios ejecutar consultas SQL directamente
contra la base de datos del servidor.
A continuación se detalla el esquema (tablas y campos de cada tabla)
disponibles para realizar consultas.
ITEMS
OBJECTID (integer)
CREATIONDATE (datetime)
OWNER (string)
REVISIONS
OBJECTID (integer)
SIZEBYTES (integer)
ITEMID (integer)
BRANCHID (integer)
CHANGESET (integer)
COMMENT (string)
CREATIONDATE (datetime)
OWNER (string)
CHECKOUTS
REVISIONID (integer)
WORKSPACESERVER (string)
CLIENTMACHINE (string)
EXCLUSIVE (char)
CREATIONDATE (datetime)
OWNER (string)
BRANCHES
OBJECTID (integer)
NAME (string)
PARENTBRANCHID (integer)
CREATIONDATE (datetime)
OWNER (string)
LABELS
OBJECTID (integer)
NAME (string)
CREATIONDATE (datetime)
OWNER (string)
LABELEDREVISIONS
LABELID (integer)
REVISIONID (integer)
CREATIONDATE (datetime)
OWNER (string)
LINKS
OBJECTID (integer)
NAME (string)
CREATIONDATE (datetime)
OWNER (string)
LINKEDOBJECTS
LINKID (integer)
SOURCEOBJECTID (integer)
DESTINATIONOBJECTID (integer)
CREATIONDATE (datetime)
OWNER (string)
ATTRIBUTES
OBJECTID (integer)
NAME (string)
CREATIONDATE (datetime)
OWNER (string)
OBJECTSWITHATTRIBUTES
ATTRIBUTEID (integer)
SOURCEOBJECTID (integer)
ATTRIBUTEVALUE (string)
CREATIONDATE (datetime)
OWNER (string)
CHANGESETS
CHANGESETNUMBER (integer)
CREATIONDATE (datetime)
OWNER (string)
Además, a la hora de escribir consultas, existen dos functiones predefinidas
para trabajar con usuarios y rutas de disco.
Estas funciones son las siguientes:
* SolveUser(nombre_usuario), resuelve el nombre de usuario dado al formato que
maneja Unity VCS.
* SolvePath(path), resuelve rutas de disco a identificadores de ítem itemid.
Para mostrar el resultado de las consultas de forma legible al usuario, se
puede indicar al intérprete de consultas que convierta identificadores de
usuario a nombres de usuario, e identificadores de ítem a rutas de disco.
Para ello se utilizan las opciones:
--solveuser=nombre_columna
--solvepath=nombre_columna
Se pueden especificar varios nombres de columnas separados por comas.
Ejemplos:
cm query "SELECT * FROM revision"
cm query "SELECT b.sname as br_name, o.dtimestamp as date from branch b, object o, seid s
where b.iobjid=o.iobjid and o.fidowner=s.iseidid and s.scode='SolveUser(juan)'"
cm query "SELECT * FROM REVISION WHERE itemid=SolvePath(c:\mi_workspace)"
cm query "SELECT r.iobjid, r.fiditem as ruta, s.scode as nombre_usuario FROM revision r, object o, seid s
WHERE r.iobjid=o.iobjid and o.fidowner=s.iseidid" --solveuser=nombre_usuario --solvepath=ruta
== CMD_DESCRIPTION_ATTRIBUTE_DELETE ==
Borra uno o más atributos.
== CMD_USAGE_ATTRIBUTE_DELETE ==
Sintaxis:
cm attribute | att delete | rm <att_spec>[ ...]
att_spec Atributos a borrar. Use un espacio en blanco para separar
atributos.
(Use 'cm help objectspec' para más información sobre
las especificaciones de atributos.)
== CMD_HELP_ATTRIBUTE_DELETE ==
Notas:
Este comando borra uno o más atributos.
Ejemplos:
cm attribute delete att:status
(Borra el atributo 'status'.)
cm att rm status att:integrated@reptest@server2:8084
(Borra los atributos 'status' e 'integrated'.)
== CMD_DESCRIPTION_ATTRIBUTE_UNSET ==
Desasigna un atributo a un objeto.
== CMD_USAGE_ATTRIBUTE_UNSET ==
Sintaxis:
cm attribute | att unset <att_spec> <object_spec>
att_spec Especificación del atributo. (Use 'cm help objectspec'
para más información sobre las especificaciones de
atributos.)
object_spec Especificación del objeto sobre el que desasignar el
atributo. Se pueden fijar atributos a ramas, changesets,
shelvesets, etiquetas, items y revisiones.
(Use 'cm help objectspec' para más información sobre
especificaciones.)
== CMD_HELP_ATTRIBUTE_UNSET ==
Notas:
Este comando elimina la asignación de un atributo que ha sido aplicado
previamente a un objeto. Este comando no borra el atributo en sí.
Ejemplo:
cm attribute unset att:status br:/main/SCM105
(Desasigna el atributo 'status' que estaba aplicado a la rama 'main/SCM105'.)
cm att unset att:integrated@reptest@localhost:8084 cs:25@reptest@localhost:8084
(Desasigna el atributo 'integrated' que estaba aplicado al changeset 25.
Tanto el atributo como el changeset se encuentran en el repositorio 'reptest'.)
== CMD_DESCRIPTION_ATTRIBUTE_RENAME ==
Renombra un atributo.
== CMD_USAGE_ATTRIBUTE_RENAME ==
Sintaxis:
cm attribute | att rename <att_spec> <new_name>
att_spec Atributo a renombrar. (Use 'cm help objectspec' para
más información sobre especificaciones de atributos.)
new_name Nuevo nombre para el atributo.
== CMD_HELP_ATTRIBUTE_RENAME ==
Notas:
Este comando renombra un atributo.
Ejemplos:
cm attribute rename att:status state
(Renombra el atributo 'status' a 'state')
== CMD_DESCRIPTION_ATTRIBUTE_EDIT ==
Edita el comentario de un atributo.
== CMD_USAGE_ATTRIBUTE_EDIT ==
Sintaxis:
cm attribute | att edit <att_spec> <new_comment>
att_spec Atributo al cual editar su comentario.
(Use 'cm help objectspec' para más información sobre
especificaciones de atributos.)
new_comment Nuevo comentario para el atributo. Este comentario puede ser
una lista de posibles valores que el usuario puede seleccionar
cuando asigne un atributo a un objeto. Consulte las Notas
para más información.
== CMD_HELP_ATTRIBUTE_EDIT ==
Notas:
Este comando cambia el comentario de un atributo.
Para especificar la lista de valores por defecto para un atributo, indique
un texto como este en el comentario del atributo:
'default: valor_uno, "valor dos", valor3, "Valor final"'.
Ejemplos:
cm attribute edit att:status "The status of a branch in the CI pipeline."
(Edita el comentario del atributo 'status'.)
cm attribute edit att:status "Status of a branch. default: open, resolved, reviewed"
(Edita el comentario del atributo 'status'. Y también especifica una lista
de valores. De este modo, cuando el usuario asigne el atribute 'status' a un
objeto, podrá seleccionar uno de los siguientes valores: 'open', 'resolved'
o 'reviewed'.)
== CMD_DESCRIPTION_REPLICATE ==
ATENCIÓN: Este comando se ha declarado obsoleto.
Ha sido reemplazado por 'pull' (equivalente a 'replicate') y por 'push'
(equivalente a 'replicate --push').
Replica datos desde un repositorio remoto.
== CMD_USAGE_REPLICATE ==
Uso:
cm replicate br_spec dst_rep_spec [--nodata] [translateOptions] [authOptions]
cm replicate hydrate br_spec [src_rep_spec] [authOptions]
cm replicate hydrate cs_spec [src_rep_spec] [authOptions]
cm replicate br_spec --package=packagename [--changeset=número]
cm replicate dst_rep_spec --import=packagename
br_spec: la rama para ser replicada/hidratada. Es una especificación
completa de rama con el siguiente formato:
br:/NOMBRE_RAMA[@rep:NOMBRE_REP[@repserver:NOMBRE_SERVIDOR:puerto]]
cs_spec: changeset para ser hidratado. Es una espec. de changeset:
cs:NUMERO_CHANGESET[@rep:NOMBRE_REP[@repserver:NOMBRE_SERVIDOR:puerto]]
src_rep_sec: repositorio origen de los datos. Es una especificación
completa de repositorio:
rep:NOMBRE_REPOSITORIO@repserver:NOMBRE_SERVIDOR:puerto
dst_rep_sec: repositorio destino de la replica. Es una especificación
completa de repositorio:
rep:NOMBRE_REPOSITORIO@repserver:NOMBRE_SERVIDOR:puerto
Opciones:
--package para crear un paquete de replicación.
--import para importar un paquete concreto.
--nodata para replicar los cambios de una rama sin replicar sus datos. Esta
opción no se puede usar para la réplica con paquetes ni con la opción
--push.
Opciones de traducción:
--trmode=[copy | name | table] para especificar cómo tratar los
nombres de usuario cuando se importen los datos en el
repositorio de destino:
* copy -> es el utilizado por defecto. Copia los SEIDs en el
repositorio de destino.
* name -> realiza una traducción por nombre entre el modo
de autentificación de origen y el de destino.
* table -> se usará una tabla de traducción en la que se
especifican los nombres de origen y cómo han de quedar
en el destino.
--trtable=[translationTable]
una tabla de traducción es un fichero que contiene entradas
en la forma nombre antiguo;nombre nuevo.
Opciones de autentificación:
Hay dos formas de especificar los datos de autentificación:
1) Especificando un fichero de autentificación.
--authfile=fichero, un fichero que contiene dos líneas: el modo de
autentificación en la primera línea y los datos de autentificación
(ver --authdata) o una cadena vacía en la segunda.
2) Especificando la autentificación mediante parámetros.
Para ello hay que especificar el modo de autentificación mediante el
modificador:
--authmode=[NameWorkingMode | NameIDWorkingMode |
LDAPWorkingMode | ADWorkingMode | UPWorkingMode]
Si está trabajando en UPWorkingMode o LDAPWorkingMode, puede
especificar los datos de autentificación de dos formas:
2.1) Para UPWorkingMode o LDAPWorkingMode:
--authdata=datos_de_autentificación
Ejemplos:
--authdata=ActiveDirectory:192.168.1.3:389:john.doe@factory.com:fPBea2rPsQaagEW3pKNveA==:dc=factory,dc=com (LDAPWorkingMode)
--authdata=john:fPBea2rPsQaagEW3pKNveA== (UPWorkingMode)
2.2) Solamente para UPWorkingMode:
--user=usuario
--password=contraseña
== CMD_HELP_REPLICATE ==
Notas:
El comando 'replicate' replica datos desde una rama hacia un
repositorio de destino. Todos los datos de la rama de origen, incluyendo
revisiones, ítems, changesets, etiquetas, revisiones de código, links
y seguridad serán replicados.
Su cliente Unity VCS debe estar configurado para trabajar con el
repositorio de destino.
La replicación también gestiona la 'reconciliación' de ramas que han
sido modificadas tanto en origen como en destino, mediante la creación
de 'ramas de entrega' (fetch branches) que podrán ser integradas
posteriormente para resolver los conflictos.
La replicación puede funcionar en tres modos diferentes:
1- Comunicación directa entre servidores: lo que significa que el servidor
de destino se comunicará con el de origen para sincronizar la rama
especificada.
2- Generación de paquete de exportación: el cliente se conectará
únicamente con el destino para generar un paquete de replicación con los
datos y los metadatos de la rama especificada. Se usará el modificador
--package. El usuario podrá especificar, opcionalmente, un changeset
inicial desde el cual generar la replicación.
3- Importar un paquete generado previamente, usando la opción --import.
En los modos 1 y 2 será necesaria la autentificación contra el servidor
de origen. El comando 'replicate' acepta parámetros para especificar los
diferentes modos de autentificación.
Ejemplos:
cm replicate br:/main@rep:default@repserver:LONDRES:8084 rep:myrep@repserver:MADRID:9090
cm replicate br:/main@rep:default@repserver:LONDRES:8084 rep:myrep@repserver:MADRID:9090 --trmode=name
cm replicate br:/main@rep:default@repserver:LONDRES:8084 rep:myrep@repserver:MADRID:9090 --trmode=table --trtable=tabla.txt
cm replicate br:/main@rep:default@repserver:LONDRES:8084 rep:myrep@repserver:MADRID:9090 --authmode=NameWorkingMode --user=john.doe
Significa que se autentificará contra el servidor 'MADRID' usando NameWorkingMode como usuario 'john.doe'
cm replicate br:/main/releaseBL060@rep:blackbird@repserver:barcelona:9090 --package=replicationpackage.data
Creará un paquete de replicación
cm replicate rep:mine@repserver:casa:9094 --import=replicationpackage.data
Importará el paquete creado con anterioridad
cm replicate br:/main/releaseBL060@rep:blackbird@repserver:barcelona:9090 --package=replicationpackage.data --changeset=1230
Generará un paquete de replicación de la rama br:/main/releaseBL060 desde el changeset 1230
cm replicate /main@project1@LONDRES:8084 projectx@localhost:8084 --nodata
Replicará la rama /main del servidor LONDRES a mi servidor sin replica los datos.
cm replicate hydrate /main@projectx@localhost:8084 project1@LONDRES:8084
Hidratará los datos de la rama /main de mi servidor, usando los datos del servidor LONDRES.
Nota adicional:
La tabla de traducción tiene entradas (una por línea) con el siguiente
formato:
nombre antiguo;nombre nuevo
== CMD_DESCRIPTION_PULL ==
Replica datos desde un repositorio remoto.
== CMD_USAGE_PULL ==
Uso:
cm pull src_br_spec dst_rep_spec
[--preview] [--nodata] [translateOptions]
[--user=usr_name [--password=pwd] | AuthOptions]
(Replicación directa entre servidores. Hace pull de una rama desde un
repositorio.)
cm pull dst_rep_spec --package=pack_file [AuthOptions]
(Replicación basada en paquetes. Importa el paquete en el servidor de
destino.)
cm pull hydrate dst_br_spec [src_rep_spec]
[--user=usr_name [--password=pwd] | AuthOptions]
(Introduce los datos restantes para todos los changesets de una rama
replicada previamente con la opción --nodata. Si no se especifica un
repositorio del que obtener los datos, Unity VCS intentará usar el
origen de replicación original de la rama.)
cm pull hydrate dst_cs_spec [src_rep_spec]
[--user=usr_name [--password=pwd] | AuthOptions]
(Introduce los datos restantes para un changeset replicado previamente
con la opción --nodata. Si no se especifica un repositorio del que obtener
los datos, Unity VCS intentará usar el origen de replicación original de
la rama.)
src_br_spec La rama a ser replicada desde un repositorio remoto.
dst_br_spec La rama a ser hidratada.
Especificación de ramas:
[br:][/]nombre_rama[@[rep:]nombre_rep[@[repserver:]nombre_servidor:puerto]]
dst_cs_spec El changeset a ser hidratado.
Especificación de changesets:
cs:numero_cset[@[rep:]nombre_rep[@[repserver:]nombre_servidor:puerto]]
dst_rep_spec El repositorio de destino.
Especificación de repositorio:
[rep:]nombre_rep[@[repserver:]nombre_servidor:puerto]
--package El fichero de donde se importa un paquete de replicación
creado anteriormente.
Es útil para mover datos entre servidores sin una
conexión de red directa.
Consule 'cm push' para crear paquetes de replicación.
Opciones:
--preview Proporciona información sobre qué cambios serán traídos
durante el pull, pero no se ejecuta ninguna acción más.
Esta opción es útil para comprobar qué datos serán
replicados antes de ejecutar el pull.
--user, --password Credenciales para utilizar en caso de que el modo de
autenticación de los servidores origen y destino
difieran, y no exista un profile para autenticarse
contra el remoto.
--nodata Replica los metadatos de una rama sin replicar los
datos. Esta opción no se puede utilizar al importar un
paquete de replicación.
Opciones de traducción (translateOptions):
--trmode={copy|name|table}
El servidor de origen y de destino pueden utilizar modos distintos de
autenticación. Este argumento especifica cómo se han de traducir los
nombres de usuario del origen al destino.
- copy El modo por defecto, indica que los nombres de usuario serán
simplemente copiados.
- name Los nombres de usuario serán emparejados entre origen y
destino por coincidencia.
- table Se utilizará una tabla de traducción (más información a
continuación).
--trtable={translation_table_file}
Si el modo de traducción es 'table', entonces una tabla de traducción
es un fichero que contiene líneas de la forma nombreantiguo;nombrenuevo.
Cuando la rama se escribe en el repositorio de destino, los objetos
creados por un usuario identificado por "nombreantiguo" en el
repositorio de origen serán asignados al usuario identificado por
"nombrenuevo" en el repositorio de destino.
Opciones de autentificación (AuthOptions):
Hay dos formas de especificar los datos de autentificación:
1) Especificando la autentificación mediante parámetros:
--authmode={NameWorkingMode|LDAPWorkingMode|ADWorkingMode|UPWorkingMode}
(LDAPWorkingMode) --authdata=::0:dave:fPBea2rPsQaagEW3pKNveA
(UPWorkingMode) --authdata=dave:fPBea2rPsQaagEW3pKNveA==
El parámetro '--authdata' es el contenido del campo <SecurityConfig>
en los ficheros client.conf o profiles.conf. El fichero profiles.conf
puede ser generado desde la GUI de Unity VCS (Windows).
Si se utiliza UPWorkingMode, se puede especificar simplemente:
--authmode=UPWorkingMode --user=user --password=pwd
2.1) Para UPWorkingMode o LDAPWorkingMode:
--authdata=datos_de_autentificación
Ejemplos:
--authdata=ActiveDirectory:192.168.1.3:389:john.doe@factory.com:fPBea2rPsQaagEW3pKNveA==:dc=factory,dc=com (LDAPWorkingMode)
--authdata=john:fPBea2rPsQaagEW3pKNveA== (UPWorkingMode)
2.2) Solamente para UPWorkingMode:
--user=usuario
--password=contraseña
1) Especificando un fichero de autentificación. Se pueden tener varios
ficheros de autenticación, uno por servidor al que se conecte,
conteniendo las credenciales específicas para dicho servidor.
--authfile=fichero
Contiene 2 líneas:
Línea 1) modo de autenticación, igual que para --authmode.
Línea 2) datos de autenticación, igual que para --authdata.
== CMD_HELP_PULL ==
Notas:
El comando pull replica ramas (junto a sus changesets) entre un repositorio
origen y otro destino. Los repositorios pueden encontrarse en diferentes
servidores.
Hay dos operaciones de replicación: push y pull.
Una operación de 'pull' significa que la operación de replicación hará que
el servidor destino obtenga datos desde el origen. El cliente se conectará
con el servidor destino, y, desde ese host, establecerá una conexión con el
repositorio origen para recuperar los datos pedidos. Durante el pull, será
el servidor destino el que se conecte al origen.
Aunque en un escenario distribuido típico el desarrollador haga pùsh de los
cambios en su servidor local al servidor central, también puede ser
necesario hacer pull de los últimos cambios en el servidor central al
servidor local.
La replicación puede resolver situaciones en las que se hagan cambios
concurrentes en la misma rama en dos repositorios replicados:
- Push: si se intenta hacer push de datos locales a un repositorio que tenga
datos más nuevos que los que se están enviando, el sistema pedirá hacer
pull de los últimos cambios, resolver el merge resultante y, finalmente,
tratar de repetir el push.
- Pull: cuando se hace pull de changesets de una rama remota, estos estarán
correctamente enlazados a sus changesets padre. Si el changeset que se ha
traído no es un hijo del último changeset de la rama, entonces aparecerá
un escenario de múltiples cabezas. La rama tendrá más de una 'cabeza', o
dicho de otro modo, más de un changeset final de rama. Será necesario
hacer merge de ambas cabezas antes de que se pueda hacer push de nuevo.
El pull puede funcionar de dos modos:
1) Comunicación directa entre servidores: lo que significa que el servidor
de destino se comunicará con el de origen para sincronizar la rama
especificada.
2) Importación de un paquete de replicación generado con push, con la opción
--package.
El modo 1) requere que el usuario que ejecute el comando esté autenticado
contra el servidor remoto, bien o usando la autenticación por defecto en
el fichero client.conf, mediante un profile creado previamente, o
especificando los argumentos --authmode y --authdata (o --user y --password
en caso de que el modo de autenticación sea UPWorkingMode).
El modo 2) require usar un paquete de replicación generado previamente con
el comando push.
Recuerde que la replicación pull funciona de una manera indirecta. Cuando
se ejecuta, el comando pide al repositorio destino que se conecte con el
origen para obtener la rama especificada.
Sin embargo, esto se puede hacer de manera directa utilizando el comando
push, que hará que sea el repositorio origen quien envíe los datos
directamente al destino.
Ejemplos:
cm pull br:/main@project1@remoteserver:8084 projectx@myserver:8084
(Hace pull de la rama principal de remoteserver a myserver. En este caso,
ambos servidores están configurados con el mismo modo de autenticación.)
cm pull br:/main@project1@remoteserver:8084 projectx@myserver:8084 --authmode=LDAPWorkingMode --authdata=::0:dave:fPBea2rPsQaagEW3pKNveA
(Hace pull de la misma rama que antes, pero ahora el servidor remoto está
configurado para autenticar usuarios contra un Active Directory. Por ejemplo,
se puede conectar de una máquina Linux a un servidor Windows configurado
para usar Active Directory. Para ello, se especificará el usuario y la
contraseña cifrada.)
cm pull br:/main@project1@remoteserver:8084 projectx@myserver:8084 --authmode=UPWorkingMode --user=dave --password=mysecret
(Hace pull de la misma rama, pero ahora ambos usuarios están autenticados
en el servidor remoto mediante el sistema de gestión de usuarios integrado
en Unity VCS.)
cm pull br:/main@project1@remoteserver:8084 projectx@myserver:8084 --nodata
(Hace pull de la rama principal de remoteserver a myserver pero sin datos.)
cm pull hydrate br:/main@projectx@myserver:8084 projectx@remoteserver:8084
(Introduce los datos de todos los changesets de la rama principal obteniendo
dichos datos del repositorio en remoteserver.)
cm pull hydrate cs:122169@projectx@myserver:8084 projectx@remoteserver:8084
(Introduce los datos del changeset 122169 en myserver obteniendo dichos
datos del repositorio en remoteserver.)
Nota adicional:
La tabla de traducción tiene entradas (una por línea) de la forma:
nombre antiguo;nombre nuevo
== CMD_DESCRIPTION_PUSH ==
Replica datos hacia un repositorio remoto.
== CMD_USAGE_PUSH ==
Uso:
cm push src_br_spec dst_rep_spec
[--preview] [translateOptions]
[--user=usr_name [--password=pwd] | AuthOptions]
(Replicación directa entre servidores. Hace push de una rama hacia un
repositorio.)
cm push src_br_spec --package=pack_file [AuthOptions]
(Replicación basada en paquetes. Crea un paquete de replicación con la
rama especificada.)
src_br_spec La rama a ser replicada desde un repositorio remoto.
Especificación de ramas:
[br:][/]nombre_rama[@[rep:]nombre_rep[@[repserver:]nombre_servidor:puerto]]
dst_cs_spec El changeset a ser hidratado.
Especificación de changesets:
cs:numero_cset[@[rep:]nombre_rep[@[repserver:]nombre_servidor:puerto]]
dst_rep_spec El repositorio de destino.
Especificación de repositorio:
[rep:]nombre_rep[@[repserver:]nombre_servidor:puerto]
--package Exporta un paquete de replicación al fichero especificado.
Es útil para mover datos entre servidores sin una
conexión de red directa.
Opciones:
--preview Proporciona información sobre qué cambios serán enviados
durante el push, pero no se ejecuta ninguna acción más.
Esta opción es útil para comprobar qué datos serán
replicados antes de ejecutar el push.
--user, --password Credenciales para utilizar en caso de que el modo de
autenticación de los servidores origen y destino
difieran, y no exista un profile para autenticarse
contra el remoto.
--nodata Replica los metadatos de una rama sin replicar los
datos. Esta opción no se puede utilizar al exportar un
paquete de replicación.
Opciones de traducción (translateOptions):
--trmode={copy|name|table}
El servidor de origen y de destino pueden utilizar modos distintos de
autenticación. Este argumento especifica cómo se han de traducir los
nombres de usuario del origen al destino.
- copy El modo por defecto, indica que los nombres de usuario serán
simplemente copiados.
- name Los nombres de usuario serán emparejados entre origen y
destino por coincidencia.
- table Se utilizará una tabla de traducción (más información a
continuación).
--trtable={translation_table_file}
Si el modo de traducción es 'table', entonces una tabla de traducción
es un fichero que contiene líneas de la forma nombreantiguo;nombrenuevo.
Cuando la rama se escribe en el repositorio de destino, los objetos
creados por un usuario identificado por "nombreantiguo" en el
repositorio de origen serán asignados al usuario identificado por
"nombrenuevo" en el repositorio de destino.
Opciones de autentificación (AuthOptions):
Hay dos formas de especificar los datos de autentificación:
1) Especificando la autentificación mediante parámetros:
--authmode={NameWorkingMode|LDAPWorkingMode|ADWorkingMode|UPWorkingMode}
(LDAPWorkingMode) --authdata=::0:dave:fPBea2rPsQaagEW3pKNveA
(UPWorkingMode) --authdata=dave:fPBea2rPsQaagEW3pKNveA==
El parámetro '--authdata' es el contenido del campo <SecurityConfig>
en los ficheros client.conf o profiles.conf. El fichero profiles.conf
puede ser generado desde la GUI de Unity VCS (Windows).
Si se utiliza UPWorkingMode, se puede especificar simplemente:
--authmode=UPWorkingMode --user=user --password=pwd
2.1) Para UPWorkingMode o LDAPWorkingMode:
--authdata=datos_de_autentificación
Ejemplos:
--authdata=ActiveDirectory:192.168.1.3:389:john.doe@factory.com:fPBea2rPsQaagEW3pKNveA==:dc=factory,dc=com (LDAPWorkingMode)
--authdata=john:fPBea2rPsQaagEW3pKNveA== (UPWorkingMode)
2.2) Solamente para UPWorkingMode:
--user=usuario
--password=contraseña
1) Especificando un fichero de autentificación. Se pueden tener varios
ficheros de autenticación, uno por servidor al que se conecte,
conteniendo las credenciales específicas para dicho servidor.
--authfile=fichero
Contiene 2 líneas:
Línea 1) modo de autenticación, igual que para --authmode.
Línea 2) datos de autenticación, igual que para --authdata.
== CMD_HELP_PUSH ==
Notas:
El comando pull replica ramas (junto a sus changesets) entre un repositorio
origen y otro destino. Los repositorios pueden encontrarse en diferentes
servidores.
Hay dos operaciones de replicación: push y pull.
Una operación de 'push' significa que la operación de replicación enviará
datos desde el repositorio origen al repositorio destino. En este caso, el
cliente se conectará al repositorio origen, recuperando los datos para ser
replicados, y entonces los enviará al repositorio destino. Mientras que el
origen necesita tener conectividad con el destino, el destino no se
conectará con el origen.
En un escenario distribuido típico el desarrollador hace push de los
cambios en su servidor local al servidor central. También puede ser
necesario hacer pull de los últimos cambios en el servidor central al
servidor local.
La replicación puede resolver situaciones en las que se hagan cambios
concurrentes en la misma rama en dos repositorios replicados:
- Push: si se intenta hacer push de datos locales a un repositorio que tenga
datos más nuevos que los que se están enviando, el sistema pedirá hacer
pull de los últimos cambios, resolver el merge resultante y, finalmente,
tratar de repetir el push.
- Pull: cuando se hace pull de changesets de una rama remota, estos estarán
correctamente enlazados a sus changesets padre. Si el changeset que se ha
traído no es un hijo del último changeset de la rama, entonces aparecerá
un escenario de múltiples cabezas. La rama tendrá más de una 'cabeza', o
dicho de otro modo, más de un changeset final de rama. Será necesario
hacer merge de ambas cabezas antes de que se pueda hacer push de nuevo.
El push puede funcionar de dos modos:
1) Comunicación directa entre servidores: lo que significa que el servidor
de origen se comunicará con el de destino para sincronizar la rama
especificada.
2) Exportación de un paquete de replicación: El cliente únicamente se
conectará con el origen y generará un paquete de replicación que contenga
tanto los datos como los metadatos para la rama especificada. Para ello
se utilizará el argumento --package.
Ambos modos requeren que el usuario ejecutando el comando esté autenticado
contra el servidor, bien o usando la autenticación por defecto en el fichero
client.conf, mediante un profile creado previamente, o especificando los
argumentos --authmode y --authdata (o --user y --password en caso de que
el modo de autenticación sea UPWorkingMode).
La replicación push funciona de una manera directa. Cuando se ejecuta, el
comando replicará la rama seleccionada del origen al destino, en vez de
pedir al repositorio destino que se conecte al repositorio origen para
obtener la rama especificada (como hace pull).
Ejemplos:
cm push br:/main@project1@myserver:8084 projectx@remoteserver:8084
(Hace push de la rama main desde myserver a remoteserver. En este caso,
ambos servidores están configurados con el mismo modo de autenticación.)
cm push br:/main@project1@remoteserver:8084 projectx@myserver:8084 --authmode=LDAPWorkingMode --authdata=::0:dave:fPBea2rPsQaagEW3pKNveA
(Hace push de la misma rama que antes, pero ahora el servidor remoto está
configurado para autenticar usuarios contra un Active Directory. Por ejemplo,
se puede conectar de una máquina Linux a un servidor Windows configurado
para usar Active Directory. Para ello, se especificará el usuario y la
contraseña cifrada.)
cm push br:/main@project1@remoteserver:8084 projectx@myserver:8084 --authmode=UPWorkingMode --user=dave --password=mysecret
(Hace push de la misma rama, pero ahora ambos usuarios están autenticados
en el servidor remoto mediante el sistema de gestión de usuarios integrado
en Unity VCS.)
Nota adicional:
La tabla de traducción tiene entradas (una por línea) de la forma:
nombre antiguo;nombre nuevo
== CMD_DESCRIPTION_CLONE ==
Clona un repositorio remoto.
== CMD_USAGE_CLONE ==
Sintaxis:
cm clone <src_rep_spec> [<dst_rep_spec> | <dst_repserver_spec>]
[--user=<usr_name> [--password=<pwd>] | AuthOptions]
[TranslateOptions]
(Clonado directo repositorio-a-repositorio.)
cm clone <src_rep_spec> --package=<pack_file>
[--user=<usr_name> [--password=<pwd>] | AuthOptions]
(Clonado a un paquete intermedio que se podrá importar posteriormente al
repositorio destino mediante un pull.)
src_rep_spec Repositorio origen de la operación de clonado.
(Use 'cm help objectspec' para más información sobre
las especificaciones de repositorio.)
dst_rep_spec Repositorio destino de la operación de clonado. Si
existe, debe estar vacío. Si no existe, se creará.
Si no se especifica, el comando utilizará el servidor
de repositorios por defecto.
(Use 'cm help objectspec' para más información sobre
las especificaciones de repositorios.
dst_repserver_spec Servidor de repositorios destino de la operación de
clonado. Si existe un repositorio con el mismo nombre
que <src_rep_spec>, debe estar vacío. Si no existe, se
creará.
Si no se especifica, el comando utilizará el servidor
de repositorios por defecto.
(Use 'cm help objectspec' para más información sobre
las especificaciones de servidor de repositorio.)
Options:
--user, --password Credenciales para utilizar en caso de que el modo de
autenticación de los servidores origen y destino
difieran, y no exista un perfil para autentificarse
en el destino.
--package Exporta el repositorio indicado a un fichero de paquete
en lugar de a otro repositorio.
Es útil para mover datos entre servidores sin una
conexión de red directa.
El paquete resultante se importará mediante el comando
pull.
TranslateOptions Consulte las opciones de traducción para más información.
AuthOptions Consulte las opciones de autentificación para más
información.
Opciones de traducción (TranslateOptions):
--trmode=(copy|name|table --trtable=<translation_table_file>)
Los repositorios origen y destino pueden utilizar distintos modos de
autenticación. La opción --trmode especifica cómo se han de traducir los
nombres de usuario del origen al destino. La opción --trmode puede tener
uno de los siguientes valores:
copy (Defecto.) Indica que los identificadores de los usuario
serán simplemente copiados.
name Los identificadores de usuario serán emparejados entre origen
y destino por nombre.
table Se utilizará la tabla de traducción indicada en la opción
--trtable (más información a continuación).
--trtable=<translation_table_file>
Si el modo de traducción es 'table', entonces una tabla de traducción
es un fichero que contiene líneas de la forma <nombreantiguo;nombrenuevo>
(uno por línea). Cuando la rama se escribe en el repositorio de destino,
los objetos creados por un usuario identificado por "nombreantiguo" en
el repositorio de origen serán asignados al usuario identificado por
"nombrenuevo" en el repositorio de destino.
Opciones de autentificación (AuthOptions):
Hay dos formas de especificar los datos de autentificación:
1) Usando parámetros de autentificación: --authmode=<mode> --authdata=<data>
--authmode=(NameWorkingMode|LDAPWorkingMode|ADWorkingMode|UPWorkingMode)
Por ejemplo:
(LDAPWorkingMode) --authdata=::0:dave:fPBea2rPsQaagEW3pKNveA
(UPWorkingMode) --authdata=dave:fPBea2rPsQaagEW3pKNveA==
La línea '--authdata' es el contenido de la entrada <SecurityConfig>
en los ficheros client.conf o profiles.conf. El fichero profiles.conf
puede ser generado desde la GUI de Unity VCS en la pestaña Perfiles
de Conexión en la ventana de Preferencias.
Si se utiliza UPWorkingMode, se puede especificar:
--authmode=UPWorkingMode --user=<user> --password=<pwd>
2) Especificando un fichero de autentificación. Pueden existir varios
ficheros de autentificación, uno por cada servidor al que se conecte,
conteniendo las credenciales específicas para dicho servidor.
--authfile=<authentication_file>
Contiene 2 líneas:
Línea 1) modo de autenticación, igual que para --authmode.
Línea 2) datos de autenticación, igual que para --authdata.
== CMD_HELP_CLONE ==
Notas:
El comando clone puede replicar ramas (junto a sus changesets, etiquetas,
atributos, reviews, etc.) desde un repositorio origen a un repositorio
destino. Los repositorios pueden encontrarse en diferentes servidores.
El repositorio destino puede existir de antemano, pero si contiene datos
previos, la operación de clonado fallará.
La operación de clonado NO clona submódulos ni repositorios que se encuentren
bajo un Xlink.
Ejemplos:
cm clone awesomeProject@tardis@cloud
(Clona el repositorio 'awesomeProject' de la organización Cloud tardis@cloud
a un repositorio local del mismo nombre.)
cm clone repo@server.home:9095 repo-local
(Clona 'repo' desde 'server.home:9095' en 'repo-local' localizado en el
servidor de repositorios por defecto del usuario.)
cm clone project@192.168.111.130:8084 repserver:192.168.111.200:9095
(Clona 'project' desde '192.168.111.130:8084' a
'project@192.168.111.200:9095'.)
cm clone project@ldapserver:8084 --authfile=credentials.txt --trmode=table --trtable=table.txt
(Clona el repositorio 'project' desde 'ldapserver:8084' utilizando un fichero
de autentificación contra el servidor remoto, y traduciendo los usuarios
siguiendo la tabla de traducción especificada.)
cm clone project@server.home:9095 --package=project.plasticpkg
cm mkrep project@mordor.home:8084
cm pull --package=project.plasticpkg project@mordor.home:8084
(Clona 'project' desde 'server.home:9095' al paquete 'project.plasticpkg'
que se importa posteriormente en el repositorio 'project' de
'mordor.home:8084' mediante una operación de pull.)
== CMD_DESCRIPTION_REVERT ==
Carga en el espacio de trabajo la revisión especificada y desprotege el elemento.
== CMD_USAGE_REVERT ==
Sintaxis:
cm revert cset_spec
cset_spec Especificación del changeset que contiene la revisión del ítem
cuyo contenido se desea cargar en el espacio de trabajo.
Usa 'cm help objectspec' para obtener más información sobre la
especificación de changesets.
== CMD_HELP_REVERT ==
Notas:
El ítem ha de esta estar protegido.
Ejemplos:
cm revert dir#cs:0
cm revert C:\mywks\dir\file1.txt#cs:23456
== CMD_DESCRIPTION_REVISION_HISTORY ==
Muestra la historia de un ítem.
== CMD_USAGE_REVISION_HISTORY ==
Sintaxis:
cm history | hist <item_path>[ ...] [--long | --format=<str_format>]
[--symlink] [--xml[=<output_file>]] [--encoding=<name>]
[--moveddeleted]
item_path Ruta de los ítems. Use un espacio en blanco para separar
rutas de ítems. Use comillas dobles (" ") para especificar
rutas que contengan espacios.
Las rutas pueden ser rutas de revisiones en servidor.
(Use 'cm help objectspec' para más información sobre las
especificaciones.)
Opciones:
--long Muestra información adicional.
--format Muestra el mensaje de salida en el formato indicado.
Consulte las Notas para más información. No puede
combinarse con --xml.
--symlink Aplica la operación al symlink pero no al destino (target).
--xml Imprime el resultado en formato XML a la salida estándar.
También es posible especificar un fichero de salida. No
puede combinarse con --format.
--encoding Usado con la opción --xml, especifica el encoding que se
usará en la salida XML, por ejemplo, utf-8.
Consulte la documentación de MSDN en
http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
para obtener la tabla de codificaciones soportadas y su
formato (al final de la página en la columna "Name").
--moveddeleted Incluye las operaciones de movidos y borrado en la historia.
--limit Muestra las N revisiones más recientes para los elementos
especificados, ordenados por fecha y por changeset id. Si
se proporciona un número negativo, el comando devolverá una
lista vacía. Si se proporciona un número mayor al número de
revisiones del elemento solicitado, devolverá las existentes.
== CMD_HELP_REVISION_HISTORY ==
Notas:
Este comando muestra una lista de revisiones para el ítem indicado, e
información de etiqueta, rama y comentario de cada revisión.
Parámetros de formato de salida (opción --format):
Este comando acepta una cadena de formato para mostrar la salida.
Los parámetros de salida de este comando son los siguientes:
{0} | {date} Fecha.
{1} | {changesetid} Número de changeset.
{2} | {branch} Rama.
{4} | {comment} Comentario.
{5} | {owner} Propietario de la revisión.
{6} | {id} Id de revisión.
{7} | {repository} Repositorio.
{8} | {server} Servidor.
{9} | {repspec} Especificación de repositorio.
{10}| {datastatus} Disponibilidad del dato de la revision.
{11}| {path} Ruta o spec pasada como <item_path>.
{12}| {itemid} Id del elemento.
{13}| {size} Tamaño.
{14}| {hash} Código hash.
{tab} Inserta un tabulador.
{newline} Inserta una nueva línea.
Ejemplos
cm history file1.txt "file2.txt"
cm hist c:\workspace --long
(Muestra toda la información.)
cm history link --symlink
(Aplica la operación al fichero de symlink y no al destino.)
cm history serverpath:/src/foo/bar.c#br:/main/task001@myserver
(Muestra la historia de una revisión de una ruta de servidor en la rama
especificada.)
cm history bar.c, foo.c --long --limit=2
(Muestra las últimas 2 revisiones para los elemetos bar.c and foo.c.)
== CMD_DESCRIPTION_REVISION_TREE ==
Muestra un árbol de revisiones para el ítem dado.
== CMD_USAGE_REVISION_TREE ==
Sintaxis:
cm tree ruta
ruta: Ruta del ítem sobre el que se mostrará el árbol.
Opciones:
--symlink: Efectúa la operación sobre el fichero de link y no sobre el ítem
al que apunta.
== CMD_HELP_REVISION_TREE ==
Ejemplos:
cm tree fichero1.txt
cm tree c:\workspace
cm tree link --symlink
(Efectúa la operación sobre el fichero de symlink
y no sobre el que apunta.)
== CMD_DESCRIPTION_RM ==
Use este comando para borrar ficheros y directorios.
== CMD_USAGE_RM ==
Sintaxis:
cm remove | em comando [opciones]
Comandos:
controlled (opcional)
private
Para obtener más información sobre cada comando:
cm remove comando --usage
cm remove comando --help
== CMD_HELP_RM ==
Ejemplos:
cm remove \fichero_controlado.txt
cm remove private \fichero_privado.txt
== CMD_DESCRIPTION_RM_CONTROLLED ==
Borra un ítem del control de versiones.
== CMD_USAGE_RM_CONTROLLED ==
Sintaxis:
cm remove [opciones] rutas
rutas: Rutas de los ítem a borrar.
Opciones:
-R: Descender recursivamente dentro de directorios.
== CMD_HELP_RM_CONTROLLED ==
Notas:
El ítem nunca borra del disco.
Requisitos para borrar:
El ítem ha de estar controlado en Unity VCS.
El directorio padre debe estar desprotegido.
El elemento no debe estar desprotegido.
Si el ítem es un directorio, no debe tener desprotecciones pendientes.
Ejemplos:
cm remove src (borra el directorio 'src')
cm remove c:\workspace\fichero.txt
== CMD_DESCRIPTION_RM_PRIVATE ==
Borra ficheros y directorios privados.
Advertencia: este comando elimina permanentemente ficheros y directorios, y no
son recuperables. Es recomendable utilizar antes la opción '--dry-run' para
comprobar qué ficheros y directorios serán afectados por el comando.
== CMD_USAGE_RM_PRIVATE ==
Sintaxis:
cm remove | rm private <ruta>+ [-r] [--verbose] [--dry-run]
ruta Ruta del fichero o directorio a borrar.
Se pueden usar comillas (") para especificar rutas que
contengan espacios.
Opciones:
--r Elimina ficheros privados recursivamente dentro de
directorios controlados.
--ignored También se elimina ficheros y directorios ignorados y
cloaked.
--verbose Muestra todos las rutas afectadas.
--dry-run Ejecuta el comando sin hacer cambios en disco.
== CMD_HELP_RM_PRIVATE ==
Notas:
Si la ruta especificada corresponde a un fichero o directorio privados, este
será eliminado de disco.
Si la ruta corresponde a un fichero bajo control de versiones, el comando
fallará.
Si la ruta pertenece a un directorio bajo control de versiones, el comando
fallará salvo que se especifique la opción '-r', en cuyo caso se borrarán
todos los ficheros y directorios privados dentro del directorio controlado
especificado.
Ejemplos:
cm remove private private_directory
(Eliminina el directorio 'private_directory'.)
cm remove private c:\workspace\controlled_directory
(Falla, pues el directorio 'controlled_directory' no es privado.)
cm remove private -r c:\workspace\controlled_directory
(Elimina todos los ficheros y directorios privados dentro de
'controlled_directory'.)
cm rm private --dry-run --verbose c:\workspace\controlled_directory -r
(Muestra todas las rutas afectadas por la operación de borrado de elementos
privados dentro de 'controlled_directory' sin borrar nada.)
cm rm private --verbose c:\workspace\controlled_directory -r
(Muestra todas las rutas afectadas por la operación de borrado de elementos
privados dentro de 'controlled_directory', ejecutando el borrado.)
== CMD_DESCRIPTION_TRIGGER_DELETE ==
Borra un trigger.
== CMD_USAGE_TRIGGER_DELETE ==
Sintaxis:
cm trigger | tr delete | rm <subtype-type> <position_number>
[--server=<repserverspec>]
subtype-type Ejecución y operación del trigger.
(Use 'cm showtriggertypes' para ver la lista de tipos de
triggers.)
position_number Posición asignada al trigger cuando se creó.
Opciones:
--server Borra el trigger del servidor especificado.
Si no se especifica ningún servidor, el comando se
ejecuta en el servidor configurado en el cliente.
== CMD_HELP_TRIGGER_DELETE ==
Ejemplos:
cm trigger delete after-setselector 4
cm tr rm after-setselector 4
== CMD_DESCRIPTION_ATTRIBUTE_SET ==
Asigna un atributo al objeto indicado.
== CMD_USAGE_ATTRIBUTE_SET ==
Sintaxis:
cm attribute | att set <att_spec> <object_spec> <att_value>
att_spec Especificación del atributo. (Use 'cm help objectspec'
para más información sobre especificaciones de atributos.)
object_spec Especificación del objeto al que asignar el atributo.
Objetos válidos para este comando: rama, changeset,
shelveset, etiqueta, item y revisión.
(Use 'cm help objectspec' para más información sobre
especificaciones.)
att_value Valor del atributo que se asignará al objeto.
== CMD_HELP_ATTRIBUTE_SET ==
Notas:
Un atributo se asigna a un objeto para añadirle más información.
Se pueden asignar atributos a los siguientes objetos: ramas, changesets,
shelvesets, etiquetas, items y revisiones.
Ejemplo:
cm attribute set att:status br:/main/SCM105 open
(Aplica el atributo 'status' a la rama 'SCM105' asignándola el valor 'open'.)
cm att set att:integrated@reptest@server2:8084 lb:LB008@reptest@server2:8084 yes
(Aplica el atributo 'integrated' a la etiqueta 'LB008' del repositorio 'reptest
asignándola el valor 'yes'.)
== CMD_DESCRIPTION_SETOWNER ==
Establece el propietario de un objeto.
== CMD_USAGE_SETOWNER ==
Sintaxis:
cm setowner | sto --user=usuario | --group=grupo spec_objeto
--user Nombre de usuario. Nuevo propietario del objeto.
--group Nombre de grupo. Nuevo propietario del objeto.
spec_objeto Especificación del objeto sobre el que asignar el nuevo
propietario.
Se puede asignar nuevo usuario a los siguientes objetos:
repserver, repositorio, rama, changeset, etiqueta, item,
revisión y atributo.
Usa 'cm help objectspec' para obtener más información
sobre la especificación de objetos.
== CMD_HELP_SETOWNER ==
Notas:
Es posible modificar el propietario de un objeto mediante el comando
setowner. El propietario de un objeto puede ser un usuario o un grupo.
Para especificar un usuario se utiliza la opción –-user=xxx y para
especificar un grupo se utiliza la opción -–group=xxx. El objeto que se
quiere modificar se especifica mediante una especificación de objeto.
Se puede modificar el propietario de los siguientes objetos:
servidor de repositorios, repositorio, rama, changeset, etiqueta, item,
revisión y atributo.
Ejemplos:
cm setowner --user=danipen repserver:localhost:8084
(establece a 'danipen' como propietario del servidor de repositorios)
cm sto --group=development rep:principal@PlasticServer:8084
(establece al grupo 'development' como el propietario del repositorio 'principal')
== CMD_DESCRIPTION_SETSELECTOR ==
Establece un selector para un espacio de trabajo.
== CMD_USAGE_SETSELECTOR ==
Sintaxis:
cm setselector [opciones] [wk_ruta | wk_spec] [--noinput]
wk_ruta Ruta del espacio de trabajo sobre el que establecer el
selector.
wk_spec Especificación del espacio de trabajo sobre el que
establecer el selector.
Usa 'cm help objectspec' para obtener más información
sobre especificaciones de espacios de trabajo.
Opciones:
--file Fichero del que cargar un selector.
--ignorechanges Ignora el mensaje de aviso de cambios pendientes que se
muestra si existen cambios pendientes cuando se
actualiza el espacio de trabajo.
--forcedetailedprogress Fuerza mostrar progreso detallado incluso cuando se
redirige la salida estándar.
--noinput Ignora las preguntas interactivas para continuar la
operación con cambios pendientes o haciendolos shelve.
== CMD_HELP_SETSELECTOR ==
Notas:
Este comando establece un selector para un espacio de trabajo determinado.
Un workspace necesita información acerca de dónde obtener las revisiones
con las que trabajará el usuario. Para especificar esa información se
utilizan los selectores.
Mediante un selector se puede indicar, por ejemplo, que se carguen las
revisiones desde una rama determinada o desde la rama ‘main’, desde una
etiqueta, y especificar la rama donde se alojarán las desprotecciones.
Si no se especifica ningún fichero del que cargar el selector se abrirá
un editor de texto.
Indicar una ruta o una especificación de workspace es opcional. Si no se
especifica ninguno el selector se fijará para el espacio de trabajo en
el que se encuentra el usuario.
Un selector de ejemplo:
repository "default" // indica el repositorio con el que se trabaja
path "/" // se aplica al path raíz
branch "/main" // se obtendrán las últimas revisiones de br:/main
checkout "/main" // los checkouts se ubicarán en la rama br:/main
Ejemplos:
cm setselector
cm setselector --file=c:\selectores\miRama.xml
cm setselector --file=c:\selectores\rama5.xml MiWorkspace
cm setselector wk:workspace_projA@BEARDTONGUE
== CMD_DESCRIPTION_SHELVE ==
El comando shelve almacena el contenido de las revisiones en checkout.
== CMD_USAGE_SHELVE ==
Este comando está obsoleto. Se ha reemplazado por 'cm shelveset'.
Sintaxis:
cm shelve [opciones] [rutas]
rutas: rutas de los items a guardar.
Opciones:
--apply=shelve_spec : Restaura los contenidos almancenados en el
repositorio, identificados por "shelve_spec" en el espacio de trabajo
local.
--delete=shelve_spec: Elimina los contenidos almancenados en el repositorio
identificados por "shelve_spec"
--all (-a): Los ítems cambiados, movidos y borrados localmente, en las
rutas dadas, también serán guardados.
--dependencies: Incluir las dependencias de los cambios locales entre los
ítems a guardar.
-c=comentarios: Añade un comentario al shelve creado en la operación.
--commentsfile=comment.txt: Carga el comentario del fichero especificado.
--summaryformat: El comando imprime sólamente la especificación del
objeto creado en el repositorio principal, omitiendo los objetos
que pudieran crearse en repositorios 'xlinked'. También se omite
cualquier otro mensaje que el comando pudiera imprimir.
Opción diseñada para implementar automatizaciones.
--mount: El punto de montaje del respositorio especificado.
--encoding=codificación: Especifica la codificación de los ficheros de
origen (por ejemplo, UTF-8 o Unicode)
--comparisonmethod=tipo: cualquiera de las siguientes opciones:
ignoreeol: Ignora diferencias de final de línea.
ignorewhitespaces: Ignora diferencias de espacios en blanco.
ignoreeolandwhitespaces: Ignora diferencias de final de línea y espacios en
blanco.
recognizeall: Detecta diferencias de final de línea y espacios en
blanco.
== CMD_HELP_SHELVE ==
Notas:
- Si no se especifican [opciones] ni [rutas], la operación involucrará a
todos los cambios pendientes en el espacio de trabajo.
- La operación de shelve se aplica siempre recursivamente desde la
ruta indicada.
- Requisitos para hacer shelve de un ítem:
* El ítem debe estar controlado por Unity VCS.
* El ítem ha de estar desprotegido.
Ejemplos:
cm shelve
cm shelve fichero1.txt fichero2.txt
Comentarios:
Para especificar comentarios use el switch "-c" o "-m" del siguiente modo:
cm shelve -c="my comment"
cm shelve -m "my comment"
Configure la variable de entorno PLASTICEDITOR para especificar un editor
para escribir el comentario. Si la variable de entorno PLASTICEDITOR está
configurada pero no se indica ningún comentario, el editor se abrirá para
que pueda escribir el comentario.
Ejemplo: Aplicar un shelve almacenado en el repositorio:
cm shelve --apply=sh:3
Ejemplo: Eliminar un shelve almacenado en el repositorio
cm shelve --delete=sh:3
Ejemplo: Shelve 'changelist'
cm status --short --changelist=pending_to_review | cm shelve -
(El comando listará los paths en el changelist llamado 'pending_to_review'
y dicha lista será redirigida a la entrada del comando 'shelve').
== CMD_DESCRIPTION_SHELVESET ==
Use este comando para administrar shelvesets.
== CMD_USAGE_SHELVESET ==
Sintaxis:
cm shelveset comando [opciones]
Comandos:
create | mk
delete | rm
apply
Para obtener más información sobre cada comando:
cm shelveset command --usage
cm shelveset command --help
== CMD_HELP_ATTRIBUTE ==
Ejemplos:
cm shelveset create -c="my comment"
cm shelveset delete sh:3
cm shelve apply sh:3
== CMD_DESCRIPTION_SHELVESET_CREATE ==
El comando shelve almacena los cambios pendientes.
== CMD_USAGE_SHELVESET_CREATE ==
Sintaxis:
cm shelveset create [opciones] [rutas]
rutas: rutas de los items a guardar.
Opciones:
--all (-a): Los ítems cambiados, movidos y borrados localmente, en las
rutas dadas, también serán guardados.
--dependencies: Incluir las dependencias de los cambios locales entre los
ítems a guardar.
-c=comentarios: Añade un comentario al shelve creado en la operación.
--commentsfile=comment.txt: Carga el comentario del fichero especificado.
--summaryformat: El comando imprime sólamente la especificación del
objeto creado en el repositorio principal.
== CMD_HELP_SHELVESET ==
Ejemplos:
cm shelveset create -c="my comment"
cm shelveset delete sh:3
cm shelve apply sh:3
== CMD_HELP_SHELVESET_CREATE ==
El comando shelveset create almacena los ítems en checkout especificados
dentro del repositorio. De este modo el contenido queda almacenado en el
servidor sin necesidad de hacer check in.
Notas:
- Si no se especifican [opciones] ni [rutas], la operación involucrará a
todos los cambios pendientes en el espacio de trabajo.
- La operación de shelve se aplica siempre recursivamente desde la
ruta indicada.
- Requisitos para hacer shelve de un ítem:
* El ítem debe estar controlado por Unity VCS.
* El ítem ha de estar desprotegido.
Ejemplos:
cm shelveset create
cm shelveset fichero1.txt fichero2.txt
Comentarios:
Para especificar comentarios use el switch "-c" o "-m" del siguiente modo:
cm shelveset -c="my comment"
cm shelveset -m "my comment"
Configure la variable de entorno PLASTICEDITOR para especificar un editor
para escribir el comentario. Si la variable de entorno PLASTICEDITOR está
configurada pero no se indica ningún comentario, el editor se abrirá para
que pueda escribir el comentario.
Ejemplo: Shelve 'changelist'
cm status --short --changelist=pending_to_review | cm shelveset -
(El comando listará los paths en el changelist llamado 'pending_to_review'
y dicha lista será redirigida a la entrada del comando 'shelve').
== CMD_DESCRIPTION_SHELVESET_DELETE ==
Borra un shelveset almacenado en el repositorio.
== CMD_USAGE_SHELVESET_DELETE ==
Sintaxis:
cm shelveset delete shelve_spec
shelve_spec: Elimina los contenidos almancenados en el repositorio
identificados por "shelve_spec"
== CMD_HELP_SHELVESET_DELETE ==
El comando shelveset delete borra un shelveset creado anteriormente.
Ejemplo:
cm shelveset delete sh:3
(Elimina un shelveset almacenado en el repositorio.)
== CMD_DESCRIPTION_SHELVESET_APPLY ==
El comando shelveset apply restaura los contenidos almancenados en el
repositorio.
== CMD_USAGE_SHELVESET_APPLY ==
Sintaxis:
cm shelveset apply shelve_spec [<change_path>[ ...]] [opciones]
shelve_spec: Restaura los contenidos almancenados en el repositorio
identificados por "shelve_spec"
change_path: Ruta(s) del cambio(s) a aplicar. Es la ruta de servidor,
una de las que se imprime con la opción --preview. Cuando no se indica
ninguna ruta se aplican todos los cambios del shelve.
Opciones:
--preview: Muestra los cambios a aplicar en el workpsace sin aplicarles
--mount: El punto de montaje del respositorio especificado.
--encoding=codificación: Especifica la codificación de los ficheros de
origen (por ejemplo, UTF-8 o Unicode)
--comparisonmethod=tipo: cualquiera de las siguientes opciones:
ignoreeol: Ignora diferencias de final de línea.
ignorewhitespaces: Ignora diferencias de espacios en blanco.
ignoreeolandwhitespaces: Ignora diferencias de final de línea y espacios en
blanco.
recognizeall: Detecta diferencias de final de línea y espacios en
blanco.
== CMD_HELP_SHELVESET_APPLY ==
El comando shelveset apply restaura los contenidos almancenados en el
repositorio.
Ejemplo: Aplicar un shelve almacenado en el repositorio:
cm shelveset apply sh:3
Ejemplo: Aplicar solo 1 cambio almacenado en un shelve en el repositorio:
cm shelveset apply sh:3 /src/foo.c
== CMD_DESCRIPTION_SHOW_FIND_OBJECTS ==
Muestra la lista de objetos disponibles y sus atributos correspondientes.
== CMD_USAGE_SHOW_FIND_OBJECTS ==
Sintaxis:
cm showfindobjects
== CMD_HELP_SHOW_FIND_OBJECTS ==
Objetos y atributos disponibles:
attribute:
Se puede buscar atributos filtrando por los siguientes campos:
Type : string.
Value : string.
Date : fecha.
Consulte la sección "constantes de fecha" en esta guía para más
info.
Owner : usuario.
Admite el usuario especial 'me'.
GUID : Identificador Global Único.
Id hexadecimal con el formato xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
Comment : string.
SrcObj : object spec.
ID : integer.
attributetype:
Se puede buscar tipos de atributo filtrando por los siguientes campos:
Name : string.
Value : string.
Date : fecha.
Consulte la sección "constantes de fecha" en esta guía para más
info.
Owner : usuario.
Admite el usuario especial 'me'.
GUID : Identificador Global Único.
Id hexadecimal con el formato xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
Comment : string.
Source : object spec.
ID : integer.
Campos de replicación. Consulte la sección "campos relacionados con la réplica"
en esta guía para más información sobre:
ReplLogId
ReplSrcDate
ReplSrcId
ReplSrcRepository
ReplSrcServer
branch:
Se puede buscar ramas filtrando por los siguientes campos:
Name : string.
Date : fecha.
Consulte la sección "constantes de fecha" en esta guía para más
info.
Changesets : fecha (de los changesets en la rama).
Consulte la sección "constantes de fecha" en esta guía para más
info.
Attribute : string.
AttrValue : string.
Owner : usuario.
Admite el usuario especial 'me'.
Parent : branch spec.
Comment : string.
GUID : Identificador Global Único.
Id hexadecimal con el formato xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
Item : item spec or item id (integer).
ID : integer.
Es posible usar la cláusula 'order by' con este objeto. En concreto, puede ordenar
por los siguientes campos:
date
branchname
Campos de replicación. Consulte la sección "campos relacionados con la réplica"
en esta guía para más información sobre:
ReplLogId
ReplSrcDate
ReplSrcId
ReplSrcRepository
ReplSrcServer
changeset:
Se puede buscar changesets filtrando por los siguientes campos:
Branch : branch spec.
ChangesetId : integer.
Attribute : string.
AttrValue : string.
Date : fecha.
Consulte la sección "constantes de fecha" en esta guía
para más info.
Owner : usuario.
Admite el usuario especial 'me'.
GUID : Identificador Global Único.
Id hexadecimal con el formato xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
Comment : string.
OnlyWithRevisions : boolean.
ReturnParent : boolean.
Parent : changeset id (integer).
ID : integer.
Es posible usar la cláusula 'order by' con este objeto. En concreto, puede ordenar
por los siguientes campos:
date
changesetid
Campos de replicación. Consulte la sección "campos relacionados con la réplica"
en esta guía para más información sobre:
ReplLogId
ReplSrcDate
ReplSrcId
ReplSrcRepository
ReplSrcServer
label:
Se puede buscar etiquetas filtrando por los siguientes campos:
Name : string.
Attribute : string.
AttrValue : string.
Date : fecha.
Consulte la sección "constantes de fecha" en esta guía para más
info.
Owner : usuario.
Admite el usuario especial 'me'.
GUID : Identificador Global Único.
Id hexadecimal con el formato xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
Branch : branch spec.
Branchid : integer.
Changeset : changeset id (integer).
Comment : string.
ID : integer.
Es posible usar la cláusula 'order by' con este objeto. En concreto, puede ordenar
por los siguientes campos:
date
labelname
Campos de replicación. Consulte la sección "campos relacionados con la réplica"
en esta guía para más información sobre:
ReplLogId
ReplSrcDate
ReplSrcId
ReplSrcRepository
ReplSrcServer
merge:
Se puede buscar merges filtrando por los siguientes campos:
SrcBranch : branch spec.
SrcChangeset : changeset id (integer).
DstBranch : branch spec.
DstChangeset : changeset id (integer).
Date : fecha.
Consulte la sección "constantes de fecha" en esta guía para
más info.
Owner : usuario.
Admite el usuario especial 'me'.
GUID : Identificador Global Único.
Id hexadecimal con el formato xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
Type : string.
Los posibles valores son 'merge', 'cherrypick',
'cherrypicksubstractive', 'interval', 'intervalcherrypick'
e 'intervalcherrypicksubstractive'
ID : integer.
replicationlog:
Se puede buscar replication log filtrando por los siguientes campos:
Branch : branch spec.
RepositoryName : string.
Owner : usuario.
Admite el usuario especial 'me'.
Date : fecha.
Consulte la sección "constantes de fecha" en esta guía para
más info.
Server : string.
Package : boolean.
ID : integer.
review:
Se puede buscar code reviews filtrando por los siguientes campos:
Status : string.
Assignee : string.
Title : string.
Target : object spec.
TargetId : integer.
TargetType : string.
Los posibles valores son 'branch' y 'changeset'.
Date : fecha.
Consulte la sección "constantes de fecha" en esta guía para más
info.
Owner : usuario.
Admite el usuario especial 'me'.
GUID : Identificador Global Único.
Id hexadecimal con el formato xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
Id : integer.
Es posible usar la cláusula 'order by' con este objeto. En concreto, puede ordenar
por los siguientes campos:
date
modifieddate
status
revision:
Se puede buscar revisiones filtrando por los siguientes campos:
Branch : branch spec.
Changeset : changeset id (integer).
Item : string o integer.
ItemId : integer.
Attribute : string.
AttrValue : string.
Archived : boolean.
Comment : string.
Date : fecha.
Consulte la sección "constantes de fecha" en esta guía
para más info.
GUID : Identificador Global Único.
Id hexadecimal con el formato xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
Owner : usuario.
Admite el usuario especial 'me'.
Parent : revision id (integer).
ReturnParent : boolean.
Shelve : shelve id (integer).
Size : integer (en bytes).
Type : string.
Los posibles valores son 'dir', 'bin' y 'txt'.
WorkspaceCheckoutId : integer.
ID : integer.
Campos de replicación. Consulte la sección "campos relacionados con la réplica"
en esta guía para más información sobre:
ReplLogId
ReplSrcDate
ReplSrcId
ReplSrcRepository
ReplSrcServer
shelve:
Se puede buscar shelves filtrando por los siguientes campos:
Owner : usuario.
Admite el usuario especial 'me'.
Date : fecha.
Consulte la sección "constantes de fecha" en esta guía para más
info.
Attribute : string.
AttrValue : string.
Comment : string.
GUID : Identificador Global Único.
Id hexadecimal con el formato xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx.
Parent : integer.
ShelveId : integer.
ID : integer.
Campos de replicación. Consulte la sección "campos relacionados con la réplica"
en esta guía para más información sobre:
ReplLogId
ReplSrcDate
ReplSrcId
ReplSrcRepository
ReplSrcServer
Campos relacionados con la réplica:
Muchos objetos mantienen información de replicación, lo que significa que
Unity VCS mantiene el rastro de dónde se crearon originalmente.
Los campos que se pueden utilizar son:
ReplSrcServer : Significa "servidor origen de la réplica", y es el
servidor de donde se trajeron los objetos.
Ejemplo:
cm find branch "where replsrcserver='skull.codicefactory.com:9095'"
ReplSrcRepository : string. Significa "repositorio origen de la réplica",
y es el repositorio de donde se trajeron los objetos.
Ejemplo:
cm find branch "where \
replsrcserver = 'skull.codicefactory.com:9095' \
and replsrcrepository = 'codice'"
ReplLogId : integer. El identificador de la operación de réplica.
En Unity VCS, cada vez que un objeto nuevo se crea de una
réplica, también se crea un nuevo 'replicationlog'.
Ejemplo:
cm find replicationlog
324054 9/13/2018 02:00:15 /main/scm23064 sluisp plasticscm.com T
327255 9/11/2018 12:33:38 /main/scm23042 maria plasticscm.com T
329631 9/17/2018 13:06:49 /main/scm23099 sluisp plasticscm.com T
Ahora se pueden buscar las ramas creadas en la réplica 327255, en
caso de haber alguna:
cm find branch "where replogid=327255"
ReplSrcDate: fecha. Es la fecha en la que la operación de réplica tuvo
lugar. Los objetos replicados mantienen la fecha en la que
fueron creados originalmente, por lo que este campo es útil
si se necesita buscar objetos que fueron replicados en un
determinado marco temporal.
Ejemplo:
cm find replicationlog "where date > 'one week ago'"
8780433 27/09/2018 8:49:38 codice@BACKYARD:8087 F mbarriosc
Ahora se puede verificar que la rama replicada se creó antes de la
propia operación de réplica:
cm find branch "where repllogid = 8780433"
8780443 26/09/2018 12:20:55 /main/scm23078 maria codice T
ReplSrcId: integer. Es el ID del servidor origen de la réplica
(ReplSrcServer). Este ID se puede descubrir buscando objetos
de tipo 'replicationsource' con el comando 'cm find'.
Ejemplo:
cm find replicationsource
7860739 codice@AFRODITA:8087 d9c4372a-dc55-4fdc-ad3d-baeb2e975f27
8175854 codice@BACKYARD:8087 66700d3a-036b-4b9a-a26f-adfc336b14f9
Ahora se pueden buscar los changesets replicados desde
codice@AFRODITA:8087 de la siguiente forma:
cm find changesets "where replsrcid = 7860739"
Constantes de fecha:
Se pueden usar fechas formateadas siguiendo la configuración de localización
del Sistema Operativo. Por ejemplo, si el SO muestra fechas en el formato
'dd/MM/yyyy', se pueden utilizar fechas como '31/12/2018' en las consultas.
Sin embargo, también se pueden utilizar las siguientes constantes para
facilitar la escritura de las queries:
'today' : la fecha de hoy.
'yesterday' : la fecha de ayer.
'this week' : la fecha del lunes de la semana actual.
'this month' : la fecha del primer día del mes actual.
'this year' : la fecha del 1 de enero del año actual.
'one day ago' : un día antes de la fecha actual.
'one week ago' : una semana antes de la fecha actual.
'one month ago' : un mes antes de la fecha actual.
'n days ago' : 'n' días antes de la fecha actual.
'n months ago' : 'n' meses antes de la fecha actual.
'n years ago' : 'n' años antes de la fecha actual.
Las siguientes cláusulas 'where' son válidas para campos que admitan fechas:
'(...) where date > 'today' (...)'
'(...) where date < 'yesterday' (...)'
'(...) where date > 'this week' (...)'
'(...) where date > 'this month' (...)'
'(...) where date < 'one day ago' and date > '3 days ago' (...)'
'(...) where date < 'one week ago' and date > '3 weeks ago' (...)'
'(...) where date < 'one month ago' and date > '3 months ago' (...)'
'(...) where date > '1 year ago' (...)'
También se puede forzar un determinado formato de fecha en el comando
'cm find' utilizando el flag --dateformat. Lee 'cm find --help' para más
información.
== CMD_DESCRIPTION_TRIGGER_SHOWTYPES ==
Muestra la lista de los tipos de triggers disponibles.
== CMD_USAGE_TRIGGER_SHOWTYPES ==
Sintaxis:
cm trigger showtypes
== CMD_DESCRIPTION_SHOWACL ==
Muestra la ACL (Lista de Control de Acceso) de un elemento.
== CMD_USAGE_SHOWACL ==
Sintaxis:
cm showacl [opciones] spec_objeto
spec_objeto Especificación del objeto sobre el que mostrar el ACL.
Objetos válidos para este comando son repserver,
repositorio, rama, changeset, etiqueta, item y atributo.
Usa 'cm help objectspec' para obtener más información
sobre la especificación de objetos.
Opciones:
--extended Muestra información detallada.
--xml Permite volcar la salida del comando en formato xml
a la salida estándar. También se permite especificar
un fichero de salida (--xml=output.xml).
--encoding Si se utiliza con la opción --xml, permite especificar
el encoding con el que se guardará la salida del
comando. Por ejemplo: --encoding=utf-8
Consulte la documentación de la MSDN para obtener la
tabla completa de codificaciones soportadas y su formato;
al final de la página en la columna "Name":
http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
== CMD_HELP_SHOWACL ==
Notas:
Este comando se utiliza para obtener una lista de permisos de un usuario o
un grupo sobre un elemento del repositorio.
Ejemplos:
cm showacl repserver:PlasticServer:8084
cm showacl br:/main --extended
== CMD_DESCRIPTION_SHOWCOMMANDS ==
Muestra todos los comandos disponibles.
== CMD_USAGE_SHOWCOMMANDS ==
Sintaxis:
cm showcommands
== CMD_HELP_SHOWCOMMANDS ==
== CMD_DESCRIPTION_SHOWOWNER ==
Muestra el propietario de un elemento del repositorio.
== CMD_USAGE_SHOWOWNER ==
Sintaxis:
cm showowner spec_objeto
spec_objeto Especificación del objeto para mostar su propietario.
Usa 'cm help objectspec' para obtener más información
sobre la especificación de objetos.
El objeto debe ser uno de los siguientes: repserver,
repositorio, rama, changeset, etiqueta, atributo,
revisión e item.
== CMD_HELP_SHOWOWNER ==
Notas:
Este comando muestra el propietario de un elemento del repositorio.
Puede ser un usuario o un grupo.
El propietario se puede modificar con el comando 'cm setowner'.
Ejemplos:
cm showowner repserver:PlasticServer:8084
cm showowner rev:fichero.cs#br:/main#LAST
== CMD_DESCRIPTION_SHOWPERMISSIONS ==
Muestra la lista de los permisos disponibles.
== CMD_USAGE_SHOWPERMISSIONS ==
Sintaxis:
cm showpermissions
== CMD_HELP_SHOWPERMISSIONS ==
Ejemplos:
cm showpermissions
== CMD_DESCRIPTION_SHOWSELECTOR ==
Muestra el selector del espacio de trabajo actual.
== CMD_USAGE_SHOWSELECTOR ==
Sintaxis:
cm showselector [wk_ruta | wk_spec]
wk_ruta Ruta del espacio de trabajo para mostrar su selector
wk_spec Especificación del espacio de trabajo para mostrar su
selector.
Usa 'cm help objectspec' para obtener más información sobre
especificaciones de espacios de trabajo.
== CMD_HELP_SHOWSELECTOR ==
Notas:
Si no se especifica una ruta o un especificador de espacio de trabajo,
el comando tomará como ruta el directorio actual.
Ejemplos:
cm showselector c:\workspace
cm showselector
cm showselector > miSelector.txt
cm showselector wk:build_wk@BUILDER
== CMD_DESCRIPTION_SUPPORT ==
Este comando permite al usuario efectuar operaciones de soporte.
== CMD_USAGE_SUPPORT ==
Sintaxis:
cm support comando [opciones]
Comandos:
bundle
Para obtener más información sobre cada uno de los comandos ejecute:
cm support comando --usage
cm support comando --help
== CMD_HELP_SUPPORT ==
Ejemplos:
cm support
cm support bundle
cm support bundle c:\outputfile.zip
== CMD_DESCRIPTION_SUPPORT_BUNDLE ==
Crea el paquete de soporte con los ficheros de log relevantes.
Este paquete se puede adjuntar cuando se solicita la ayuda, cuando
se pregunte por información extra o cuando se envíe un error.
== CMD_USAGE_SUPPORT_BUNDLE ==
Sintaxis:
cm support bundle [outputfile]
Opciones:
outputfile Crea el paquete de soporte en la ruta especificado.
== CMD_HELP_SUPPORT_BUNDLE ==
Notas:
Este comando permite al usuario crear un paquete de soporte con los
ficheros de log relevantes. Es posible especificar un fichero de salida.
Ejemplos:
cm support bundle
(Crea el paquete de soporte en el directorio temporal)
cm support bundle c:\outputfile.zip
(Crea el paquete de soporte en la ruta especificado)
== CMD_DESCRIPTION_SWITCH ==
Actualiza el espacio de trabajo a la rama, etiqueta, changeset o shelve especificado.
== CMD_USAGE_SWITCH ==
Sintaxis:
cm switch brspec | csetspec | lbspec | shspec
[--workspace=path] [--repository=name]
[--forcedetailedprogress] [--noinput]
[--silent] [--verbose] [--xml[=<output_file>]] [--encoding=<name>]
Opciones:
--workspace Ruta del espacio de trabajo a cambiar.
--repository Repositorio al que se va a cambiar.
--forcedetailedprogress Fuerza mostrar progreso detallado incluso cuando se
redirige la salida estándar.
--noinput Ignora las preguntas interactivas para continuar la
operación con cambios pendientes o haciendolos shelve.
--silent Solo se imprimen mensajes en caso de error.
--verbose Muestra información adicional.
--xml Imprime el resultado en formato XML a la salida
estándar. También es posible especificar un fichero
de salida.
--encoding Usado con la opción --xml, especifica el encoding
que se usará en la salida XML, por ejemplo, utf-8.
Consulte la documentación de MSDN en
http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
para obtener la tabla de codificaciones soportadas y
su formato (al final de la página en la columna "Name").
Usa 'cm help objectspec' para aprender más sobre cómo indicar
especificaciones de changesets, ramas y etiquetas.
== CMD_HELP_SWITCH ==
Notas:
Este comando permite a los usuarios actualizar el espacio de trabajo
con el contenido del objeto especificado (rama, etiqueta o changeset).
Ejemplos:
cm switch br:/main
cm switch lb:Rel1.1
cm switch Rel2.0
cm switch cs:4375
cm switch 5632
cm switch sh:2
== CMD_DESCRIPTION_SWITCH_TO_BRANCH ==
Establece la rama especificada como rama de trabajo.
== CMD_USAGE_SWITCH_TO_BRANCH ==
Sintaxis:
cm switchtobranch [opciones] [spec_rama]
spec_rama: Especificación de rama.
Opciones:
--label=nombre | --changeset=número: Carga las revisiones de la etiqueta
o changeset especificado. Si no se especifica spec_rama, una de
estas opciones es obligatoria.
--workspace | -wk=path: Ruta del espacio de trabajo a cambiar.
== CMD_HELP_SWITCH_TO_BRANCH ==
Notas:
Este comando permite a los usuarios especificar una rama, como rama de
trabajo. Adicionalmente se puede especificar una etiqueta o un changeset,
desde la cual se cargarán las revisiones.
Si no se especifica rama, se ha de especificar una etiqueta o un changeset
obligatoriamente. Consulte el manual para obtener más información.
Si no se especifica repositorio, la rama se fija sobre el repositorio
actual.
Ejemplos:
cm switchtobranch br:/main
cm switchtobranch br:/main/tarea001
cm switchtobranch --label=BL050
(Configuración de sólo lectura. Se cargan revisiones del changeset etiquetado)
== CMD_DESCRIPTION_SYNC ==
Sincroniza con Git
== CMD_USAGE_SYNC ==
Sintaxis:
cm synchronize | sync repspec git [url [--user=usr_name --pwd=pwd]] [--author]
[[--txtsimilaritypercent | --binsimilaritypercent | --dirsimilaritypercent]=value]
[--skipgitlfs] [--gitpushchunk=<value>]
repspec Especificación del repositorio.
Usa 'cm help objectspec' para obtener más información
sobre la especificación de repositorios.
git (Default).
Opciones:
url URL del repositorio remoto
(http(s):// o git:// o una URL ssh).
--user Nombre de usuario para la URL especificada.
--pwd Contraseña para la URL especificada.
--txtsimilaritypercent | --binsimilaritypercent | --dirsimilaritypercent
Opciones para detectar ítems movidos, del mismo modo que
lo hace la GUI de Unity VCS.
--author Usa los valores de nombre y fecha (timestamp) del autor
en git (git committer by default).
--skipgitlfs Ignora la configuración de Git LFS que haya en el
fichero '.gitattributes'. Se comporta como si no
tuviese soporte de Git LFS.
--gitpushchunk Procesa la operación de push (exportar cambios de
Unity VCS a Git) en bloques de un determinado número
de changesets. Esta opción solo es útil en
repositorios muy grandes para evitar problemas con
la red o con el tamaño del paquete a enviar a Git o
simplemente con el fin de depurar otros problemas.
Usa bloques de 1000 changesets si no se especifica
un valor concreto.
== CMD_HELP_SYNC ==
Notas:
En caso de sincronizar con un servidor que no requiera credenciales, tras
la primera sincronización no es necesario introducir el parámetro URL.
Este comando no soporta repositorios locales.
En el caso de usar el protocolo SSH, es necesario tener añadido al PATH
el cliente por línea de comandos 'ssh' y que esté correctamente configurado
para conectarse al servidor remoto (claves públicas/privadas).
Ejemplos:
cm sync default@localhost:8087 git git://localhost/repository
== CMD_DESCRIPTION_TRIGGER ==
Use este comando para administrar triggers.
== CMD_USAGE_TRIGGER ==
Sintaxis:
cm trigger | tr <command> [options]
Comandos:
create | mk
delete | rm
edit
list | ls
showtypes
Para obtener más información sobre cada comando:
cm trigger <command> --usage
cm trigger <command> --help
== CMD_HELP_TRIGGER ==
Ejemplos:
cm tr mk before-mklabel new "/path/to/script" --server=myserver:8084
cm tr edit before-mklabel 7 --position=4 --server=myserver:8084
cm tr ls before-mkbranch --server=myserver:8084
cm tr rm after-setselector 4
cm tr showtypes
== CMD_DESCRIPTION_TUBE ==
Ejecuta comandos relacionados con Plastic Tube.
== CMD_USAGE_TUBE ==
Sintaxis:
cm tube config -u=user -p=password
cm tube create remoteuser
cm tube remove remoteuser
cm tube local
cm tube remote
cm tube share <repository_spec>+ -u=remoteuser -a=access_mode
cm tube unshare <repository_spec>+ -u=remoteuser
cm tube connect
cm tube disconnect
cm tube status
Opciones:
-u Usuario de Tube (el usuario de plasticscm.com)
-p Password del usuario
-a Acceso: pull, push o ambos (pull | push | pull,push)
rep_spec Especificación del repositorio.
Usa 'cm help objectspec' para obtener más información
sobre la especificación de repositorios.
== CMD_HELP_TUBE ==
Notas:
config
Configura Unity VCS para usar Plastic Tube con el usuario y password
especificados.
create
Crea el Tube remoteuser -> myuser.
El usuario 'myuser' permite a 'remoteuser' conectarse al servidor
de 'myuser'.
Pueden establecerse conexiones de 'remoteuser' a 'myuser'.
Sólo pueden crearse un Tube de otro usuario al usuario actual de
Plastic Tube.
remove
Elimina el Tube remoteuser -> myuser.
local
Lista los repositorios locales compartidos en el servidor local y los
usuarios con quien son compartidos.
remote
Lista los repositorios remotamente compartidos que son compartidos con
el usuario actual de Plastic Tube.
share
Comparte el repositorio(s) local con el usuario y remoto y los permisos
especificados.
unshare
Deja de compartir el repositorio local con el usuario remoto.
connect
Conecta el servidor de Unity VCS a Plastic Tube.
disconnect
Desconecta el servidor de Unity VCS de Plastic Tube.
status
Muestra si el servidor de Unity VCS está conectado a Plastic Tube.
Ejemplos:
cm tube config -u=ruben@codicesoftware.com -p=rubenpassword
cm tube create pablo@codicesoftware.com
('pablo@codicesoftware.com' puede conectar con el usuario actual del Tube)
cm tube remove pablo@codicesoftware.com
cm tube local
cm tube remote
cm tube share repo@server:8087 -u=pablo@codicesoftware.com -a=pull,push
cm tube share repo@server:8087 doc@server:8087 -u=pablo@codicesoftware.com -a=push
cm tube unshare repo@server:8087 -u=pablo@codicesoftware.com
cm tube connect
cm tube disconnect
cm tube status
== CMD_DESCRIPTION_UNCO ==
Deshace la desprotección de un ítem.
== CMD_USAGE_UNCO ==
Sintaxis:
cm undocheckout | unco <item_path>+ [--all] [--symlink] [--silent]
[--keepchanges | -k]
item_path Especificación de los ítems para deshacer la desprotección,
separados por comas.
Se pueden usar comillas (") para especificar rutas que
contengan espacios.
Use . para aplicar la operación al directorio actual.
Opciones:
--all (-a) Los ítems especificados que han sido cambiados, movidos
y borrados localmente también serán deshechos.
--symlink Deshace la protección del fichero de link y no al
elemento al que apunta.
--silent No muestra salida.
--keepchanges (-k) Deshace la desprotección dejando los cambios locales.
Ejemplo: un checkout lo deja como changed con el
contenido en disco que tenia antes de hacer el unco.
Esta opción no puede utilizarse con workspaces dinámicos.
== CMD_HELP_UNCO ==
Notas:
Si se desean descartar los cambios realizados en un ítem desprotegido
previamente, se utiliza este comando.
El ítem se cambia a la revisión justamente anterior.
Requisitos para deshacer la desprotección:
El ítem ha de estar controlado por Unity VCS
El ítem ha de estar desprotegido
Ejemplos:
cm undocheckout .
(Desprotege el directorio actual)
cm undocheckout fichero1.txt fichero2.txt
cm unco c:\workspace\fichero.txt
cm undocheckout -R c:\workspace\src
(Deshace la desprotección de 'src' recursivamente)
cm unco link --symlink
(Efectúa la desprotección sobre el fichero de symlink y no del que apunta.)
cm unco code\cgame\cg_main.c --all
(Deshace la desprotección del fichero cambiado)
Deshacer 'changelist'. Ejemplo:
cm status --short --changelist=pending_to_review | cm undocheckout -
(El comando listará los paths en el changelist llamado 'pending_to_review'
y dicha lista será redirigida a la entrada del comando 'uncheckout').
== CMD_DESCRIPTION_UNCOUNCHANGED ==
Deshace la desprotección en elementos que no han cambiado.
== CMD_USAGE_UNCOUNCHANGED ==
Sintaxis:
cm uncounchanged [opciones]
Opciones:
-R|-r|--recursive Descender recursivamente dentro de directorios.
== CMD_HELP_UNCOUNCHANGED ==
Notas:
Este comando se aplica desde la raíz del workspace recursivamente.
Ejemplos:
cm uncounchanged
== CMD_DESCRIPTION_UNDELETE ==
Recupera en el espacio de trabajo la revisión especificada en la ruta dada.
== CMD_USAGE_UNDELETE ==
Sintaxis:
cm undelete rev_spec ruta
rev_spec: Especificación de la revisión del ítem cuyo contenido se desea
cargar en el espacio de trabajo.
path: Ruta donde se va a restaurar.
== CMD_HELP_UNDELETE ==
Notas:
El elemento a recuperar no debe de estar ya cargado en el workspace.
La operación de recuperar no esta soportada para xlinks.
Ejemplos:
cm undelete revid:756 C:\mywks\src\foo.c
cm undelete itemid:68#cs:2 C:\mywks\dir\myfile.pdf
cm undelete serverpath:/src#br:/main C:\mywks\Dir
== CMD_DESCRIPTION_UNDOCHANGE ==
Deshace los cambios hechos en un fichero.
== CMD_USAGE_UNDOCHANGE ==
Notas:
Si se desean descartar los cambios en un ítem, independientemente de su
estado (desprotegido o modificado sin hacer desprotección), este comando
vuelve a la revisión anterior. Si se ordena realizar la operación sobre
un directorio en vez de un fichero la acción se realiza recursivamente por
defecto.
Ejemplos:
cm unc . (Descarta los cambios de los ítems del directorio actual).
cm unc fichero1.txt fichero2.txt
cm unc c:\workspace\fichero1.txt
== CMD_HELP_UNDOCHANGE ==
Ejemplos:
cm unc . (Descarta los cambios de los ítems del directorio actual).
cm unc fichero1.txt fichero2.txt
cm unc c:\workspace\fichero1.txt
== CMD_DESCRIPTION_UNDO ==
Deshace cambios en un workspace.
== CMD_USAGE_UNDO ==
Syntaxis:
cm undo [<path>[ ...]] [--symlink] [-r | --recursive] [<filter>[ ...]]
[--silent | --machinereadable [--startlineseparator=<sep>]
[--endlineseparator=<sep>] [--fieldseparator=<sep>]]
path Rutas de los ficheros o directorios sobre los que deshacer los
cambios. Use comillas dobles (" ") para especificar rutas que
contengan espacios. Use un espacio en blanco para separar rutas
de ítems.
Si no se especifica ninguna ruta, la operación se ejecutará
sobre los ficheros del directorio actual.
filter Aplica el filtro o filtros indicados a las rutas especificadas.
Use un espacio en blanco para separar filtros. Consulte la
sección Filtros para más información.
Opciones:
--symlink Deshace los cambios en el symlink pero no en el
destino (target).
-r Deshace los cambios recursivamente.
--silent No muestra ninguna salida.
--machinereadable Muestra el resultado en un formato fácil de parsear.
--startlineseparator Usado con '--machinereadable', indica cómo deben
empezar las líneas del resultado.
--endlineseparator Usado con '--machinereadable', indica cómo deben
terminar las líneas del resultado.
--fieldseparator Usado con '--machinereadable', indica cómo deben
separarse los campos de cada línea resultante.
Filtros:
Las rutas se pueden filtrar usando uno o varios de los filtros a continuación.
Cada uno de estos filtros se refiere a un tipo de cambio:
--checkedout Selecciona ficheros y directorios desprotegidos (checked-out).
--unchanged Selecciona ficheros sin cambios.
--changed Selecciona ficheros y directorios cambiados o desprotegidos
(checked-out).
--deleted Selecciona ficheros y directorios borrados.
--moved Selecciona ficheros y directorios movidos.
--added Selecciona ficheros y directorios añadidos.
Si la ruta contiene alguno de los tipos de cambios especificados en los
filtros, entonces solo esos tipos de cambios se desharán en dicha ruta.
Por ejemplo, si se especifica a la vez --checkedout y --moved, si un fichero
está tanto movido como checkedout, ambos tipos de cambios se desharán.
Si no se especifica ningun filtro, se deshacen todos los tipos de cambios.
== CMD_HELP_UNDO ==
Notas:
- Si no se especifica ninguna ruta, se deshacen todos los cambios en el
directorio actual pero no recursivamente.
- Si se especifica una o más rutas, se deshacen todos los cambios en las
rutas especificadas pero no recursivamente.
- Para hacer que el undo sea recursivo hay que especificar la opción -r.
Así para deshacer todos los cambios de un directorio incluyendo los cambios
sobre el propio directorio habría que ejecutar lo siguiente:
cm undo dirpath -r
Si dirpath es la ruta de un workspace, entonces se deshacen todos los
cambios dentro del workspace.
- El comando undo es peligroso porque deshace los cambios irreversiblemente.
Es decir, no hay manera posible de recuperar el estado anterior de los
ficheros y directorios afectados.
- En el siguiente escenario:
/src
|- file.txt
|- code.cs
\- /test
|- test_a.py
\- test_b.py
Estos comandos son equivalentes (ejecutados desde el directorio /src):
cm undo
cm undo *
cm undo file.txt code.cs /test
Y estos también son equivalentes (también ejecutados desde /src):
cm undo .
cm undo /src file.txt code.cs
Ficheros borrados:
Para deshacer borrados de fichero o directorios hay que especificar la
ruta completa del fichero o directorio, o el directorio padre más la opción
-r (recursivo).
Por ejemplo:
cm undo .
(NO deshace los borrados (solo otros cambios) en el directorio actual.)
cm undo . -r
(Deshace todos los borrados (y otros cambios) recursivamente del directorio
actual.)
cm undo src/file.txt
(Deshace el borrado (u otro cambio) del fichero src/file.txt.)
Ejemplos:
cm undo . -r
(Deshace recursivamente todos los cambios en el directorio actual. Si
se ejecuta desde la raíz del workspace, deshace todos los cambios en el
workspace completo.)
cm co file.txt
cm undo file.txt
(Deshace el checkout en file.txt.)
cm undo c:\otroworkspace\file.txt
(Deshace los cambios en 'file.txt' que se encuentra en un workspace distinto
del que se está trabajando.)
echo content >> file.txt
cm undo file.txt
(Deshace el cambio local en file.txt.)
cm undo src
(Deshace los cambios en el directorio src y en todos los ficheros
controlados que contenga)
cm undo src/*
(Deshace los cambios en todos ficheros y directorios en src sin afectar
al propio directorio.)
cm undo *.cs
(Deshace cambios en cada fichero y directorio que cumpla el patrón *.cs en
el directorio actual.)
cm undo *.cs -r
(Deshace recursivamente cambios en cada fichero y directorio que cumpla el
patrón *.cs en el directorio actual y en cada directorio por debajo.)
cm co file1.txt file2.txt
echo content >> file1.txt
cm undo --unchanged
(Deshace el checkout en file2.txt y no en file1.txt ya que file1.txt sí
tiene cambios locales.)
echo content >> file1.txt
echo content >> file2.txt
cm co file1.txt
cm undo --checkedout
(Deshace el cambio en el fichero desprotegido (checked-out) file1.txt e
ignora file2.txt ya que no está en checked-out.)
cm add file.txt
cm undo file.txt
(Deshace el añadido de file.txt dejándolo de nuevo como privado.)
$ rm file1.txt
$ echo content >> file2.txt
$ cm add file3.txt
$ cm undo --deleted --added *
(Deshace el borrado de file1.txt y el añadido de file3.txt, ignorando
el cambio en file2.txt.)
== CMD_DESCRIPTION_LOCK_UNLOCK ==
Deshace los bloqueos en los elementos de un servidor.
== CMD_USAGE_LOCK_UNLOCK ==
Sintaxis:
cm lock unlock [<repserverspec>] <guid>[ ...]
repserverspec Especificación del servidor de repositorio.
(Use 'cm help objectspec' para más información sobre las
especificaciones de servidores de repositorio.)
guid Lista de GUIDs de ítems a desbloquear. Use un
espacio en blanco para separar GUIDs.
== CMD_HELP_LOCK_UNLOCK ==
Notas:
- El comando usa el servidor especificado para desbloquear los ítems.
- Si no se especifica ningún servidor, el comando intentará obtener un
servidor del espacio de trabajo actual.
- Si con los pasos anteriores no se pudo obtener ningún servidor, el comando
utilizará el servidor de la configuración actual del cliente de Unity VCS.
- Únicamente el administrador del servidor puede ejecutar el comando 'cm unlock'.
- Para especificar un GUID, indique los 32 dígitos separados por guiones con
el siguiente formato (y, opcionalmente, incluidos entre llaves):
{00000000-0000-0000-0000-000000000000}
o
00000000-0000-0000-0000-000000000000
Ejemplos:
cm lock unlock 91961b14-3dfe-4062-8c4c-f33a81d201f5
(Deshace el bloqueo del ítem indicado.)
cm lock unlock DIGITALIS:8084 2340b4fa-47aa-4d0e-bb00-0311af847865 \
bcb98a61-2f62-4309-9a26-e21a2685e075
(Deshace los bloqueos de los ítems indicados del servidor 'DIGITALIS'.)
cm lock unlock tardis@cloud 4740c4fa-56af-3dfe-de10-8711fa248635 \
71263c17-5eaf-5271-4d2c-a25f72e101d4
(Deshace los bloqueos de los ítems indicados del servidor cloud 'tardis'.)
== CMD_DESCRIPTION_UPDATE ==
Actualiza el espacio de trabajo.
== CMD_USAGE_UPDATE ==
Sintaxis:
cm update [<ruta> | --last]
[--changeset=csetspec] [--cloaked] [--dontmerge] [--forced]
[--ignorechanges] [--override] [--recursewk] [--skipchangedcheck]
[--silent] [--verbose] [--xml[=output_file]] [--encoding=name]
[--machinereadable [--startlineseparator=<sep>]
[--endlineseparator=<sep>] [--fieldseparator=<sep>]]
[--forcedetailedprogress] [--noinput]
ruta Ruta a actualizar.
Use . para aplicar la actualización al directorio actual.
Si no se especifica ninguna ruta, se actualiza todo
el workspace.
--last Antes de la actualización, cambia el selector del
espacio de trabajo (workspace) desde una configuración
de changeset o de etiqueta a una configuración de
rama.
El selector se cambia a la rama a la que pertenece el
changeset o la etiqueta.
Opciones:
--changeset Actualiza el espacio de trabajo a un changeset concreto.
(Use 'cm help objectspec' para obtener más información
sobre la especificación de changesets.)
--cloaked Incluye los ítems cloaked en la operación de update.
Si no se utiliza esta opción, se ignorarán durante
la actualización todos los ítems cloaked.
--dontmerge El update merge no se llevará cabo en el caso en que
se requiera esa operación.
--forced Fuerza la actualización de todos los ítems a aquella
revisión especificada en el selector.
--ignorechanges Si existen cambios pendientes durante la actualización
del espacio de trabajo, se ignorarán y se continuará
con la actualización.
--noinput Ignora las preguntas interactivas para continuar la
operación con cambios pendientes o haciendolos shelve.
--override Ignoran los ficheros cambiados fuera del control de
Unity VCS. Su contenido se sobrescribirá con el
contenido del servidor.
--recursewk Actualiza todos los espacios de trabajo de la ruta
actual. Esto es útil para actualizar todos los
espacios de trabajo contenidos en la ruta indicada.
--skipchangedcheck Comprueba si hay cambios locales en el workspace
antes de actualizar. Esta opción es útil para
acelerar la actualización cuando siempre se
desprotegen (checkout) ficheros antes de
modificarlos.
--silent Solo se imprimen mensajes en caso de error.
--verbose Muestra información adicional.
--xml Imprime el resultado en formato XML a la salida
estándar. También es posible especificar un fichero
de salida.
--encoding Usado con la opción --xml, especifica el encoding
que se usará en la salida XML, por ejemplo, utf-8.
Consulte la documentación de MSDN en
http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
para obtener la tabla de codificaciones soportadas y
su formato (al final de la página en la columna "Name").
--machinereadable Muestra el resultado en un formato fácil de parsear.
--startlineseparator Usado con '--machinereadable', indica cómo deben
empezar las líneas del resultado.
--endlineseparator Usado con '--machinereadable', indica cómo deben
terminar las líneas del resultado.
--fieldseparator Usado con '--machinereadable', indica cómo deben
separarse los campos de cada línea resultante.
--forcedetailedprogress Fuerza mostrar el progreso detallado incluso cuando
se redirige la salida estándar.
== CMD_HELP_UPDATE ==
Notas:
El comando 'update' solo descarga los ficheros necesarios.
El comando asume recursividad.
Cuando se especifica la opción --last, no es necesario especificar una ruta.
En ese caso, el espacio de trabajo del directorio actual se actualizará.
(Especificar la opción --last puede hacer que el selector del espacio de
trabajo cambie a un configuración de rama si previamente apuntaba a un
changeset o una etiqueta.)
Ejemplos:
cm update
(Actualiza el espacio de trabajo actual.)
cm update .
(Actualiza recursivamente el contenido del directorio actual.)
cm update . --forced --verbose
(Fuerza la actualización de todas las revisiones y muestra información
adicional.)
cm update --last
cm update . --machinereadable --startlineseparator=">"
(Actualiza recursivamente el directorio actual y muestra por pantalla el
resultado en un formato simple y fácil de parsear, comenzando cada línea con
el separador indicado.)
== CMD_DESCRIPTION_VERSION ==
Muestra el número de versión del cliente.
== CMD_USAGE_VERSION ==
Sintaxis:
cm version
== CMD_HELP_VERSION ==
== CMD_DESCRIPTION_WHOAMI ==
Muestra el usuario actual de Unity VCS.
== CMD_USAGE_WHOAMI ==
Sintaxis:
cm whoami
== CMD_HELP_WHOAMI ==
== CMD_USAGE_WKTREENODESTATUS ==
Uso:
cm wktreenodestatus path1, path2, ...
== CMD_DESCRIPTION_WORKSPACE ==
Use este comando para administrar workspaces.
== CMD_USAGE_WORKSPACE ==
Sintaxis:
cm workspace | wk comando [options]
Comandos:
list | ls
create | mk
delete | rm
move | mv
rename
Para obtener más información sobre cada comando:
cm workspace comando --usage
cm workspace comando --help
== CMD_HELP_WORKSPACE ==
Ejemplos:
cm workspace create myWorkspace wk_path
cm workspace list
cm workspace delete myWorkspace
== CMD_DESCRIPTION_WORKSPACE_CREATE ==
Crea un nuevo workspace.
== CMD_USAGE_WORKSPACE_CREATE ==
Sintaxis:
cm workspace | wk [create | mk] <rep_spec>
[create | mk] <nombre> <ruta> [<rep_spec>]
[create | mk] <nombre> <ruta> [--selector[=<fichero_selector>]
(Crea un nuevo workspace.)
cm workspace | wk [create | mk] <nombre> <ruta> --dynamic --tree=[<tree>]
(Crea un workspace dinámico. Esta característica es experimental,
y solamente se encuentra disponible en Windows.)
nombre Nombre del nuevo workspace.
ruta Ruta de acceso del workspace.
rep_spec Crea el nuevo workspace con el repositorio especificado.
Use 'cm help objectspec' para obtener más
información sobre especificaciones de repositorios.
Opciones:
--selector Edita el selector para el nuevo workspace.
Si se especifica selector-file, entonces el selector
para el nuevo workspace se fiha desde el fichero
especificado.
--dynamic Crea un workspace dinámico. Esta funcionalidad es
todavía experimental, y solo está disponible para
Windows. Si se usa esta opción, es obligatorio usar el
parámetro --tree.
--tree Especifica el punto inicial al que apuntará el
workspace dinámico. Puede ser una especificación de
rama, changeset o etiqueta. El workspace continuará
usando el repositorio de la especificación. Use
'cm help objectspec' para obtener más información sobre
la especificación.
== CMD_HELP_WORKSPACE_CREATE ==
Notas:
- Un workspace es una vista del repositorio mapeado en el sistema de
ficheros local, en un directorio especificado. Utilice los comandos
'cm showselector' y 'cm setselector' para ver y modificar el selector.
- Si no se especifica rep_spec ni --selector, el workspace cargará
automáticamente el contenido del primer repositorio (alfabéticamente) del
servidor configurado en el fichero de configuración client.conf
- Los workspaces dinámicos son una funcionalidad experimental (sólo Windows),
y requiere que el programa plasticfs.exe se esté ejecutando en segundo
plano.
Ejemplos:
cm workspace create mycode
cm wk mk mycode
(Crea un workspace llamado 'mycode' apuntando al repositorio del mismo nombre.
El directorio del workspace se creará bajo el directorio actual.)
cm wk mk mycode@localhost:8084
cm wk mk mycode@myorganization@cloud
(Crea un workspace llamado 'mycode' igual que antes, pero es posible especificar
un servidor de repositorios diferente.)
cm workspace create myworkspace c:\workspace
cm wk mk myworkspace /home/john/wkspace
(Crea el workspace 'myworkspace' en 'c:\workspace' y '/home/john/wkspace'
respectivamente.)
cm wk mywktest c:\wks\wktest --selector=myselector.txt
(Crea 'mywktest' utilizando como selector 'myselector.txt'.)
cm wk mywkprj c:\wks\wkprj myrep@repserver:localhost:8084
(Crea 'mywkprj' en 'c:\wks\wkprj' con el repositorio seleccionado.)
cm wk mywkprj c:\dynwks\mywkprj --dynamic --tree=br:/main@myrep@localhost:8084
(Crea el workspace dinámico 'mywkprj' en 'c:\dynwks\mywkprj' con el
repositorio 'myrep@localhost:8084', apuntando a la rama '/main' la primera
vez que se monte.)
== CMD_DESCRIPTION_WORKSPACE_DELETE ==
Borra un workspace.
== CMD_USAGE_WORKSPACE_DELETE ==
Sintaxis:
cm workspace | wk delete | rm [ruta | wkspec] [--keepmetadata]
ruta Ruta del workspace.
wkspec Especificación del workspace a borrar.
Use 'cm help objectspec' para obtener más información sobre la
especificación de espacios de trabajo.
Opciones:
--keepmetadata: No elimina los archivos de metadatos del directorio
.plastic.
== CMD_HELP_WORKSPACE_DELETE ==
Notas:
Si no se especifican parámetros, se borrará el workspace actual.
Ejemplos:
cm workspace delete
(Elimina el workspace actual)
cm wk delete c:\workspace
cm workspace rm /home/danipen/wks
cm wk rm wk:MiWorkspace
cm wk rm wk:MiWorkspace@DIGITALIS
== CMD_DESCRIPTION_WORKSPACE_LIST ==
Muestra la lista de workspaces.
== CMD_USAGE_WORKSPACE_LIST ==
Sintaxis:
cm workspace | wk [list | ls] [--format=str_format]
Opciones:
--format Devuelve el mensaje de respuesta con el formato
especificado. Consulte la ayuda para más información.
== CMD_HELP_WORKSPACE_LIST ==
Notas:
Este comando acepta una cadena de texto formateada para mostrar la
salida.
Los parámetros de salida del comando son los siguientes:
{0} | {wkname} Nombre del workspace.
{1} | {machine} Nombre de la máquina.
{2} | {path} Ruta del workspace.
{3} | {wkid} Identificador único del workspace.
{4} | {wkspec} Especificación del workspace en el formato:
'wkname@machine'.
{tab} Inserta un tabulador.
{newline} Inserta una nueva línea.
Ejemplos:
cm wk
(Lista todos los workspaces.)
cm workspace list --format={0}#{3,40}
cm workspace list --format={wkname}#{wkid,40}
(Lista todos los workspaces mostrando el nombre del workspaces, el
símbolo '#' y el identificador del workspace utilizando 40 espacios y
alineado a la izquierda.)
cm wk --format="Workspace {0} in path {2}"
cm wk --format="Workspace {wkname} in path {path}"
(Lista todos los workspaces, mostrando los resultados en cadenas
formateadas.)
== CMD_DESCRIPTION_WORKSPACE_MOVE ==
Mueve un workspace.
== CMD_USAGE_WORKSPACE_MOVE ==
Sintaxis:
cm workspace | wk move | mv [wkspec] ruta
Opciones:
wkspec Especificación del workspace a ser movido.
Use 'cm help objectspec' para obtener más información sobre la
especificación de espacios de trabajo.
ruta La ruta destino a la que mover el workspace.
== CMD_HELP_WORKSPACE_MOVE ==
Notas:
Este comando permite al usuario mover workspace a otro lugar en disco.
Ejemplos:
cm workspace move myWorkspace \new\workspaceDirectory
(Mueve el workspace a la ruta especificada.)
cm wk mv C:\wkspaces\newpath
(Mueve el workspace de trabajo a 'C:\wkspaces\newpath')
== CMD_DESCRIPTION_WORKSPACE_RENAME ==
Cambia el nombre de un workspace.
== CMD_USAGE_WORKSPACE_RENAME ==
Sintaxis:
cm workspace | wk rename [nombre_antiguo] nombre_nuevo
nombre_antiguo Nombre antiguo del workspace.
nombre_nuevo Nombre nuevo del workspace.
== CMD_HELP_WORKSPACE_RENAME ==
Notas:
Este comando renombra un workspace. Si no se especifica nombre_antiguo,
el sistema tomará el nombre del workspace actual.
Ejemplos:
cm workspace rename miworkspace wk2
(El workspace 'miworkspace' se renombra a 'wk2'.)
cm wk rename nuevoNombre
(El workspace actual se renombra a 'nuevoNombre'.)
== CMD_DESCRIPTION_WORKSPACESTATUS ==
Muestra el changeset cargado en un workspace y si los hay los elementos cambios que contiene.
== CMD_USAGE_WORKSPACESTATUS ==
Sintaxis:
cm status [workspacepath] [opciones] [tipos_de_búsqueda]
workspacepath: El path de un workspace determinado o una ruta por debajo
del mismo. La búsqueda de cambiados se realizará a partir del path
especificado y de manera recursiva.
Opciones generales:
--changelist=NAME: Muestra los cambios en el 'changelist' llamado "NAME".
--changelists: Muestra los cambios agrupados en 'changelists'.
--cutignored: Evita mostrar los contenidos de los directorios ignorados.
Requiere el tipo de búsqueda --ignored.
--header: Solo imprimirá la información del changeset cargado en el
workspace, no realizará la búsqueda de elementos cambiados.
--noheader: El comando no imprimirá el estado del workspace, sólo
realizará e imprimirá la búsqueda de elementos cambiados.
--nomergesinfo: La información de los merges de los cambios no se imprimirá.
--head: El comando imprimirá el estado del último changeset de la rama.
--short: Muestra únicamente rutas de elementos que tienen cambios.
--symlink: Aplica la operación a los enlaces simbólicos en lugar de
aplicarla a sus destinos.
--dirwithchanges: Muestra directorios que contienen cambios (ítems
añadidos, movidos o eliminados en su interior).
--xml: Permite volcar la salida del comando en formato xml. Por defecto la
salida sale en la pantalla, pero si se especifica un fichero
(--xml=output.xml) la salida se vuelca en dicho fichero.
--pretty: Imprime los cambios del workspace en formato de tabla.
--encoding: si se utiliza con la opción --xml, permite especificar el
encoding con el que se guardará la salida del comando. Consulte la
documentación de la MSDN para obtener la tabla completa de
codificaciones soportadas y su formato; al final de la página en la
columna "Name":
http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
--wkrootrelativepaths, --wrp: Muestra rutas relativas a la raíz del
workspace en vez de rutas relativas al directorio actual.
--fullpaths, --fp: Fuerza al comando a imprimir rutas absolutas,
sobreescribiendo cualquier otra configuración acerca de impresión
de rutas.
--iscochanged: Incluye información sobre si el contenido de un fichero en
checkout ha sido o modificado o no. Esta opción sólo está disponible en
combinación con las opciones "--compact", "--xml" y
"--machinereadable".
Si no se especifica la opción "--iscochanged", las opciones
"--compact", "--xml" o "--machinereadable" sólamente mostrarán el
estado "CO" para un fichero en checkout cuyo contenido ha cambiado.
Si se especifica la opción "--iscochanged", las opciones "--compact",
"--xml" o "--machinereadable" mostrarán el estado "CO+CH" para un
fichero en checkout cuyo contenido ha cambiado.
Opciones del viejo formato:
--cset: El comando imprimirá el estado del workspace en el viejo formato.
--compact: El comando imprimirá el estado del workspace y la búsqueda de
elementos cambiados en el viejo formato.
--noheaders: Usado junto con --compact, la información de cada grupo de
cambiós no se imprimirá. (No aplica al nuevo formato.)
Tipos de búsqueda:
--added: El comando busca elementos añadidos.
--checkout: El comando busca elementos en checkout.
--changed: El comando busca elementos cambiados.
--copied: El comando busca elementos copiados.
--replaced: El comando busca elementos reemplazados.
--deleted: El comando busca elementos borrados.
--localdeleted: El comando busca elementos borrados localmente.
--moved: El comando busca elementos movidos.
--localmoved: El comando busca elementos movidos localmente.
--percentofsimilarity (-p)=valor: Porcentaje de similitud entre dos
ficheros para considerarlos el mismo en la búsqueda de movidos
locales, su valor por defecto es un 20%.
--txtsameext: Sólo aquellos ficheros de texto que tengan la misma
extensión serán tenidos en cuenta para la búsqueda de movidos basada
en la similitud del contenido. Por defecto todos los ficheros de texto
son procesados.
--binanyext: Cualquier fichero binario es tenido en cuenta para la
búsqueda de movidos basada en la similitud del contenido. Por defecto
sólo aquellos ficheros binarios que tengan la misma extensión
son procesados.
--private: El comando busca elementos no controlados.
--ignored: El comando busca elementos ignorados.
--hiddenchanged: El comando busca elementos cambiados marcados como
ocultos (incluye '--changed').
--cloaked: El comando busca elementos marcados como cloaked.
--controlledchanged: Este modificador engloba los siguientes parámetros:
'--added' '--checkout' '--copied' '--replaced' '--deleted' '--moved'.
--all (-a): Este modificador engloba los siguientes parámetros:
'--controlledchanged' '--changed' '--localdeleted' '--localmoved'
'--private'.
== CMD_HELP_WORKSPACESTATUS ==
Notas:
El comando status muestra el changeset cargado en un workspace
y si los hay, los cambios que contiene.
Se puede utilizar el comando para saber cuál es el changeset con el que se
está trabajando en un momento dado, y poder utilizarlo, por ejemplo, para
marcar configuraciones concretas mediante etiquetas de tipo changeset.
También es útil para conocer los cambios pendientes que existen dentro
del workspace, los tipos de cambios que deseamos obtener del workspace pueden
ser modificados gracias a los parámetros que el comando admite. Por defecto
se muestran todos los cambios, controlados y locales.
El porcentaje de similitud entre dos ficheros usado por el algoritmo de
cálculo de movidos locales se puede especicifar mediante la option '--percentofsimilarity'
o '-p' y su rango va desde 0 hasta 100. Si este parámetro no es especidicado
su valor por por defecto es del 20%.
A través de éste comando, también es posible mostrar los cambios agrupados
en 'changelists' de cliente. El changelist por defecto del sistema (llamado
'default'), agrupa los cambios que no están contenidos en el resto de
'changelists', por lo que los cambios que se muestran especificando éste
'changelist', dependerán del tipo de búsquedas especificados en el comando.
La opción de mostrar cambios agrupados en 'changelists' requiere mostrar cambios
controlados (en estado 'added', 'checkout', 'copied', 'replaced', 'deleted' o
'moved'), por lo que la opción '--controlledchanged' se activará automáticamente
cuando se muestren 'changelists'.
El formato por defecto para la salida en XML es UTF-8. Es posible cambiar
dicho encoding usando la opción --encoding=otro_encoding.
El comando 'status' imprime por defecto rutas relativas al directorio de trabajo,
a menos que se especifiquen las opciones '--machinereadable' o '--short'
(en cuyo caso, se imprimen rutas absolutas).
Si se usa la opción '--xml', el comando 'status' imprimirá por defecto rutas
relativas a la raíz del workspace, a menos que se especifique adicionalmente
la opción '--fp' (en cuyo caso, se imprimen rutas absolutas).
Ejemplos:
cm status
(Ejecutándolo dentro de un workspace el comando imprime el changeset cargado
y los elementos en checkout, añadidos, copiados, reemplazados, borrados, borrados locales,
movidos, movidos locales, y privados. La busqueda de los elementos se realiza
sobre el workspace de forma recursiva)
cm status --controlledchanged
(Ejecutándolo dentro de un workspace el comando imprime el changeset cargado
y los elementos del workspace en checkout, añadidos, copiados, reemplazados,
borrados, y movidos)
cm status --added
(Ejecutándolo dentro de workspace el comando imprime el changeset cargado
y solamente los elementos añadidos. La búsqueda de los elementos se realiza
sobre el workspace de forma recursiva)
cm status c:\workspaceLocation\code\client --added
(El comando imprime el changeset cargado y solamente los elementos añadidos.
La búsqueda de los elementos se realiza sobre el path proporcionado de forma recursiva)
cm status --changelists
cm status --changelist
(El comando muestra todos los cambios en el espacio de trabajo, agrupados
por 'changelists').
cm status --changelist=pending_to_review
(El comando muestra los cambios que contiene el changelist 'pending_to_review')
cm status --changelist=default --private
(El comando muestra los cambios que contiene el changelist 'default',
el changelist por defecto del sistema, mostrando elementos privados,
además de elementos con cambios controlados si los hubiese).
cm status --short --changelist=pending_to_review | cm checkin -
(Se protegen los cambios en el changelist llamado 'pending_to_review').
cm status c:\workspaceLocation\code\client --xml=output.xml
(Guarda la salida del status en el fichero output.xml, en formato XML y
usando UTF-8.)
cm status --ignored
(Muestra todos los elementos ignorados)
Salida:
IG src
IG src/version.c
IG out/app.exe
cm status --ignored --cutignored
(Muestra ficheros ignorados cuyo directorio padre no está ignorado y
directorios ignorados pero no el árbol de sus contenidos)
Salida:
IG src
IG out/app.exe
== CMD_DESCRIPTION_XLINK ==
Crea, edita o muestra un xlink
== CMD_USAGE_XLINK ==
Sintaxis:
cm xlink [-w] [-rs] xlink_path / <csetspec | lbspec | brspec> [<expansion_rules>+]
(Crea un xlink).
cm xlink [-rs] xlink_path /relative_path <csetspec | lbspec | brspec> [<expansion_rules>+]
(Crea un xlink parcial de solo lectura apuntando a /relative_path en lugar
de apuntar a la raíz por defecto / ).
cm xlink -e xlink_path <csetspec | lbspec | brspec>
(Edita un xlink para cambiar la especificación destino).
cm xlink -s|--show xlink_path
(Muestra la información de un xlink incluyendo las reglas de expansión).
cm xlink -ar|--addrules xlink_path <expansion_rules>+
(Añade al xlink las reglas de expansión proporcionadas).
cm xlink -dr|--deleterules xlink_path <expansion_rules>+
(Borra del xlink las reglas de expansión especificadas).
xlink_path Ruta en el espacio de trabajo actual donde se cargan
los contenidos del repositorio que se va a enlazar
(cuando se crea un xlink) o que ya está enlazado
(cuando se edita un xlink).
csetspec Especificación del changeset que se va a enlazar.
Determina qué versión y rama se carga en el espacio de
trabajo para el repositorio enlazado.
Usa 'cm help objectspec' para obtener más información
sobre la especificación de changesets.
lbspec Especificación de la etiqueta que se va a enlazar.
Usa 'cm help objectspec' para obtener más información
sobre la especificación de etiquetas.
brspec Especificación de la rama que se va a enlazar.
Usa el changeset actual a donde la rama especificada
está apuntando.
Usa 'cm help objectspec' para obtener más información
sobre la especificación de ramas.
-e Indica que el comando va a editar un xlink existente
para cambiar la especificación del changeset enlazado.
-s | --show Muestra información sobre el xlink seleccionado.
-ar | --addrules Añade una o más reglas de expansión al xlink indicado.
-dr | --deleterules Borra una o más reglas de expansión del xlink indicado.
expansion_rules Especifica una o más reglas de expansión. Cada regla de
expansión es un par (rama)-(rama a enlazar)
br:/main/fix-br:/main/develop/fix
Opciones:
-w Crea un xlink de escritura. Esto significa que los
contenidos bajo el xlink se podrán editar mediante el
uso de autoexpansión de ramas.
-rs Relative server. Permite crear un xlink a un repositorio
que es una réplica de otro que existe en un servidor
central. De este modo se reconcilian automáticamente los
repositorios replicados con el original.
Ejemplos:
cm xlink codigo\segundorepositorio / 1@segundo@localhost:8084
cm xlink codigo\segundorepositorio / lb:LB001@segundo@localhost:8084
cm xlink -s codigo\segundorepositorio
cm xlink -ar codigo\segundorepositorio br:/main-br:/main/develop br:/main/fix-br:/main/develop/fix
cm xlink -dr codigo\segundorepositorio br:/main/fix-br:/main/develop/fix
== CMD_HELP_XLINK ==
Notas:
Este comando crea un xlink al changeset especificado. Por defecto se
creará como un xlink de sólo lectura. Esto significa que los contenidos
correspondientes a otro repositorio cargados por debajo del xlink no
podrán ser modificados.
Para la edición del changeset de un xlink se puede utilizar una sintaxis
reducida en la que no hay que especificar el resto de parámetros del
xlink. Solamente es necesario en nuevo changeset al que apuntará.
Auto-expansión de ramas:
Cuando se realiza un cambio en uno de los repositorios enlazados en modo
de lectura y escritura (opción -e) es necesario crear una nueva rama en
dicho repositorio basándose en la rama en la que se está trabajando en el
repositorio principal. Para determinar el nombre de dicha rama, se aplican
las siguientes reglas:
1) Se comprueba si el nombre completo de la rama existe en el
repositorio enlazado:
- Si existe, se utiliza dicha rama.
- Si no existe, Unity VCS construye el nombre de la rama de esta forma:
- Nombre de la rama que contiene el changeset enlazado + nombre
de la rama del repositorio principal.
- Si existe una rama con dicho nombre, se utiliza como rama de
trabajo.
- Si no, se crea una rama nueva con el nombre así construido y
se establece como base de la rama el changeset enlazado.
2) Después, se crea una nueva versión del xlink dentro de la nueva rama
apuntando al nuevo changeset.
De este modo, la estructura completa del xlink se mantiene actualizada con
los últimos cambios en las versiones correctas.
Ejemplos:
cm xlink code\firstrepo / 1@first@localhost:8084
(Crea un xlink en la carpeta 'firstrepo' en el espacio de trabajo actual
donde el changeset '1' en el repositorio 'first' se enlazará).
cm xlink opengl\include /includes/opengl 1627@includes@localhost:8087
(Crea un xlink parcial de solo lectura en la ruta 'opengl\include' en el
espacio de trabajo actual donde la ruta '/includes/opengl' en el changeset
'1627' del repositorio 'includes' se enlazará como raíz. Esto significa
que cualquier ítem dentro de '/includes/opengl' se enlazará en
'opengl\include' mientras que el resto del repositorio se ignorará).
cm xlink -w -rs code\secondrepo / lb:LB001@second@localhost:8084
(Crea un xlink de escritura y relativo en la ruta 'secondrepo' en el
espacio de trabajo actual donde la etiqueta'LB001' en el repositorio
'second' se enlazará).
cm xlink code\thirdrepo / 3@third@localhost:8087 br:/main-br:/main/scm003
(Crea un xlink en la ruta 'thirdrepo' dentro del espacio de trabajo actual
donde el changeset '3' en el repositorio 'third' se enlazará).
cm xlink -e code\secondrepo br:/main/task1234@second@localhost:8084
(Edita el xlink 'code\secondrepo' para cambiar el repositorio destino
enlazando la rama 'main/task1234' en el repositorio 'second').
cm xlink --show code\thirdrepo
(Muestra información del xlink 'code\thirdrepo' incluyendo las reglas de
expansión si éstas existen).
cm xlink -ar code\secondrepo br:/main-br:/main/develop br:/main/fix-br:/main/develop/fix
(Añade dos reglas de expansión al xlink 'code\secondrepo').
cm xlink -dr code\secondrepo br:/main/fix-br:/main/develop/fix
(Borra la regla de expansión del xlink 'code\secondrepo').
cm xlink code\secondrepo / 1@second@localhost:8084
cm xlink code\secondrepo / lb:LB001@second@localhost:8084
== CMD_USAGE_AUTOCOMPLETE ==
Sintaxis:
cm autocomplete install
Instala el autocompletado de comandos para 'cm' en la shell.
cm autocomplete uninstall
Desinstala el autocompletado de comandos para 'cm' de la shell.
cm autocomplete --line <shell_line> --position <cursor_position>
Devuelve sugerencias de autocompletado para 'shell_line', que deben ser
insertadas en 'cursor_position'. Este comando no está pensado para ser
ejecutado por el usuario final, pero está documentado en caso de que se
quiera extender el soporte de autocompletado a otras shells.
shell_line La linea que el usuario ha escrito en la shell cuando se
pidió el autocompletado.
En Bash, encuentra en la variable de entorno COMP_LINE.
En PowerShell, se encuentra en la variable $wordToComplete.
cursor_position La posición del cursor cuando se pidió el autocompletado.
En Bash, se encuentra en la variable de entorno COMP_POINT.
En PowerShell, se encuentra en la variable $cursorPoint.
== CMD_DESCRIPTION_API ==
Arranca un servidor HTTP local que escucha peticiones de REST API.
== CMD_USAGE_API ==
Sintaxis:
cm api [(-p|--port)=<portnumber>] [(-r|--remote)]
Opciones:
-p | --port Pide al servidor escuchar en el puerto <portnumber>
en lugar del 9090.
-r | --remote Permite conexiones entrantes remotas, es decir,
aquellas que provienen de otras máquinas en vez de
la local.
== CMD_HELP_API ==
Notas:
El comando 'cm api' permite a los programadores realizar operaciones Unity VCS
de cliente en sus máquinas.
Lea la Guía de Unity VCS API para más información:
https://www.plasticscm.com/documentation/restapi/plastic-scm-version-control-rest-api-guide
Por defecto, la API escucha solamente conexiones locales en el puerto 9090.
Para detener el servidor, presione la tecla Enter.
Ejemplos:
cm api
(Arranca la API en el puerto 9090; únicamente conexiones locales.)
cm api -r
(Arranca la API en el puerto 9090; permite cualquier conexión entrante.)
cm api --port=15000 -r
(Arranca la API en el puerto 15000; permite cualquier conexión entrante.)
== CMD_DESCRIPTION_CONFIGURECLIENT ==
Configura el cliente de Unity VCS y especificar un servidor por defecto para el usuario actual.
== CMD_USAGE_CONFIGURECLIENT ==
Sintaxis:
cm configure [--language=<idioma> --workingmode=<modo> [AuthParameters]
--server=<servidor> [--port=<puerto>]] [--clientconf=<ruta_clientconf>]
--language Idiomas disponibles:
en (English)
es (Spanish)
--workingmode Modos de seguridad/usuarios disponibles:
NameWorkingMode (Name)
NameIDWorkingMode (Name + ID)
LDAPWorkingMode (LDAP)
ADWorkingMode (Active Directory)
UPWorkingMode (User and password)
SSOWorkingMode (Single Sign On)
AuthParameters Parámetros de autenticación (solo para modos LDAPWorkingMode y UPWorkingMode):
--user=<usuario>
--password=<contraseña>
Parámetros de Single Sign On (solo para modos SSOWorkingMode):
--user=<usuario>
--token=<token>
--server Nombre/dirección IP del servidor de Unity VCS
--port Puerto del servidor de Unity VCS
(el puerto es opcional para servidores de Cloud)
--clientconf Ruta del fichero de configuración a crear (opcional)
Este argumento puede ser una ruta completa, un nombre de fichero o un directorio.
Si no se especifica este parámetro, el directorio por defecto para el fichero
de configuración 'client.conf' será:
* '%LocalAppData%\plastic4' en Windows
* '$HOME/.plastic4' en linux/macOS
Ejemplos:
--clientconf=c:/path/to/myclient.conf
(La ruta especificada se utilizará para crear el fichero de configuración del cliente)
--clientconf=myclient.conf
(Se utilizará el fichero 'myclient.conf' dentro del directorio de configuración por defecto)
--clientconf=c:/exisitingDirectory
(Se utilizará el nombre de fichero por defecto, client.conf, en el directorio especificado)
== CMD_HELP_CONFIGURECLIENT ==
Notas:
El comando 'cm configure' no podrá ser usado en las versiones Cloud Edition o DVCS Edition de Unity VCS.
Use de forma alternativa la aplicación 'plastic --configure'.
Ejemplos:
cm configure
(ejecuta la versión interactiva del comando de configuración del cliente de Unity VCS)
cm configure --language=en --workingmode=LDAPWorkingMode --user=jack --password=01234 \
--server=plastic.mymachine.com --port=8084
(configura el cliente de Unity VCS con los parámetros especificados, y creará el fichero
de configuración 'client.conf' en el directorio por defecto).
cm configure --language=en --workingmode=NameWorkingMode --server=plastic.mymachine.com \
--port=8084 --clientconf=clientconf_exp.conf
(configura el cliente de Unity VCS con los parámetros especificados, y creará el fichero
de configuración 'client.conf' en el directorio especificado).
|